使用 Mac+Xampp+PhpStorm+xdebug 进行本地php调试

本文介绍 macOS 系统下 Xampp+PhpStorm+xdebug 进行 php 调试

篇幅较长，阅读需要较长时间，如有疑问请下方留言

下载安装 Xampp

点我去官网下载 Xampp

找到 XAMPP for OS X 7.1.29, 7.2.18, 7.3.5, 7.1.29, 7.2.18 & 7.3.5 这个部分

选择 More Downloads

选择 XAMPP Mac OS X

根据需要选择 PHP 版本 我这里选择 7.3.5

前方高能前方高能前方高能
这里要注意不要选后面带 vm 的版本，这个版本是在 macOS 上运行 Linux 版本的 Xampp 虚拟机 (虽然官方推荐但是在安装 xdebug 时我是装不成功的)

OS X native modules have been deprecated. Please use XAMPP-VM for OS X and the Linux version of the add-ons. Check our FAQs for more info.

注:编写该文章时PHP最新版本为7.3.5

生成xdebug.so文件

获取量身定制的xdebug.so生成步骤

点我去官网生成一个xdebug.so

此页面可帮助您查找要下载的文件，以及如何配置 PHP 以使 Xdebug 运行。请粘贴 phpinfo 的完整输出（HTML版本，HTML源代码 或 php -i 输出的复制和粘贴）并提交表单以接收定制的下载和安装说明。

打开先前安装好的 Xampp

选择 Manage Servers 点击下面的 Start All 等待红色圆圈变为绿色圆圈后，即启动成功

选择 Welcome 右下角点击 Go to Application 会打开网页

网页打开后选择网页菜单栏的 PHPInfo

打开 PHPInfo 页面后按command + a 全选网页并复制

打开点我去官网生成一个xdebug.so 将刚才复制的内容黏贴到文本框中，并点击 Analyse my phpinfo() output 按钮

之后将会显示出您本地的PHP信息以及专门问您定制的xdebug安装步骤(每个人显示的可能不一样，请按照网站显示步骤进行安装)

生成xdebug.so文件

下载 xdebug-2.7.2.tgz (xdebug版本与php版本相关联，不可乱安装)

xdebug版本对应的PHP版本，仅做参考，该链接下载的是Windows版本的

打开命令行工具 cd 到 xdebug下载目录解压刚才下载的 xdebug

tar -xvzf xdebug-2.7.2.tgz

cd 到 xdebug目录这里的 xdebug-2.7.2 不同版本，版本号会不一样

cd xdebug-2.7.2

在命令行输入 phpize (这里的 phpize 是 XAMPP 带的)

/Applications/XAMPP/xamppfiles/bin/phpize

2019-07-20 更新
如果报 Cannot find autoconf. Please check your autoconf installation and the $PHP_AUTOCONF environment variable. Then, rerun this script. 错误

安装 autoconf

brew install autoconf

命令行输入 ./configure

./configure --with-php-config=/Applications/XAMPP/xamppfiles/bin/php-config

这里要指定 Xampp 带的 php-config 否则最后生成的 xdebug.so 无法在 PHP7.3.5 使用

命令行输入 make

make

这里出现了 ** ‘php.h’ file not found** 的错误，如果没遇到请忽视这里

/Users/mac/Downloads/xdebug-2.7.2/xdebug.c:25:10: fatal error: 'php.h' file not found
#include "php.h"

解决办法：

终端输入 xcode-select –install 如果提示没有命令，请安装 Xcode

xcode-select --install

如果提示以下信息，不用管

xcode-select: error: command line tools are already installed, use "Software Update" to install updates

接着命令行输入

sudo installer -pkg /Library/Developer/CommandLineTools/Packages/macOS_SDK_headers_for_macOS_10.14.pkg -target /

macOS 10.15看这里
https://bbqsoftwares.com/blog/xdebug-catalina

注:

1、我的系统版本是 10.14 的所以才有 macOS_SDK_headers_for_macOS_10.14.pkg 这个包

具体叫什么名字请去以下目录中查看

/Library/Developer/CommandLineTools/Packages/

2、-target / -target 后面有个空格接着才是 /

当看到 The install was successful. 即成功

参考资料:
https://stackoverflow.com/questions/52623108/installing-xdebug-on-macos-mojave-php-h-file-not-found/

接着重复第6步，命令行输入 make

make

当看到以下内容即 xdebug 编译成功，我们可以在刚才解压的 xdebug 目录的 modules 文件夹里看到 xdebug.so 文件

Build complete.
Don't forget to run 'make test'.

将 xdebug.so 拷到 /Applications/XAMPP/xamppfiles/lib/php/extensions/no-debug-non-zts-20180731 目录下

no-debug-non-zts-20180731 这个目录不同版本的 XAMPP 会不一样，请注意

cp modules/xdebug.so /Applications/XAMPP/xamppfiles/lib/php/extensions/no-debug-non-zts-20180731

这时可能命令行会提示** Permission denied** 错误
使用 sudo 命令即可

sudo cp modules/xdebug.so /Applications/XAMPP/xamppfiles/lib/php/extensions/no-debug-non-zts-20180731

接着编辑 php.ini 文件路径如下(建议使用 Sublime Text 等工具打开)

/Applications/XAMPP/xamppfiles/etc/php.ini

在最底部添加

plications/XAMPP/xamppfiles/lib/php/extensions/no-debug-non-zts-20180731/xdebug.so
xdebug.remote_autostart=on
xdebug.remote_enable=on
xdebug.remote_mode="req"
xdebug.remote_host=localhost
xdebug.remote_port=9000
xdebug.remote_handler="dbgp"
xdebug.idekey="PhpStorm"
xdebug.profiler_enable = Off

接着重启 Xampp 服务

PhpStorm 配置 xdebug

打开 PhpStorm 配置列表快捷键

同时按下 command 和 ,

修改 PHP 为 Xampp 自带的 PHP

1、展开 Language&Framework 并点击 PHP 找到 PHP language level 将其版本号改为 Xampp 自带的 PHP 版本，我这里是 7.3

2、修改 CLI InterPreter
点击 CLI InterPreter 右侧的 … 按钮

在弹出面板左上角，点击 + 号按钮选择 Other Local…

选择 PHP 路径
Xampp 的 PHP 路径为

/Applications/XAMPP/xamppfiles/bin/php

展开 Language&Framework 并选择 PHP 展开并点击 Debug，查看右侧 Xdebug 里的 Debug port, 这里的端口要和 php.ini 里的 xdebug.remote_port 保持一致。

展开 Debug 配置 DBGp Proxy 里的 IDE key、Host、Port

1、IDE key: 要和 php.ini 的 xdebug.idekey=”PhpStorm” 值一致，所以这里是填 PhpStorm

2、Host: 填 localhost

3、Port: 填 80（这里的端口号要与Xampp带的Apache的端口号一致）

Apache 端口号查看:

配置 servers

1、展开 Language&Framework 并选择 PHP 展开并点击 Servers

2、在右上角点击 + 按钮创建一个 Servers

3、在 Host 里输入 127.0.0.1，端口号还是刚才的Apache的端口号 Debugger 选择 xdebug

创建一个PHP Web Page

1、回到编译器界面，点击右上角 add configuration 按钮

2、点击左上角 + 号选择 PHP Web Page

3、在右边面板选择 configuration 下的 Server 里下拉选择刚才配置的 Server

4、在Start URL里填你要调试的 php 文件或者站点，我这里是调试 wordpress，他的路径就是 127.0.0.1/wordpress/，所以填 wordpress

5、选择刚才创建好的 web application 点击右边的红色电话按钮，待变为绿色电话即可，然后点击 debug 按钮进行调试

chrome 安装 xdebug(需要梯子)

Xdebug helper