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