天天看點

php psr4 編碼規範,PHP規範PSR0和PSR4的了解

一、PSR0簡介

下文描述了若要使用一個通用的自動加載器(autoloader),你所需要遵守的規範:

一個完全标準的命名空間(namespace)和類(class)的結構是這樣的:()*

每個命名空間(namespace)都必須有一個頂級的空間名(namespace)("組織名(Vendor Name)")。

每個命名空間(namespace)中可以根據需要使用任意數量的子命名空間(sub-namespace)。

從檔案系統中加載源檔案時,空間名(namespace)中的分隔符将被轉換為 DIRECTORY_SEPARATOR。

類名(class name)中的每個下劃線_都将被轉換為一個DIRECTORY_SEPARATOR。下劃線_在空間名(namespace)中沒有什麼特殊的意義。

完全标準的命名空間(namespace)和類(class)從檔案系統加載源檔案時将會加上.php字尾。

組織名(vendor name),空間名(namespace),類名(class name)都由大小寫字母組合而成。

以下,列出PSR0建構的規範類的幾種形式:

php psr4 編碼規範,PHP規範PSR0和PSR4的了解

二、實作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 以及其他類似的結構;

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

()*

完全限定類名必須有一個頂級命名空間(Vendor Name);

完全限定類名可以有多個子命名空間;

完全限定類名應該有一個終止類名;

下劃線在完全限定類名中是沒有特殊含義的;

字母在完全限定類名中可以是任何大小寫的組合;

所有類名必須以大小寫敏感的方式引用;

當從完全限定類名載入檔案時:

在完全限定類名中,連續的一個或幾個子命名空間構成的命名空間字首(不包括頂級命名空間的分隔符),至少對應着至少一個基礎目錄。

在「命名空間字首」後的連續子命名空間名稱對應一個「基礎目錄」下的子目錄,其中的命名 空間分隔符表示目錄分隔符。子目錄名稱必須和子命名空間名大小寫比對;

終止類名對應一個以 .php 結尾的檔案。檔案名必須和終止類名大小寫比對;

自動載入器的實作不可抛出任何異常,不可引發任何等級的錯誤;也不應傳回值;

在其中有以下的類執行個體,但是相對與PSR0,卻是不太容易明白

php psr4 編碼規範,PHP規範PSR0和PSR4的了解

首先,SymfonyCoreRequest和endAcl很好了解,其滿足PSR0規範,但是AcmeLogWriterFile_Writer就不太好了解了。

四、Composer對PSR4的處理

看了Composer對PSR4的處理,才能比較容易了解PSR4。自動生成的PSR4配置檔案名稱為autoload_psr4.php(PSR0的是autoload_namespace.php),配置檔案傳回一個關聯數組,鍵是名稱空間的字首,值是名稱空間字首對應的路徑。

以AcmeLogWriterFile_Writer作為例子,其名稱空間字首是AcmeLogWriter,則其在autoload_psr4.php表示為

‘\Acme\Log\Writer‘ => (array) ‘./acme-log-writer/lib/‘

使用自動加載時,先通過名稱空間的字首,找到對應的映射路徑,在根據PSR0規範找到對應的類定義檔案。但是這裡有些例外,類名中的下劃線在PSR4中是不需要轉換成目錄的。

使用PSR4,我覺得有2個好處:

1. 減少代碼目錄的深度

2. 可以通過字首快速找到映射目錄,提高自動加載的效率