ubuntu php配置如何调试

在 Ubuntu 上调试 PHP 配置和代码，通常可以从配置检查、日志查看、错误显示、调试工具几个方面入手。下面按实用场景给你一个完整指引。

一、确认 PHP 环境

1. 查看 PHP 版本

php -v

2. 查看 PHP 配置文件位置

php --ini

常见路径：

• /etc/php/8.x/cli/php.ini（命令行）
• /etc/php/8.x/fpm/php.ini（PHP-FPM，Web 用）
• /etc/php/8.x/apache2/php.ini（Apache 用）

二、开启 PHP 错误显示（调试关键）

1. 修改 php.ini

找到对应 php.ini，修改以下项：

display_errors = On
display_startup_errors = On
error_reporting = E_ALL
log_errors = On
error_log = /var/log/php_errors.log

2. 重启服务

• PHP-FPM：

sudo systemctl restart php8.x-fpm

• Apache：

sudo systemctl restart apache2

三、查看 PHP 错误日志

1. PHP 错误日志

tail -f /var/log/php_errors.log

2. Web 服务器日志

• Apache：

tail -f /var/log/apache2/error.log

• Nginx + PHP-FPM：

tail -f /var/log/nginx/error.log
tail -f /var/log/php8.x-fpm.log

四、临时在代码中开启调试（不修改 php.ini）

<?php
ini_set('display_errors', 1);
ini_set('display_startup_errors', 1);
error_reporting(E_ALL);

五、使用 phpinfo() 检查配置

<?php
phpinfo();

访问页面，可确认：

• 实际加载的 php.ini
• 扩展是否启用
• 配置项是否生效

六、命令行调试 PHP 脚本

php -l file.php      # 语法检查
php file.php         # 直接运行
php -d display_errors=1 file.php

七、使用 Xdebug（强烈推荐）

1. 安装 Xdebug

sudo apt install php-xdebug

2. 配置 Xdebug（示例 php.ini）

zend_extension=xdebug.so
xdebug.mode=debug
xdebug.start_with_request=yes
xdebug.client_host=127.0.0.1
xdebug.client_port=9003

3. 配合编辑器

• VS Code（PHP Debug 插件）
• PhpStorm

适合断点调试、变量查看、调用栈分析

八、常见问题排查清单

✅ PHP 不生效？

• 确认改的是 Web 用的 php.ini
• 重启 Web 服务

✅ 页面空白？

• 查看 error_log
• 开启 display_errors

✅ 扩展未加载？

php -m

如果你能告诉我：

• 用的是 Apache / Nginx
• PHP 版本
• 是 Web 调试还是 CLI 调试
• 具体报错信息

我可以直接给你针对性的配置方案。