> 官網原文網址：http://www.php-fig.org/psr/psr-4/ 關鍵詞 “必須”("MUST")、“一定不可/一定不能”("MUST NOT")、“需要”("REQUIRED")、 “將會”("SHALL")、“不會”("SHALL NOT")、“應該”("SHOULD")、“不該”("SHOULD NOT")、 “推薦”("RECOMMENDED")、“可以”("MAY")和”可選“("OPTIONAL")的詳細描述可參見 [RFC 2119](http://tools.ietf.org/html/rfc2119)。 ## 1. 概述 本 PSR 是關于由文件路徑 [自動載入][自動載入] 對應類的相關規范， 本規范是可互操作的，可以作為任一自動載入規范的補充，其中包括 PSR-0，此外， 本 PSR 還包括自動載入的類對應的文件存放路徑規范。 ## 2. 詳細說明 1. 此處的“類”泛指所有的class類、接口、traits可復用代碼塊以及其它類似結構。 2. 一個完整的類名需具有以下結構: \<命名空間>(\<子命名空間>)*\<類名> 1. 完整的類名**必須**要有一個頂級命名空間，被稱為 "vendor namespace"； 2. 完整的類名**可以**有一個或多個子命名空間； 3. 完整的類名**必須**有一個最終的類名； 4. 完整的類名中任意一部分中的下劃線都是沒有特殊含義的； 5. 完整的類名**可以**由任意大小寫字母組成； 6. 所有類名都**必須**是大小寫敏感的。 3. 當根據完整的類名載入相應的文件…… 1. 完整的類名中，去掉最前面的命名空間分隔符，前面連續的一個或多個命名空間和子命名空間，作為“命名空間前綴”，其必須與至少一個“文件基目錄”相對應； 2. 緊接命名空間前綴后的子命名空間**必須**與相應的”文件基目錄“相匹配，其中的命名空間分隔符將作為目錄分隔符。 3. 末尾的類名**必須**與對應的以 `.php` 為后綴的文件同名。 4. 自動加載器（autoloader）的實現**一定不能**拋出異常、**一定不能**觸發任一級別的錯誤信息以及**不應該**有返回值。 ## 3. 例子 下表展示了符合規范完整類名、命名空間前綴和文件基目錄所對應的文件路徑。 | 完整類名 | 命名空間前綴 | 文件基目錄 | 文件路徑 | ----------------------------- |--------------------|--------------------------|------------------------------------------- | \Acme\Log\Writer\File_Writer | Acme\Log\Writer | ./acme-log-writer/lib/ | ./acme-log-writer/lib/File_Writer.php | \Aura\Web\Response\Status | Aura\Web | /path/to/aura-web/src/ | /path/to/aura-web/src/Response/Status.php | \Symfony\Core\Request | Symfony\Core | ./vendor/Symfony/Core/ | ./vendor/Symfony/Core/Request.php | \Zend\Acl | Zend | /usr/includes/Zend/ | /usr/includes/Zend/Acl.php [自動載入]: http://php.net/autoload