本文介紹幾個有助於提高開發效率和質量的ThinkPHP專用composer包, 它們都是packgist上最流行的composer包為與ThinkPHP進行無縫整合而特別封裝. 安裝後, 無需修改框架原始碼, 無需或僅需修改一下配置檔案, 便立即可用.

本文假設讀者有能力正常使用composer

環境隔離 dotenv

真實世界的開發往往是這樣, 多個團隊成員共同開發, 線上線下的程式碼通過版本控制系統保持一致.
但你無法保證也沒理由要求所有機器上的應用配置一致. 例如,要求所有成員使用相同的本地資料庫使用者名稱和密碼是不合理的.
線上線下使用相同的資料庫配置更加不合理.

我們有很多種方式避免這種問題, 一種常見的方法是, 將配置檔案重新命名為config.example.php, 然後在每個部署的環境再重新命名為config.php,並在分發時排除這個檔案.
這種方法很容易實現,但缺點是他是靜態的. 每當你增加了一項配置, 或者減少了一項配置, 都需要告訴別人手動處理config.php. 否則, 它的程式可能無法正常執行.

通過專門的環境配置區分不同的部署環境,是另一種被廣泛採用的方案. 它的原理很簡單: 不同的部署環境中, 需要區別的配置往往非常有限, 所有將config.php納入版本控制或者分發包中更合理.
這樣config.php有變化時,其他環境中的應用可以第一時間更新. 那有限的幾個有環境有關配置, 往往都是諸如資料庫配置這種必不可少的. 將它們單獨隔離出來更加合理. 通常, 實施這種方案會把
隔離的配置放在一個名為.env

Packgist.org 中的 php-dotenv 是一個非常棒的包, 很適合與TP整合. think-dotenv 包已經完成了整合, 所以你可以拿來就用:

composer require snowair/think-dotenv:dev-master

修改 Common/Conf/tags.php

return array( 'app_init'=>array( 'Snowair\Think\Behavior\HookAgent' ) )

在專案根目錄下建立.env 檔案, 配置內容以 key=value 的格式逐行書寫,例如:

DB_HOST=localhost
DB_NAME=test
DB_USER=root
DB_PWD=root

這樣, 應用執行時, 上面四項配置將生效覆蓋config.php中的配置. 不同的部署環境, 只需要建立自己的.env檔案, 相互之間就實現了環境隔離.

全功能日誌 monolog

開發階段的日誌管理很簡單, 甚至很多人認為不重要. 但生產環境中, 如果你輕視日誌管理, 代價可能是巨大的. 日誌記錄了應用的歷史, 歷史可以詔示未來.
分析海量日誌, 你可以得出很多很重要的資訊, 這些資訊可以幫助你提升效能,避免瓶頸,及時擴容,發現攻擊,修補漏洞….

但TP的日誌功能, 非常簡單, 也許無法擔當重任. 試想一下, 當你發展到需要十臺伺服器在負載均衡下執行應用時, 你該如何管理你的日誌?
或者, 線上程式碼出現了隨機偶發性的問題, 本地幾乎不可能重現這些問題,你該如何捕捉資訊? 還有很多情況,需要有一個趁手的日誌工具幫助你解決問題.

monolog是 Packgist上最流行的日誌庫, 在 composer 約7萬餘個包中, 它的安裝量排名第一. 它也是symfony和laravel預設整合的日誌庫. 它之所以流行, 在於它功能豐富可以滿足各種層次的需要,而且易於整合至其他系統,並且簡單好用.

think-monolog 包完成了將monolog整合至TP的工作, 所以在TP專案中, 你只需要這樣使用:

composer requrie snowair/think-monolog:dev-master

程式碼中:

\Snowair\Think\Logger::debug('這是一條debug日誌');

敏捷利器 phpunit

你的專案越複雜龐大, 可能約需要單元測試. 為獨立的類寫單元測試是件輕鬆愉快的事情, 但為存在耦合的類寫單元測試就不那麼爽快了.

因此, 如果要實施單元測試, 您的程式碼需要寫的適合做單元測試. 但有些情景,你可能無能為力: 在TP中, 你的控制器類必須繼承Think\Controller類,你的模型類必須繼承Think\Model類. 而這兩個類中相當的邏輯, 與TP的生命週期密切耦合.

要測試它們, 你首先需要模擬出應用的執行過程, 創建出它們所需要的那些耦合的元素, 否則它們無法正常執行. 所以, 大多情況, 我們會忽略對這倆種類的測試或只做有限的測算.

think-phpunit 的目標是幫助你對控制器和模型類做完整測試, 並且將這一過程簡單化.

首先, 為了讓phpunit能載入你的類, 你必須修改專案的 composer.json:

{
  "name": "公司名/專案名",
  "autoload": {
    "classmap": ["Application","ThinkPHP/Library"]
  }
}

然後安裝:

composer requrie snowair/think-phpunit:dev-master

接下來,我建立了一個 ./test/IndexControllerTest.php 測試類:

<?php
class IndexControllerTest extends PhpUnit
{

    static public function setupBeforeClass()
    {
        // 下面四行程式碼模擬出一個應用例項, 每一行都很關鍵
        parent::$app = new \Think\PhpunitHelper();
        parent::$app->setMVC('domain.com','Home','Index');
        parent::$app->setTestConfig(['DB_NAME'=>'test', 'DB_HOST'=>'127.0.0.1',]); 
        parent::$app->start();
    }

    public function testIndex()
    {
        $output = $this->execAction('index');
        $this->assertEquals('hello world',$output);
    }
}

然後執行:

$ vendor/bin/phpunit test/IndexControllerTest.php 
PHPUnit 4.8.6 by Sebastian Bergmann and contributors.

.

Time: 139 ms, Memory: 7.00Mb

OK (1 test, 1 assertion)

就是如此輕鬆.

優雅模板 Twig引擎

相比ThinkPHP內建的Think模板引擎, Twig引擎擁有更優雅的語法, IDE的對其支援更好. 並且,使用獨立的Twig引擎開發模板有助於未來的移植: 當專案決定遷移至Laravel或Symfony時, 模板可以原封不動的保留.

composer require snowair/think-twig:dev-master

引擎配置:

/* Twig模板引擎設定 */
'TMPL_ENGINE_TYPE'      =>  'Twig',      // 設定為Twig啟用twig引擎
'TMPL_TEMPLATE_SUFFIX'  =>  '.html',     // 設定模板字尾, 可自由設定ACTION_NAME之間的分割符

做完上面的配置, twig就生效了

優雅異常 Whoops

當系統丟擲異常, 我們需要一個工具, 立即在頁面顯示出異常棧的全過程,Whoops是這方面做的最好的工具.

composer require snowair/think-whoops:dev-master

• 在 Common/Conf/tags.php 增加一個行為,如果之前已經新增過,就不用再添加了:
  
return array(
'app_init'=>array(
'Snowair\Think\Behavior\HookAgent'
),
)


就是這麼簡單, whoops立即生效了!