怎样在Laragon7.0.0中配置PHP8.3环境-php教程-PHP中文网

laragon 7.0.0 原生不支持 php 8.3，需手动下载 vc17 编译的 ts 版 php 8.3.13、放入 bin/php 目录、切换版本、取消 php.ini 中 mbstring 等扩展注释并设 mbstring.strict=off，再升级 laravel 至 ≥10.42 才可稳定运行。

怎样在laragon7.0.0中配置php8.3环境

Laragon 7.0.0 原生不支持 PHP 8.3，需手动添加并正确配置，否则会出现 ParseError: unexpected token "enum" 或 Fatal error 等运行时崩溃——这不是警告，是直接中断。

关键点在于：Laragon 7.0.0 的内置 PHP 版本最高只到 8.2.x（如 8.2.12），其默认的 Apache/Nginx 模块、PHP-FPM 配置、以及环境变量绑定均未适配 PHP 8.3 的底层变更（如 ReflectionUnionType 重构、never 类型强化等）。

以下是安全启用 PHP 8.3 的实操步骤：

确认 Laragon 当前状态
打开 Laragon 主界面 → 点击左上角「Menu」→「About」→ 查看版本号是否确为 7.0.0。若低于此版本，请先升级；若高于（如 7.1+），则已原生支持 8.3，无需手动操作。

下载并放置 PHP 8.3 运行时

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

前往官方源下载线程安全（TS）、VC17 编译的 PHP 8.3 Windows 版：
https://www.php.cn/link/37281569c4df0307a395bbae7abc1c7f（推荐 8.3.13，已修复早期 8.3.0 的多个 FPM 兼容问题）
解压后重命名为 php-8.3.13，放入 Laragon 的 bin\php\ 目录下（即路径为：C:\laragon\bin\php\php-8.3.13\）
确保该目录内含 php.exe、php.ini-development、php.ini-production 及 ext\ 文件夹

启用 PHP 8.3 并修正关键配置

在 Laragon 主界面点击「Menu」→「PHP」→「Switch version」→ 选择刚放入的 php-8.3.13
Laragon 会自动重启 Apache/Nginx，但此时仍不可用——需手动编辑 php-8.3.13\php.ini：
- 找到 ;extension=mbstring → 取消注释（改为 extension=mbstring）
- 找到 ;extension=openssl、;extension=pdo_mysql、;extension=xml、;extension=ctype、;extension=json → 全部取消注释
- 必须添加：mbstring.strict=Off（PHP 8.3 默认开启 strict 模式，Laravel 10.42 以下版本会因 mbstring 函数行为变化而报错）
- 可选但推荐：启用 opcache.enable=1 和 opcache.memory_consumption=128

验证 Laravel 兼容性前提
PHP 8.3 ≠ Laravel 8.3。你项目所用的 Laravel 版本必须 ≥ 10.42（2025年10月发布），否则即使 PHP 跑通，php artisan tinker 或 vendor/autoload.php 仍会 fatal：

运行命令：cd /your/laravel/project && php artisan --version

若输出为 10.39.0 或更低，先升级 Laravel：

composer require laravel/framework:^10.42 --with-all-dependencies

升级后执行 composer update，再清缓存：php artisan config:clear && php artisan cache:clear

最后检查与启动

在 Laragon 中右键点击「Apache」或「Nginx」→「Restart All」
打开浏览器访问 http://localhost → 查看 PHP Info 页面顶部是否显示 PHP Version 8.3.13

进入你的 Laravel 项目目录，运行：

php -v        # 应输出 8.3.13  
php -m | findstr "mbstring openssl pdo"  # 确认关键扩展已加载  
php artisan tinker --execute="echo 'OK';"

完成以上步骤后，Laragon 7.0.0 就能稳定承载 Laravel 10.42+ + PHP 8.3 的组合。不复杂，但每一步都绕不开。

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！