ThinkPHP 项目需配置 Composer 镜像源、GitHub OAuth Token、vendor 目录路径及安全选项：一、用 composer config --global repos.packagist 切换阿里云/腾讯云镜像；二、通过 composer config --global github-oauth.github.com 设置 Token 避免 GitHub 限流；三、在项目根目录执行 composer config vendor-dir 指定 vendor 路径；四、调试时可用 composer config --global secure-http false 临时禁用 HTTPS 校验；五、误配时用 --unset 参数精准清除。
如果您在安装或使用 ThinkPHP 过程中遇到依赖下载缓慢、认证失败或路径异常等问题，则很可能是 Composer 配置未适配国内网络环境或项目需求。以下是使用 composer config 命令为 ThinkPHP 项目配置镜像源、OAuth 凭据、目录路径等关键参数的具体操作步骤：
一、设置国内镜像源加速依赖安装
ThinkPHP 的依赖包（如 topthink/think、psr/log 等）均从 Packagist 下载，而默认官方源位于境外，直连速度慢且易超时。通过修改 repos.packagist 配置项，可将请求代理至阿里云或腾讯云等国内镜像节点，显著提升 composer create-project 和 composer install 效率。
1、在命令行中执行全局镜像切换命令，覆盖所有 ThinkPHP 项目：
2、composer config --global repos.packagist composer https://mirrors.aliyun.com/composer/
立即学习“PHP免费学习笔记（深入）”；
3、若需切换为腾讯云镜像，运行：
4、composer config --global repos.packagist composer https://mirrors.cloud.tencent.com/composer/
5、验证是否生效：执行 composer config --list --global，检查输出中 repos.packagist 的值是否已更新为对应镜像地址。
二、配置 GitHub OAuth Token 避免限流
ThinkPHP 6+ 及其生态组件（如 think-swoole、think-queue）常依赖 GitHub 上的私有仓库或高频率访问 public API。未配置 OAuth Token 时，Composer 每小时仅允许 60 次未认证请求，极易触发 API rate limit exceeded 错误。该配置必须设为全局，项目级设置无效。
1、前往 GitHub Personal Access Tokens 页面 创建新 Token，勾选 repo 权限。
2、复制生成的 Token 字符串。
3、在终端中执行：
4、composer config --global github-oauth.github.com your_token_here
5、确认配置已写入全局 ~/.composer/config.json：运行 composer config github-oauth.github.com 应返回空（因仅全局生效），而 composer config --global github-oauth.github.com 应显示 Token 值。
三、调整 vendor 目录位置以适配 ThinkPHP 部署结构
ThinkPHP 默认将第三方依赖安装至项目根目录下的 vendor/，但在某些生产部署场景（如 Nginx 将 public/ 设为 Web 根目录）中，需将 vendor/ 移出 Web 可访问路径。通过修改 vendor-dir 配置，可指定其存放位置，Composer 后续操作（如 autoload 生成、脚本执行）将自动适配新路径。
1、进入 ThinkPHP 项目根目录（含 composer.json 的目录）。
2、执行项目级配置命令：
3、composer config vendor-dir ../shared/vendor
4、该命令会直接在当前项目的 composer.json 中新增或更新 "config": {"vendor-dir": "../shared/vendor"} 字段。
5、运行 composer install 后，依赖将被安装至上层 shared/vendor 目录，而非项目内。
四、禁用 HTTPS 强制校验（仅限调试环境）
在企业内网或本地代理环境中，Composer 可能因 SSL 证书不可信而报错 SSL certificate problem: unable to get local issuer certificate。此时可临时关闭 HTTPS 安全校验，使 Composer 允许 HTTP 协议通信。该操作存在安全风险，严禁在生产环境启用。
1、执行全局禁用命令：
2、composer config --global secure-http false
3、若仅对当前 ThinkPHP 项目禁用，运行：
4、composer config secure-http false
5、执行后，Composer 将不再拒绝非 HTTPS 源（如自建私有仓库使用 HTTP 协议）。
五、清除错误配置并恢复默认行为
若误设了冲突配置（如错误指定 vendor-dir 导致自动加载失败，或镜像地址拼写错误引发 Could not resolve packages），可通过 --unset 参数精准移除指定键，避免手动编辑 JSON 文件引发格式错误。
1、删除当前项目的 vendor-dir 设置：
2、composer config --unset vendor-dir
3、还原全局镜像源为官方地址：
4、composer config --global --unset repos.packagist
5、清除所有全局凭据类配置（如误存的 OAuth Token）：
6、composer config --global --unset github-oauth.github.com
