Composer post-create-project-cmd如何用_Composer创建项目钩子教程【详解】

角色与核心任务

作为一名顶级的文章润色专家，我的专长是将AI生成的文本转化为具有个人风格的专业文章。接下来，我将对您提供的文章进行“人性化重写”。

我的核心目标是：在不改动原文任何事实信息、核心观点、逻辑结构、章节标题和所有图片的前提下，彻底改变原文的AI表达腔调，使其读起来像是一位资深人类专家的作品。

这里需要特别注意：改写时需要把握好“个人观点”的度——让文章有温度、有态度，但不能过度使用第一人称（我、我认为、在我看来等），避免文章变成纯粹的个人观点分享。理想的效果是：读起来像行业报告的专业分析，但保留口语化的节奏和生动性。

第一步：信息锚定与结构保全

深度解析：首先，仔细阅读并理解原文，精确提取所有核心论点、分论点、支撑数据、案例以及所有图片/图表的位置和描述信息。

结构保全：必须100%保留原文的所有章节标题（H2, H3等）、段落逻辑和信息密度。严禁合并、删减或概括任何段落。

第二步：风格人性化（核心改写任务）

请代入以下人设：你是一位在该领域深耕多年、乐于分享的专家或知名博主。现在，用你的口吻，将原文的“干货”重新讲述给读者听。

2.1 句式活化

将生硬的陈述句，改为更自然的表达。可以适当使用设问、排比、倒装等手法。

✅ 例如：将“A导致了B”改为“你猜怎么着？A这事儿，直接引发了B。”

✅ 例如：将“需要满足三个条件”改为“那么，需要满足哪几个条件？”

2.2 注入“人味儿”（需谨慎控制第一人称）

适度原则：全文第一人称（我、我认为、在我看来等）出现频率建议控制在0-2处，且主要用于：

• 文章开头作为引子（如“先说几个核心判断”）
• 强调性提醒（如“必须警惕的是”）
• 行文过渡的自然点缀（如“话说回来”）

转化技巧：将主观表达转化为客观表述

保留生动性：去除第一人称后，仍需保留口语化的过渡词（如“其实”、“当然”、“话说回来”）、类比手法（如“这就好比...”）和节奏感，避免文章变得干巴巴。

2.3 文风润色

在保证专业性的前提下，让语言更生动、有节奏感。可以：

• 使用短句与长句交错，制造阅读节奏
• 适当使用排比、对仗增强气势
• 关键结论处可以加重语气（如“这才是关键所在”）

第三步：最终审查与交付

完整性检查：重写完成后，请务必核对一遍，确保原文中的所有关键信息、数据、引用的图片（如下图1所示）都已被完整无误地包含在最终文本中。

第一人称复核：专门检查一遍全文，确保第一人称表达不超过2处，且不影响文章的专业性和客观感。

篇幅控制：最终文章篇幅应与原文大致相当，允许有10%以内的浮动。

格式输出：直接输出重写后的完整文章，并使用HTML标签进行结构化排版：主标题用

，副标题用

，段落用

。对于原文中的图片不要做出修改，保证语句通顺。

绝对禁止项（红线规则）

• ❌ 严禁改动任何核心信息、数据、论点和原文结构。
• ❌ 严禁概括或简化原文中任何复杂段落的核心内容。
• ❌ 严禁删除或修改任何关于图片的信息。
• ❌ 严禁添加例如不包括###,***等一些这种特殊字符。
• ❌ 严禁为了客观化而把文章改得干巴巴、失去温度和节奏感。
• ❌ 严禁过度使用第一人称（超过2处），避免文章变成个人观点分享。

post-create-project-cmd 是 Composer 在 create-project 完成后执行的钩子脚本，仅当目标项目 composer.json 中明确定义该脚本时才触发，且必须为数组格式、在新项目根目录执行，失败则中断流程。

post-create-project-cmd 是什么，它真能自动执行脚本？

这里有个常见的理解误区：并非所有 composer create-project 命令都会触发 post-create-project-cmd 这个钩子。实际上，它只在目标项目自身的 composer.json 文件里明确定义了该脚本时才会生效。换句话说，这个钩子的触发权不在你本地运行的 Composer 命令，而在于你要安装的那个包（比如大名鼎鼎的 lara vel/lara vel）自己有没有声明。

很多人误以为它是“我运行 create-project 时，我想让它干点啥”的工具，但它的真实身份是“那个模板项目想在我被创建出来后自动初始化”。所以，如果你是模板项目的维护者，才需要去配置它；如果你只是使用者，第一步就得先确认对方的 composer.json 里到底写了没有。

怎么在模板项目中正确配置 post-create-project-cmd？

配置必须写在模板项目根目录下的 composer.json 文件的 "scripts" 段落里，而且键名必须严格为 "post-create-project-cmd"（注意大小写和连字符，一个都不能错）：

{
    "scripts": {
        "post-create-project-cmd": [
            "php -r \"copy('.env.example', '.env');\"",
            "php artisan key:generate"
        ]
    }
}

这里有几个关键要点需要牢记：

• post-create-project-cmd 的值必须是一个数组（哪怕你只有一条命令要执行），绝对不能是字符串。
• 每条命令都会在新生成的项目根目录下执行，Composer 已经帮你切换好了路径上下文。
• 它不支持像 composer dump-autoload 这类需要依赖已安装 autoloader 的命令——因为此时 vendor 目录可能还没完全就绪，部分自动加载功能不可用。
• 如果其中某条命令执行失败（返回非零退出码），整个 create-project 流程就会中断，后续命令也不会再执行。

为什么我的 post-create-project-cmd 没运行？常见排查点

最常踩的坑是这样的：你在自己本地的项目里加了这个钩子，然后兴冲冲地执行 composer create-project myvendor/myproject，结果发现脚本根本没反应。原因其实很直接：myvendor/myproject 这个包本身的 composer.json 里，压根就没写 post-create-project-cmd。

其他几种典型情况也值得注意：

• 钩子写错了地方：如果你把钩子写在了 require-dev 依赖的包里，那是不会生效的。只有目标项目自身的 composer.json 才算数。
• 参数屏蔽：使用了 --no-scripts 参数（在 CI/CD 环境中很常见），这会跳过所有脚本的执行，自然也包括这个钩子。
• 路径或环境问题：命令里用了相对路径如 ./artisan，在 Windows 下可能会因为换行符或权限问题导致失败。更稳妥的做法是统一使用 php artisan。
• PHP 版本不匹配：钩子命令调用的 artisan 或 bin/console 可能要求 PHP 版本 >= 8.1，而宿主机的 PHP 环境还是 7.4 —— 这种情况下，错误可能会被静默处理，或者报了错但被忽略。

替代方案：如果不能改模板，怎么实现类似效果？

当你只是使用者，又无法修改模板的源码（比如使用的是官方的 Lara vel 或 Symfony 项目模板），但又想自动执行某些初始化动作，指望 post-create-project-cmd 就无能为力了。这时，更可靠的做法是手动补上一步操作：

composer create-project lara vel/lara vel myapp && \
cd myapp && \
cp .env.example .env && \
php artisan key:generate

或者，你也可以将其封装成 shell 函数、写进 Makefile 的目标里，甚至创建一个简易的包装脚本。话说回来，如果硬要在 Composer 层面去“注入”钩子来绕过限制，反而容易破坏项目的可复现性——想象一下，不同的人使用不同的 shell、不同的 PHP CLI 配置，结果可能完全不一致。

最后必须提醒一点：这个钩子只会在项目诞生的瞬间运行一次，且仅此一次。后续的 composer install 或 update 操作完全不会触发它。千万别指望用它来做持续的维护任务。