如何在Docker Compose环境中启用WordPress调试模式

针对你遇到的问题，结合wp-config.php中define( 'WP_DEBUG', !!getenv_docker('WORDPRESS_DEBUG', '') );的配置，以下是正确的解决步骤：

• 修改docker-compose.yaml配置
  在WordPress服务的environment区块中添加：

  WORDPRESS_DEBUG: '1'
  

  （推荐用'1'而非'true'，PHP对数字字符串的布尔转换更稳定，可避免大小写或解析差异导致的问题）

• 重启容器加载新配置
  执行命令重启WordPress服务，确保环境变量生效：

  docker-compose up -d --force-recreate wordpress
  

为什么之前的配置没生效？ #

1. 未重启容器：环境变量修改后必须重启容器才能被WordPress读取
2. YAML解析问题：如果直接写WORDPRESS_DEBUG: true（不加引号），YAML会将其解析为布尔值，而Docker环境变量仅支持字符串类型，可能导致getenv_docker无法正确获取有效值
3. 缓存问题：部分情况下WordPress会缓存配置，强制重建容器可以彻底清除缓存

验证调试模式是否启用 #

可以通过以下方式确认：

• 在WordPress前端/后台查看是否显示调试警告（如未定义变量提示）
• 创建一个临时PHP文件（比如debug-check.php）放入容器的网站根目录，内容为：

  <?php var_dump(WP_DEBUG); ?>
  

  访问该文件，如果输出bool(true)则说明调试模式已成功启用

内容的提问来源于stack exchange，提问作者Josph