PHP最佳實(shí)踐系列之標(biāo)準(zhǔn)

DoINsiSt 發(fā)布于2019-06-27 17:07 / 1475人閱讀

摘要：框架之間通過(guò)接口自動(dòng)加載和標(biāo)準(zhǔn)的編碼風(fēng)格進(jìn)行合作。該規(guī)范的精髓是把命名空間的前綴和系統(tǒng)中的目錄對(duì)應(yīng)起來(lái)。

PHP-FIG

1).即PHP Framework Interop Group。這個(gè)組織發(fā)布推薦的規(guī)范，而不是強(qiáng)制規(guī)范。
2).PHP-FIG的使命是實(shí)現(xiàn)框架的互操作性。框架的互操作性指的是通過(guò)自動(dòng)加載機(jī)制、接口和標(biāo)準(zhǔn)的風(fēng)格，讓框架互相合作。
3).框架之間通過(guò)接口、自動(dòng)加載和標(biāo)準(zhǔn)的編碼風(fēng)格進(jìn)行合作。

PSR

1).即PHP推薦標(biāo)準(zhǔn)。這是上面的組織制定的推薦規(guī)范。例如下面的規(guī)范：

PSR-1:基本的代碼風(fēng)格

必須把PHP代碼放在或標(biāo)簽中。

編碼字符集必須是UTF-8

一個(gè)PHP文件可以定義類(lèi)或者處理數(shù)據(jù)，但是不能同時(shí)做這兩件事

遵循自動(dòng)加載

類(lèi)命名遵循駝峰式命名

常量大寫(xiě)

方法名稱(chēng)使用第一個(gè)字母小寫(xiě)的駝峰式命名

PSR-2:嚴(yán)格的代碼風(fēng)格

貫徹執(zhí)行PSR-1

使用四個(gè)空格縮進(jìn)

使用UNIX風(fēng)格換行符

不能使用關(guān)閉標(biāo)簽

每一行不能超過(guò)120個(gè)字符

PHP關(guān)鍵字一律小寫(xiě)

命名空間之后必須跟一個(gè)空行

類(lèi)的定義體起始括號(hào)應(yīng)該在類(lèi)命后新起一行，類(lèi)的結(jié)束括號(hào)也必須新起一行

方法名的括號(hào)換行方式和類(lèi)一直，參數(shù)除了第一個(gè)參數(shù)前面要有空格。

必須聲明屬性和方法的可見(jiàn)性

可以使用php code sniffer檢查代碼格式

控制結(jié)構(gòu)關(guān)鍵字后面的起始括號(hào)應(yīng)該和控制結(jié)構(gòu)的關(guān)鍵字寫(xiě)在同一行，結(jié)束括號(hào)另起一行。例子如下

isAwake() === true) {
         do {
             $gorilla->beatChest();
         } while ($libs->isAsleep() === true);
         $libs->flyAway();
}

PSR-3:日志記錄接口

該規(guī)范不是一系列方針，而是一個(gè)接口，規(guī)定了PHP日志記錄器組件可以實(shí)現(xiàn)的方法。

PSR-4:自動(dòng)加載

這個(gè)規(guī)范描述了一個(gè)標(biāo)準(zhǔn)的自動(dòng)加載策略。自動(dòng)加載策略是指在運(yùn)行時(shí)按需查找PHP類(lèi)、接口或者形狀，并將其載入PHP解析器，支持PSR-4自動(dòng)加載器標(biāo)準(zhǔn)的PHP組件和框架使用同一個(gè)自動(dòng)加載器就能找到相關(guān)代碼，然后將其載入PHP解釋器。

該規(guī)范的精髓是把命名空間的前綴和系統(tǒng)中的目錄對(duì)應(yīng)起來(lái)。

自己實(shí)現(xiàn)psr-4自動(dòng)加載器


這樣的話(huà)當(dāng)我們使用 FooBarBazQux這個(gè)類(lèi)的時(shí)候，使用SPL注冊(cè)了上面這個(gè)函數(shù)之后，PHP就會(huì)嘗試從/path/to/project/src/Baz/Qux.php 加載這個(gè)類(lèi)。
專(zhuān)題系列
PHP專(zhuān)題系列目錄地址：https://github.com/xx19941215/webBlog
PHP專(zhuān)題系列預(yù)計(jì)寫(xiě)二十篇左右，主要總結(jié)我們?nèi)粘HP開(kāi)發(fā)中容易忽略的基礎(chǔ)知識(shí)和現(xiàn)代PHP開(kāi)發(fā)中關(guān)于規(guī)范、部署、優(yōu)化的一些實(shí)戰(zhàn)性建議，同時(shí)還有對(duì)Javascript語(yǔ)言特點(diǎn)的深入研究。