Download the PHP package theseer/autoload without Composer

PHP Autoload Builder

The PHP AutoloadBuilder CLI tool phpab is a command line application to automate the process of generating an autoload require file with the option of creating static require lists as well as phar archives.

Features

• scan multiple directories recursively in one run, optionally follow symlinks, wildcards or based on composer.json
• Cache scan results
• Template based autoload code
• Custom variables for templates
• Compatibility mode for PHP 5.2 compliant autoloader
• Case sensitive as well as case insensitive classname mapping
• Phar generation, with or without compression and openssl key signing
• Static require list generation
• Opcache warming list generation
• Linting of generated code

Requirements

• PHP 5.3+ (Runtime, for development / tests: 7.2+)
• Fileinfo (ext/fileinfo)
• Tokenizer (ext/tokenizer)
• For PHAR generation support:
  • ext/phar (write enabled: phar.readonly = Off)
  • ext/gzip (optional)
  • ext/bzip2 (optional)
  • ext/openssl (optional, for phar signing only)

Installation

Executable PHAR

The recommended way to install phpab is by using phive:

Manual install

If you do not have phive installed or want to install manually, you can download the PHAR archive from the Releases tab.

Please note: On Linux/Unix based system the phar needs to be marked executable for direct execution:

Other Downloads

• Latest development snapshot (ZIP Archive)
• Releases (Source)

Usage

Usage Examples

[theseer@rikka ~]$ phpab -o src/autoload.php -b src composer.json

[theseer@rikka ~]$ phpab -o opcache_warming.php -w --reset src

[theseer@rikka ~]$ phpab -o src/autoload.inc.php src

[theseer@rikka ~]$ phpab -c -o src/autoload.inc.php src

[theseer@rikka ~]$ phpab -o src/core/autoload.inc.php -b src src

[theseer@rikka ~]$ phpab -p -o framework.phar -b src composer.json

[theseer@rikka ~]$ phpab -p -o framework.phar framework/src

[theseer@rikka ~]$ phpab -p -o framework.phar --bzip2 --key sign.key framework/src

[theseer@rikka ~]$ phpab -b . --tolerant -o zf1_autoload.php -e '*/Test/*' Zend

Automation

When using phpab it is necessary to recreate the autoload file every time a new class is created. This usually also happens after pulling from a repo or when switchting branches. Using a git post-checkout hook placed in .git/hooks/post-update this can be automated for most cases.

Basic Sample:

Sample using an ant build.xml file.

Template Variables

The generated code is based uppon templates provided by default in the templates subfolder. The template engine allows for simply replacing of name based placeholders. For now, only a few default variables are defined but API hooks / CLI parameters exist to set custom variables.

Known variables are:

• Set to a timestamp of creation, format can be adjusted
• The found list classes in form of a generated map
• If a Basedir is set, the value will get removed from the file path and get replaced by DIR

Used in PHAR Mode only:

• The filename of the generated phar or it's alias when --alias is given (see src/templates/phar.php.tpl)

Custom variables as defined by passing --var name=value via cli are accessed by pre- and appending ___ to it:

• Going to be replaced by the value provided via cli param

Changelog

The changelog moved to its own document