laragon下laravel安装超时需分层排查:composer卡住应调process-timeout、换阿里云镜像;php执行超时才改laragon专属php.ini中max_execution_time和default_socket_timeout;数据库连不上则改.env中db_host为127.0.0.1并核对端口。

Laragon 环境下安装 Laravel 报超时错,通常不是 Laravel 本身的问题,而是 PHP 脚本执行时间、Composer 下载过程或 Laragon 内置服务响应慢导致的。直接改 max_execution_time 只是临时掩盖,关键要分清是哪一环卡住了。
查看当前超时来源再动手
先确认错误具体出现在哪个阶段:
-
Composer 安装 Laravel 时卡住或报
Connection timed out→ 属网络或 Composer 配置问题,和 PHP 执行时间无关 -
运行
php artisan serve或访问页面时白屏/504 → Laravel 请求处理超时 → 才涉及 PHP 或框架层超时设置 -
数据库连接失败(如
SQLSTATE[HY000] [2002] Connection timed out) → 是 MySQL 连接问题,非 Laravel 配置能解决
Composer 安装超时?优先调 Composer 而非 PHP
Laragon 默认用系统 PHP,但 Composer 的超时由自身控制:
- 运行前加参数提速:
composer create-project laravel/laravel myapp --prefer-dist --no-interaction -vvv
- 增大 Composer 超时(单位秒):
composer config -g process-timeout 3600 composer config -g use-include-path true
- 切换国内镜像(避免 GitHub 下载慢):
composer config -g repo.packagist https://mirrors.aliyun.com/composer/
PHP 执行时间真要调?只动 Laragon 对应的 php.ini
Laragon 的 PHP 配置独立于系统,别去改 Windows 全局 php.ini:
- 打开 Laragon → 菜单 PHP → php.ini(会自动定位到它管理的配置文件)
- 找到并修改这两项(开发环境可放宽,线上不建议):
max_execution_time = 120 default_socket_timeout = 300
- 改完必须重启 Laragon 的 Apache/Nginx 和 PHP 服务(右键托盘图标 → Restart All)
Laravel 启动或请求超时?检查中间件和路由缓存
新装 Laravel 若访问首页就超时,大概率是没跑缓存命令:
- 在项目根目录执行:
php artisan config:cache php artisan route:cache php artisan view:cache
- 若仍慢,临时加一个中间件快速定位耗时点(不用改超时):
在app/Http/Middleware/CheckExecutionTime.php中写:public function handle($request, Closure $next) { $start = microtime(true); $response = $next($request); $duration = round((microtime(true) - $start) * 1000); if ($duration > 3000) { \Log::warning('Slow request', ['url' => $request->url(), 'ms' => $duration]); } return $response; }然后注册到
app/Http/Kernel.php的$middleware数组里。
数据库连不上?别碰 Laravel 配置,先验底层
Laragon 自带 MySQL,但常见坑是:
-
.env里DB_HOST=localhost→ 改成127.0.0.1(避免 socket 连接失败) -
DB_PORT=3306必须和 Laragon MySQL 设置一致(右键托盘 → MySQL → Settings 查看) - 清掉配置缓存再试:
php artisan config:clear
- 终端手动连一次验证:
mysql -h 127.0.0.1 -P 3306 -u root -proot
不复杂但容易忽略











