Laravel环境Composer安装卡住?阿里云/腾讯云中文源配置技巧

云敏酱_3756

云敏酱_3756

2026-06-14

493人浏览

原创

卡在installing dependencies是composer拉包失败所致,需配对镜像源(如阿里云或腾讯云)、清缓存(composer clear-cache)并验证生效(composer config -g repo.packagist输出完整json),三步缺一不可。

laravel环境composer安装卡住?阿里云/腾讯云中文源配置技巧

卡在 Installing dependencies 不是 Laravel 问题,而是 Composer 拉包失败的典型表现;换阿里云或腾讯云镜像源能解决 90% 的卡顿,但必须配对、清缓存、验证生效,三步缺一不可。

镜像源配置命令必须写对

键名、type、URL 斜杠三处错一个,镜像就等于没配:

  • repo.packagist(不是 repos.packagist 或 repository.packagist)
  • composer 必须显式作为 type 值写进命令里
  • URL 末尾必须带 /,比如 https://mirrors.aliyun.com/composer/,少斜杠会报 Invalid repository type

正确命令示例:

composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

或腾讯云源:

composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/

换源后不清理缓存=白配

Composer 会优先读旧缓存里的 packages.json 和包元数据,哪怕源已改,它仍试图从旧地址拉取校验信息,结果就是卡在 DNS 解析或 TLS 握手。

必须立即执行:

composer clear-cache

验证是否清干净:

腾讯云跨账号资源迁移
腾讯云跨账号资源迁移

腾讯云跨账号资源迁移工具,支持将账号A的VPC、CLB、NAT、CVM、安全组等资源迁移至账号B,通过CCN云联网实现跨账号网络互通,提供自动扫描、配置生成、Terraform部署功能。

下载
  • macOS/Linux:rm -rf ~/.composer/cache
  • Windows:del /s /q %COMPOSER_HOME%\cache

清完再跑 composer install 或 composer create-project,否则大概率继续卡。

怎么确认镜像真生效了?

别只看命令没报错,要验证实际请求发到了哪:

  • 查配置:composer config -g repo.packagist 输出必须是完整 URL,如 {"type":"composer","url":"https://mirrors.aliyun.com/composer/"}
  • 看日志:composer install -vvv 最后几行应出现类似 Reading packages.json from cache at .../https---mirrors-aliyun-com-composer/...
  • 若日志里还出现 https://packagist.org/packages.json,说明 fallback 了,配置没起作用

常见干扰项:

  • 项目级 composer.json 里写了 "repositories" 字段,会覆盖全局配置
  • http_proxy 环境变量开着,可能绕过镜像走代理
  • 公司防火墙拦截 HTTPS 重定向,需临时加 --secure-http=false(不推荐长期开)

安装时加参数避开常见卡点

composer create-project laravel/laravel 卡住,往往不是下载慢,而是 autoload 生成或 dev 依赖扫描太耗时:

  • --prefer-dist:强制下 ZIP 包,跳过 Git clone 开销
  • --no-dev:跳过 require-dev 里的测试/开发依赖(本地调试可先关掉)
  • -o(即 --optimize-autoloader):生成高效 autoload 映射,减少后续加载耗时
  • --no-install:跳过自动 install,只拉骨架,进目录后再按需装

组合示例:

composer create-project laravel/laravel myapp --prefer-dist --no-dev -o

如果项目含自定义 post-create-project-cmd(比如 Laravel 的 key:generate),--no-install 会跳过这些脚本,得手动补。

真正容易被忽略的是:镜像源配置后不验证、不清缓存、不检查项目级覆盖——这三步漏掉任何一步,都会让换源变成无效操作。尤其 composer clear-cache,很多人以为配完就能跑,结果还是卡在原地。

相关专题

更多
laravel组件介绍
laravel组件介绍

laravel 提供了丰富的组件,包括身份验证、模板引擎、缓存、命令行工具、数据库交互、对象关系映射器、事件处理、文件操作、电子邮件发送、队列管理和数据验证。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

2024.04.09

837

10

laravel中间件介绍
laravel中间件介绍

laravel 中间件分为五种类型:全局、路由、组、终止和自定。想了解更多laravel中间件的相关内容,可以阅读本专题下面的文章。

2024.04.09

815

9

laravel使用的设计模式有哪些
laravel使用的设计模式有哪些

laravel使用的设计模式有:1、单例模式;2、工厂方法模式;3、建造者模式;4、适配器模式;5、装饰器模式;6、策略模式;7、观察者模式。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

2024.04.09

2468

10

thinkphp和laravel哪个简单
thinkphp和laravel哪个简单

对于初学者来说,laravel 的入门门槛较低,更易上手,原因包括:1. 更简单的安装和配置;2. 丰富的文档和社区支持;3. 简洁易懂的语法和 api;4. 平缓的学习曲线。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.10

3761

7

laravel入门教程
laravel入门教程

本专题整合了laravel入门教程,想了解更多详细内容,请阅读专题下面的文章。

2025.08.05

5310

22

laravel实战教程
laravel实战教程

本专题整合了laravel实战教程,阅读专题下面的文章了解更多详细内容。

2025.08.05

3556

13

laravel面试题
laravel面试题

本专题整合了laravel面试题相关内容,阅读专题下面的文章了解更多详细内容。

2025.08.05

6709

7

PHP高性能API设计与Laravel服务架构实践
PHP高性能API设计与Laravel服务架构实践

本专题围绕 PHP 在现代 Web 后端开发中的高性能实践展开,重点讲解基于 Laravel 框架构建可扩展 API 服务的核心方法。内容涵盖路由与中间件机制、服务容器与依赖注入、接口版本管理、缓存策略设计以及队列异步处理方案。同时结合高并发场景,深入分析性能瓶颈定位与优化思路,帮助开发者构建稳定、高效、易维护的 PHP 后端服务体系。

2026.03.04

1396

29

Laravel 框架安装指南
Laravel 框架安装指南

本指南详解 Laravel 框架安装全流程,涵盖 PHP 8.1+ 环境配置、Composer 依赖管理工具安装及国内镜像源优化。重点演示使用 composer create-project 命令创建 Laravel 10/11 项目,解决常见安装错误与依赖冲突。从环境搭建到项目初始化,助您快速完成 Laravel 开发环境部署,为后续 Web 应用开发奠定基础。适合 PHP 初学者与框架迁移开发者参考。

2026.04.09

195

6

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
如何安装 Composer
如何安装 Composer

共1课时 | 201人学习

Composer手册
Composer手册

共0课时 | 0人学习