摘要：但是，系統(tǒng)自帶的只有基礎(chǔ)的配置，如果想做開發(fā)，還是必須的，以下就總結(jié)一下如何在中為系統(tǒng)自帶的增加模塊。本文先發(fā)布于我的個人博客系統(tǒng)增加，后續(xù)如有更新，可以查看原文。

Apple在發(fā)布macOS High Sierra后，系統(tǒng)也終于自帶了php v7.1，相比于之前，如果想使用php7，還得額外想辦法( Homebrew 或者 php-osx )而言著實(shí)方便了不少。

但是，系統(tǒng)自帶的PHP只有基礎(chǔ)的配置，如果想做PHP開發(fā)，Xdebug還是必須的，以下就總結(jié)一下如何在macOS High Sierra中為系統(tǒng)自帶的PHP增加Xdebug模塊。

macOS High Sierra: v10.13.3

PHP: v7.1.7

Xdebug官網(wǎng)安裝文檔中有MAC推薦的方式，鑒于系統(tǒng)自帶的是PHP是v7.1.7，所以在選擇的時(shí)候，需要選擇php71-xdebug這個安裝包。

另外由于brew中的php71-xdebug依賴于php71的，所以建議加上--without-homebrew-php這個參數(shù)，這樣的話brew就會忽略安裝php71。

brew install php71-xdebug --without-homebrew-php

不過這個時(shí)候，或許你會碰到下面這樣的報(bào)錯：

phpize
grep: /usr/include/php/main/php.h: No such file or directory
grep: /usr/include/php/Zend/zend_modules.h: No such file or directory
grep: /usr/include/php/Zend/zend_extensions.h: No such file or directory
Configuring for:
PHP Api Version:
Zend Module Api No:
Zend Extension Api No:

提示缺失依賴，從而導(dǎo)致phpize無法正常工作，phpize是用來準(zhǔn)備 PHP 擴(kuò)展庫的編譯環(huán)境的，理論上系統(tǒng)自帶的PHP應(yīng)該是有phpize的，但是沒有在/usr/include/php/*里面找到它需要的模塊，并且檢索/usr/include時(shí)發(fā)現(xiàn)這個目錄根本不存在。

Google了一圈，解決問題，就需要在/usr/include中補(bǔ)全相關(guān)的內(nèi)容，在OSX v10.10以前系統(tǒng)，需要手動做軟鏈來解決：

sudo ln -s /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/usr/include /usr/include

但是v10.11以后的系統(tǒng)重寫了安全策略，所以會遇到權(quán)限問題(sudo也不行)：

ln: /usr/include: Operation not permitted

不過好在Apple為開發(fā)人員準(zhǔn)備了Xcode，這是一個很強(qiáng)大的工具，但是體積也很大(下載安裝有點(diǎn)慢)，而一般我們只需要它提供的Command Line Tools就夠了，上面的問題，其實(shí)只要安裝Command Line Tools就可以解決：

xcode-select --install

接下來，跟著提示做，安裝、同意協(xié)議...

等待安裝結(jié)束以后，再用 brew 來安裝 php71-xdebug:

brew install php71-xdebug --without-homebrew-php

一切結(jié)束以后，brew會給出提示：

To finish installing xdebug for PHP 7.1:
  * /usr/local/etc/php/7.1/conf.d/ext-xdebug.ini was created,
    do not forget to remove it upon extension removal.
  * Validate installation via one of the following methods:
  *
  * Using PHP from a webserver:
  * - Restart your webserver.
  * - Write a PHP page that calls "phpinfo();"
  * - Load it in a browser and look for the info on the xdebug module.
  * - If you see it, you have been successful!
  *
  * Using PHP from the command line:
  * - Run `php -i "(command-line "phpinfo()")"`
  * - Look for the info on the xdebug module.
  * - If you see it, you have been successful!

經(jīng)過上面步驟，系統(tǒng)里面是有Xdebug了，但是在php.ini配置文件中不一定有，因此需要手動添加Xdebug的配置項(xiàng)：

[xdebug]
zend_extension="/usr/local/opt/php71-xdebug/xdebug.so"
xdebug.remote_enable = 1
xdebug.remote_autostart = 1
xdebug.remote_connect_back = 1
xdebug.remote_port = 9000
xdebug.scream = 0
xdebug.show_local_vars = 1

然后就是重啟php-fpm：

# 關(guān)閉php-fpm
sudo killall php-fpm

# 啟動php-fpm
sudo php-fpm

運(yùn)行php -i "(command-line "phpinfo()")" | grep xdebug后，你就可以看到關(guān)于Xdebug的配置內(nèi)容了：

xdebug
...
xdebug.remote_autostart => On => On
xdebug.remote_connect_back => On => On
xdebug.remote_cookie_expire_time => 3600 => 3600
xdebug.remote_enable => On => On
xdebug.remote_handler => dbgp => dbgp
xdebug.remote_host => localhost => localhost
xdebug.remote_log => no value => no value
xdebug.remote_mode => req => req
xdebug.remote_port => 9000 => 9000
xdebug.remote_timeout => 200 => 200
xdebug.scream => Off => Off
...

VSCode是目前最流行的開發(fā)工具之一，雖然輕量，但是對標(biāo)各類IDE毫不遜色，微軟良心之作，通過安裝不同的插件可以擴(kuò)展它的能力，其中有一款 PHP Debug 的插件，可以作為Xdebug的橋梁，方便直接通過Xdebug調(diào)試PHP，官方的描述十分貼切：

PHP Debug Adapter for Visual Studio Code

官網(wǎng)的指導(dǎo)也寫的相當(dāng)不錯：

Install XDebug
I highly recommend you make a simple test.php file, put a phpinfo(); statement in there, then copy the output and paste it into the XDebug installation wizard. It will analyze it and give you tailored installation instructions for your environment.
In short:

On Windows: Download the appropiate precompiled DLL for your PHP version, architecture (64/32 Bit), thread safety (TS/NTS) and Visual Studio compiler version and place it in your PHP extension folder.
On Linux: Either download the source code as a tarball or clone it with git, then compile it.



Configure PHP to use XDebug by adding zend_extension=path/to/xdebug to your php.ini.
The path of your php.ini is shown in your phpinfo() output under "Loaded Configuration File".

Enable remote debugging in your php.ini:
[XDebug]
xdebug.remote_enable = 1
xdebug.remote_autostart = 1
There are other ways to tell XDebug to connect to a remote debugger than remote_autostart, like cookies, query parameters or browser extensions. I recommend remote_autostart because it "just works". There are also a variety of other options, like the port (by default 9000), please see the XDebug documentation on remote debugging for more information.

If you are doing web development, don"t forget to restart your webserver to reload the settings
Verify your installation by checking your phpinfo() output for an XDebug section.

這里需要注意的是它推薦開啟Xdebug配置項(xiàng)中的remote_autostart這一項(xiàng)。

好了，經(jīng)過上面的操作，你應(yīng)該可以跟Demo里面一樣在VSCode中調(diào)試PHP了。

本文先發(fā)布于我的個人博客《macOS系統(tǒng)PHP7增加Xdebug》，后續(xù)如有更新，可以查看原文。