class xautoload_LoaderFactory in X Autoload 7.3

This thing has an overview of available class loaders with different cache mechanics. It can detect the currently applicable cache method, and it can switch between cache methods.

It should be mentioned that "loader" and "finder" mean two separate things in xautoload. The "finder" knows all the namespaces and directories. The "loader" is for the cache layer and for file inclusion, and it is plugged with a "finder" to actually find the class on a cache miss.

Hierarchy

• class \xautoload_LoaderFactory

File

lib/LoaderFactory.php, line 13

class xautoload_LoaderFactory {

  /**
   * @var xautoload_ClassFinder_Proxy
   */
  protected $proxyFinder;

  /**
   * @var string
   */
  protected $apcPrefix;

  /**
   * @param xautoload_ClassFinder_Proxy $proxyFinder
   *   The class finder to plug into our loaders.
   */
  function __construct($proxyFinder) {
    $this->proxyFinder = $proxyFinder;
  }

  /**
   * This is called on instantiation,
   * and whenever the APC prefix is renewed,
   * but only if the system actually supports APC.
   *
   * @param string $apc_prefix
   */
  function setApcPrefix($apc_prefix) {
    $this->apcPrefix = $apc_prefix;
  }

  /**
   * Build a loader for a given mode.
   *
   * @param string $mode
   *   Loader mode, e.g. 'apc' or 'default'.
   *
   * @return xautoload_ClassLoader_Interface
   *   The class loader.
   */
  function buildLoader($mode) {
    switch ($mode) {
      case 'apc_lazy':
        if (isset($this->apcPrefix)) {

          // Create a loader that uses the proxy finder.
          $loader = new xautoload_ClassLoader_ApcCache($this->proxyFinder, $this->apcPrefix);

          // Give the loader the real finder, once the proxy fires.
          $this->proxyFinder
            ->proxyObserveInstantiation(array(
            $loader,
            'setFinder',
          ));

          // Return the loader.
          return $loader;
        }
        break;
      case 'apc':
        if (isset($this->apcPrefix)) {

          /**
           * @var xautoload_ClassFinder_Interface
           */
          $finder = $this->proxyFinder
            ->proxyGetInstance();
          return new xautoload_ClassLoader_ApcCache($finder, $this->apcPrefix);
        }
        break;
      case 'default':
      case 'dev':
      default:

        /**
         * @var xautoload_ClassFinder_Interface
         */
        $finder = $this->proxyFinder
          ->proxyGetInstance();
        return new xautoload_ClassLoader_NoCache($finder);
    }

    // Loader could not be created, because the respective cache mechanic is not available.
    return FALSE;
  }

}

Members

Name	Modifiers	Type	Description	Overrides
xautoload_LoaderFactory::$apcPrefix	protected	property
xautoload_LoaderFactory::$proxyFinder	protected	property
xautoload_LoaderFactory::buildLoader		function	Build a loader for a given mode.
xautoload_LoaderFactory::setApcPrefix		function	This is called on instantiation, and whenever the APC prefix is renewed, but only if the system actually supports APC.
xautoload_LoaderFactory::__construct		function