PHP の PSR-0 標準は自動ロードに名前空間を使用します

PSR-0 を紹介する前に、まず名前空間 (NameSpace) とオートローディングについて話しましょう。

NameSpace (名前空間)

namespace は、クラス ライブラリやアプリケーションを作成するときに、クラスや関数などの再利用可能なコードを作成するときに発生する 2 種類の問題を解決するために、PHP5.3 バージョンで追加された新機能です。

1. 名前があります。ユーザーが作成したコードと PHP の内部クラス/関数/定数またはサードパーティのクラス/関数/定数の間の競合。
2. ソース コードの読みやすさを向上させるために、非常に長い識別子名 (通常は最初の種類の問題を軽減するために定義される) のエイリアス (または短い) 名を作成します。

PHP 名前空間の要素は、ファイル システムと同様の原則を使用します。たとえば、クラス名は次の 3 つの方法で参照できます:
1. 非修飾名、または $a=new foo(); や foo::staticmethod(); などのプレフィックスを含まないクラス名。現在の名前空間が currentnamespace の場合、foo は currentnamespacefoo に解決されます。 foo を使用するコードがグローバルであり、どの名前空間にもコードが含まれていない場合、foo は foo として解決されます。 警告: ネームスペース内の関数または定数が未定義の場合、修飾されていない関数または定数名はグローバル関数または定数名に解決されます。詳細については、「名前空間の使用: フォールバック グローバル関数名/定数名」を参照してください。
2. 修飾名、またはプレフィックスを含む名前 ($a = new subnamespacefoo(); または subnamespacefoo::staticmethod(); など)。現在の名前空間が currentnamespace の場合、foo は currentnamespacesubnamespacefoo に解決されます。 foo を使用するコードがグローバルであり、コードがどの名前空間にも含まれていない場合、foo はサブ名前空間 foo に解決されます。
3. 完全修飾名、またはグローバル接頭辞演算子を含む名前 ($a = new currentnamespacefoo(); または currentnamespacefoo::staticmethod(); など)。この場合、foo はコード内で常にリテラル名 currentnamespacefoo に解決されます。

また、グローバル クラス、関数、定数にアクセスするには、strlen()、Exception、INI_ALL などの完全修飾名を使用できることにも注意してください。

<?phpuse My\Full\Classname as Another, My\Full\NSname;$obj = new Another; // 实例化一个 My\Full\Classname 对象$obj = new \Another; // 实例化一个Another对象$obj = new Another\thing; // 实例化一个My\Full\Classname\thing对象$obj = new \Another\thing; // 实例化一个Another\thing对象$a = \strlen('hi'); // 调用全局函数strlen$b = \INI_ALL; // 访问全局常量 INI_ALL$c = new \Exception('error'); // 实例化全局类 Exception?>

上記は名前空間についての簡単な紹介です。理解していない学生は、このドキュメントを注意深く読んでください。多くの新しい PHP プロジェクトでは、名前空間が一般的に使用されています。特に Composer の人気に伴い、Composer を理解することが非常に必要な機能になりました。

オートローディング

多くの開発者は、オブジェクト指向アプリケーションを作成するときに、クラス定義ごとに PHP ソース ファイルを作成します。大きな煩わしさは、各スクリプトの先頭に、require ファイルの長いリスト (クラスごとに 1 つのファイル) を記述しなければならないことです。

オートローディングは、/series オートロード関数を定義することでこの問題を解決します。この関数は、まだ定義されていないクラスを使用しようとすると自動的に呼び出されます。 autoload 関数を呼び出すことにより、スクリプト エンジンは、PHP がエラーで失敗する前に、必要なクラスをロードする最後のチャンスを得ることができます。この自動ロード関数は、次のようにデフォルトの __autoload() にすることができます:

<?phpfunction __autoload($class_name) {    require_once $class_name . '.php';}$obj  = new MyClass();

は、より柔軟な方法を使用して、spl_autoload_register() を通じて独自の __autoload() 関数を定義することもできます:

<?phpfunction my_autoload($class_name) {	require_once $class_name . '.php';}spl_autoload_register("my_autoload");$obj  = new MyClass();

上記のコードは、 my_autoload ()関数は __autoload スタックに登録され、それによって __autoload() 関数が取得されます (__autoload() 関数は機能しなくなりますが、明示的に __autoload スタックに登録できます)。 __autoload スタックについて先ほど説明したことに注意してください。これは、複数の自動ロード関数を登録し、登録の順序に従ってそれらを順番にロードできることを意味します (この順序は spl_autoload_register の 3 番目のパラメーターで変更できます)。

ここでは、自動ロード機能の最も単純な例を示します。もちろん、いくつかのルールを設定することで、実際の環境における多くの複雑な状況にも対応できます。

しかし、私たちのプロジェクトが他のプロジェクトに依存している場合、それらは独自の独立した読み込みルールの下でスムーズに実行できますが、統合はうまくいかない可能性があります。では、この問題を解決するための一般的な読み込みルールはあるのでしょうか?

PSR-0

PSR は、PHP Framework Interoperability Group (PHP Universal Framework Group) によってリリースされた一連の標準/仕様であり、現在合計 4 つの PSR-0 ～ PSR-4 が含まれており、PSR-0 はその 1 つです。自動ローディング規格 (後続の PSR-4 は、PSR-0 を補足する改良型自動ローディング規格と呼ばれます。PSR-0 の方が広く使用されています)。 https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-0.md

以下は、特定の相互運用性のための自動読み込みに必要な条件について説明します。

强制要求

一个完全合格的namespace和class必须符合这样的结构 \\(\)*

每个namespace必须有一个顶层的namespace（"Vendor Name"提供者名字）

每个namespace可以有多个子namespace

当从文件系统中加载时，每个namespace的分隔符要转换成 DIRECTORY_SEPARATOR(操作系统路径分隔符)

在CLASS NAME（类名）中，每个下划线(_)符号要转换成DIRECTORY_SEPARATOR。在namespace中，下划线(_)符号是没有（特殊）意义的。

当从文件系统中载入时，合格的namespace和class一定是以 .php 结尾的

verdor name,namespaces,class名可以由大小写字母组合而成（大小写敏感的）

除此之外可能还会遵循这个规则：如果文件不存在则返回false。

例子

\Doctrine\Common\IsolatedClassLoader => /path/to/project/lib/vendor/Doctrine/Common/IsolatedClassLoader.php

\Symfony\Core\Request => /path/to/project/lib/vendor/Symfony/Core/Request.php

\Zend\Acl => /path/to/project/lib/vendor/Zend/Acl.php

\Zend\Mail\Message => /path/to/project/lib/vendor/Zend/Mail/Message.php

NameSpace和Class Name中的下划线

\namespace\package\Class_Name => /path/to/project/lib/vendor/namespace/package/Class/Name.php

\namespace\package_name\Class_Name => /path/to/project/lib/vendor/namespace/package_name/Class/Name.php

实现的范例

下面是一个按照如上标准进行自动加载的简单范例：

<?phpfunction autoload($className){    //这里的$className一般是用namespace的方式来引用的，文章开头已有介绍    //去除$className左边的'\' 这是PHP5.3的一个bug，详见https://bugs.php.net/50731    $className = ltrim($className, '\\');    $fileName  = '';    $namespace = '';    //找到最后一个namespace分隔符的位置    if ($lastNsPos = strrpos($className, '\\')) {        $namespace = substr($className, 0, $lastNsPos);        $className = substr($className, $lastNsPos + 1);        $fileName  = str_replace('\\', DIRECTORY_SEPARATOR, $namespace) . DIRECTORY_SEPARATOR;    }    $fileName .= str_replace('_', DIRECTORY_SEPARATOR, $className) . '.php';    require $fileName;}

SplClassLoader 的实现

下面有一个SplClassLoader 的实现范例，如果你遵循了如上的标准，可以用它来进行自动加载。这也是目前PHP5.3推荐的类加载标准。 http://gist.github.com/221634

<?php /* * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * * This software consists of voluntary contributions made by many individuals * and is licensed under the MIT license. For more information, see * <http://www.doctrine-project.org>. */ /** * SplClassLoader implementation that implements the technical interoperability * standards for PHP 5.3 namespaces and class names. * * http://groups.google.com/group/php-standards/web/psr-0-final-proposal?pli=1 * *     // Example which loads classes for the Doctrine Common package in the *     // Doctrine\Common namespace. *     $classLoader = new SplClassLoader('Doctrine\Common', '/path/to/doctrine'); *     $classLoader->register(); * * @license http://www.opensource.org/licenses/mit-license.html  MIT License * @author Jonathan H. Wage <jonwage> * @author Roman S. Borschel <roman> * @author Matthew Weier O'Phinney <matthew> * @author Kris Wallsmith <kris.wallsmith> * @author Fabien Potencier <fabien.potencier> */class SplClassLoader{    private $_fileExtension = '.php';    private $_namespace;    private $_includePath;    private $_namespaceSeparator = '\\';     /**     * Creates a new <tt>SplClassLoader</tt> that loads classes of the     * specified namespace.     *      * @param string $ns The namespace to use.     */    public function __construct($ns = null, $includePath = null)    {        $this->_namespace = $ns;        $this->_includePath = $includePath;    }     /**     * Sets the namespace separator used by classes in the namespace of this class loader.     *      * @param string $sep The separator to use.     */    public function setNamespaceSeparator($sep)    {        $this->_namespaceSeparator = $sep;    }     /**     * Gets the namespace seperator used by classes in the namespace of this class loader.     *     * @return void     */    public function getNamespaceSeparator()    {        return $this->_namespaceSeparator;    }     /**     * Sets the base include path for all class files in the namespace of this class loader.     *      * @param string $includePath     */    public function setIncludePath($includePath)    {        $this->_includePath = $includePath;    }     /**     * Gets the base include path for all class files in the namespace of this class loader.     *     * @return string $includePath     */    public function getIncludePath()    {        return $this->_includePath;    }     /**     * Sets the file extension of class files in the namespace of this class loader.     *      * @param string $fileExtension     */    public function setFileExtension($fileExtension)    {        $this->_fileExtension = $fileExtension;    }     /**     * Gets the file extension of class files in the namespace of this class loader.     *     * @return string $fileExtension     */    public function getFileExtension()    {        return $this->_fileExtension;    }     /**     * Installs this class loader on the SPL autoload stack.     */    public function register()    {        spl_autoload_register(array($this, 'loadClass'));    }     /**     * Uninstalls this class loader from the SPL autoloader stack.     */    public function unregister()    {        spl_autoload_unregister(array($this, 'loadClass'));    }     /**     * Loads the given class or interface.     *     * @param string $className The name of the class to load.     * @return void     */    public function loadClass($className)    {        if (null === $this->_namespace || $this->_namespace.$this->_namespaceSeparator === substr($className, 0, strlen($this->_namespace.$this->_namespaceSeparator))) {            $fileName = '';            $namespace = '';            if (false !== ($lastNsPos = strripos($className, $this->_namespaceSeparator))) {                $namespace = substr($className, 0, $lastNsPos);                $className = substr($className, $lastNsPos + 1);                $fileName = str_replace($this->_namespaceSeparator, DIRECTORY_SEPARATOR, $namespace) . DIRECTORY_SEPARATOR;            }            $fileName .= str_replace('_', DIRECTORY_SEPARATOR, $className) . $this->_fileExtension;             require ($this->_includePath !== null ? $this->_includePath . DIRECTORY_SEPARATOR : '') . $fileName;        }    }}</fabien.potencier></kris.wallsmith></matthew></roman></jonwage>

完。