20 调试、测试与维护

整理 WP_DEBUG、日志、Query Monitor 思路、错误处理、计划任务和维护清单。

20 调试、测试与维护

本页关键词

WP_DEBUG error_log WP_Error cron maintenance

学习目标

代码使用提醒

本页代码适合用于学习和研究。复制到正式网站前,请先备份,并优先在测试环境验证。

涉及用户输入、后台保存、接口请求、删除操作和邮件发送时,要同时考虑权限、nonce、sanitize、validate 和 escape。

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 恢复账户时的临时应急操作。代码启用期间,知道触发网址的人可能重置指定账户的密码;成功后立即删除整段代码。

本页总结

调试维护的重点是日志、错误处理、计划任务和复测流程。任何修复都要以备份和可回滚为前提。