iis环境下composer镜像配置必须使用项目级配置，因iis以独立应用池用户运行php，无法读取全局配置；需执行composer config repo.packagist composer https://mirrors.aliyun.com/composer/写入composer.json，并确保php_openssl、php_mbstring启用及应用池用户有目录权限。
Windows IIS 环境下用 Composer 装包，镜像配置不是“设了就快”，而是必须绕开 IIS 用户权限、PHP 运行上下文和 Composer 配置加载路径三重干扰——否则 composer install 仍会走默认国外源，卡在 Loading composer repositories 不动。
为什么 IIS 下的 PHP 进程读不到全局镜像配置
IIS 默认以 IIS_IUSRS 或应用池指定用户（如 ApplicationPoolIdentity）运行 PHP-CGI，该用户没有读取当前登录用户 %APPDATA%\Composer\config.json 的权限。即使你在 CMD 里用管理员身份执行了 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，IIS 的 PHP 进程也根本不会加载那个文件。
- 验证方式：在 IIS 站点里建一个
info.php，写<?php echo getenv('USERPROFILE'); ?>，看输出路径是否等于你配置镜像时的%APPDATA% - 常见现象：命令行
composer --version正常、composer config -g repo.packagist返回正确 URL，但 IIS 执行composer install仍超时或 404 - 根本原因：Composer 在 CLI 和 Web SAPI 下加载配置的路径不同；Web 模式下优先读取
getenv('HOME')或getenv('USERPROFILE')对应目录，而 IIS 应用池用户通常没有%APPDATA%\Composer目录，更不会自动创建
项目级镜像配置才是 IIS 下唯一可靠方案
把镜像写进项目根目录的 composer.json，让每次 composer install 都强制从指定源拉包，不依赖任何用户级配置。
- 执行命令前，先确保项目目录下已有
composer.json（哪怕空文件也要有） - 运行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意：**没有-g**） - 检查是否生效：
composer config repo.packagist应输出{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 如果报错
Key "repo.packagist" does not exist，说明composer.json里"repositories"是数组（[]）而非对象（{}），需手动编辑为"repositories": {}再重试 - 切忌写
"packagist.org": false——这会让 Composer 彻底禁用回退机制，镜像站临时不可用时整个安装直接失败
PHP 运行环境对 Composer 的硬性要求
IIS + PHP 组合容易漏掉两个关键扩展，导致 Composer 启动即报错或静默失败：
-
php_openssl.dll必须启用：否则无法建立 HTTPS 连接，所有镜像源都访问不了；检查php.ini中extension=openssl是否取消注释，且对应 DLL 文件存在于ext/目录 -
php_mbstring.dll必须启用：Composer 解析 JSON 和处理多字节包名依赖它；同样检查extension=mbstring - IIS 应用池的“加载用户配置文件”选项建议设为
True（高级设置里），否则部分扩展初始化可能异常 - PHP 版本不能低于 7.3 —— Lumen、Laravel 9+ 等主流框架已不再支持更低版本，而 Composer 2.5+ 也要求 PHP ≥7.2.5
部署后验证与常见卡点
镜像配置完成 ≠ 安装一定成功。IIS 下实际跑 composer install 时，最容易被忽略的是权限和路径问题：
- 确保 IIS 应用池标识用户（如
IIS_IUSRS）对项目目录有读取 & 执行、写入权限（特别是vendor/和composer.lock） - 不要在 IIS 管理器里直接“运行命令”——必须用命令行（CMD/PowerShell）以应用池对应用户身份执行（可用
psexec -i -u "IIS APPPOOL\DefaultAppPool" cmd模拟） - 如果仍卡在
Loading composer repositories，立刻检查：①composer.json里是否有"repositories"字段覆盖了repo.packagist；② 镜像 URL 末尾是否少了/（如https://mirrors.aliyun.com/composer会拼成/composerpackages.json导致 404） - 阿里云镜像偶尔会返回 503，可临时切腾讯云：
composer config repo.packagist composer https://mirrors.cloud.tencent.com/composer/
真正决定速度的不是镜像 URL 本身，而是它能否被 IIS 下的 PHP 进程实际加载并执行请求——所有配置都得落在项目内、权限要落到应用池用户、扩展得在 php.ini 里真实启用，缺一不可。
