Laravel Herd

macOS 文档

Xdebug

#
使用 Xdebug 与 Herd

Herd 包含对 Xdebug 的支持,Xdebug 是一个流行且功能强大的 PHP 调试器。Herd 的免费版本随附 Xdebug 的 PHP 扩展,但您需要在需要时手动启用扩展。

[!注意]
正在寻找更轻松的调试应用程序方法?查看 Herd Pro 的 Xdebug 集成。它可以自动检测应用程序中的断点,并在需要时动态启用 Xdebug。

#
手动启用 Xdebug

为了激活 Xdebug,您需要将相应的 PHP 扩展添加到您的 php.ini 文件中。这些扩展位于 Herd 应用程序包中,您可以在应用程序文件夹中找到它。确切位置取决于您的 PHP 版本和设备架构。

以下扩展可用

# Apple Silicon
/Applications/Herd.app/Contents/Resources/xdebug/xdebug-74-arm64.so
/Applications/Herd.app/Contents/Resources/xdebug/xdebug-80-arm64.so
/Applications/Herd.app/Contents/Resources/xdebug/xdebug-81-arm64.so
/Applications/Herd.app/Contents/Resources/xdebug/xdebug-82-arm64.so
/Applications/Herd.app/Contents/Resources/xdebug/xdebug-83-arm64.so
 
# Intel
/Applications/Herd.app/Contents/Resources/xdebug/xdebug-74-x86.so
/Applications/Herd.app/Contents/Resources/xdebug/xdebug-80-x86.so
/Applications/Herd.app/Contents/Resources/xdebug/xdebug-81-x86.so
/Applications/Herd.app/Contents/Resources/xdebug/xdebug-82-x86.so
/Applications/Herd.app/Contents/Resources/xdebug/xdebug-83-x86.so

找到正确的 Xdebug 版本后,您应该将必要的配置追加到您的 php.ini 文件中。例如,在 Apple Silicon Mac 上为 PHP 8.3 设置如下所示

zend_extension=/Applications/Herd.app/Contents/Resources/xdebug/xdebug-83-arm64.so
xdebug.mode=debug,develop
xdebug.start_with_request=yes
xdebug.start_upon_error=yes

保存对 php.ini 文件的更改后,您需要从菜单栏图标重启 Herd 的服务,或者在终端中运行以下命令

herd restart

有关可用的 Xdebug 设置的更多信息,请参阅 官方 Xdebug 文档