Composer如何用自定义Packagist_Composer自定义Packagist教程【精通】-composer-PHP中文网

composer不支持“自定义packagist_composer”；正确做法是通过composer.json的repositories配置私有源（如satis），关闭默认packagist.org并手动添加以控制优先级，避免认证、缓存与构建失败等问题。

composer如何用自定义packagist_composer自定义packagist教程【精通】

Composer 不支持“自定义 Packagist_Composer”这种东西——它根本不存在，是混淆了概念的错误提法。你真正想做的，大概率是：用私有仓库（比如 Satis、Private Packagist、Git 仓库或 Artifactory）替代 packagist.org，让 composer install 能拉到内部包。下面直说怎么做、为什么这么设、以及踩过哪些坑。

怎么让 Composer 用你的私有包源代替 packagist.org

核心是改 composer.json 的 repositories 配置，告诉 Composer：“别只认 packagist.org，这个地址才是我自己的源”。注意顺序：Composer 按数组顺序查源，packagist.org 默认在最前；要让它优先走私有源，就得显式关掉默认源再手动加回来（放后面）。

常见错误现象：composer require myorg/private-package 报 Could not find package，但包明明已推到 Git 仓库或 Satis 页面能打开。

必须在项目根目录的 composer.json 中添加 repositories 数组，不能只靠全局配置
私有源类型选 composer（对应 Satis / Private Packagist）或 vcs（直接指向 Git URL），别错写成 package（那是手动声明单个包，不适用批量管理）
如果用了 "packagist.org": false，记得在 repositories 里手动补上 packagist 官方源，否则连 monolog/monolog 这种公共包也装不了

{
    "repositories": [
        {
            "type": "composer",
            "url": "https://packages.myorg.com"
        },
        {
            "packagist.org": false
        }
    ]
}

为什么用 Satis 而不是直接配 Git 仓库（vcs）

vcs 类型虽然简单（填个 Git URL 就行），但它每次 composer update 都要跑 git clone --mirror，慢、占磁盘、还容易因分支名变更或 tag 删除导致锁文件失效。Satis 是静态生成的 Composer 仓库，把所有包元数据提前编译成 packages.json，速度快、可 CDN 缓存、支持权限控制。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

使用场景：团队有 5+ 私有 PHP 包，且需要稳定、可审计的依赖分发路径。

Satis 配置里 require-all 设为 true 才会自动收录所有 tagged 版本；漏设会导致 composer require 找不到刚打的 v1.2.0 tag
Satis 构建后必须确保 packages.json 和各包的 dist zip 文件都能被 HTTP 直接访问（比如 Nginx 需开 autoindex on 或配好 try_files）
别把 Satis 输出目录放在 Web 根目录下一级（如 /var/www/packages），而应指向子路径（如 /var/www/packages/dist），否则 packages.json 可能被当成首页返回 HTML

认证失败：401 或 “Could not authenticate against github.com” 怎么办

私有 Git 仓库（尤其是 GitHub/GitLab）要求认证时，Composer 默认不会透传系统凭据。错误信息通常是 Failed to download vendor/private: Could not authenticate against github.com 或 401 Unauthorized。

根本原因不是密码错了，而是 Composer 没拿到 token 或 SSH key。

GitHub 推荐用 Personal Access Token（PAT），scope 至少勾 repo；然后执行 composer config -g github-oauth.github.com <your_token></your_token>
如果用 SSH，确保 ~/.ssh/config 里 Host 别名和 composer.json 中的 vcs URL 一致（比如都用 git@github.com:myorg/pkg.git，而不是 https://github.com/myorg/pkg.git）
CI 环境（如 GitHub Actions）中，别把 token 写死在 composer.json，要用 COMPOSER_AUTH 环境变量注入 JSON 字符串