Recommended releases

Download Links

xautoload is a comprehensive and yet highly efficient PHP class loading suite.

Most importantly, it provides Drupal-8-style PSR-4 (and the old D8 PSR-0-style in "lib") autoloading for Backdrop. But it is also a great tool for 3rd party autoloading.

Allows to use the xautoload cache options for traditional core and contrib classes.

Class loading for Backdrop modules

  • D8-style PSR-4 module namespaces (under "$module_dir/src/..").
  • Old D8-style PSR-0 module namespaces (under "$module_dir/lib/..").
  • PHP 5.2 compatibility pattern ("PEAR-flat") with prefix/underscore class names instead of namespaces.

Class loading for 3rd party libraries

  • hook_xautoload() to register additional namespaces with PSR-4, PSR-0 or whatever you like.
  • Libraries API: Namespace registration for libraries directly from hook_libraries_info().
  • Can scan downloaded libraries to build a classmap. (which will be cached)
  • Can read and understand composer.json files from downloaded libraries.
  • Can process composer-generated autoload files in a vendor/composer directory, to register all this stuff to the xautoload class loader.
    (all of these can be registered from hook_xautoload() or hook_libraries_info())

How to use

  • Install this module using the official Backdrop CMS instructions at
    https://backdropcms.org/guide/modules
  • Optionally, enable APC and other cache options on Administration > Configuration > Development > Performance. The more checkboxes, the better!
  • Add as a dependency in your modules that need it: dependencies[] = xautoload (>= 7.x-5.0)
  • Now create your PSR-4 class files, e.g.
    File: "$module_dir/src/Foo/Bar.php"
namespace Backdrop\modulename\Foo;
class Bar {..}

Issues

Bugs and Feature requests should be reported in the Issue Queue:
https://github.com/backdrop-contrib/xautoload/issues

Current Maintainers

Credits

License

This project is GPL v2 software. See the LICENSE.txt file in this directory for
complete text.