Mac HomeBrew 自 18-03-31 起弃用 homebrew/php 后安装 Xdebug 方法

详见：https://brew.sh/2018/01/19/homebrew-1.5.0/

By 31st March 2018 we will deprecate and archive the Homebrew/php tap. Unfortunately we have been unable to maintain an acceptable, consistent user or contributor experience and CI workload through non-core formula taps in the Homebrew organisation so we are continuing to migrate widely used formulae into Homebrew/core and encourage more niche formulae and options to be supported outside the Homebrew organisation.

在更新前我们可以通过如下命令安装 Xdebug 扩展

brew install php71-xdebug

然而现在不行了，现在连 brew tap homebrew/php 都会失败

再没有一个更方便的办法前，我们只能手动编译一下

懒人直接下载…然后看 3、4 步就行：OSX-PHP-Xdebug

PS：目前只编译了 PHP 7.1 版本的 Xdebug 2.6.0 和 PHP 5.6 版本的 Xdebug 2.5.5

---

2018年04月28日更新一个简单的方法

直接打开终端输入：

pecl install xdebug

等待命令运行，会自动下载 xdebug 源码并编译放置到
（版本不同，可能有差异）
/usr/local/Cellar/php@7.1/7.1.17/pecl/20160303/xdebug.so

如果失败，先删除 /usr/local/opt/php@7.1/ 下的 pecl

安装成功后，建议把 /usr/local/Cellar/php@7.1/7.1.17/pecl/20160303/xdebug.so 这个文件

剪切到下方步骤 3、4 所提及的目录即可。

---

1. 首先进入 Xdebug 官方下载页面：https://xdebug.org/download.php

   截止博文发表日期，当前最新稳定版为 2.6.0，我们下载稳定版的 source，一个 tgz 压缩包。

2. 下载完成后，在压缩包位置戳开终端或 iTerm2，命令走起（无需 sudo）：

   tar -xzf xdebug-2.6.0.tgz
   cd xdebug-2.6.0
   phpize
   ./configure
   # 等待上方命令完成后开始编译
   make -j2
   # 稍等 10s 左右，在 modules 目录即可得到 xdebug.so 文件
   

3. 放置 xdebug.so 文件（以 PHP 7.1 为例）

   从 4 月开始，brew 中的命名也发生了变化，如 php71 变成了 php@7.1。而通过 brew install php@7.1 安装 PHP 7.1 后，默认会有一个扩展 opcache.so 在 /usr/local/opt/php@7.1/lib/php/20160303 这个目录，那么我们可以在 /usr/local/lib/php/ 这个目录下新建一个 extensions 文件夹，将刚刚编译的 xdebug.so 扔进来

4. 配置参数

   到这一步，基本上就已经结束了，进入 /usr/local/etc/php，进入自己使用的 PHP 版本文件夹，再进入 conf.d，例如 /usr/local/etc/php/7.1/conf.d。
   新建文件 ext-xdebug.ini，内容如下：

   [Xdebug]
   zend_extension="/usr/local/lib/php/extensions/xdebug.so"
   ;自动跟踪，可关闭（关闭后提升性能）
   xdebug.auto_trace=On
   ;性能分析，可关闭（关闭后提升性能，该项在 Xdebug 3 后用 xdebug.mode 代替）
   xdebug.profiler_enable=On
   xdebug.var_display_max_children=512
   xdebug.var_display_max_data=2048
   xdebug.var_display_max_depth=8