mouf / classname-mapper
Provides a way to find in which PHP files a class will be looked upon.
Installs: 1 806 384
Dependents: 8
Suggesters: 0
Security: 0
Stars: 11
Watchers: 7
Forks: 3
Open Issues: 2
Requires
- php: >=5.4.0
Requires (Dev)
- phpunit/phpunit: ~4.0 | ~5.0
- satooshi/php-coveralls: ~1.0
README
ClassName mapper
What is it?
Some packages generate PHP classes. When a package generates a class, it needs to know in which directory to put the PHP file, so that the class can be autoloaded by the autoloader. This package is here to help you find in which directory to write your PHP file.
This package contains a simple ClassNameMapper
PHP class.
This class will map a fully qualified class name (FQCN) to one or many possible file names according to PSR-0 or PSR-4 rules defined in your composer.json
file.
So you pass the ClassNameMapper
a FQCN, and it gives you back a list of file paths that will be checked by the Composer autoloader.
This is very useful in case you want to generate PHP classes, and you don't know where to write those classes.
Sample
Imagine your composer.json
looks like this:
{ "require" : { "mouf/classname-mapper": "~1.0" }, "autoload" : { "psr-4" : { "Acme\\" : "src/" } } }
Now, let's say you want to create a Acme\Controller\MyController
class. Where should you put the class?
To a PHP developer, it is obvious the class will go in src/Controller/MyController.php
.
To a PHP program, it is a tricky problem. The ClassNameMapper
is here to solve the problem:
use Mouf\Composer\ClassNameMapper; // This will create a mapper from your root composer file. $mapper = ClassNameMapper::createFromComposerFile(); $files = $mapper->getPossibleFileNames('Acme\Controller\MyController'); // $files == ["src/Controller/MyController.php"];
You can also query the ClassNameMapper
for a list of all namespaces that are configured in your composer.json
file:
$namespaces = $mapper->getManagedNamespaces(); // $namespaces == ["Acme\\"];