在 composer.json 的 require-dev 中锁定 PHPUnit 版本需使用精确版本号(如 "9.6.13")或连字符范围(如 "9.6.13 - 9.6.13"),避免 ^ 或 ~;须确认 PHP 版本兼容性,并通过 composer.lock 和 phpunit --version 验证锁定效果。

在 composer.json 的 require-dev 中锁定 PHPUnit 版本,关键在于使用精确版本号(如 "9.6.13")或带连字符的范围(如 "9.6.13 - 9.6.13"),避免使用波浪线(~)或插入符(^)这类允许升级的约束。
直接写死具体版本号
这是最简单、最可靠的锁定方式。Composer 会严格安装指定版本,不会自动升级:
- 打开
composer.json - 在
require-dev中添加:"phpunit/phpunit": "9.6.13" - 运行
composer update phpunit/phpunit或composer install
该方式适用于 CI 环境、团队协作或需要长期稳定测试行为的项目。
用连字符范围明确限定单个版本
等价于“只允许这个版本”,语义更清晰,且能防止意外写错成 ^:
立即学习“PHP免费学习笔记(深入)”;
免费 盛世企业网站管理系统(SnSee)系统完全免费使用,无任何功能模块使用限制,在使用过程中如遇到相关问题可以去官方论坛参与讨论。开源 系统Web代码完全开源,在您使用过程中可以根据自已实际情况加以调整或修改,完全可以满足您的需求。强大且灵活 独创的多语言功能,可以直接在后台自由设定语言版本,其语言版本不限数量,可根据自已需要进行任意设置;系统各模块可在后台自由设置及开启;强大且适用的后台管理支
- 写法示例:
"phpunit/phpunit": "9.6.13 - 9.6.13" - Composer 解析为“必须是 9.6.13,不能高也不能低”
- 比纯字符串更显式表达“锁定”意图,适合强调版本稳定性要求的场景
注意 PHP 版本兼容性
PHPUnit 版本和 PHP 版本强绑定。锁定前请确认:
- 你当前的 PHP 版本(如
php -v) - 目标 PHPUnit 版本的官方支持列表(参考 phpunit.de/supported-versions.html)
- 例如:PHP 8.2 推荐用 PHPUnit 9.6.x 或 10.x;PHP 7.4 只能用 PHPUnit 9.5.x 或更早
若版本不匹配,composer install 会报错,提示无满足条件的可用版本。
验证是否真正锁定
执行后检查两个地方:
-
composer.lock中phpunit/phpunit的version字段是否为你指定的精确值 -
vendor/autoload.php加载后运行phpunit --version,输出是否一致 - 尝试运行
composer update phpunit/phpunit—— 若没更新,说明已锁定成功
不复杂但容易忽略。










