Composer怎么配置scripts钩子_Composer脚本命令编写规范【核心】
Composer脚本命令编写规范：避开那些“静默失效”的坑 想把自动化脚本写进composer.json？这事儿看似简单，实则处处是“暗礁”。一个字母拼错，或者引号没加对，你的脚本就可能彻底“静默失效”——不是报错提醒你，而是直接当作不存在，悄无声息地罢工。 scripts 必须放在 compose
Composer脚本命令编写规范：避开那些“静默失效”的坑
想把自动化脚本写进composer.json？这事儿看似简单，实则处处是“暗礁”。一个字母拼错，或者引号没加对，你的脚本就可能彻底“静默失效”——不是报错提醒你，而是直接当作不存在，悄无声息地罢工。
scripts 必须放在 composer.json 顶层，不能嵌套
首先得明确一点：scripts可不是什么config或extra的“下属部门”。它和name、require一样，是根级别的“合伙人”。放错了位置，一切努力都白费。
下面这两种常见的错误写法，你中招了吗？
"extra": { "scripts": { "dev:serve": "php -S localhost:8000" } }→ 脚本不会生效。"config": { "scripts": { ... } }→ 配置会被完全忽略。
正确的结构有且只有一种，那就是让它“站对位置”：
{
"name": "my/app",
"require": { ... },
"scripts": {
"dev:serve": "php -S localhost:8000",
"post-install-cmd": ["@php scripts/init.php"]
}
}
另外，JSON的语法规则必须遵守：键名和字符串值都必须用双引号包裹。如果把"dev:serve"写成dev:serve（没有引号）或者用单引号，解析器就会直接“罢工”。
钩子名别写错：post-install-cmd 和 post-update-cmd 触发时机完全不同
这两个名字长得像，但触发逻辑天差地别，混用它们可能会让你的CI/CD流程变得不可靠：
post-install-cmd：只在vendor/目录为空时运行（通常是首次执行composer install）。之后再次运行install，它就不会被触发了。post-update-cmd：每次执行composer update或composer install --with-dependencies时，它都会执行。
举个例子，如果你在CI环境中把清理缓存的操作写在了post-install-cmd里，那么当依赖更新后，旧的缓存就可能残留下来，导致构建行为不一致。更稳妥的做法是把这类清理操作统一放到post-update-cmd中，或者在必要时手动执行composer run-script post-update-cmd来补救。
命令怎么写：字符串 vs 数组 vs PHP 回调
定义脚本命令有三种方式，用错了场景，路径、环境、参数问题就会接踵而至：
- 单条shell命令用字符串：
"test": "vendor/bin/phpunit"。这里有个细节：别直接写phpunit，因为系统的PATH环境变量不一定包含全局命令。 - 多条命令优先用数组：
"pre-start": ["@php -v", "npm run build"]。这样做可以避免shell解析的差异，比如在Windows系统下，&&操作符可能不被识别。 - PHP回调要确保自动加载就绪：
"build:config": ["App\Scripts\ConfigBuilder::run"]。这里引用的类必须已经通过autoload配置注册，否则会直接报错：Class 'App\Scripts\ConfigBuilder' not found。
另外，在数组写法中，以@开头的项（比如@php）会被Composer递归解析，它会自动使用当前项目绑定的PHP版本，这比硬编码php命令要安全得多。
传参和调试：-- 是分隔符，$argv 不可靠
给脚本传递参数时，--这个分隔符至关重要。Composer本身不解析参数，--之后的内容才会原封不动地传递给底层命令。漏掉它，参数就“丢在半路”了：
- ✅ 正确写法：
composer test:unit -- --filter=testLogin - ❌ 错误写法：
composer test:unit --filter=testLogin→phpunit根本收不到--filter参数。
在PHP脚本内部，也别依赖$argv来获取参数，因为它的索引很容易发生偏移。更推荐的做法是读取$_SERVER['COMPOSER_ARGS']（Composer 4.0及以上版本提供），它直接就是--后面的参数数组。
调试脚本时，可以加上-v参数来查看Composer实际执行的命令。或者在脚本里临时插入echo语句来打点，比如：
"post-install-cmd": ["echo '>> vendor built'", "@php scripts/check-env.php"]
最后，还有两个容易被忽略的“环境陷阱”：Composer执行脚本时，当前工作目录确实是项目根目录，但$PATH环境变量里并不包含vendor/bin目录，同时.env文件也不会被自动加载——这些环境问题，都需要在你的脚本里自行处理妥当。
正软商城本月促销专区，汇集办公、设计、安全、影音、系统工具及AI软件等正版软件优惠活动，提供限时折扣、特价授权和优惠购买信息，活动库存及价格以页面实时展示为准。
正软商城装机必备专区，精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件，帮助用户快速完成新电脑软件配置。
正软商城Windows软件专区，汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件，提供软件介绍、系统要求、正版授权及购买下载服务。
正软商城macOS软件专区，精选适用于Mac电脑的办公、设计、影音、效率、开发和系统工具，提供软件功能介绍、macOS兼容版本、正版授权及购买下载服务。
正软商城iOS软件专区，精选适用于iPhone和iPad的办公、学习、影音、设计、效率及AI应用，提供功能介绍、适用设备、系统要求和正版获取方式等信息。
正软商城AI软件专区，汇集AI写作、AI绘画、AI视频、AI办公、AI编程、AI翻译、智能客服和数据分析等人工智能工具，提供功能介绍、适用平台、收费方式及正版购买信息。
正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法，同时介绍常用PDF软件和工具的使用技巧。
赤友清理大师是一款为 Mac 设计的智能清理优化工具，可精准扫描垃圾、大文件、重复文件等，释放磁盘空间。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。
Mountain Duck 是一款能将多个网盘挂载到本地的工具，像本地磁盘一样使用网盘。清理链路的完整性会更好一些，做应用卸载、残留处理和空间整理时，通常能少走很多手动排查步骤。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
Wise Folder Hider Pro 是一款专业级文件和文件夹隐藏加密软件，为私密数据添加多重保护。高频操作更强调就近处理，浏览、整理和跨目录移动文件时，来回切换和重复点击都会少很多。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。
Mountain Duck 是一款能将多个网盘挂载到本地的工具，像本地磁盘一样使用网盘。清理链路的完整性会更好一些，做应用卸载、残留处理和空间整理时，通常能少走很多手动排查步骤。
