跨平台Composer post-install-cmd脚本创建软链接问题求助

问题背景 #

我有这样的项目结构：

project\
  templates\
  web\assets\
  composer.json

执行composer update时，Composer默认会在vendor/目录创建项目的软链接，但我希望自定义post-install-cmd脚本，在指定位置给templates\和web\assets\文件夹创建软链接。团队成员混用Windows/Mac/Linux系统，打算用PHP命令实现，但之前尝试的脚本因为路径问题失败了——连创建空文件的测试都没成功，主要是搞不清PHP脚本执行时的当前工作路径。

我原本期望的脚本配置大概是这样的，但显然有问题：

"scripts": {
  "post-install-cmd": [
    "php -r \"symlink('/vendor/project/templates', '/templates/project');\"",
    "php -r \"symlink('/vendor/project/web/assets', '/web/project/assets');\""
  ]
}

核心问题解决 #

首先得明确：Composer执行脚本时的当前工作路径就是项目根目录（也就是composer.json所在的目录），所以绝对不能用根目录开头的/vendor/这种路径（这是系统根目录，不是项目根）。另外还要兼容不同系统的路径分隔符，以及处理软链接已存在的情况避免报错。

这里给你调整后的可行方案：

完整的Composer脚本配置 #

"scripts": {
  "post-install-cmd": [
    "php -r '$vendorDir = realpath(__DIR__ . \"/vendor\"); $targetTemplates = $vendorDir . \"/project/templates\"; $linkTemplates = __DIR__ . \"/templates/project\"; if (!file_exists($linkTemplates)) { symlink($targetTemplates, $linkTemplates); }'",
    "php -r '$vendorDir = realpath(__DIR__ . \"/vendor\"); $targetAssets = $vendorDir . \"/project/web/assets\"; $linkAssets = __DIR__ . \"/web/project/assets\"; if (!file_exists($linkAssets)) { symlink($targetAssets, $linkAssets); }'"
  ],
  "post-update-cmd": [
    "@post-install-cmd"
  ]
}

关键细节说明 #

1. 路径正确性：
   • __DIR__在PHP命令行执行时，指向的就是composer.json所在的项目根目录，这是最可靠的获取根路径的方式。
   • realpath()用来解析绝对路径，确保路径不会因为相对路径的问题出错。
2. 跨系统兼容：
   • PHP的symlink()函数在Mac/Linux（原生支持软链接）和Windows（PHP 7.0+，需要管理员权限）都能正常工作，系统会自动处理路径分隔符的差异。
3. 避免重复创建报错：
   • 先判断file_exists($linkTemplates)，如果软链接已经存在就跳过，防止脚本执行时报错中断。
4. 同步更新操作：
   • 把post-update-cmd指向@post-install-cmd，这样执行composer update时也会触发同样的软链接创建逻辑。

注意事项 #

• Windows用户需要以管理员身份运行终端/命令提示符来执行Composer命令，因为Windows创建软链接需要系统权限。
• 确保你的包已经正确安装到vendor/project目录下，也就是templates和web/assets目录确实存在于vendor/project中，否则软链接会指向不存在的路径。
• 如果需要更复杂的逻辑（比如删除旧链接再重建），可以把这些PHP代码写到单独的脚本文件里，比如scripts/create-symlinks.php，然后在Composer脚本里调用php scripts/create-symlinks.php，这样代码更易读和维护。

内容的提问来源于stack exchange，提问作者krizajb