本文介绍Mac系统下Xampp+VSCode+xdebug 进行php调试
篇幅较长,阅读需要较长时间,如有疑问请下方留言
下载安装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.1.23
注意
这里要注意 不要选后面带VM的版本,这个版本是在Mac上运行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.
生成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
命令行输入 ./configure
./configure --with-php-config=/Applications/XAMPP/xamppfiles/bin/php-config
** 特别注意 **
这里要指定 Xampp 带的 php-config 否则最后生成的 xdebug.so 无法在 PHP7.1.23 使用!!!!
命令行输入 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 /
当看到 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'.
注意:
1、我的系统版本是10.14的所以才有 macOS_SDK_headers_for_macOS_10.14.pkg 这个包
具体叫什么名字请去以下目录中查看
/Library/Developer/CommandLineTools/Packages/
2、-target / -target 后面有个空格接着才是 /
将 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
在最底部添加
[xdebug]
zend_extension=/Applications/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 服务
VSCODE 配置 xdebug
打开 VSCODE 的插件安装页面
- 安装 PHP Intelephense
-
安装 PHP Debug
最后断点就能调试代码
注意: 文档路径要放在apache的应用根目录,通过访问本地localhost:80来进行触发
错误解决方案
1、执行命令 /Applications/XAMPP/xamppfiles/bin/phpize 报 Cannot find autoconf. Please check your autoconf installation and the $PHP_AUTOCONF environment variable. Then, rerun this script. 错误的解决办法
安装 autoconf
brew install autoconf