必须先确认镜像源已正确配置并实际生效,再执行require;内网包名须与镜像中注册一致,且需验证packages.json可访问、认证有效、autoload配置无冲突。

require 内网镜像包前先确认镜像源已配置
Composer 默认走 packagist.org,要拉内网包,必须让 composer require 知道该去哪找。不是改 composer.json 里的 repositories 就完事——得确保 Composer 实际请求时真发给了你的内网地址。
最稳妥的方式是全局或项目级配置镜像源:
- 项目级:在项目根目录运行
composer config repositories.packagist composer https://your-mirror-domain.com(注意末尾不带/packages.json) - 全局级(推荐给团队统一):运行
composer config -g repositories.packagist composer https://your-mirror-domain.com - 如果镜像服务启用了 Basic Auth,得额外加
--auth参数,比如composer config --auth repositories.packagist.http-basic.your-mirror-domain.com username password
配完用 composer config repositories 查一眼,确认输出里有你刚设的 URL,且类型是 composer(不是 package 或 vcs)。
require 的包名必须和镜像中注册的一致
内网镜像不是“自动同步所有包”的黑盒。你 require 的包名(如 vendor/internal-sdk),必须已在镜像后台完成同步或手动上传,并在镜像的 packages.json 中可查。否则 Composer 会报 Could not find package vendor/internal-sdk,哪怕 URL 能通。
常见验证方式:
- 浏览器直接访问
https://your-mirror-domain.com/packagist/vendor/internal-sdk.json,看是否返回有效 JSON - 或者 curl
https://your-mirror-domain.com/packages.json | jq '.packages."vendor/internal-sdk",确认有版本列表 - 如果镜像用的是 Satis 或 Private Packagist,检查其 Web UI 是否显示该包状态为 “enabled” 或 “published”
遇到 401/403 时优先检查认证头和 token 生效范围
内网镜像常启用鉴权,但错误往往不出现在登录页,而出现在 Composer 请求元数据阶段。比如你配了 HTTP Basic Auth,但镜像服务实际校验的是 Bearer Token,或 token 只对 /api 路径生效,而 Composer 默认请求的是根路径下的 packages.json。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
调试建议:
- 用
composer -v require vendor/internal-sdk看详细请求 URL 和响应状态码 - 抓包(如
tcpdump或镜像服务 access log)确认请求头是否含Authorization: Basic ...或Bearer xxx - 某些镜像(如 Nexus Repository)需在
repositories配置中显式指定options.auth.basic结构,不能只靠config --auth
require 后 vendor/autoload.php 不生效?检查 autoload 配置是否被覆盖
内网包的 composer.json 里若写了 "autoload": {"psr-4": {...}},本地 require 后本该自动加载——但如果项目根目录的 composer.json 里也定义了同名命名空间,或者用了 "autoload-dev" 覆盖了生产 autoload 规则,就可能漏掉类。
执行以下两步快速定位:
- 运行
composer dump-autoload -v,观察输出里是否包含你的内网包路径(如vendor/vendor/internal-sdk/src/) - 检查生成的
vendor/composer/autoload_psr4.php,搜索你的命名空间,确认映射路径正确且未被后加载的配置覆盖 - 如果包本身没写 autoload,又没提供
files入口,require 只是下载文件,不会自动引入——得手动require或补上"autoload": {"files": ["src/functions.php"]}
内网包的 autoload 配置容易被忽略,尤其当它来自历史遗留项目、未严格遵循 PSR 标准时,这时候 require 成功不代表能用。










