觉得每次敲长串命令太繁琐？Composer自定义scripts别名让你效率翻倍-composer-PHP中文网

composer 的 scripts 是可复用、可组合、带上下文的命令封装，直接在 composer.json 的 "scripts" 中定义如 "serve": "php -s localhost:8000 -t public"，运行 composer serve 即可启动；支持环境变量、自动加载 autoload.php、固定工作目录、path 包含 vendor/bin，并可通过 @@ 占位符或 wrapper 脚本传递参数。

觉得每次敲长串命令太繁琐？composer自定义scripts别名让你效率翻倍

Composer 的 scripts 不是快捷方式，而是可复用、可组合、带上下文的命令封装 —— 直接改 composer.json 就生效，不用装插件、不依赖 shell 别名。

怎么在 composer.json 里加一个 dev-server 启动脚本

你不需要每次输 php -S localhost:8000 -t public，更不用记端口或目录。直接在 composer.json 的 "scripts" 段里加一行：

"scripts": {
  "serve": "php -S localhost:8000 -t public"
}

之后运行 composer serve 就能启动。注意三点：

serve 是自定义命令名，不和内置命令冲突（如 install、dump-autoload）即可
命令字符串里支持环境变量，比如 "serve": "php -S $HOST:$PORT -t public"，再配合 export HOST=127.0.0.1 PORT=8080 使用
如果命令含空格或重定向，建议用单引号包裹整个字符串（JSON 允许），避免 JSON 解析失败

为什么 run-script 比直接写 shell 别名更可靠

Shell 别名只在当前终端有效，换项目、换机器就得重新配；而 composer.json 是项目级配置，composer run-script 还能自动加载项目根目录下的 vendor/autoload.php —— 这意味着你可以直接调用项目里的 PHP 类。

比如这个脚本：

"scripts": {
  "check-env": "php -r "require 'vendor/autoload.php'; echo (new App\EnvChecker())->isValid() ? 'OK' : 'FAIL';""
}

它不是简单执行系统命令，而是在项目上下文中跑 PHP 逻辑。常见错误是忘了转义双引号，导致 JSON 格式损坏，报错 JSON decode error。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

scripts 执行时的当前工作目录和 PATH 行为

Composer 运行 script 时，当前目录始终是 composer.json 所在目录，不是你执行 composer 命令时所在的子目录。这点容易踩坑 —— 比如你在 src/ 下执行 composer test，但脚本里写的 phpunit tests/ 依然从项目根开始找 tests/。

PATH 环境变量默认包含 vendor/bin/，所以你可以直接写 "test": "phpunit"，不用写成 ./vendor/bin/phpunit。但要注意：

如果本地装了全局 phpunit，可能版本不匹配，建议显式指定路径或加 --no-scripts 排查
Windows 用户需注意：CMD 不支持单引号，脚本中含单引号会失败，统一用双引号 + 反斜杠转义
script 中调用的二进制文件必须在 PATH 或写绝对路径，Composer 不会自动补全 vendor/bin 到所有命令

如何让 scripts 支持参数传递（比如传测试目录）

Composer 原生不支持 composer test --filter=FooTest 这种透传，但有绕过方案：

用 @@ 占位符：定义 "test": "phpunit @@ "，然后执行 composer test -- --filter=FooTest（注意两个 --）
用环境变量临时覆盖：运行前设 TEST_FILTER=FooTest，脚本里读 getenv('TEST_FILTER')
写个 wrapper PHP 脚本，比如 bin/run-test.php，在 script 里调用它，由 PHP 解析 $argv 更灵活

别指望 @@ 能处理复杂参数，它只是简单字符串替换，遇到空格、引号容易断裂 —— 真要传参，优先走 wrapper 脚本。

最常被忽略的是：scripts 里的命令不会自动继承父进程的 stdin/stdout 配置。比如你写了 "cs-fix": "php-cs-fixer fix"，但它卡住不动，大概率是因为 php-cs-fixer 默认交互式确认，得加 --no-interaction 参数才能静默跑完。