Laragon如何切PHP版本？适配Laravel指南-php教程-PHP中文网

laragon切换php版本全自动，无需手动配置：先stop all，再通过php→version选择或下载目标版本（推荐nts/vc17/x64），点击切换后start all即可；laravel 11要求php≥8.2，升级须先切版本再同步更新composer.json与运行php artisan upgrade。

laragon如何切php版本？适配laravel指南

Laragon 切换 PHP 版本非常简单，不需要手动改环境变量或配置文件，所有操作都在图形界面中完成。Laravel 项目能否正常运行，高度依赖 PHP 版本是否匹配——比如 Laravel 11 要求 PHP ≥ 8.2，而 Laravel 8 还支持 PHP 7.3～8.1。所以切换 PHP 版本不是“可选项”，而是 Laravel 升级或降级时的前置动作。

一、在 Laragon 中切换 PHP 版本

切换过程全自动，Laragon 会同步更新 Apache/Nginx 的模块路径、系统 PATH 和 php.ini 引用：

先点击主界面上的 Stop All，确保服务已停止
顶部菜单栏点 PHP → Version，下拉列表显示当前已安装的所有 PHP 版本（如 PHP 8.3.x、8.2.x、7.4.x）
若所需版本未出现，点 PHP → Version → "+" 或 Download，从官方源选择并下载对应版本（推荐选 non-thread-safe (NTS)、VC17 编译、x64 架构）
下载完成后，回到 PHP → Version，直接点击目标版本即可切换
最后点击 Start All 启动服务，访问 http://localhost/phpinfo.php 或运行 php -v 验证

二、Laravel 项目对 PHP 版本的实际要求

不同 Laravel 主版本有明确的 PHP 支持范围，不能仅凭“能跑通”就认为适配成功：

Laravel 8：支持 PHP 7.3～8.1（不建议在 8.2+ 上长期运行，部分废弃函数会触发警告）
Laravel 9：最低要求 PHP 8.0.2，推荐 8.1
Laravel 10：需 PHP 8.1+，部分组件（如 Symfony Mailer）在 8.2+ 表现更稳定
Laravel 11：硬性要求 PHP ≥ 8.2，且禁用 mbstring.func_overload，否则启动报错

你可以在项目根目录运行 php artisan --version 查当前 Laravel 版本，再对照官方升级指南确认 PHP 范围。

Laravel Creem Agent

Creem 支付商店助理 — 查询订阅、客户、交易、产品，执行心跳检查，管理本地 Laravel支付商店。

下载

三、切换后 Laravel 项目常见问题与处理

版本切换后，Laravel 可能因扩展缺失、配置不兼容或 Xdebug 路径错误而无法启动：

报错 “Class 'Illuminate\Support\Facades\Hash' not found”：说明 PHP 版本过高（如用 PHP 8.3 运行 Laravel 8），或 composer autoload 损坏，执行 composer dump-autoload
phpinfo() 显示 Xdebug 未加载：Laragon 不自动配置 Xdebug，需手动编辑对应 PHP 版本下的 php.ini，添加 zend_extension 路径，并确认 DLL 文件与 PHP 架构（TS/NTS）、VC 版本一致
artisan 命令提示 “syntax error, unexpected token”：多为 PHP 版本过低（如用 7.4 运行 Laravel 10+ 的箭头函数或枚举语法），需升 PHP
数据库连接失败或中文乱码：检查 php.ini 中 mysql.default_charset = utf8mb4 和 default_charset = "UTF-8" 是否启用