PSR (php standard recommendations)

為了讓大家開發的套件,能夠更輕鬆地整合到自己的專案當中,在 PHP 社群中大家一起定義了一些標準的程式碼撰寫規則

但是 Laravel 5.0.x 版本之前,Laravel 都沒有真正的遵照 PSR 的規範去撰寫程式碼,直到 Laravel 5.1 LTS 版本時,Laravel 終於將所有的程式碼遵照 PSR-2 及 PSR-4 的程式碼撰寫規則了,詳細的規則說明大家可以自己參考相關的說明文件。

而為了讓自己專案的開發也能夠遵照 PSR 規則,除了自己一個檔案一個檔案自己修改外,也可以用 PHP Coding Standards Fixer 套件去幫我們自動地將程式修改成遵照 PSR 規則的程式!

PHP Coding Standards Fixer 安裝使用教學

使用 compser 下載套件

使用 composer 將 php-cs-fixer 安裝到全域(global)目錄下

$ composer global require fabpot/php-cs-fixer

設定 composer bin 目錄到環境變數中

我們必須要將我們家目錄下的全域 ~/.composer/vendor/bin 目錄,設到環境變數中,這樣我們在命令列就可以直接執行 ~/.composer/vendor/bin 下面的可執行檔案了

$ export PATH="$PATH:$HOME/.composer/vendor/bin"

我們可以直接在命令列下這樣的指令就可以了,但每次開啟新的 Terminal 視窗時,都要再重新的設定一次這樣的環境變數,所以我們也可以把這個設定寫在 ~/.bash_profile 檔案中,這樣每次執行 Terminal 時,就會自動將 ~/.composer/vendor/bin 設到環境變數中了!

使用 php-cs-fixer 修正 PHP 檔案

設定完成後,我們就可以使用 php-cs-fixer fix /path/to/project --level=psr2 這樣的指令去修正我們專案目錄下的檔案了

一些 php-cs-fixer 相關的指令會像這樣:

$ php-cs-fixer fix /path/to/project --level=psr0
$ php-cs-fixer fix /path/to/project --level=psr1
$ php-cs-fixer fix /path/to/project --level=psr2
$ php-cs-fixer fix /path/to/project --level=symfony

設定 Sublime 使用 php-cs-fixer 修正程式碼

在 Sublime 上方工具列 Tools\Bulid System\New Build System 我們可以新增一個新的建立指令,指令中我們輸入像這樣的指令:

{
	"shell_cmd": "php-cs-fixer fix $file --level=psr2"
}

將新的指令檔案名稱取為 php-cs-fixer.sublime-bulid,這樣我們回到 Sublime 去開啟任一 PHP 檔案,只要按下 Command(⌘)+B,Sublime 就會自動幫我們執行 php-cs-fixer 的 shell script 指令,去修正我們的 PHP 檔案了!!

php-cs-fixer 使用小技巧

我們可以將修改 ~/.bash_profile 檔案,將使用 php-cs-fixer 修正 Terminal 目前目錄的 PHP 指令加入,這樣我們只要用 Terminal 瀏覽到我們想要做 php-cs-fixer 的目錄下,我們每次只需要下 phpCSFixerThisFolder 指令就可以了,這樣就不用記住也不用打那麼落落長的 php-cs-fixer 指令了!

alias phpCSFixerThisFolder="php-cs-fixer fix ./ --level=psr2"

PSR 中文文件

參考資料

KeJyun 最新新書推薦
- Laravel 5 for beginner 新手道場:優雅運用框架快速開發 PHP 網站
- Laravel框架开发详解:从零基础到运用框架快速开发PHP网站

Laravel 是 PHP 的框架(Framework),提供了很多開發網站或 API 所需的工具及環境,經過簡單的設定就可以完成資料的處理及顯示,使開發者可以很優雅且快速的開發出各個不同的產品。本書適合有 PHP 基礎的人,但不知道要怎麼選擇框架,或者不用框架的人也能夠明白它的好處。

雖然 WordPress 也能夠架站,但如果有客製化需求,要開發各式各樣的網站,或提供 App 使用的 API,如此一來你只能選擇用框架,而 Laravel 是目前最受歡迎的。

本書將解說為什麼要使用框架,以及理解框架的優缺點後,要怎麼選擇框架,並用框架快速建構一個網站。除非必要,否則書中會避免專業技術用語,盡量使用最生活化易懂的例子及語氣,讓大家更容易進入 Laravel 的世界。

Laravel 5 for beginner 新手道場:優雅運用框架快速開發 PHP 網站

購書連結

Laravel框架开发详解:从零基础到运用框架快速开发PHP网站

購書連結

comments powered by Disqus