Download the PHP package helhum/class-alias-loader without Composer
On this page you can find all versions of the php package helhum/class-alias-loader. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download helhum/class-alias-loader
More information about helhum/class-alias-loader
Files in helhum/class-alias-loader
Package class-alias-loader
Short Description Amends the composer class loader to support class aliases to provide backwards compatibility for packages
License MIT
Homepage http://github.com/TYPO3/class-alias-loader
Informations about the package class-alias-loader
Class Alias Loader
Introduction
The idea behind this composer package is, to provide backwards compatibility for libraries that want to rename classes but still want to stay compatible for a certain amount of time with consumer packages of these libraries.
What it does?
It provides an additional class loader which amends the composer class loader by rewriting the vendor/autoload.php
file when composer dumps the autoload information. This is only done if any of the packages that are installed by composer
provide a class alias map file, which is configured in the respective composer.json
.
How does it work?
If a package provides a mapping file which holds the mapping from old to new class name, the class loader registers itself
and transparently calls class_alias()
for classes with an alias. If an old class name is requested, the original class
is loaded and the alias is established, so that third party packages can use old class names transparently.
Configuration in composer.json
You can define multiple class alias map files in the extra section of the composer.json
like this:
Currently these files must be PHP files which return an associative array, where the keys are the old class names and the values the new class names. Such a mapping file can look like this:
The '::class' constant is not available before PHP 5.5. Under a PHP before 5.5 the mapping file can look like this:
In your root composer.json
file, you can decide whether to allow classes to be found that are requested with wrong casing.
Since PHP is case insensitive for class names, but PSR class loading standards bound file names to class names, class names de facto
become case sensitive. For legacy packages it may be useful however to allow class names to be loaded even if wrong casing is provided.
For this to work properly, you need to use the composer optimize class loading information feature.
You can activate this feature like this:
The default value of this option is true
.
If no alias mapping is found and case sensitivity is set to true
then by default this package does nothing. It means no additional class loading information is dumped
and the vendor/autoload.php
is not changed. This enables library vendors to deliver compatibility packages which provide such aliases
for backwards compatibility, but keep the library clean (and faster) for new users.
In case you want your application to add alias maps during runtime, it may be useful however if the alias loader is always initialized.
Therefore it is possible to set the following option in your root composer.json
:
Using the API
The public API is pretty simple and consists of only one class with only three static methods, TYPO3\ClassAliasLoader\ClassAliasMap::getClassNameForAlias
being the most important one.
You can use this class method if you have places in your application that deals with class names in strings and want to provide backwards compatibility there.
The API returns the original (new) class name if there is one, or the class name given if no alias is found.
The remaining methods, deal with adding alias maps during runtime, which generally is not recommended to do.
Feedback appreciated
I'm happy for feedback, be it feature requests or bug reports.
Contribute
If you feel like contributing, please do a regular pull request. The package is pretty small. The only thing to respect is to follow PSR-2 coding standard and to add some tests for functionality you add or change.
All versions of class-alias-loader with dependencies
composer-plugin-api Version ^1.0 || ^2.0