Composer 的 scripts 是可复用、可组合、带上下文的命令封装，直接在 composer.json 的 "scripts" 中定义如 "serve": "php -S localhost:8000 -t public"，运行 composer serve 即可启动；支持环境变量、自动加载 autoload.php、固定工作目录、PATH 包含 vendor/bin，并可通过 @@ 占位符或 wrapper 脚本传递参数。
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）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “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 参数才能静默跑完。
