AJ-Captcha不提供PHP日志开关配置，其错误日志完全依赖PHP自身机制；需在php.ini中启用log_errors=On、设置error_log路径、配置error_reporting=E_ALL & ~E_DEPRECATED & ~E_STRICT，并确保目录权限正确。
AJ-Captcha 本身不直接提供 PHP 日志开关配置项，它的日志行为完全依赖于你如何配置 PHP 自身的错误日志机制。换句话说：AJ-Captcha 不管你记不记日志，它只抛错；记不记、往哪记、记什么级别，全靠 PHP 的 error_log、log_errors 和 error_reporting 控制。
PHP 错误日志没开，AJ-Captcha 报错就“消失”了
你调用 AJ-Captcha 的 PHP SDK（比如 fastknife/ajcaptcha）时如果出错——例如 GD 扩展未启用、图片路径不存在、缓存写入失败——它会触发 PHP trigger_error() 或抛出异常，但若 PHP 没开启日志记录，这些错误既不显示也不落盘。
常见现象：
- 滑动验证接口返回空响应或 500
-
test目录下示例跑不通，但无任何提示 - 查看 Nginx/Apache 错误日志也找不到线索
根本原因不是 AJ-Captcha 有问题，而是 PHP 错误被静默吞掉了。
必须改 php.ini 的三个关键配置
确保以下三项在你实际运行 AJ-Captcha 的 PHP 环境中生效（注意：CLI 和 Web（如 php-fpm）可能用不同 php.ini）：
-
log_errors = On -
error_log = /var/log/php_ajcaptcha.log（路径需存在且www-data或nginx用户可写） -
error_reporting = E_ALL & ~E_DEPRECATED & ~E_STRICT
✅ 做完后重启服务：sudo systemctl restart php-fpm（或 apache2）
⚠️ 容易踩的坑：
- 忘了检查 CLI 和 Web 使用的是同一个 php.ini（运行
php --ini和phpinfo()对比） -
error_log路径用了相对路径（必须用绝对路径） - 目录权限不对，日志文件创建失败（可用
touch /var/log/php_ajcaptcha.log && chown www-data:www-data /var/log/php_ajcaptcha.log测试）
开发调试时用 ini_set() 快速验证
如果你无法改 php.ini（如共享主机），在入口脚本（如 index.php 或 test/block_puzzle.php）最顶部加：
<?php ini_set('log_errors', '1');
ini_set('error_log', '/path/to/your/ajcaptcha_debug.log');
ini_set('error_reporting', E_ALL);
ini_set('display_errors', '0'); // 生产环境务必关掉
// 后续引入 AJ-Captcha 类或调用逻辑...
? 注意：
- 这种方式只对当前脚本生效
-
/path/to/your/目录必须已存在，且 Web 进程用户有写权限 - 若你用 Composer 自动加载，这段代码必须放在
require 'vendor/autoload.php'之前
AJ-Captcha 自身的日志输出点在哪？
AJ-Captcha 的 PHP 实现（fastknife/ajcaptcha）没有内置日志类，但以下位置容易出错，值得主动加日志观察：
- 图片生成失败时：
block_puzzle::createPuzzle()内部调用imagecolorat()前后可加error_log("puzzle start, width={$width}"); - 缓存写入失败：
CacheManager::set()返回 false 时，建议补一句error_log("cache set failed: {$key}"); - AES 解密失败（
aes-status: true时）：检查decrypt()是否收到空或损坏的坐标字符串
这些不是框架强制要求，但上线前手动加几行 error_log()，能快速定位是 GD 性能问题、缓存失效，还是前端传参格式错误。
AJ-Captcha 的日志“盲区”往往不在它自己，而在 PHP 底层配置是否真正生效。很多人卡在“为什么没报错”，其实只是 log_errors 还关着——先确认这一条通了，再查具体逻辑。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
