本文目录导读：
为PHP项目设置调试模式主要有以下几种方法,可根据项目和开发环境选择：
直接修改 php.ini 文件（全局设置）
找到并编辑 PHP 配置文件（通常位于 /etc/php/ 或 /usr/local/etc/php/）：
; 开启错误显示 display_errors = On display_startup_errors = On ; 设置错误报告级别（开发环境推荐） error_reporting = E_ALL ; 开启错误日志 log_errors = On error_log = /path/to/php-error.log ; 可选：设置错误处理方式 html_errors = On
重启 Web 服务器使配置生效：
# Apache sudo service apache2 restart # 或 sudo systemctl restart httpd # Nginx + PHP-FPM sudo systemctl restart php-fpm
在代码中动态设置（推荐）
在项目入口文件（如 index.php 或 config.php）开头添加：
<?php
// 开启所有错误报告
error_reporting(E_ALL);
ini_set('display_errors', 1);
ini_set('display_startup_errors', 1);
// 记录错误日志
ini_set('log_errors', 1);
ini_set('error_log', dirname(__FILE__) . '/error.log');
// 可选：设置时区
date_default_timezone_set('Asia/Shanghai');
?>
使用 .htaccess 文件（Apache 环境）
在项目根目录创建 .htaccess 文件（需启用 mod_rewrite）：
# 开启错误显示 php_flag display_errors on php_flag display_startup_errors on # 设置错误报告级别 php_value error_reporting E_ALL # 开启错误日志 php_flag log_errors on php_value error_log /path/to/error.log
使用 debug 库/工具
Xdebug（推荐用于调试）
# 安装 Xdebug pecl install xdebug # 或使用包管理器 sudo apt install php-xdebug # Ubuntu/Debian sudo yum install php-xdebug # CentOS/RHEL
在 php.ini 中添加配置：
zend_extension=xdebug.so xdebug.mode=debug xdebug.start_with_request=yes xdebug.client_host=127.0.0.1 xdebug.client_port=9000 xdebug.log=/tmp/xdebug.log
使用调试框架
- Laravel：
APP_DEBUG=true在.env文件中 - Symfony：
APP_DEBUG=1在.env文件中 - WordPress：在
wp-config.php中添加：define('WP_DEBUG', true); define('WP_DEBUG_LOG', true); define('WP_DEBUG_DISPLAY', true);
专为特定环境设置
创建环境配置文件,根据环境加载：
<?php
// config.php
function setDebugMode($environment) {
switch ($environment) {
case 'development':
error_reporting(E_ALL);
ini_set('display_errors', 1);
break;
case 'testing':
error_reporting(E_ALL & ~E_NOTICE & ~E_DEPRECATED);
ini_set('display_errors', 1);
break;
case 'production':
error_reporting(0);
ini_set('display_errors', 0);
break;
}
}
// 根据环境变量设置
$env = getenv('APP_ENV') ?: 'development';
setDebugMode($env);
?>
完整的调试配置示例
创建一个 debug.php 文件，在开发环境引入：
<?php
// debug.php - 完整的调试配置
class DebugConfig {
public static function enable() {
// 错误报告
error_reporting(E_ALL);
ini_set('display_errors', 1);
ini_set('display_startup_errors', 1);
// 记录详细信息
ini_set('log_errors', 1);
ini_set('error_log', __DIR__ . '/storage/logs/php-error.log');
ini_set('ignore_repeated_errors', 0);
// 设置内存限制（开发环境可适当调高）
ini_set('memory_limit', '256M');
ini_set('max_execution_time', 300);
// 开启输出缓冲并立即输出
ini_set('output_buffering', 'Off');
ini_set('implicit_flush', 1);
// JSON 调试辅助
if (!function_exists('dd')) {
function dd(...$vars) {
foreach ($vars as $var) {
echo '<pre>';
var_dump($var);
echo '</pre>';
}
die(1);
}
}
}
public static function disable() {
error_reporting(0);
ini_set('display_errors', 0);
}
}
// 使用
if (getenv('APP_DEBUG') === 'true') {
DebugConfig::enable();
}
?>
重要提醒
- 永远不要在生产环境开启调试模式！ 这可能会暴露敏感信息。
- 使用环境变量或配置文件来区分开发/生产环境。
- 对于生产环境,建议仅记录错误日志，不显示错误信息。
- 调试模式开启时,注意处理敏感信息（如数据库密码）的暴露风险。
选择适合你项目的方法,并根据实际需求调整配置级别。
