ubuntu php配置怎样调试

在 Ubuntu 上调试 PHP 配置和代码，常见有配置检查、错误日志、断点调试、运行参数几种方式。下面按使用场景给你一套实用方法。

一、确认 PHP 环境与配置

1. 查看 PHP 版本

php -v

2. 查看当前使用的 php.ini

php --ini

或

php -i | grep "Loaded Configuration File"

3. 检查 PHP 配置

php -i

或导出为文件：

php -i > phpinfo.txt

二、开启 PHP 错误显示（调试配置）

编辑 php.ini（路径通常在）：

• CLI: /etc/php/8.x/cli/php.ini
• Apache: /etc/php/8.x/apache2/php.ini
• Nginx + PHP-FPM: /etc/php/8.x/fpm/php.ini

修改以下配置：

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

修改后重启服务：

# Apache
sudo systemctl restart apache2

# PHP-FPM
sudo systemctl restart php8.x-fpm

三、查看 PHP 错误日志

sudo tail -f /var/log/php_errors.log

如果是 Web 环境，也可看：

sudo tail -f /var/log/apache2/error.log
# 或
sudo tail -f /var/log/nginx/error.log

四、使用 phpinfo() 调试配置

新建测试文件：

<?php
phpinfo();

访问页面，可看到：

• 实际加载的 php.ini
• 已启用模块
• 配置项当前值

五、命令行调试 PHP 脚本

1. 直接运行并查看错误

php -d display_errors=1 script.php

2. 语法检查

php -l script.php

六、使用 Xdebug 断点调试（推荐）

1. 安装 Xdebug

sudo apt install php-xdebug

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

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

3. 配合 IDE

• VS Code（PHP Debug 插件）
• PhpStorm

浏览器访问时即可断点调试。

七、常见问题排查

• 配置不生效：确认改的是正确的 php.ini（CLI / FPM 不同）
• 页面空白：开启 display_errors
• 权限问题：日志文件需 PHP 进程可写

如果你能告诉我：

• 用的是 Apache / Nginx
• PHP 版本
• 是 Web 调试还是 CLI 脚本

我可以给你更精准的配置示例。