Composer脚本不能直接重命名项目目录,需手动组合shell命令更新composer.json的"name"字段并重命名文件夹,且Windows不支持该写法,重命名后还需手动处理autoload、PSR-4命名空间及Git远程地址等。

Composer 脚本不能直接重命名项目目录
Composer 本身不提供重命名项目文件夹或修改 composer.json 中 "name" 字段的内置命令。所谓“用 Composer 脚本重命名项目”,实际是靠组合 shell 命令 + composer.json 的 scripts 配置,手动完成两件事:改目录名、更新包名声明。它不是原子操作,出错需人工回退。
在 composer.json 里定义 rename 脚本
把重命名逻辑写进 "scripts",方便复用。注意:脚本运行时工作目录是项目根目录,pwd 和 dirname 等命令行为依赖当前 shell 环境。
示例配置(放在 composer.json 的 "scripts" 下):
"rename": [
"php -r "file_put_contents('composer.json', preg_replace('/\"name\":\s*\"[^\"]+\/[^\"]+\"/', '\"name\": \"$argv[1]\"', file_get_contents('composer.json')));"",
"cd .. && mv $(basename $(pwd)) $argv[1] || exit 1"
]
使用方式:composer rename vendor/new-name
使用 circleci/circleci-cli 和 circleci/orb-tools-orb SDK 来组合和验证 CircleCI Orbs。自动化 orb 打包、使用 conventional-changelog 进行语义化版本控制,并发布到 CircleCI Orb Registry。
-
$argv[1]是传入的参数,必须含/(因"name"格式为vendor/name) - 第一行用 PHP 替换
composer.json中的"name"字段,避免 JSON 格式被破坏 - 第二行跳到父目录再重命名文件夹;失败时
exit 1阻止后续执行 - Windows 不支持该写法,需另写
.bat或用 cross-env 工具
重命名后必须手动处理的三件事
脚本只改了目录名和 composer.json,但 Composer 不会自动同步其他地方:
-
vendor/autoload.php仍按旧命名空间加载 —— 运行composer dump-autoload重建自动加载映射 - 如果项目有 PSR-4 自动加载配置(
"autoload": {"psr-4": {...}}),要同步更新命名空间前缀,否则类找不到 - Git 仓库远程地址通常不含项目名,但若用了 GitHub/GitLab 的默认 URL 模式(如
git@github.com:old-vendor/old-name.git),得手动改.git/config或重新git remote set-url
更安全的做法:不用脚本,分步手动操作
对多数项目,尤其已有提交历史或团队协作中,硬编码脚本反而容易翻车。推荐明确分步:
- 先改
composer.json的"name"和"autoload"/"autoload-dev"中的命名空间 - 运行
composer dump-autoload确认类能正常加载 - 退出项目目录,用
mv old-name new-name重命名文件夹 - 进新目录,运行
composer install(触发 autoload 重建和依赖校验) - 检查
vendor/composer/autoload_static.php里的$prefixLengthsPsr4是否已更新,这是最直接的验证点
真正麻烦的从来不是改名字,而是所有隐式依赖名字的地方 —— 比如 Dockerfile 里的 COPY 路径、CI 脚本里的部署目录、甚至 IDE 缓存。这些没法靠 Composer 脚本覆盖。

















