PHP規範PSR0和PSR4的理解
- 2019 年 11 月 28 日
- 筆記
一、PSR0簡介 下文描述了若要使用一個通用的自動載入器(autoloader),你所需要遵守的規範: 一個完全標準的命名空間(namespace)和類(class)的結構是這樣的:<Vendor Name>(<Namespace>)*<Class Name> 每個命名空間(namespace)都必須有一個頂級的空間名(namespace)("組織名(Vendor Name)")。 每個命名空間(namespace)中可以根據需要使用任意數量的子命名空間(sub-namespace)。 從文件系統中載入源文件時,空間名(namespace)中的分隔符將被轉換為 DIRECTORY_SEPARATOR。 類名(class name)中的每個下劃線_都將被轉換為一個DIRECTORY_SEPARATOR。下劃線_在空間名(namespace)中沒有什麼特殊的意義。 完全標準的命名空間(namespace)和類(class)從文件系統載入源文件時將會加上.php後綴。 組織名(vendor name),空間名(namespace),類名(class name)都由大小寫字母組合而成。 參考:http://www.php-fig.org/psr/psr-0/ 以下,列出PSR0構建的規範類的幾種形式:

二、實現PSR0自動載入
function autoload($className) { $className = ltrim($className, '\'); $fileName = ''; $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; } spl_autoload_register('autoload');
三、PSR4簡介 這個 PSR 描述的是通過文件路徑自動載入類的指南;它作為對 PSR-0 的補充;根據這個 指導如何規範存放文件來自動載入; 術語「類」是一個泛稱;它包含類,介面,traits 以及其他類似的結構; 完全限定類名應該類似如下範例: <NamespaceName>(<SubNamespaceNames>)*<ClassName> 完全限定類名必須有一個頂級命名空間(Vendor Name); 完全限定類名可以有多個子命名空間; 完全限定類名應該有一個終止類名; 下劃線在完全限定類名中是沒有特殊含義的; 字母在完全限定類名中可以是任何大小寫的組合; 所有類名必須以大小寫敏感的方式引用; 當從完全限定類名載入文件時: 在完全限定類名中,連續的一個或幾個子命名空間構成的命名空間前綴(不包括頂級命名空間的分隔符),至少對應著至少一個基礎目錄。 在「命名空間前綴」後的連續子命名空間名稱對應一個「基礎目錄」下的子目錄,其中的命名 空間分隔符表示目錄分隔符。子目錄名稱必須和子命名空間名大小寫匹配; 終止類名對應一個以 .php 結尾的文件。文件名必須和終止類名大小寫匹配; 自動載入器的實現不可拋出任何異常,不可引發任何等級的錯誤;也不應返回值; 參考:http://www.php-fig.org/psr/psr-4/ 在其中有以下的類實例,但是相對與PSR0,卻是不太容易明白

首先,SymfonyCoreRequest和ZendAcl很好理解,其滿足PSR0規範,但是AcmeLogWriterFile_Writer就不太好理解了。 四、Composer對PSR4的處理 看了Composer對PSR4的處理,才能比較容易理解PSR4。自動生成的PSR4配置文件名稱為autoload_psr4.php(PSR0的是autoload_namespace.php),配置文件返回一個關聯數組,鍵是名稱空間的前綴,值是名稱空間前綴對應的路徑。 以AcmeLogWriterFile_Writer作為例子,其名稱空間前綴是AcmeLogWriter,則其在autoload_psr4.php表示為 '<span style="font-size:14px;">Acme\Log\Writer</span>' => (array) './acme-log-writer/lib/' 使用自動載入時,先通過名稱空間的前綴,找到對應的映射路徑,在根據PSR0規範找到對應的類定義文件。但是這裡有些例外,類名中的下劃線在PSR4中是不需要轉換成目錄的。 使用PSR4,我覺得有2個好處: 1. 減少程式碼目錄的深度 2. 可以通過前綴快速找到映射目錄,提高自動載入的效率