1. wp-config 调试配置
调试
<?php
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
正式站不建议把错误直接显示给访客。
2. 写入调试日志
调试
<?php
error_log( 'Contact form handler started.' );
$data = array( 'name' => 'Test', 'status' => 'ok' );
error_log( print_r( $data, true ) );
临时排查可用 error_log,修复后应清理过多日志。
3. 处理 WP_Error
稳定
<?php
$response = wp_remote_get( 'https://example.com/api' );
if ( is_wp_error( $response ) ) {
error_log( $response->get_error_message() );
return;
}
$body = wp_remote_retrieve_body( $response );
调用接口、插入数据、上传文件时都可能返回 WP_Error。
4. 注册计划任务
维护
<?php
function mysite_schedule_daily_task() {
if ( ! wp_next_scheduled( 'mysite_daily_cleanup' ) ) {
wp_schedule_event( time(), 'daily', 'mysite_daily_cleanup' );
}
}
add_action( 'wp', 'mysite_schedule_daily_task' );
function mysite_daily_cleanup_callback() {
// 每日清理逻辑。
}
add_action( 'mysite_daily_cleanup', 'mysite_daily_cleanup_callback' );
WP-Cron 依赖访问触发,不等同于系统 cron。
5. 停用插件时清理计划任务
维护
<?php
function mysite_clear_scheduled_tasks() {
$timestamp = wp_next_scheduled( 'mysite_daily_cleanup' );
if ( $timestamp ) {
wp_unschedule_event( $timestamp, 'mysite_daily_cleanup' );
}
}
register_deactivation_hook( __FILE__, 'mysite_clear_scheduled_tasks' );
注册了计划任务,就要考虑停用时清理。
6. 维护模式短路输出
维护
<?php
function mysite_simple_maintenance_mode() {
if ( current_user_can( 'manage_options' ) ) {
return;
}
if ( get_option( 'mysite_maintenance_mode' ) ) {
wp_die( '网站维护中,请稍后访问。', 'Maintenance', array( 'response' => 503 ) );
}
}
add_action( 'template_redirect', 'mysite_simple_maintenance_mode' );
维护模式要允许管理员访问,且返回合适状态码。
7. 基础维护检查清单代码注释
维护
<?php
/**
* 每次更新前检查:
* 1. 备份数据库和文件
* 2. 记录当前 WordPress / 主题 / 插件版本
* 3. 在测试环境更新
* 4. 测试首页、表单、购物车、登录、搜索
* 5. 查看 debug.log 是否有新错误
*/
把维护流程写进项目文档,比只靠记忆更可靠。
8. 紧急重置管理员密码(简易临时方案)
紧急维护
<?php
/**
* 临时重置 WordPress 管理员密码
*
* 使用方法:
* 1. 先备份当前主题的 functions.php。
* 2. 修改下面的管理员用户名和新密码。
* 3. 将本段代码临时添加到当前主题的 functions.php。
* 4. 访问:https://你的域名/?reset_admin=1
* 5. 页面提示成功后,立即删除本段代码并保存 functions.php。
* 6. 使用新密码登录 WordPress 后台。
*
* 安全提醒:
* - 仅在紧急情况下短暂使用。
* - 代码启用期间,知道触发网址的人可能重置指定账户的密码。
* - 成功后立即删除,不要长期保留。
* - 不要将填写真实密码的版本提交到 GitHub。
*/
add_action( 'init', function () {
// 修改为需要重置的管理员用户名。
$username = 'admin';
// 修改为新的强密码,建议至少 16 位。
$new_password = 'YourNewPassword123!';
// 只有访问 ?reset_admin=1 时才执行。
if ( ! isset( $_GET['reset_admin'] ) || '1' !== $_GET['reset_admin'] ) {
return;
}
// 查找用户,并确认具有管理员权限。
$user = get_user_by( 'login', $username );
if ( ! $user || ! user_can( $user, 'manage_options' ) ) {
wp_die( '管理员账号不存在或权限不足。' );
}
// 使用 WordPress 原生函数重置密码。
wp_set_password( $new_password, $user->ID );
// 结束本次请求,提示立即删除临时代码。
wp_die( '密码重置成功!请立即删除 functions.php 中的这段临时代码。' );
} );
适用于无法通过主机面板或 WP-CLI 恢复账户时的临时应急操作。代码启用期间,知道触发网址的人可能重置指定账户的密码;成功后立即删除整段代码。