ehough/pulsar

Intelligent classloaders PHP 5

pulsar

Fork of Symfony's ClassLoader component compatible with PHP 5.2+., _(*1)

Motivation

Symfony's ClassLoader component is a fantastic classloading library, but it's only compatible with PHP 5.3+. While 97% of PHP servers run PHP 5.2 or higher, 32% of all servers are still running PHP 5.2 or lower (source). It would be a shame to exempt this library from nearly half of the world's servers just because of a few version incompatibilities., _(*2)

Once PHP 5.3+ adoption levels near closer to 100%, this library will be retired., _(*3)

Differences from Symfony's ClassLoader component

The primary difference is naming conventions of Symfony's classes. Instead of the \Symfony\Component\ClassLoader namespace (and sub-namespaces), instead prefix the class names with ehough_pulsar and follow the PEAR naming convention., _(*4)

A few examples of class naming conversions:, _(*5)

\Symfony\Component\ClassLoader\ApcClassLoader        ----->    ehough_pulsar_ApcClassLoader
\Symfony\Component\ClassLoader\UniversalClassLoader  ----->    ehough_pulsar_UniversalClassLoader

How to use

Please see the Symfony documentation for general use instructions., _(*6)

ComposerClassLoader

pulsar also includes a novel class for Composer-based projects, ehough_pulsar_ComposerClassLoader, which features:, _(*7)

• All functionality of the UniversalClassLoader
• Recognition and proper handling of Composer autoloading

Simple to create and use. Just point it to your vendor directory:, _(*8)

$classLoader = new ehough_pulsar_ComposerClassloader('/path/to/your/vendor/directory');

Releases and Versioning

Releases are synchronized with the upstream Symfony repository. e.g. ehough/pulsar v2.3.1 has merged the code from symfony/ClassLoader v2.3.1., _(*9)