class ApcUniversalClassLoader extends UniversalClassLoader

deprecated since version 2.4, to be removed in 3.0. Use the {@link ClassLoader} class instead.

ApcUniversalClassLoader implements a "universal" autoloader cached in APC for PHP 5.3.

It is able to load classes that use either:

  • The technical interoperability standards for PHP 5.3 namespaces and class names (https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-0.md);

  • The PEAR naming convention for classes (http://pear.php.net/).

Classes from a sub-namespace or a sub-hierarchy of PEAR classes can be looked for in a list of locations to ease the vendoring of a sub-set of classes for large projects.

Example usage:

require 'vendor/symfony/src/Symfony/Component/ClassLoader/UniversalClassLoader.php';
require 'vendor/symfony/src/Symfony/Component/ClassLoader/ApcUniversalClassLoader.php';

use Symfony\Component\ClassLoader\ApcUniversalClassLoader;

$loader = new ApcUniversalClassLoader('apc.prefix.');

// register classes with namespaces
$loader->registerNamespaces(array(
    'Symfony\Component' => __DIR__.'/component',
    'Symfony' => __DIR__.'/framework',
    'Sensio' => array(__DIR__.'/src', __DIR__.'/vendor'),
));

// register a library using the PEAR naming convention
$loader->registerPrefixes(array(
    'Swift_' => __DIR__.'/Swift',
));

// activate the autoloader
$loader->register();

In this example, if you try to use a class in the Symfony\Component namespace or one of its children (Symfony\Component\Console for instance), the autoloader will first look for the class under the component/ directory, and it will then fallback to the framework/ directory if not found before giving up.

Methods

useIncludePath(bool $useIncludePath)

Turns on searching the include for class files. Allows easy loading of installed PEAR packages.

bool
getUseIncludePath()

Can be used to check if the autoloader uses the include path to check for classes.

array
getNamespaces()

Gets the configured namespaces.

array
getPrefixes()

Gets the configured class prefixes.

array
getNamespaceFallbacks()

Gets the directory(ies) to use as a fallback for namespaces.

array
getPrefixFallbacks()

Gets the directory(ies) to use as a fallback for class prefixes.

registerNamespaceFallbacks(array $dirs)

Registers the directory to use as a fallback for namespaces.

registerNamespaceFallback(string $dir)

Registers a directory to use as a fallback for namespaces.

registerPrefixFallbacks(array $dirs)

Registers directories to use as a fallback for class prefixes.

registerPrefixFallback(string $dir)

Registers a directory to use as a fallback for class prefixes.

registerNamespaces(array $namespaces)

Registers an array of namespaces.

registerNamespace(string $namespace, array|string $paths)

Registers a namespace.

registerPrefixes(array $classes)

Registers an array of classes using the PEAR naming convention.

registerPrefix(string $prefix, array|string $paths)

Registers a set of classes using the PEAR naming convention.

register(bool $prepend = false)

Registers this instance as an autoloader.

bool|null
loadClass(string $class)

Loads the given class or interface.

string|null
findFile(string $class)

Finds a file by class name while caching lookups to APC.

__construct(string $prefix)

Constructor.

Details

in UniversalClassLoader at line line 78
useIncludePath(bool $useIncludePath)

Turns on searching the include for class files. Allows easy loading of installed PEAR packages.

Parameters

bool $useIncludePath

in UniversalClassLoader at line line 89
bool getUseIncludePath()

Can be used to check if the autoloader uses the include path to check for classes.

Return Value

bool

in UniversalClassLoader at line line 99
array getNamespaces()

Gets the configured namespaces.

Return Value

array A hash with namespaces as keys and directories as values

in UniversalClassLoader at line line 109
array getPrefixes()

Gets the configured class prefixes.

Return Value

array A hash with class prefixes as keys and directories as values

in UniversalClassLoader at line line 119
array getNamespaceFallbacks()

Gets the directory(ies) to use as a fallback for namespaces.

Return Value

array An array of directories

in UniversalClassLoader at line line 129
array getPrefixFallbacks()

Gets the directory(ies) to use as a fallback for class prefixes.

Return Value

array An array of directories

in UniversalClassLoader at line line 139
registerNamespaceFallbacks(array $dirs)

Registers the directory to use as a fallback for namespaces.

Parameters

array $dirs An array of directories

in UniversalClassLoader at line line 149
registerNamespaceFallback(string $dir)

Registers a directory to use as a fallback for namespaces.

Parameters

string $dir A directory

in UniversalClassLoader at line line 159
registerPrefixFallbacks(array $dirs)

Registers directories to use as a fallback for class prefixes.

Parameters

array $dirs An array of directories

in UniversalClassLoader at line line 169
registerPrefixFallback(string $dir)

Registers a directory to use as a fallback for class prefixes.

Parameters

string $dir A directory

in UniversalClassLoader at line line 179
registerNamespaces(array $namespaces)

Registers an array of namespaces.

Parameters

array $namespaces An array of namespaces (namespaces as keys and locations as values)

in UniversalClassLoader at line line 192
registerNamespace(string $namespace, array|string $paths)

Registers a namespace.

Parameters

string $namespace The namespace
array|string $paths The location(s) of the namespace

in UniversalClassLoader at line line 202
registerPrefixes(array $classes)

Registers an array of classes using the PEAR naming convention.

Parameters

array $classes An array of classes (prefixes as keys and locations as values)

in UniversalClassLoader at line line 215
registerPrefix(string $prefix, array|string $paths)

Registers a set of classes using the PEAR naming convention.

Parameters

string $prefix The classes prefix
array|string $paths The location(s) of the classes

in UniversalClassLoader at line line 225
register(bool $prepend = false)

Registers this instance as an autoloader.

Parameters

bool $prepend Whether to prepend the autoloader or not

in UniversalClassLoader at line line 237
bool|null loadClass(string $class)

Loads the given class or interface.

Parameters

string $class The name of the class

Return Value

bool|null True, if loaded

at line line 93
string|null findFile(string $class)

Finds a file by class name while caching lookups to APC.

Parameters

string $class The name of the class

Return Value

string|null The path, if found

at line line 77
__construct(string $prefix)

Constructor.

Parameters

string $prefix A prefix to create a namespace in APC

Exceptions

RuntimeException