国产xxxx99真实实拍_久久不雅视频_高清韩国a级特黄毛片_嗯老师别我我受不了了小说

資訊專欄INFORMATION COLUMN

PHP-PSR 現(xiàn)代PHPer的開發(fā)規(guī)范

zebrayoung / 2405人閱讀

摘要:的使命是實(shí)現(xiàn)框架之間的互操作性。個(gè)人和官方都認(rèn)為開發(fā)者應(yīng)該遵循更為嚴(yán)格的代碼標(biāo)準(zhǔn),在現(xiàn)代的生態(tài)系統(tǒng)中,風(fēng)格統(tǒng)一,可以更好的讓其他開發(fā)者理解代碼。記錄的消息用于診斷檢查和排除應(yīng)用中的操作穩(wěn)定性和性能方面的問(wèn)題。

原文是在我自己博客中,小伙伴也可以點(diǎn)閱讀原文進(jìn)行跳轉(zhuǎn)查看,還有好聽(tīng)的背景音樂(lè)噢~

????PSR是PHP Standards Recommendation的簡(jiǎn)稱,意為PHP推薦標(biāo)準(zhǔn)。要想了解PSR,首先得知道制定這一標(biāo)準(zhǔn)的人/組織是誰(shuí)————PHP-FIG。

PHP-FIG

PHP-FIG全稱為PHP Framework Interop Group,是一個(gè)組織,這個(gè)組織的成員由一些PHP框架的代表組成,這些人聚在一起“討論框架之間的共性,尋找可以合作的方式”。PHP-FIG制訂了推薦規(guī)范,PHP框架可以自愿實(shí)現(xiàn)這些規(guī)范,改進(jìn)其他框架的通信和共享功能。

PHP-FIG的使命是實(shí)現(xiàn)框架之間的互操作性。

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

????在文章的最開始,我們就已經(jīng)簡(jiǎn)單介紹過(guò)什么是PSR,PSR是PHP標(biāo)準(zhǔn),而PSR-1是PHP最基本也是最簡(jiǎn)單的標(biāo)準(zhǔn)。

PHP標(biāo)簽

必須把代碼放在標(biāo)簽中。不得使用其它的標(biāo)簽句法

這點(diǎn)相信很多PHPer都很容易遵守,而且在現(xiàn)實(shí)擼代碼中一般都是采用正常的標(biāo)簽

編碼

所有PHP文件都必須使用UTF-8字符集編碼,而且不能有字節(jié)順序標(biāo)記(Byte Order Mark,BOM)

這個(gè)也很常見(jiàn),就是無(wú)BOM和有BOM格式,記得剛開始敲PHP代碼的時(shí)候,前輩總是很關(guān)照,一定要用IDE調(diào)成無(wú)BOM格式啊,當(dāng)時(shí)表示懵懂,然后就跟著做了,現(xiàn)在看到這里,又重新查了資料,找到了為什么不能使用有BOM格式的原因,BOM會(huì)產(chǎn)生多余的輸出,就像平白無(wú)故多了一個(gè)空行:

php在處理BOM頭的時(shí)候,有時(shí)候存在錯(cuò)誤,可能造成你在使用 header 或 session_start 之類的函數(shù)時(shí),出現(xiàn) 文件已經(jīng)輸出的錯(cuò)誤,多數(shù)都是因?yàn)锽OM頭送出去了。。因?yàn)樵趐hp看來(lái),成了一個(gè)空格。所以使用無(wú)BOM的格式

目的

一個(gè)PHP文件可以定義符號(hào)(類、性狀、函數(shù)、常量等),或者執(zhí)行有副作用的操作(生成結(jié)果或者處理數(shù)據(jù)),但不能同時(shí)做兩件事

這個(gè)規(guī)定的意思差不多就是一個(gè)變量、方法或者一個(gè)類,只能相應(yīng)完成一個(gè)操作、做一件事情,這樣保證了代碼的清晰易懂,也保證了方法、變量的單一性,各司其職。其實(shí)也是為了方便,我們?cè)谝院箜?xiàng)目/應(yīng)用較大時(shí),可以很好的解耦

自動(dòng)加載

PHP的命名空間和類必須遵守PSR-4自動(dòng)加載器標(biāo)準(zhǔn)

后續(xù)看PSR-4的具體解釋

類的名稱

PHP類的名稱必須使用駝峰式,又名標(biāo)題式

駝峰式和分詞式(每個(gè)單詞用_隔開)這兩種寫法,記得以前存在很大的爭(zhēng)議,有人支持駝峰(GirlFriend),有人支持分詞式(girl_friend),現(xiàn)在好了,統(tǒng)一規(guī)定出來(lái)了,為了PHP更好的發(fā)展,那就委屈支持分詞式的兄弟,統(tǒng)一駝峰了。記得公司的CI2項(xiàng)目,用的就是這種分詞式,不過(guò)也是框架規(guī)定,后來(lái)在自己的項(xiàng)目中,自己有預(yù)感的使用了駝峰式,哈哈,為自己的眼光點(diǎn)贊~

常量的名稱

PHP的常量名稱必須大寫;

這點(diǎn)應(yīng)該是毋庸置疑的吧,最開始寫PHP的時(shí)候,這個(gè)寫法已經(jīng)根深蒂固了。

方法的名稱

使用駝峰式(boyFriend)

方法的命名和類的命名方式有些相似,不過(guò)還是有些區(qū)別:類的命名規(guī)定首字母大寫(BoyFriendMoney),而方法的命名規(guī)定首字母小寫(boyFriendMoney)

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

PSR-2 相較于PSR-1是更為嚴(yán)格的代碼規(guī)范。個(gè)人和官方都認(rèn)為開發(fā)者應(yīng)該遵循更為嚴(yán)格的代碼標(biāo)準(zhǔn),在現(xiàn)代的PHP生態(tài)系統(tǒng)中,風(fēng)格統(tǒng)一,可以更好的讓其他開發(fā)者理解PHP代碼。

貫徹PSR-1

使用PSR-2 之前先要貫徹PSR-1

縮進(jìn)

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

關(guān)于縮進(jìn)這個(gè)問(wèn)題,相信有很多爭(zhēng)議。我在真正正視這個(gè)問(wèn)題之前,一直使用的都是IDE的tab鍵。然后當(dāng)同事和自己在編寫同一文件的時(shí)候,就會(huì)出先代碼縮進(jìn)不一的情況,導(dǎo)致代碼結(jié)構(gòu)非常亂。所以在出現(xiàn)這個(gè)問(wèn)題之后,就統(tǒng)一了一下文件縮進(jìn)的標(biāo)準(zhǔn),以四個(gè)空格為縮進(jìn)。這樣的話,就算是用不一致的編輯器打開,效果也是一樣的。
很多IDE都可以設(shè)置tab鍵,百度一下就可以搜到。

文件和代碼行

PHP文件必須使用UNIX風(fēng)格的換行符(LF),最后要有一個(gè)空行,而且不能使用PHP關(guān)閉 ?> 標(biāo)簽。

最開始我也不懂為什么在純PHP頁(yè)面中不使用關(guān)閉 ?> 標(biāo)簽,后來(lái)在書中找到了答案

為了避免意料之外的輸出錯(cuò)誤,如果加上關(guān)閉標(biāo)簽,而且在關(guān)閉標(biāo)簽后有空行,那么這個(gè)空行也被當(dāng)成輸出,導(dǎo)致錯(cuò)誤(例如,設(shè)定http首部時(shí))

關(guān)鍵字

關(guān)鍵字,要使用小寫;

之前不知道在哪兒看的PHP的教程,上面寫的PHP代碼像truefalse這樣的關(guān)鍵字都使用的是大寫TRUEFALSE,我也一直在這樣使用,后來(lái)看到PSR-2的規(guī)范,才知道應(yīng)該要使用小寫,心累~

命名空間

每個(gè)命名空間語(yǔ)句后必須跟著一個(gè)空行。類似的,使用use關(guān)鍵字導(dǎo)入命名空間或?yàn)槊臻g創(chuàng)建別名時(shí),在一系列use聲明語(yǔ)句后要加一個(gè)空行

類似于:



類定義體的起始括號(hào)應(yīng)在類名之后另起一行寫;
類定義體的結(jié)束括號(hào)必須在定義體之后新起一行寫;

例:


方法

方法定義體的起始括號(hào)應(yīng)在方法名之后另起一行寫;
方法定義體的結(jié)束括號(hào)必須在方法定義體之后新起一行寫;

請(qǐng)參考上面類示例中方法的例子。

可見(jiàn)性

1、類中的每個(gè)屬性和方法都要聲明可見(jiàn)性。可見(jiàn)性由public、protected或者private指定,其作用是決定在類的內(nèi)部和外部如何訪問(wèn)屬性的方法。
2、私有方法的名稱前加上下劃線
3、如果類屬性聲明為abstractfinal,這兩個(gè)限定符必須放在可見(jiàn)性關(guān)鍵字之前
4、如果屬性、方法聲明為static,這個(gè)限定符必須放在可見(jiàn)性關(guān)鍵字之后

例子:

// 1、2
public $sex;
private $_sex;
protected $sex;

// 3、
abstract public $sex;
final public $sex;

// 4、
public static $sex;
public static $age;
控制結(jié)構(gòu)

所有控制結(jié)構(gòu)關(guān)鍵字后面都要有一個(gè)空格。控制結(jié)構(gòu)關(guān)鍵字包括:ifelseifelseswitchcasewhiledo whileforforeachtrycatch。如果控制結(jié)構(gòu)關(guān)鍵字后面有一對(duì)圓括號(hào),起始圓括號(hào)后面不能有空格,結(jié)束圓括號(hào)之前不能有空格。與類和方法的定義體不同,控制結(jié)構(gòu)關(guān)鍵字后面的起始括號(hào)應(yīng)該和控制機(jī)構(gòu)關(guān)鍵字寫在同一行。控制結(jié)構(gòu)關(guān)鍵字后面的結(jié)束括號(hào)必須寫在多帶帶一行。

例:

/** 
* 錯(cuò)誤的示例:
* 這里有4個(gè)錯(cuò)誤:
* 1、if關(guān)鍵詞后面和圓括號(hào)之前沒(méi)有空格
* 2、圓括號(hào)前后有空格
* 3、后圓括號(hào)和起始括號(hào)之前沒(méi)有空格
* 4、else關(guān)鍵詞前后沒(méi)有空格
**/
if( 1 == true ){
    // do something
}else{
    // do something
}

/** 
* 正確的示例:
**/
if (1 == true) {
    // do something
} else {
    // do something
}
PSR-3:日志記錄器接口 日志記錄器

PHP-FIG發(fā)布的第三個(gè)推薦規(guī)范和前兩個(gè)不同,這個(gè)有點(diǎn)特殊,是一個(gè)接口。規(guī)定PHP日志記錄器組件可以實(shí)現(xiàn)的方法。

日志記錄器是對(duì)象,用于把不同重要程度的消息寫入指定的輸出。記錄的消息用于診斷、檢查和排除應(yīng)用中的操作、穩(wěn)定性和性能方面的問(wèn)題。例如:開發(fā)的時(shí)候把調(diào)試信息寫入到文本文件,把網(wǎng)站的流量統(tǒng)計(jì)信息記錄到數(shù)據(jù)庫(kù)等。

相信基本上所有的框架中都實(shí)現(xiàn)了日志功能,那么如果想要使用PSR-3規(guī)范的日志記錄器,該怎么做呢?首先要滿足兩點(diǎn):

日志功能委托給第三方庫(kù)實(shí)現(xiàn)

最終用戶能選擇他們喜歡的日志記錄器組件

編寫PSR-3日志記錄器

符合PSR-3推薦規(guī)范的PHP日志記錄器組件,必須包含一個(gè)實(shí)現(xiàn)PsrLogLoggerInterface接口的PHP類。PSR-3接口復(fù)用了RFC 5424系統(tǒng)日志協(xié)議,規(guī)定要實(shí)現(xiàn)9個(gè)方法:

下面的代碼是我從PHP-FIG的官網(wǎng)上拿過(guò)來(lái)的,想了解詳細(xì)信息的可以 點(diǎn)我


這個(gè)類中的每一個(gè)方法都對(duì)應(yīng)RFC 5424協(xié)議的一個(gè)日志級(jí)別,而且都接受兩個(gè)參數(shù)。第一個(gè)參數(shù)必須是一個(gè)字符串,或者有一個(gè)__toString()方法的對(duì)象。第二個(gè)參數(shù)為數(shù)組,可選參數(shù);

如果要編寫符合PSR-3規(guī)范的日志記錄器,那么就要?jiǎng)?chuàng)建一個(gè)實(shí)現(xiàn)PsrLogLoggerInterface接口的PHP類,而且要提供這個(gè)接口中每個(gè)方法的具體實(shí)現(xiàn)

使用PSR-3日志記錄器

PSR-3規(guī)范出來(lái)之后,達(dá)到這種效果的組件太多了,這里就不介紹,如何實(shí)現(xiàn)這個(gè)接口的類了。現(xiàn)在有成熟的日志記錄器組件,推薦monolog/monolog。這個(gè)組件完全上線了PSR-3的接口,而且可以使用自定義的消息格式化程序和處理程序擴(kuò)展功能
如果monolog滿足不了日常的使用,我們可以在此基礎(chǔ)上拓展自己的方法,也非常簡(jiǎn)單;

使用monolog示例:

pushHandler(new StreamHandler("logs/development.log", Logger::DEBUG));
$logger->pushHandler(new StreamHandler("logs/production.log", Logger::WARNING));
// 使用日志記錄器
$logger->debug("This is debug message");
$logger->debug("This is warning message");
PSR-4:自動(dòng)加載器

PHP-FIG發(fā)布的第四個(gè)推薦規(guī)范描述了一個(gè)標(biāo)準(zhǔn)的自動(dòng)加載器策略;自動(dòng)加載器的意思就是指在程序運(yùn)行時(shí)按需查找PHP類、接口(interface)或性狀(trait)并將其載入加載器。

自動(dòng)加載器策略

PSR-4推薦規(guī)范不要求改變代碼的實(shí)現(xiàn)方式,只建議如何使用文件系統(tǒng)目錄結(jié)構(gòu)和PHP命名空間組織代碼。PSR-4依賴PHP命名空間和文件系統(tǒng)目錄結(jié)構(gòu)查找并加載PHP類、性狀和接口

為什么自動(dòng)加載器很重要

舉一個(gè)很常見(jiàn)的場(chǎng)景,我們引入文件通常都是采用requireinclude這樣的方法,這樣的方式簡(jiǎn)單也可靠,但是如果我們引入一兩個(gè)還好說(shuō),但是當(dāng)我們一個(gè)項(xiàng)目運(yùn)行時(shí)需要引入幾十個(gè)文件呢,那我們豈不是要寫幾十個(gè)require或者include?這樣既不方便,又不美觀,所以PHP-FIG在此基礎(chǔ)上考慮,規(guī)范了一個(gè)統(tǒng)一的自動(dòng)加載器策略;

如何使用自動(dòng)加載器

建議使用依賴管理器Composer自動(dòng)生成的PSR-4自動(dòng)加載器。
現(xiàn)代的PHP框架,laravel、Yii、TP5等都使用了依賴Composer的自動(dòng)加載器策略,方便我們下載組件和引入合適的類。

PSR-ME:制定自己的PHP規(guī)范

遵循PSR-1、PSR-2的使用規(guī)范

合適、精簡(jiǎn)的變量、方法、類命名。能讓人看一眼就清楚是做什么的

盡量編寫出高內(nèi)聚、低耦合的代碼

保持代碼結(jié)構(gòu)整潔、美觀

總結(jié)

以上內(nèi)容均來(lái)自《Mordern PHP》,中文名為現(xiàn)代PHP,書中詳細(xì)的介紹了在現(xiàn)代化PHP開發(fā)中的新特性和良好實(shí)踐,非常好的一本書。
PHP-FIG推出的PHP規(guī)范,并不一定說(shuō)所有的PHP開發(fā)者必須遵守。制定這一規(guī)范的目的就是為了,在全世界的PHP開發(fā)者在查看代碼的時(shí)候,能更加簡(jiǎn)單和輕松。造出來(lái)的組件/輪子可以很容易的就被所有開發(fā)者熟知和使用,同時(shí)也減少了我們的工作投入率,使產(chǎn)出大于投入,效率更高更快。

文章版權(quán)歸作者所有,未經(jīng)允許請(qǐng)勿轉(zhuǎn)載,若此文章存在違規(guī)行為,您可以聯(lián)系管理員刪除。

轉(zhuǎn)載請(qǐng)注明本文地址:http://specialneedsforspecialkids.com/yun/25866.html

相關(guān)文章

  • PHPer也刷《劍指Offer》之鏈表

    摘要:劍指中鏈表相關(guān)題目俗話說(shuō)光說(shuō)不練假把式,既然學(xué)習(xí)了鏈表的基礎(chǔ)概念和基本操作那我們一定要找些題目鞏固下,下面來(lái)看劍指中的相關(guān)題目。題目分析合并兩個(gè)排序的鏈表,需要分別比較兩個(gè)鏈表的每個(gè)值,然后改變指針。 溫故知新 鏈表由一個(gè)一個(gè)的作為節(jié)點(diǎn)的對(duì)象構(gòu)成的,每一個(gè)節(jié)點(diǎn)都有指向下一個(gè)節(jié)點(diǎn)的指針,最后一個(gè)節(jié)點(diǎn)的指針域指向空。每個(gè)節(jié)點(diǎn)可以存儲(chǔ)任何數(shù)據(jù)類型。 根據(jù)類型可以分為單鏈表、雙鏈表、環(huán)形鏈表、...

    daydream 評(píng)論0 收藏0
  • tastphp,為現(xiàn)代 phper 準(zhǔn)備 PHP 框架

    摘要:大家好,推薦下我們團(tuán)隊(duì)自己研發(fā)的框架為現(xiàn)代化的準(zhǔn)備的。可拔插,擴(kuò)展性強(qiáng)。借鑒了等優(yōu)秀框架。有興趣的可以關(guān)注下。最渴望有人給我們提交。中文文檔基礎(chǔ)已經(jīng)寫完,剩下努力寫中。。。 大家好,推薦下我們團(tuán)隊(duì)自己研發(fā)的框架:tastphp 為現(xiàn)代化的phper準(zhǔn)備的。可拔插,擴(kuò)展性強(qiáng)。借鑒了Symfony、Laravel、Silex等優(yōu)秀框架。 有興趣的可以關(guān)注下 tastphp。最渴望有人給...

    meteor199 評(píng)論0 收藏0
  • 2017 —— 一個(gè) PHPer 自白

    摘要:大會(huì)年,我去了。小會(huì)值得一提的是,今年月份,我參加了一個(gè)的分享會(huì)。出游沙巴這是部門組織的出游,獲得了最佳團(tuán)隊(duì),拿到了一筆經(jīng)費(fèi),于是有了這次出游。于是,我的下個(gè)目的地是西藏。 轉(zhuǎn)眼間 2017 年過(guò)去了。我已經(jīng)不能說(shuō)自己是去年的畢業(yè)生了,時(shí)光匆匆,感覺(jué)自己越來(lái)越老了。 這一年,我所經(jīng)歷的,讓我收獲很多,讓我懂得很多,讓我明白了很多。也許是明確了某一個(gè)目標(biāo),也許是其它的什么,我覺(jué)得,201...

    BenCHou 評(píng)論0 收藏0
  • PHPer書單

    摘要:想提升自己,還得多看書多看書多看書下面是我收集到的一些程序員應(yīng)該看得書單及在線教程,自己也沒(méi)有全部看完。共勉吧當(dāng)然,如果你有好的書想分享給大家的或者覺(jué)得書單不合理,可以去通過(guò)進(jìn)行提交。講師溫銘,軟件基金會(huì)主席,最佳實(shí)踐作者。 想提升自己,還得多看書!多看書!多看書!下面是我收集到的一些PHP程序員應(yīng)該看得書單及在線教程,自己也沒(méi)有全部看完。共勉吧!當(dāng)然,如果你有好的書想分享給大家的或者...

    jimhs 評(píng)論0 收藏0

發(fā)表評(píng)論

0條評(píng)論

最新活動(dòng)
閱讀需要支付1元查看
<