内网Composer必须禁用packagist.org并严格配置本地path源:在项目composer.json中设"repositories":[{"type":"packagist","url":false},{"type":"path","url":"./packages/my-utils"}],本地包需有合法composer.json、已git初始化或显式声明version,require版本须与本地分支名或version字段完全一致且写死,启用"minimum-stability":"dev",本地包composer.json中加"options":{"symlink":true}以启用符号链接。

内网环境不能连 Packagist,但 Composer 完全可以只靠本地包工作——前提是路径、name、version 三者严丝合缝,且不依赖任何远程源。
内网项目 composer.json 必须禁用 packagist.org
默认情况下,Composer 即使配置了 repositories,仍会 fallback 到 packagist.org 查包,而内网根本连不通,导致 composer update 卡死或报 Could not find package。必须显式屏蔽官方源:
- 在项目根目录
composer.json顶层加:"repositories": [{"type": "packagist", "url": false}] - 再追加你的本地
path源,例如:{"type":"path","url":"./packages/my-utils"} - 缺这一步,Composer 会先尝试访问
packagist.org/packages.json,超时后才退到本地路径——内网中这个“尝试”就是无限等待
本地包目录必须满足三个硬性条件(内网无容错)
内网没有网络兜底,Composer 不会给你任何提示,静默跳过即失败。以下三点缺一不可:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
-
composer.json文件存在且 JSON 合法(无尾逗号、全双引号、name字段值与require中**逐字一致**,如"acme/utils"≠"acme/utils-dev") - 目录下已执行
git init && git add . && git commit -m "init";若未初始化 Git,必须在本地包的composer.json中显式写"version": "dev-main" -
url必须是相对于主项目composer.json的路径,如"./packages/my-utils";不能用file://、~/、$HOME或绝对路径(Windows 也别用C:\,跨机器部署会崩)
require 版本必须写死为分支别名,不能带通配符
内网环境下,"*@dev"、"^1.0"、"dev-master" 这类写法会让 Composer 放弃 path 源,转而试图解析语义化版本——结果就是找不到包。正确写法只有两种:
- 用本地包实际存在的 Git 分支名,如
"acme/utils": "dev-main"(前提是该目录有main分支) - 或直接依赖
composer.json中声明的version值,如本地包写了"version": "dev-test",那require就必须写"acme/utils": "dev-test" - 同时需确保项目级启用了开发版:加
"minimum-stability": "dev"和"prefer-stable": true防止被过滤
验证 symlink 是否生效(改代码是否立刻可见)
内网调试最怕“改了不生效”,本质是没启用符号链接。默认 path 类型走的是复制(copy),不是链接(symlink):
- 在本地包自己的
composer.json里加:"options": {"symlink": true}(注意:不是主项目的repositories条目里加) - Windows 用户必须以管理员身份运行终端,否则
symlink创建失败且无任何错误提示,静默 fallback 到 copy - 验证方式:
ls -la vendor/acme/utils(Linux/macOS)应看到-> ./packages/my-utils;Windows 下用dir vendor\acme\utils,应显示“快捷方式”或“JUNCTION”
改完本地包代码后,只需运行 composer update acme/utils 触发重映射,无需删 vendor/ 或重装。

















