PHP規範PSR0和PSR4的理解

一、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)都由大小寫字母組合而成。
以下,列出PSR0構建的規範類的幾種形式:
 

 

 

二、實現PSR0自動加載

 

  1.  
    function autoload($className)
  2.  
    {
  3.  
    $className = ltrim($className, '\\');
  4.  
    $fileName = '';
  5.  
    $namespace = '';
  6.  
    if ($lastNsPos = strrpos($className, '\\')) {
  7.  
    $namespace = substr($className, 0, $lastNsPos);
  8.  
    $className = substr($className, $lastNsPos + 1);
  9.  
    $fileName = str_replace('\\', DIRECTORY_SEPARATOR, $namespace) . DIRECTORY_SEPARATOR;
  10.  
    }
  11.  
    $fileName .= str_replace('_', DIRECTORY_SEPARATOR, $className) . '.php';
  12.  
     
  13.  
    require $fileName;
  14.  
    }
  15.  
    spl_autoload_register('autoload');

 

三、PSR4簡介

這個 PSR 描述的是通過文件路徑 自動載入 類的指南;它作爲對  PSR-0  的補充;根據這個 指導如何規範存放文件來自動載入; 
  1. 術語「類」是一個泛稱;它包含類,接口,traits 以及其他類似的結構;

  2. 完全限定類名應該類似如下範例:

    <NamespaceName>(<SubNamespaceNames>)*<ClassName>

    1. 完全限定類名必須有一個頂級命名空間(Vendor Name);
    2. 完全限定類名可以有多個子命名空間;
    3. 完全限定類名應該有一個終止類名;
    4. 下劃線在完全限定類名中是沒有特殊含義的;
    5. 字母在完全限定類名中可以是任何大小寫的組合;
    6. 所有類名必須以大小寫敏感的方式引用;
  3. 當從完全限定類名載入文件時:

    1. 在完全限定類名中,連續的一個或幾個子命名空間構成的命名空間前綴(不包括頂級命名空間的分隔符),至少對應着至少一個基礎目錄。
    2. 在「命名空間前綴」後的連續子命名空間名稱對應一個「基礎目錄」下的子目錄,其中的命名 空間分隔符表示目錄分隔符。子目錄名稱必須和子命名空間名大小寫匹配;
    3. 終止類名對應一個以 .php 結尾的文件。文件名必須和終止類名大小寫匹配;
  4. 自動載入器的實現不可拋出任何異常,不可引發任何等級的錯誤;也不應返回值;

在其中有以下的類實例,但是相對與PSR0,卻是不太容易明白
 
首先,\Symfony\Core\Request和\Zend\Acl很好理解,其滿足PSR0規範,但是\Acme\Log\Writer\File_Writer就不太好理解了。

四、Composer對PSR4的處理

看了Composer對PSR4的處理,才能比較容易理解PSR4。自動生成的PSR4配置文件名稱爲autoload_psr4.php(PSR0的是autoload_namespace.php),配置文件返回一個關聯數組,鍵是名稱空間的前綴,值是名稱空間前綴對應的路徑。
 
以\Acme\Log\Writer\File_Writer作爲例子,其名稱空間前綴是\Acme\Log\Writer,則其在autoload_psr4.php表示爲
'\<span style="font-size:14px;">\Acme\\Log\\Writer</span>' => (array) './acme-log-writer/lib/'
使用自動加載時,先通過名稱空間的前綴,找到對應的映射路徑,在根據PSR0規範找到對應的類定義文件。但是這裏有些例外,類名中的下劃線在PSR4中是不需要轉換成目錄的。
 
使用PSR4,我覺得有2個好處:
1. 減少代碼目錄的深度
2. 可以通過前綴快速找到映射目錄,提高自動加載的效率
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章