用于调试的示例 wp-config.php - PHP

wp-config.php 是 WordPress 的核心配置文件，包含了数据库连接信息、用户认证密钥、文件存储路径等重要的配置信息。本文将提供一份用于调试的示例 wp-config.php 文件，旨在帮助程序员快速排查 WordPress 网站的问题。

示例代码

<?php
/**
 * WordPress 的核心配置文件。
 *
 * 本文件包含以下配置选项：MySQL 设置、数据库表名前缀、密钥、
 * WordPress 语言设定以及 ABSPATH。如需更多信息，请访问我们的
 * Codex
 * @link https://codex.wordpress.org/zh-cn:%E5%88%9B%E5%BB%BA%E4%B8%80%E4%B8%AA%E6%96%B0%E7%BD%91%E7%AB%99
 *
 * @package WordPress
 */

use Monolog\Logger;
use Monolog\Handler\StreamHandler;

// 开启调试模式
define( 'WP_DEBUG', true );

// 将错误日志写入文件
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
ini_set( 'log_errors', 'On' );
ini_set( 'error_log', '/var/log/mywordpress/error_log' );

// 打印所有 PHP 错误信息
error_reporting( E_ALL );
ini_set( 'display_errors', 'On' );

// 配置数据库连接字符串和前缀
define( 'DB_NAME', 'example_db' );
define( 'DB_USER', 'database_user' );
define( 'DB_PASSWORD', 'database_password' );
define( 'DB_HOST', 'localhost' );
define( 'DB_CHARSET', 'utf8mb4' );
define( 'DB_COLLATE', '' );
$table_prefix = 'wp_';

// 设置认证密钥
define( 'AUTH_KEY', 'put your unique phrase here' );
define( 'SECURE_AUTH_KEY', 'put your unique phrase here' );
define( 'LOGGED_IN_KEY', 'put your unique phrase here' );
define( 'NONCE_KEY', 'put your unique phrase here' );
define( 'AUTH_SALT', 'put your unique phrase here' );
define( 'SECURE_AUTH_SALT', 'put your unique phrase here' );
define( 'LOGGED_IN_SALT', 'put your unique phrase here' );
define( 'NONCE_SALT', 'put your unique phrase here' );

// 定义 WordPress 目录路径和 URL
define( 'WP_HOME', 'http://example.com' );
define( 'WP_SITEURL', 'http://example.com/wp' );
define( 'WP_CONTENT_DIR', __DIR__ . '/wp-content' );
define( 'WP_CONTENT_URL', WP_HOME . '/wp-content' );
define( 'WP_PLUGIN_DIR', __DIR__ . '/wp-content/plugins' );
define( 'WP_PLUGIN_URL', WP_HOME . '/wp-content/plugins' );
define( 'WP_DEBUG_LOG', __DIR__ . '/wp-content/debug.log' );

// 定义 ABSPATH
if ( ! defined( 'ABSPATH' ) ) {
	define( 'ABSPATH', __DIR__ . '/' );
}

// 加载 Composer 依赖
require_once ABSPATH . 'vendor/autoload.php';

// 配置 Monolog 日志输出
$log = new Logger( 'mywordpress' );
$log->pushHandler( new StreamHandler( '/var/log/mywordpress/error.log', Logger::ERROR ) );
$log->pushHandler( new StreamHandler( '/var/log/mywordpress/info.log', Logger::INFO ) );

// 定义 Monolog 日志记录器
function mywordpress_logger( $message ) {
	global $log;
	$log->debug( $message );
}

// 定义自定义错误处理函数
function mywordpress_error_handler( $errno, $errstr, $errfile, $errline ) {
	mywordpress_logger( "Error: [$errno] $errstr - $errfile:$errline" );
}

// 将错误处理函数注册到 PHP 中
set_error_handler( 'mywordpress_error_handler' );

// 启用 WordPress
require_once ABSPATH . 'wp-settings.php';

解释说明

开启调试模式

将常量 WP_DEBUG 设置为 true 开启 WordPress 的调试模式，会输出所有的错误和警告信息。

define( 'WP_DEBUG', true );

将错误日志写入文件

将常量 WP_DEBUG_LOG 设置为 true，将错误信息写入 debug.log 文件中。

define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
ini_set( 'log_errors', 'On' );
ini_set( 'error_log', __DIR__ . '/wp-content/debug.log' );

打印所有 PHP 错误信息

将错误报告的级别设置为 E_ALL，并将 display_errors 设置为 On。

error_reporting( E_ALL );
ini_set( 'display_errors', 'On' );

配置数据库连接字符串和前缀

将相关配置信息放置在 wp-config.php 文件中。

define( 'DB_NAME', 'example_db' );
define( 'DB_USER', 'database_user' );
define( 'DB_PASSWORD', 'database_password' );
define( 'DB_HOST', 'localhost' );
define( 'DB_CHARSET', 'utf8mb4' );
define( 'DB_COLLATE', '' );
$table_prefix = 'wp_';

设置认证密钥

将以下常量替换成自己的唯一密钥。

define( 'AUTH_KEY', 'put your unique phrase here' );
define( 'SECURE_AUTH_KEY', 'put your unique phrase here' );
define( 'LOGGED_IN_KEY', 'put your unique phrase here' );
define( 'NONCE_KEY', 'put your unique phrase here' );
define( 'AUTH_SALT', 'put your unique phrase here' );
define( 'SECURE_AUTH_SALT', 'put your unique phrase here' );
define( 'LOGGED_IN_SALT', 'put your unique phrase here' );
define( 'NONCE_SALT', 'put your unique phrase here' );

定义 WordPress 目录路径和 URL

将 WordPress 目录路径和 URL 相关信息放置在 wp-config.php 文件中。

define( 'WP_HOME', 'http://example.com' );
define( 'WP_SITEURL', 'http://example.com/wp' );
define( 'WP_CONTENT_DIR', __DIR__ . '/wp-content' );
define( 'WP_CONTENT_URL', WP_HOME . '/wp-content' );
define( 'WP_PLUGIN_DIR', __DIR__ . '/wp-content/plugins' );
define( 'WP_PLUGIN_URL', WP_HOME . '/wp-content/plugins' );
define( 'WP_DEBUG_LOG', __DIR__ . '/wp-content/debug.log' );

加载 Composer 依赖

将 autoload.php 文件导入 wp-config.php 文件中。

require_once ABSPATH . 'vendor/autoload.php';

配置 Monolog 日志输出

使用 Monolog 来管理 WordPress 的日志记录。

// 配置 Monolog 日志输出
$log = new Logger( 'mywordpress' );
$log->pushHandler( new StreamHandler( '/var/log/mywordpress/error.log', Logger::ERROR ) );
$log->pushHandler( new StreamHandler( '/var/log/mywordpress/info.log', Logger::INFO ) );

定义 Monolog 日志记录器

定义一个 mywordpress_logger 函数来输出日志信息。

function mywordpress_logger( $message ) {
	global $log;
	$log->debug( $message );
}

定义自定义错误处理函数

定义一个 mywordpress_error_handler 函数来处理 PHP 错误信息，并通过 mywordpress_logger 函数输出错误日志。

function mywordpress_error_handler( $errno, $errstr, $errfile, $errline ) {
	mywordpress_logger( "Error: [$errno] $errstr - $errfile:$errline" );
}

将错误处理函数注册到 PHP 中

将 mywordpress_error_handler 函数注册到 PHP 的错误处理中，用来处理 WordPress 中的错误信息。

set_error_handler( 'mywordpress_error_handler' );