摘要:的使命是實(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-FIGPSR-1:基本的代碼風(fēng)格PHP-FIG全稱為PHP Framework Interop Group,是一個(gè)組織,這個(gè)組織的成員由一些PHP框架的代表組成,這些人聚在一起“討論框架之間的共性,尋找可以合作的方式”。PHP-FIG制訂了推薦規(guī)范,PHP框架可以自愿實(shí)現(xiàn)這些規(guī)范,改進(jìn)其他框架的通信和共享功能。
PHP-FIG的使命是實(shí)現(xiàn)框架之間的互操作性。
????在文章的最開始,我們就已經(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縮進(jìn)使用PSR-2 之前先要貫徹PSR-1
使用四個(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)在書中找到了答案
關(guān)鍵字為了避免意料之外的輸出錯(cuò)誤,如果加上關(guān)閉標(biāo)簽,而且在關(guān)閉標(biāo)簽后有空行,那么這個(gè)空行也被當(dāng)成輸出,導(dǎo)致錯(cuò)誤(例如,設(shè)定http首部時(shí))
關(guān)鍵字,要使用小寫;
之前不知道在哪兒看的PHP的教程,上面寫的PHP代碼像true、false這樣的關(guān)鍵字都使用的是大寫TRUE、FALSE,我也一直在這樣使用,后來(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、如果類屬性聲明為abstract和final,這兩個(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)鍵字包括:if、elseif、else、switch、case、while、do while、for、foreach、try、catch。如果控制結(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)景,我們引入文件通常都是采用require、include這樣的方法,這樣的方式簡(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)加載器。
PSR-ME:制定自己的PHP規(guī)范
現(xiàn)代的PHP框架,laravel、Yii、TP5等都使用了依賴Composer的自動(dòng)加載器策略,方便我們下載組件和引入合適的類。遵循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)題目俗話說(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)形鏈表、...
摘要:大家好,推薦下我們團(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。最渴望有人給...
摘要:大會(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...
閱讀 4933·2021-11-25 09:43
閱讀 1186·2021-11-24 09:38
閱讀 1892·2021-09-30 09:54
閱讀 2800·2021-09-23 11:21
閱讀 2367·2021-09-10 10:51
閱讀 2368·2021-09-03 10:45
閱讀 1163·2019-08-30 15:52
閱讀 1766·2019-08-30 14:13