PCOV扩展不显示是因为PHP CLI与Web服务器使用不同配置，需确认php.ini路径、pcov.so存在性及extension=pcov.so是否写入对应SAPI的ini文件，并重启FPM或Apache服务。
PCOV扩展安装后为什么php --ri pcov不显示？
常见原因是PHP CLI和Web服务器（如Apache/Nginx）使用的不是同一个PHP配置，PCOV只装在了其中一个SAPI里。比如用apt install php-pcov可能只启用了CLI，而FPM或Apache模块没加载。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 先确认当前环境：运行
which php和php -i | grep "Loaded Configuration File"，看CLI用的是哪个php.ini - 检查PCOV是否已编译进PHP：运行
php-config --extension-dir，然后去该目录下找pcov.so；若没有，需手动编译（PHP ≥ 7.4推荐源码安装） - 确保
extension=pcov.so写在正确的php.ini中——CLI和FPM通常各有一个独立ini文件，别只改了一个 - 重启对应服务：CLI无需重启，但FPM要
sudo systemctl restart php*-fpm，Apache要sudo systemctl restart apache2
启用PCOV后pcov\collect()返回false怎么办？
PCOV默认不自动收集数据，必须显式开启且满足执行上下文条件。返回false通常不是报错，而是“未就绪”状态。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 确认已设置
pcov.enabled=1和pcov.directory="/path/to/your/src"（注意路径必须存在、可读、且是源码根目录，不能是/var/www这种泛目录） -
pcov\collect()只能在脚本执行中途调用，且要求之前已触发过代码执行（比如已include了被测文件），否则无数据可收 - 别在
__autoload或__construct里直接调；稳妥做法是：先require测试目标文件 → 执行待测逻辑 → 再调pcov\collect() - 若仍返回
false，加一句var_dump(pcov\status());看输出的enabled和collected字段是否为true
生成覆盖率报告时pcov\report()结果为空数组
空数组 ≠ 没覆盖，而是PCOV没识别到任何已执行的源文件路径——根本原因通常是pcov.directory配置错误或文件未被实际执行。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
-
pcov.directory必须精确指向你的源码顶层目录（如/home/user/project/src），且所有被测PHP文件路径必须以该目录为前缀；若用相对路径或软链接，PCOV会跳过 - 检查被测代码是否真被执行：在关键函数开头加
echo "hit"; die;，确认流程走到那里 -
pcov\report()返回的是二维数组，结构为['/abs/path/file.php' => [...]]，如果路径不匹配，该文件条目直接不出现，不是填0，而是彻底消失 - 避免用
pcov\clear()清空后再报告——它会删掉所有已收集数据，除非你明确想重置
和Xdebug、PHPDBG共存时PCOV失效或报Cannot load Xdebug
PCOV与Xdebug互斥，二者不能同时启用；PHPDBG虽不冲突，但若已加载Xdebug，PCOV会因扩展初始化顺序问题被绕过。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 禁用Xdebug最彻底：注释掉
zend_extension=xdebug.so，或运行phpdismod xdebug（Ubuntu/Debian） - 不要试图用
ini_set('pcov.enabled', '1')动态开启——PCOV必须在PHP启动时加载，运行时设置无效 - 验证是否干净：执行
php -m | grep -E "(pcov|xdebug|phpdbg)"，确保只有pcov一行输出 - CI场景下建议用Docker多阶段构建：测试镜像只装PCOV，开发镜像装Xdebug，避免混用
PCOV轻量是真轻量，但轻量的前提是路径精准、环境隔离、时机可控。最容易被忽略的是pcov.directory必须与realpath()后的绝对路径完全一致——哪怕多一个/结尾，都会导致整个目录下所有文件不计入报告。
