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

本文介绍Mac系统下Xampp+VSCode+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

image

选择 XAMPP Mac OS X

image

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

image.png

注意
这里要注意 不要选后面带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.

image.png

生成xdebug.so文件

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

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

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

打开先前安装好的 Xampp

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

image

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

image

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

image

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

image

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

image

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

image

生成xdebug.so文件

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

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

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

1. tar -xvzf xdebug-2.7.2.tgz

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

1. cd xdebug-2.7.2

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

1. /Applications/XAMPP/xamppfiles/bin/phpize

image

命令行输入 ./configure

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

** 特别注意 **
这里要指定 Xampp 带的 php-config 否则最后生成的 xdebug.so 无法在 PHP7.1.23 使用!!!!

命令行输入 make

1. make

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

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

image

解决办法：

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

1. xcode-select --install

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

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

接着命令行输入

1. 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

1. make

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

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

注意：

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

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

1. /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 会不一样，请注意

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

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

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

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

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

在最底部添加

1. [xdebug]
2. zend_extension=/Applications/XAMPP/xamppfiles/lib/php/extensions/no-debug-non-zts-20180731/xdebug.so
3. xdebug.remote_autostart=on
4. xdebug.remote_enable=on
5. xdebug.remote_mode="req"
6. xdebug.remote_host=localhost
7. xdebug.remote_port=9000
8. xdebug.remote_handler="dbgp"
9. xdebug.idekey="PhpStorm"
10. xdebug.profiler_enable = Off

接着重启 Xampp 服务

VSCODE 配置 xdebug

打开 VSCODE 的插件安装页面

1. 安装 PHP Intelephense

2. 安装 PHP Debug

   
   
   

   image.png

image.png

image.png

最后断点就能调试代码

注意： 文档路径要放在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

1. brew install autoconf