@php 使用 Composer 当前的 PHP 解释器确保环境一致,php 调用系统默认 PHP 可能导致版本差异,推荐优先使用 @php 避免多版本冲突。

在 Composer 的 scripts 配置中,@php 和 php 看似相似,但作用方式不同,关键在于执行上下文和路径解析。
1. php:调用系统全局的 PHP 可执行文件
php 直接调用操作系统环境中配置的 PHP 命令,也就是你在终端输入 php 时所使用的那个可执行程序。它依赖于系统的 PATH 环境变量。
例如:
这条命令会使用系统默认的 PHP 来执行脚本。如果系统中有多个 PHP 版本,可能不会使用你期望的那个,尤其是在开发环境与部署环境不一致时容易出问题。
立即学习“PHP免费学习笔记(深入)”;
2. @php:由 Composer 解析并代理执行
@php 是 Composer 提供的一个特殊语法,表示“使用当前运行 Composer 的 PHP 解释器”来执行后面的命令。它不是直接交给 shell 执行,而是由 Composer 拦截并替换为实际的 PHP 路径。
例如:
"scripts": { "test": "@php ./tests/run.php" }Composer 会自动将 @php 替换为启动 Composer 时所使用的 PHP 二进制路径,比如 /usr/bin/php 或 C:\xampp\php\php.exe,从而保证使用的是同一个 PHP 环境。
这意味着:
- 如果你用 PHP 8.1 运行
composer install,那么@php就会使用 PHP 8.1 执行脚本。 - 即使系统
PATH中指向的是 PHP 7.4,@php依然使用 8.1,避免版本错乱。
实际差异示例
假设你的系统默认 PHP 是 7.4,但你是通过 PHP 8.1 执行 Composer:
composer run test对比两种写法:
-
php -r 'echo PHP_VERSION;'→ 输出可能是 7.4(系统默认) -
@php -r 'echo PHP_VERSION;'→ 输出是 8.1(Composer 使用的 PHP)
这种差异在多 PHP 版本环境(如 macOS + brew、Docker、CI/CD)中尤其重要。
推荐使用场景
- 用 @php:确保脚本与 Composer 使用相同的 PHP 环境,适合大多数项目脚本(如测试、生成缓存、迁移等)。
- 用 php:仅当你明确需要系统默认 PHP,或在非 Composer 上下文中运行命令时。
基本上就这些。简单记:@php 更安全,更一致,推荐优先使用。











