使用 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
https://img.wangquanwei.com/wp-content/uploads/2019/05/1558430196-2333A742-508F-4CC1-87B2-2F57CD390597.jpg

选择 XAMPP Mac OS X

https://img.wangquanwei.com/wp-content/uploads/2019/05/1558430185-8E8427F1-6867-4D77-975E-03818AB8FB42.jpg

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

https://img.wangquanwei.com/wp-content/uploads/2019/05/1558430208-E8347E46-0575-4601-88BF-944CFC356681.jpg

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

https://img.wangquanwei.com/wp-content/uploads/2019/05/0B1217A4B4EF2FA75242F1C4D872C4B8.jpg

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

生成xdebug.so文件

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

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

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

打开先前安装好的 Xampp

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

https://img.wangquanwei.com/wp-content/uploads/2019/05/1558430188-8EE4F4E8-3E79-42CC-8DFD-3E839BD38486.jpg

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

https://img.wangquanwei.com/wp-content/uploads/2019/05/1558430197-374795D1-D6C1-4135-A556-E9DE2474F0AD.jpg

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

https://img.wangquanwei.com/wp-content/uploads/2019/05/1558430217-FC94D280-380C-4E8F-90C7-6328DBC03518.jpg

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

https://img.wangquanwei.com/wp-content/uploads/2019/05/1558430195-659C8EC8-A86D-4C8E-8D04-C3AB6FFF8146.jpg

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

https://img.wangquanwei.com/wp-content/uploads/2019/05/1558430205-D462D929-2117-4B57-BF1B-6A552D373042.jpg

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

https://img.wangquanwei.com/wp-content/uploads/2019/05/23098BB6-671A-4C8E-AA72-A9A1ABC4BAAD.jpeg

生成xdebug.so文件

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

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

打开命令行工具 cdxdebug下载目录 解压刚才下载的 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

https://img.wangquanwei.com/wp-content/uploads/2019/05/1558431121-AD27C4F6-1CFD-46D7-B8F4-5E8308624F57.jpeg

2019-07-20 更新
如果报 Cannot find autoconf. Please check your autoconf installation and the $PHP_AUTOCONF environment variable. Then, rerun this script. 错误
https://img.wangquanwei.com/wp-content/uploads/2019/05/5168CDC9-36B7-45E7-9345-ACE70B350013.jpeg

安装 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"

https://img.wangquanwei.com/wp-content/uploads/2019/05/1558430216-F0574140-2EDA-4E34-B39D-F23667C190B4.jpg

解决办法:

终端输入 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
https://img.wangquanwei.com/wp-content/uploads/2019/05/1558430182-2DEA59C1-58AE-4158-B231-9D20C3FEC445.jpg

2、修改 CLI InterPreter
点击 CLI InterPreter 右侧的 ... 按钮
https://img.wangquanwei.com/wp-content/uploads/2019/05/1558430194-618F86CD-B8B8-493F-8919-7F1CFFAE172E.jpg

在弹出面板左上角,点击 + 号按钮 选择 Other Local...
https://img.wangquanwei.com/wp-content/uploads/2019/05/1558430199-0687787A-A726-4B38-8649-AE942F37E807.jpg

选择 PHP 路径
XamppPHP 路径为

/Applications/XAMPP/xamppfiles/bin/php

https://img.wangquanwei.com/wp-content/uploads/2019/05/1558430190-59F899C1-265E-49F6-A17F-2BDE85882E30.jpg

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

https://img.wangquanwei.com/wp-content/uploads/2019/05/09F146B4-E0CB-4B6D-9A74-5C163727CCAC.jpeg

展开 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 端口号查看:
https://img.wangquanwei.com/wp-content/uploads/2019/05/FAD7A545-2EFC-4564-AE65-B77C27FD93DB.jpeg

https://img.wangquanwei.com/wp-content/uploads/2019/05/F6D4FE85-2179-4914-98E8-23BB7B4C0DE5.jpeg

配置 servers

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

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

3、在 Host 里 输入 127.0.0.1,端口号还是刚才的Apache的端口号 Debugger 选择 xdebug
https://img.wangquanwei.com/wp-content/uploads/2019/05/1558430207-E36C1C0A-18E9-4E7C-91AD-1387BECE27E3.jpg

创建一个PHP Web Page

1、回到编译器界面,点击右上角 add configuration 按钮
https://img.wangquanwei.com/wp-content/uploads/2019/05/A9D9F2E4-9FC2-4AC5-AE84-A216DB26C193.jpeg

2、点击左上角 + 号 选择 PHP Web Page
https://img.wangquanwei.com/wp-content/uploads/2019/05/1558430201-B949FB4B-B353-440A-9A6F-F2EC9D72348A.jpg

3、在右边面板选择 configuration 下的 Server 里下拉选择刚才配置的 Server
https://img.wangquanwei.com/wp-content/uploads/2019/05/1558430183-6E485101-8DA2-4D24-8327-E1220349DD0C.jpg

4、在Start URL里填你要调试的 php 文件或者站点,我这里是调试 wordpress,他的路径就是 127.0.0.1/wordpress/,所以填 wordpress
https://img.wangquanwei.com/wp-content/uploads/2019/05/1558430206-E6FB49C2-D950-4C85-BE9B-1CE966761952.jpg

5、选择刚才创建好的 web application 点击 右边的红色电话按钮,待变为绿色电话即可,然后点击 debug 按钮进行调试
https://img.wangquanwei.com/wp-content/uploads/2019/05/E6C7947C-DDE3-4CA0-9477-F8D62353B2BB.jpeg

chrome 安装 xdebug(需要梯子)

Xdebug helper

博主大大

假如生活欺骗了你,不要悲伤,不要心急,反正明天也一样~

2 Comments

  • 报这个错误怎么办呢 zsh: no such file or directory: ./configure

  • 可以可以,棒棒的。

留下你的评论

*评论支持代码高亮<pre class="prettyprint linenums">代码</pre>

猜你喜欢