├── .editorconfig
├── .gitignore
├── .travis.yml
├── LICENSE
├── README.md
├── composer.json
├── phpcs.xml
├── phpunit.xml.dist
├── src
    └── autoload.php
└── tests
    ├── bootstrap.php
    ├── cases
        └── autoload-test.php
    └── fixtures
        ├── class-plugin.php
        ├── extra
            └── trait-length.php
        ├── interface-say.php
        └── trait-name.php


/.editorconfig:
--------------------------------------------------------------------------------
 1 | # editorconfig.org
 2 | root = true
 3 | 
 4 | [*.php]
 5 | charset = utf-8
 6 | end_of_line = lf
 7 | indent_size = 4
 8 | indent_style = tab
 9 | insert_final_newline = true
10 | tab_width = 4
11 | trim_trailing_whitespace = true
12 | 


--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
1 | composer.lock
2 | vendor
3 | 


--------------------------------------------------------------------------------
/.travis.yml:
--------------------------------------------------------------------------------
 1 | language: php
 2 | 
 3 | sudo: false
 4 | 
 5 | php:
 6 |   - 5.4
 7 |   - 5.5
 8 |   - 5.6
 9 |   - 7.0
10 |   - hhvm
11 | 
12 | install:
13 |   - travis_retry composer install --no-interaction --prefer-source
14 | 
15 | script:
16 |   - phpunit
17 | 


--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
 1 | Copyright (c) 2015 Fredrik Forsmo <fredrik.forsmo@gmail.com>
 2 | 
 3 | Permission is hereby granted, free of charge, to any person obtaining
 4 | a copy of this software and associated documentation files (the
 5 | 'Software'), to deal in the Software without restriction, including
 6 | without limitation the rights to use, copy, modify, merge, publish,
 7 | distribute, sublicense, and/or sell copies of the Software, and to
 8 | permit persons to whom the Software is furnished to do so, subject to
 9 | the following conditions:
10 | 
11 | The above copyright notice and this permission notice shall be
12 | included in all copies or substantial portions of the Software.
13 | 
14 | THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
15 | EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
16 | MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
17 | IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
18 | CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
19 | TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
20 | SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
21 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
 1 | # WordPress Autoload
 2 | 
 3 | [![Build Status](https://travis-ci.org/wpup/autoload.svg?branch=master)](https://travis-ci.org/wpup/autoload)
 4 | [![No Maintenance Intended](http://unmaintained.tech/badge.svg)](http://unmaintained.tech/)
 5 | 
 6 | Simple autoloader that will autoload classes, interfaces or traits with namespace prefix
 7 | 
 8 | # Install
 9 | 
10 | ```
11 | composer require frozzare/wp-autoload
12 | ```
13 | 
14 | ## Example
15 | 
16 | Example of your main php file.
17 | 
18 | ```php
19 | require 'vendor/autoload.php';
20 | register_wp_autoload( 'Example\\', __DIR__ . '/src' );
21 | ```
22 | 
23 | Example of `src/class-plugin-loader.php`
24 | 
25 | ```php
26 | namespace Example;
27 | class Plugin_Loader {}
28 | ```
29 | 
30 | Example of `src/trait-crawler.php`
31 | 
32 | ```php
33 | namespace Example;
34 | trait Crawler {}
35 | ```
36 | 
37 | Example of `src/interface-say.php`
38 | 
39 | ```php
40 | namespace Example;
41 | interface Say {}
42 | ```
43 | 
44 | ## License
45 | 
46 | MIT © [Fredrik Forsmo](https://github.com/frozzare)
47 | 


--------------------------------------------------------------------------------
/composer.json:
--------------------------------------------------------------------------------
 1 | {
 2 |   "name": "frozzare/wp-autoload",
 3 |   "description": "Simple autoloader that will autoload classes or traits with namespace prefix",
 4 |   "keywords": ["wordpress", "autoload", "namespace"],
 5 |   "license": "MIT",
 6 |   "authors": [
 7 |     {
 8 |       "name": "Fredrik Forsmo",
 9 |       "email": "fredrik.forsmo@gmail.com"
10 |     }
11 |   ],
12 |   "require": {
13 |     "php": "^5.4 || ^7.0"
14 |   },
15 |   "require-dev": {
16 |     "phpunit/phpunit": "~4.0"
17 |   },
18 |   "autoload": {
19 |     "files": [
20 |       "src/autoload.php"
21 |     ]
22 |   },
23 |   "minimum-stability": "dev"
24 | }
25 | 


--------------------------------------------------------------------------------
/phpcs.xml:
--------------------------------------------------------------------------------
 1 | <?php xml version="1.0"?>
 2 | <ruleset name="WordPress autoload">
 3 | 	<description>WordPress autoload rules for PHP_CodeSniffer</description>
 4 | 
 5 | 	<rule ref="WordPress-Core">
 6 | 	  <exclude name="WordPress.Arrays.ArrayKeySpacingRestrictions" />
 7 | 	  <exclude name="WordPress.Arrays.ArrayDeclaration" />
 8 | 	  <exclude name="WordPress.PHP.YodaConditions" />
 9 | 	  <exclude name="WordPress.WhiteSpace.ControlStructureSpacing.NoSpaceAfterStructureOpen" />
10 | 	  <exclude name="WordPress.WhiteSpace.ControlStructureSpacing.NoSpaceBeforeOpenParenthesis" />
11 | 	  <exclude name="Generic.WhiteSpace.DisallowSpaceIndent.SpacesUsed" />
12 | 	</rule>
13 | 
14 | 	<rule ref="Generic.WhiteSpace.ScopeIndent">
15 | 	  <properties>
16 | 	    <property name="indent" value="4"/>
17 | 	    <property name="tabIndent" value="false"/>
18 | 	  </properties>
19 | 	</rule>
20 | </ruleset>
21 | 


--------------------------------------------------------------------------------
/phpunit.xml.dist:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="UTF-8"?>
 2 | <phpunit backupGlobals="false"
 3 |          backupStaticAttributes="false"
 4 |          beStrictAboutTestsThatDoNotTestAnything="true"
 5 |          beStrictAboutOutputDuringTests="true"
 6 |          bootstrap="tests/bootstrap.php"
 7 |          colors="true"
 8 |          convertErrorsToExceptions="true"
 9 |          convertNoticesToExceptions="true"
10 |          convertWarningsToExceptions="true"
11 |          processIsolation="false"
12 |          stopOnError="false"
13 |          stopOnFailure="false"
14 |          syntaxCheck="true"
15 |          verbose="true"
16 |          >
17 |   <testsuites>
18 |     <testsuite name="WordPress Autoloader Test Suite">
19 |       <directory suffix=".php">./tests/cases</directory>
20 |     </testsuite>
21 |   </testsuites>
22 |   <filter>
23 |     <whitelist addUncoveredFilesFromWhitelist="true">
24 |       <directory suffix=".php">./src</directory>
25 |     </whitelist>
26 |   </filter>
27 | </phpunit>
28 | 


--------------------------------------------------------------------------------
/src/autoload.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | if ( ! function_exists( 'register_wp_autoload' ) ) {
 4 | 
 5 | 	/**
 6 | 	 * Register the autoloader.
 7 | 	 *
 8 | 	 * The autoloader understands WordPress file naming convention.
 9 | 	 *
10 | 	 * @param string $prefix
11 | 	 * @param string $base_dir
12 | 	 */
13 | 	function register_wp_autoload( $prefix, $base_dir ) {
14 | 		if ( empty( $prefix ) || empty( $base_dir ) ) {
15 | 			return;
16 | 		}
17 | 
18 | 		spl_autoload_register( function ( $class ) use( $prefix, $base_dir ) {
19 | 			$base_len = strlen( $base_dir ) - 1;
20 | 
21 | 			if ( $base_dir[$base_len] !== '/' ) {
22 | 				$base_dir .= '/';
23 | 			}
24 | 
25 | 			// does the class use the namespace prefix?
26 | 			$len = strlen( $prefix );
27 | 
28 | 			if ( 0 !== strncmp( $prefix, $class, $len ) ) {
29 | 				// no, move to the next registered autoloader
30 | 				return;
31 | 			}
32 | 
33 | 			// get the relative class name
34 | 			$relative_class = substr( $class, $len );
35 | 			$relative_class = str_replace( '_', '-', $relative_class );
36 | 			$files = [];
37 | 
38 | 			foreach ( ['interface-', 'class-', 'trait-', ''] as $type ) {
39 | 				$parts = explode( '\\', $relative_class );
40 | 				$last  = array_pop( $parts );
41 | 				$last  = $type . str_replace( '_', '-', $last );
42 | 				$parts[] = $last;
43 | 				$files[] = implode( '\\', $parts );
44 | 			}
45 | 
46 | 			foreach ( $files as $file ) {
47 | 				// replace the namespace prefix with the base directory, replace namespace
48 | 				// separators with directory separators in the relative class name, append
49 | 				// with .php
50 | 				$file = $base_dir . str_replace( '\\', '/', $file ) . '.php';
51 | 				$file = strtolower( $file );
52 | 
53 | 				// if the file exists, require it
54 | 				if ( file_exists( $file ) ) {
55 | 					require_once $file;
56 | 					break;
57 | 				}
58 | 			}
59 | 		} );
60 | 	}
61 | 
62 | }
63 | 


--------------------------------------------------------------------------------
/tests/bootstrap.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | // Load Composer autoload.
4 | require __DIR__ . '/../vendor/autoload.php';
5 | 
6 | // Register Hello with the autoload.
7 | register_wp_autoload( 'Hello\\', __DIR__ . '/fixtures' );
8 | 


--------------------------------------------------------------------------------
/tests/cases/autoload-test.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | use Hello\Plugin as Hello_Plugin;
 4 | 
 5 | class Autoload_Test extends PHPUnit_Framework_TestCase {
 6 | 
 7 | 	public function test_class_autoload() {
 8 | 		$plugin = new Hello_Plugin();
 9 | 		$this->assertEquals( 'Hello, world!', $plugin->hello() );
10 | 
11 | 		$hello_name = $plugin->hello_name( 'Foo' );
12 | 		$this->assertEquals( 'Hello, Foo!', $hello_name );
13 | 		$this->assertEquals( 11, $plugin->strlen( $hello_name ) );
14 | 	}
15 | 
16 | }
17 | 


--------------------------------------------------------------------------------
/tests/fixtures/class-plugin.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Hello;
 4 | 
 5 | use Hello\Extra\Length;
 6 | 
 7 | class Plugin implements Say {
 8 | 	use Name;
 9 | 	use Length;
10 | 
11 | 	public function hello() {
12 | 		return 'Hello, world!';
13 | 	}
14 | }
15 | 


--------------------------------------------------------------------------------
/tests/fixtures/extra/trait-length.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Hello\Extra;
 4 | 
 5 | trait Length {
 6 | 	public function strlen( $str ) {
 7 | 		return strlen( $str );
 8 | 	}
 9 | }
10 | 


--------------------------------------------------------------------------------
/tests/fixtures/interface-say.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | namespace Hello;
4 | 
5 | interface Say {
6 | 	public function hello();
7 | }
8 | 


--------------------------------------------------------------------------------
/tests/fixtures/trait-name.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Hello;
 4 | 
 5 | trait Name {
 6 | 	public function hello_name( $name ) {
 7 | 		return sprintf( 'Hello, %s!', $name );
 8 | 	}
 9 | }
10 | 


--------------------------------------------------------------------------------