Yii2 HOW-TO（3）：調試工具yii2-debug和Xdebug（失敗）

Yii 1.0時代使用CWebLogRoute

在早期Yii 1.0時代，借助于CWebLogRoute可以在指定Web頁面中輸入日志信息。因為現在廣泛使用Yii 2.X，所以此方式使用說明不再詳述。有興趣的讀者可參考參考資料1.

使用yii2-debug

簡介

yii2-debug調試工具當屬Yii 2.0時代調試PHP代碼的首選。此擴展為 Yii 2 應用程序提供了一個調試器。當使用此擴展時， 每個頁面的底部將出現一個調試器工具欄。此擴展還提供了 一系列獨立的頁面來顯示更詳細的調試信息。

工具欄顯示當前打開的頁面信息，此時調試器可以用來分析你以前 所收集的數據（例如，確認變量的值）。

在這些工具中您可以：

• 通過工具欄可快速獲取框架版本，PHP 版本，響應狀態，當前控制器和動作，性能信息和 更多；
• 瀏覽應用程序和 PHP 配置;
• 查看請求數據，請求和響應頭，會話數據，和環境變量；
• 查看，搜索，和過濾日志；
• 查看任意的分析結果；
• 查看頁面執行的數據庫查詢；
• 查看應用程序發送的電子郵件。

所有這些信息可按要求提供，讓您更好的重新查看過去的請求信息。

安裝、配置和使用

本文后面引用4中簡潔、準確記錄了Yii2-debug的使用方法；在此不再贅述。

剛開始Yii開發時，Yii2-debug調試面板并不顯示。參考下圖，其中是一個簡單的視圖。

注意到，上圖中沒有顯示調試面板。但是，請注意觀察截圖右下角的“<”，點擊這個符號即可顯示Yii2-debug調試面板的最小縮圖，如下：

點擊面板上某個內容即可顯示大面板和詳細信息，如下圖所示：

至此，恕不再詳述。如果您熟悉Firefox下的Firebug開發工具，相信你這個工具你一定喜歡，相當棒！

安裝與使用Xdebug失敗

重要聲明

其實，這幾句是我特別在此插入的。因為，我的MacOS High Sierra（10.13.6）中安裝的XAMPP版本太高了（約上一個月安裝的），對應的PHP版本是7.2.9。因此，有一個奇怪的結果是：目前使用在網絡及官方建議的“pecl install xdebug”方式安裝Xdebug失敗............

注意：我花費了近兩天時間GOOGLE了大量資料，最后結論是針對PHP版本7.2.9，尚無法安裝XDEBUG支持。可能這個結論有所變動，或者過段時間“pecl install xdebug”命令官方會提供支持，我會進一步修改此結論。因此，如果有讀者正想在您的MAC下XAMPP中加入XDEBUG支持，請使用版本較低的！！！后面的內容目前不再需要浪費您的閱讀時間了。

Xdebug是調試PHP開發中必須安裝的調試工具——單補調試，斷點跟蹤等，所以這一些都不必說了。我安裝的是xampp-osx-7.2.9-0-installer.dmg，但是值得注意的是：在比較新的XAMPP中并沒有內置Xdebug這個內置擴展。需要手動安裝。

安裝PECL

這是引用文6（官方網站）中推薦的MAC上的安裝方法。因此首先需要安裝PECL。

PECL（The PHP Extension Community Library）是 PHP 擴展的存儲庫，為 PHP 所有的擴展提供提供托管和下載服務。

通過 PEAR（PHP Extension and Application Repository）的 Package Manager 的安裝管理方式，可以對 PECL 擴展進行下載和安裝。

1. 下載 PEAR

使用MAC內置的命令行工具 curl 命令下載即可：
curl -O https://pear.php.net/go-pear.phar

2. 安裝 PEAR

必須是使用 sudo 授權進行安裝，如下：
sudo php -d detect_unicode=0 go-pear.phar

安裝過程需要進行簡單的配置，如下：

Below is a suggested file layout for your new PEAR installation. To
change individual locations, type the number in front of the
directory. Type 'all' to change all of them or simply press Enter to
accept these locations.

1. Installation base ($prefix) : /usr
2. Temporary directory for processing : /tmp/pear/install
3. Temporary directory for downloads : /tmp/pear/install
4. Binaries directory : /usr/bin
5. PHP code directory ($php_dir) : /usr/share/pear
6. Documentation directory : /usr/docs
7. Data directory : /usr/data
8. User-modifiable configuration files directory : /usr/cfg
9. Public Web Files directory : /usr/www
   10. System manual pages directory : /usr/man
   11. Tests directory : /usr/tests
   12. Name of configuration file : /private/etc/pear.conf

1-12, 'all' or Enter to continue:

輸入 1，將安裝根目錄修改為 /usr/local/pear；
輸入 4，將命令安裝到 /usr/local/bin 目錄；
其它選項默認即可，一路回車。

也就是說，在上面【：】后面輸入1，然后在隨后的提示行中把安裝根目錄的位置修改為/usr/local/pear，再輸入4來修改命令安裝位置，此時輸入/usr/local/bin。之后，一路回車下來，即可完美安裝PEAR了。

3. 測試安裝結果

輸入命令行：pear version，我的電腦結果輸出如下：

PEAR Version: 1.10.5
PHP Version: 7.1.16
Zend Engine Version: 3.1.0
Running on: Darwin undefined.hostname.localhost 17.7.0 Darwin Kernel Version 17.7.0: Thu Jun 21 22:53:14 PDT 2018; root:xnu-4570.71.2~1/RELEASE_X86_64 x86_64

使用PECL安裝Xdebug

理論上是使用如下命令：
pecl install xdebug
但是，出現如下錯誤提示：
Password:
WARNING: channel "pecl.php.net" has updated its protocols, use "pecl channel-update pecl.php.net" to update
downloading xdebug-2.6.1.tgz ...
Starting to download xdebug-2.6.1.tgz (283,961 bytes)
.................................................done: 283,961 bytes
79 source files, building
running: phpize
Configuring for:
PHP Api Version: 20160303
Zend Module Api No: 20160303
Zend Extension Api No: 320160303
Cannot find autoconf. Please check your autoconf installation and the
$PHP_AUTOCONF environment variable. Then, rerun this script.

ERROR: `phpize' failed

于是，先使用brew安裝了autoconf:
brew install autoconf

正式安裝Xdebug

使用如下命令：
sudo pecl install xdebug

出現很長的跨屏幕提示，大致意思是下載后要重新編譯一下才得到xdebug.so文件。

路徑問題

注意，上面命令編譯后的xdebug.so所在的位置要搞清楚。我的機器上是生成到了路徑/usr/lib/php/extensions/no-debug-non-zts-20160303。

其他（略）

引用

1.https://blog.csdn.net/calm_thinker/article/details/51452695，《yii 如何使用 CWebLogRoute 記錄和調試變量》。2.https://www.yiiframework.com/doc/api/1.1/CWebLogRoute
3.https://github.com/yiisoft/yii2-debug/blob/master/docs/guide-zh-CN/README.md
4.https://github.com/yiisoft/yii2-debug/blob/master/docs/guide-zh-CN/installation.md。
5.https://blog.csdn.net/json_vip/article/details/79324524
6.https://xdebug.org/docs/install
7.https://medium.com/@romaninsh/install-php-7-2-xdebug-on-macos-high-sierra-with-homebrew-july-2018-d7968fe7e8b8
br/>2.https://www.yiiframework.com/doc/api/1.1/CWebLogRoute
3.https://github.com/yiisoft/yii2-debug/blob/master/docs/guide-zh-CN/README.md
4.https://github.com/yiisoft/yii2-debug/blob/master/docs/guide-zh-CN/installation.md。
5.https://blog.csdn.net/json_vip/article/details/79324524
6.https://xdebug.org/docs/install
7.https://medium.com/@romaninsh/install-php-7-2-xdebug-on-macos-high-sierra-with-homebrew-july-2018-d7968fe7e8b8