AJ-Captcha在PHP中运行慢或报“Allowed memory size exhausted”，根本原因是GD库逐像素处理滑动拼图导致内存陡增，尤其开启干扰图、禁用像素缓存或加载Xdebug时；需按Web/CLI/单脚本场景分别调优memory_limit，并配合禁用干扰、启用缓存等代码级优化。
AJ-Captcha 在 PHP 环境下运行慢或报 Allowed memory size exhausted，根本原因常是 GD 图像处理函数（如 imagecolorat、imagesetpixel）在生成滑动拼图时内存开销陡增——尤其开启像素级干扰或未启用缓存时。直接调高 memory_limit 是最快见效的临时手段，但必须配合具体场景选对方式，否则无效甚至引发新问题。
为什么 AJ-Captcha 特别吃内存？
它不是普通验证码：生成滑动拼图需逐像素读取/写入图像，GD 库底层会为每张图分配完整位图内存（比如 400×300 的 RGB 图约占用 360KB 内存），若同时生成多张干扰图+背景图+缺口图，再叠加循环采样逻辑，峰值内存很容易突破默认的 128M。
常见触发点包括：
- 使用
block_puzzle.is_cache_pixel = false（默认关闭像素缓存） - 启用了
block_puzzle.is_interfere = true（干扰图叠加） - 在 CLI 下跑测试脚本（如
php test/puzzle_test.php）却没改 CLI 的php.ini - PHP 同时加载了 Xdebug（内存开销翻倍）
调整 memory_limit 的三种实操路径
不能只改一个地方，要按执行环境区分：
立即学习“PHP免费学习笔记（深入）”；
-
Web 请求（如浏览器访问验证码接口）：修改 Web 服务加载的
php.ini（路径看phpinfo()中Loaded Configuration File），设memory_limit = 256M或512M，改完重启php-fpm或apache2 -
CLI 命令（如跑 test 或 composer install）：用
php --ini查 CLI 对应的php.ini，同样改memory_limit，保存后**必须重启终端**（CLI 配置不热加载） -
单脚本兜底（仅限调试）：在 AJ-Captcha 初始化前加
ini_set('memory_limit', '256M');，注意必须放在<?php后第一行，且确保memory_limit允许被覆盖（php.ini中不能设为PHP_INI_SYSTEM级别）
不改内存也能降内存的硬核操作
单纯加内存只是掩盖问题，AJ-Captcha 官方已给出明确优化开关：
- 强制开启像素缓存：
block_puzzle.is_cache_pixel = true（1.1.x+ 版本支持，能省掉 70%+ 像素遍历） - 关闭干扰图：
block_puzzle.is_interfere = false（视觉干扰减弱，但内存直降 40%） - 避免在开发环境启用 Xdebug：临时禁用
zend_extension=xdebug.so，或改用XDEBUG_MODE=off - 确认 GD 扩展已启用：
extension=gd，否则 fallback 到纯 PHP 实现，性能更差、内存更高
真正容易被忽略的是：AJ-Captcha 的 memory_limit 需求和你用的 PHP 模式强绑定——FPM、Apache module、CLI 各自读不同的 php.ini，改错文件等于白改；另外，Docker 或 MAMP 等集成环境常自带覆盖配置，务必用 phpinfo() 或 php -r "echo ini_get('memory_limit');" 实时验证当前值。
