document.writeln('');
華為云服務器上composer install卡頓,首要確認鏡像地址是否為https://mirrors.huaweicloud.com/repository/php/composer/(含/repository/php/composer/且末尾帶/),鍵名必須是repo.packagist、type必須顯式設為composer、需開啟并發下載(composer config -g parallel-downloads 8),并排除項目級repositories覆蓋及同步延遲影響。

華為云鏡像不是 https://mirrors.huaweicloud.com/composer/,也不是 https://repo.huaweicloud.com/composer/——正確地址是:https://mirrors.huaweicloud.com/repository/php/composer/(注意路徑含 /repository/php/composer/,且末尾必須帶 /)。
常見錯誤包括:
/,導致部分 Composer 版本返回 404 或解析失敗repo.packagist 錯寫成 repos.packagist(多一個 s),配置靜默失效composer 類型標識,命令變成 composer config -g repo.packagist https://...,結果被當成 vcs 源處理驗證是否生效:運行 composer config -g repo.packagist,輸出應為完整 JSON 對象,例如:{"type": "composer", "url": "https://mirrors.huaweicloud.com/repository/php/composer/"}。空、null 或報錯說明沒寫進去。
華為云服務器上跑 CI/CD 或多人協作時,composer.json 里只要出現 "repositories" 字段,哪怕內容為空("repositories": {}),全局鏡像也會被忽略。
安全寫法是顯式聲明 packagist 子源:
1 2 3 4 5 6 7 8 |
|
注意三點:
"packagist" 是固定 key 名,不能改成 "huawei" 或其他名字composer.json 頂層,不能嵌套在 require 或其他位置composer.lock 的 hash 可能不一致Composer 2.2+ 默認只開 3 個并發線程下載,相當于把千兆帶寬壓成百兆體驗。華為云服務器通常帶寬充足,不啟用并發就是浪費資源。
執行這條命令開啟并行:
composer config -g parallel-downloads 8
為什么是 8?
驗證是否生效:composer config -g parallel-downloads 應輸出 8。
華為云鏡像同步有 5–30 分鐘延遲。如果 composer install 報類似 The "https://mirrors.huaweicloud.com/repository/php/p2/vendor/package/1.2.3.json" file could not be downloaded (HTTP/2 404),大概率不是你配錯了,而是該包剛發布,鏡像還沒抓取過來。
臨時解法(不用動配置):
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/composer.lock 或 vendor 強行重裝——會破壞依賴一致性真正容易被忽略的是:鏡像只加速「下載」,不解決「依賴解析」本身慢的問題。如果 composer install 卡在 Resolving dependencies 階段,和鏡像無關,得回頭檢查 composer.json 里的 PHP 版本約束、dev 包數量或 lock 文件是否損壞。