用途
wp-admin-tester 用于在本地 WordPress 开发环境中调试和测试 wp-admin 管理后台流程。它聚焦于 wp-admin 交互,所有测试均通过浏览器(Playwright)或带 Cookie 认证的直接页面请求完成。
主要能力
- 基于 Cookie 的认证登录 wp-admin
- 访问任意管理页面,检查 HTTP 状态码与内容
- 实时追踪 PHP 错误日志
- 添加临时 PHP 调试日志(error_log)
- 使用 Playwright 捕获 JavaScript 控制台错误与网络错误
- 在区块编辑器中创建文章并上传图片
- 通过媒体库上传图片
本地环境配置
- 管理后台 URL:https://wpdev.localhost/wp-admin
- 用户名:admin
- 密码:password
- PHP 错误日志路径:/Applications/MAMP/logs/php_error.log
- 测试图片:~/Downloads/IMG_0299.jpg(或用户指定的任何图片)
使用方式
认证使用 Cookie 方式:
curl -sk -c /tmp/wp-cookies.txt -b /tmp/wp-cookies.txt \
-d "log=admin&pwd=password&wp-submit=Log+In&redirect_to=%2Fwp-admin%2F&testcookie=1" \
"https://wpdev.localhost/wp-login.php"
访问管理页面并检查状态码:
curl -sk -b /tmp/wp-cookies.txt -o /dev/null -w "%{http_code}" "https://wpdev.localhost/wp-admin/options-general.php"
追踪 PHP 日志:
tail -f /Applications/MAMP/logs/php_error.log > /tmp/php-errors-session.log 2>&1 &
浏览器自动化需安装 Playwright:
npm ls playwright 2>/dev/null || npm install -D playwright
npx playwright install chromium
随后可运行临时的 Playwright 脚本(存放于 /tmp/)来捕获控制台错误、网络错误,并执行创建文章、上传图片等交互流程。
调试工作流
- 启动日志监控(清空旧记录并新建 tail)
- 如需要,添加 PHP 的 error_log() 或 JS 的 console.log() 调试代码
- 复现问题:UI/JS/交互流程用 Playwright;PHP 渲染/HTTP 状态用带 Cookie 的 curl
- 收集证据:检查 PHP 错误日志、控制台错误,以及 wp-content/debug.log(若启用 WP_DEBUG_LOG)
- 分析并修复,重新运行测试确认
- 清理:移除临时调试代码、删除临时脚本、停止后台 tail 进程
适用场景
- 本地 WordPress 开发环境中的 wp-admin 问题诊断
- 管理后台流程的回归测试
- 控制台错误与 PHP 错误的关联排查
- 区块编辑器与媒体库上传流程验证
限制
- 所有测试通过 wp-admin 完成,不使用 REST API 或应用密码
- 依赖本地环境与固定的 URL、凭据、日志路径
- Playwright 需单独安装 chromium
- 仅面向 wp-admin 交互,不覆盖前台或其他接口
补充的收费、价格、平台、效果等信息暂未提供。