必须在composer.json中显式禁用packagist.org并正确配置私有仓库URL，否则私有包无法匹配；repositories需为数组，每项含"type":"composer"和以/结尾的URL，且"packagist.org":false不可省略。
要在PHP项目中稳定使用私有组件或加速依赖下载，必须正确配置Composer仓库源，否则会出现包找不到、安装失败或始终走外网等问题。
初始化项目并创建composer.json
在项目根目录执行composer init，按提示填写包名、描述、作者、最低稳定性（建议选stable）、许可证等信息；这一步会生成基础composer.json文件，不填依赖项也无妨，后续可手动补全。
如果已有项目但缺失composer.json，直接运行composer init即可交互式生成，无需提前手写——它比手动拼JSON更不容易出语法错误。
配置国内镜像源（全局或项目级）
方法一：全局配置（推荐给所有项目提速）
执行命令：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，该操作会修改用户家目录下的.composer/config.json，此后所有项目默认走阿里云镜像。
方法二：仅当前项目生效
在项目根目录下运行：composer config repo.packagist composer https://mirrors.cloud.tencent.com/composer/，此命令直接向本项目composer.json写入repositories字段，不影响其他项目。
【URL末尾必须带斜杠/】，例如https://mirrors.aliyun.com/composer/正确，而https://mirrors.aliyun.com/composer会导致404，Composer将静默回退到packagist.org。
添加私有VCS仓库（如Git代码库）
第一步：确认你的私有包已托管在支持Git的平台（GitHub/GitLab/Gitee或自建Gitea），且仓库为公开或你有对应访问权限。
第二步：在项目composer.json的repositories数组中添加一项：
{"type": "vcs", "url": "https://gitlab.example.com/team/internal-sdk.git"}。
第三步：运行composer require team/internal-sdk:dev-main（分支名按实际替换），Composer会自动识别该VCS源并拉取代码。
注意：VCS仓库不能替代composer类型仓库做版本聚合，它只适用于单个Git仓库的直连安装；若需统一管理多个私有包，应搭建Satis或Artifactory composer仓库。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
配置企业级私有Composer仓库（Artifactory/Satis）
方法1：Artifactory虚拟仓库配置
在项目composer.json中写入完整配置：
{ "repositories": [ { "type": "composer", "url": "https://artifactory.example.com/artifactory/api/composer/my-virtual-repo/" } ], "packagist.org": false }
【"packagist.org": false这一行不可省略】，否则Composer仍会优先查询官方源，导致私有包永远不被命中——即使URL完全正确也会报Could not find package。
方法2：Satis静态镜像配置
确保Satis服务已部署且packages.json可通过浏览器直接访问（如curl -I https://satis.example.com/packages.json返回200）；然后在项目composer.json中配置：
{ "repositories": [ { "type": "composer", "url": "https://satis.example.com/" } ], "packagist.org": false }
URL末尾同样要带斜杠，且Nginx/Apache必须允许对packages.json和dist/目录的公开读取，否则Composer会静默fallback到packagist.org。
验证仓库配置是否生效
① 运行composer config --list | grep repositories，检查输出中是否包含你刚配置的URL；
② 执行composer show -p，观察返回的包列表是否来自你设定的源（如显示aliyun或你的域名）；
③ 尝试安装一个明确只存在于私有源中的包，例如composer require internal/utils:1.0.0，成功则说明仓库路径、认证、禁用packagist三者全部到位。
