禁用Xdebug应优先使用运行时参数而非修改php.ini：CLI场景用php -d 'zend_extension='临时禁用，Composer可用--no-xdebug自动fallback，Debian/Ubuntu可phpdismod -s cli xdebug，因Xdebug加载本身即带来5–10%性能开销。
禁用或开启 Xdebug 完全可以不碰 php.ini —— 关键在于区分 CLI 和 Web SAPI，且优先用运行时参数覆盖，而不是改全局配置。
用 php -d 临时禁用 Xdebug（CLI 场景）
这是最轻量、最安全的禁用方式，尤其适合跑 composer、phpunit 或脚本时临时绕过 Xdebug。
-
php -d 'zend_extension=' your-script.php：直接清空所有 zend 扩展加载，Xdebug 必然不生效 - 更精准一点可只禁用 Xdebug：
php -d 'zend_extension=' -d 'xdebug.enable=0' composer install - 注意：
-d参数必须写在php命令后、脚本名前，顺序错就无效 - 该方式对
php-fpm或 Apache 模块无效，仅作用于当前 CLI 进程
用 composer --no-xdebug 自动跳过（Composer 专用）
现代 Composer（≥2.2）内置了该开关，它会尝试找一个不带 Xdebug 的 PHP CLI 环境执行，比手动加 -d 更省心。
- 执行
composer --no-xdebug install时，Composer 会检测php -m | grep xdebug，若发现已加载，就自动 fallback 到php -d 'zend_extension='方式 - 前提是系统里至少有一个 PHP CLI 可用；如果连这个都没有，它会报错
Could not find a PHP binary without Xdebug - 不是所有环境都支持 fallback（比如某些 Docker 镜像只装了一个 PHP），这时仍需配合
php -d使用
用 phpdismod 快速开关（Debian/Ubuntu 系发行版）
如果你用的是 apt 安装的 PHP（如 php8.2-cli、php8.2-fpm），phpdismod 是最接近“动态切换”的系统级方法。
立即学习“PHP免费学习笔记（深入）”；
- 禁用 CLI 的 Xdebug：
sudo phpdismod -s cli xdebug - 禁用 FPM 的 Xdebug：
sudo phpdismod -s fpm xdebug - 重新启用只需把
dismod换成enmod，无需重启服务（但 PHP-FPM 进程要 reload 才生效） - 本质是软链接管理：
/etc/php/8.2/cli/conf.d/20-xdebug.ini被移出目录，不是删文件，所以可逆 - CentOS/RHEL 系没有这个命令，得手动注释
xdebug.ini或改php.ini
为什么别急着改 php.ini？
直接编辑 php.ini 或注释 zend_extension 行看似简单，但容易踩坑：
- Web 和 CLI 可能共用同一份
php.ini，禁用后调试网页就彻底失效，得来回改 - 有些环境（如宝塔、Docker）的
php.ini实际被多层覆盖，你以为改了，其实没生效 -
zend_extension路径写错或扩展文件缺失时，PHP 启动直接失败，连错误日志都不输出 - 真正影响性能的是 Xdebug 加载本身，哪怕所有功能都关了（
xdebug.mode=off），只要扩展在内存里，就有约 5–10% 的基础开销
所以，优先用运行时控制，只在明确需要长期关闭（例如生产环境 CLI）时，才去动配置文件。动态切换的核心，其实是分清「谁在用」和「怎么用」——CLI 脚本、Composer、Web 请求，它们的加载路径和生效范围完全不同。
