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

本文介绍Mac系统下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的版本,这个版本是在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.

注:编写该文章时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

命令行输入 ./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 /

当看到 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 服务

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

2019-07-20 更新

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

博主大大

假如生活欺骗了你,不要悲伤,不要难过,反正明天也一样......

1 Comment

  • 可以可以,棒棒的。

留下你的评论

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

猜你喜欢