Laragon之所以能快速切换PHP版本，是因为它会把安装目录下bin\php中的每个子文件夹当成一个独立的PHP环境。因此手动添加PHP 8.3的思路很直接：下载官方二进制包，解压到bin\php目录，补上配置文件，然后让Laragon重新识别。
这一步操作不会覆盖已有版本，也不会影响Apache或Nginx的其他配置。真正容易出错的环节在于目录层级和php.ini的生成，而不是下载本身。只要掌握了这两个部分，后续切换版本会非常顺畅。
一、下载PHP 8.3之前需要确认的三件事
在动手下载之前，先明确三个关键选项。第一是线程安全版本。PHP官方Windows二进制包分为TS与NTS两种，TS主要用于Apache的mod_php方式加载，NTS则适用于Nginx和命令行场景。Laragon同时支持Apache和Nginx，但如果你主要使用Nginx，或者项目依赖命令行脚本，选择NTS会让性能表现更好。如果坚持使用Apache并且以模块方式运行PHP，则需要下载TS版本。
第二是系统架构。64位操作系统选择x64包，32位系统才需要x86包。目前绝大多数开发机都是x64，下载时注意不要选错。第三是VC运行库。PHP 8.3的官方Windows版本依赖Visual C++ Redistributable for Visual Studio 2015-2022，如果你的机器还没有安装，启动php.exe时通常会直接提示缺少VCRUNTIME140.dll。可以先到微软官方页面下载vc_redist.x64.exe安装，然后重启一次终端再继续。
确认完这些后，到PHP官方Windows下载页找到PHP 8.3最新版本，选择zip格式下载，不建议使用installer。zip包更干净，也方便Laragon按目录管理。
二、解压二进制包到bin目录并创建php.ini
假设Laragon安装在C:\laragon，那么PHP版本统一放在C:\laragon\bin\php目录下。可以先打开这个目录看看现有结构，一般会有类似php-8.1.10-Win32-vs16-x64这样的文件夹。将下载好的zip解压，得到类似php-8.3.0-nts-Win32-vs16-x64的文件夹，把这个文件夹整体移动或复制到C:\laragon\bin\php下面。
这里最需要留意的是目录层级。最终php.exe的位置必须是C:\laragon\bin\php\php-8.3.0-nts-Win32-vs16-x64\php.exe，而不是C:\laragon\bin\php\php-8.3.0-nts-Win32-vs16-x64\php-8.3.0-nts-Win32-vs16-x64\php.exe。如果一个文件夹内还有一层同名字文件夹，Laragon扫描时找不到php.exe，就不会在版本列表中显示。
# 假设zip已下载到Downloads目录 Expand-Archive -Path "$env:USERPROFILE\Downloads\php-8.3.0-nts-Win32-vs16-x64.zip" -DestinationPath "C:\laragon\bin\php" # 进入解压后的目录 cd C:\laragon\bin\php\php-8.3.0-nts-Win32-vs16-x64 # 复制开发配置为正式配置 Copy-Item php.ini-development php.ini # 验证php.exe是否可以运行 .\php.exe -v
如果执行.\php.exe -v时能看到PHP 8.3.x的版本信息，说明二进制包本身没有问题。如果提示缺少DLL，则回到前面安装对应的VC运行库。
接下来用文本编辑器打开刚刚生成的php.ini，做几项基础配置。PHP 8.3自带的php.ini-development已经包含大多数配置项，但很多扩展默认是关闭的。需要把extension_dir设置为ext，并启用Laragon下常用的扩展，如curl、mbstring、openssl、pdo_mysql、fileinfo等。示例如下：
extension_dir = "ext" extension=curl extension=fileinfo extension=mbstring extension=openssl extension=pdo_mysql extension=sodium date.timezone = Asia/Shanghai memory_limit = 512M
保存后，可以执行.\php.exe -m查看已加载的模块，确认这些扩展没有加载失败。其实在Laragon切换PHP版本后，这些配置会直接作用于Web服务和命令行工具，所以这里提前测试能省去后面的排查时间。
三、让Laragon识别并切换PHP 8.3
将PHP目录放好后，需要让Laragon重新扫描版本。先完全退出托盘中的Laragon，再重新打开。接着点击Laragon菜单，选择PHP，再进入版本选项，此时应该能看到刚刚放进去的php-8.3.0-nts-Win32-vs16-x64。点击它，Laragon会自动修改Apache或Nginx的配置，把PHP处理模块指向新版本。
如果版本列表里没有出现这个目录，先不要反复重启。打开C:\laragon\bin\php确认php.exe的路径是否只有一层目录，再看目录名是否包含空格或特殊字符。虽然空格一般不影响，但为了稳妥可以重命名为php-8.3.0这样的简洁名称。确认无误后，再在Laragon菜单中使用重新扫描版本的功能，或者直接退出并重新启动。
切换完成后，验证分为两步。第一步是终端验证。在Laragon中打开Terminal，执行php -v，如果显示PHP 8.3.x，说明命令行环境已经切换。如果显示的仍是旧版本，可能是系统环境变量PATH中还有其他PHP路径，可以关闭终端重新打开，或者执行where php检查顺序。第二步是Web验证。在Laragon的www根目录新建一个info.php文件，内容如下：
<?php phpinfo(); ?>
保存后启动服务，用浏览器访问http://localhost/info.php。页面顶部显示的PHP Version应该是8.3.x，Server API会因Web服务器不同而显示为Apache 2.0 Handler或FPM/FastCGI。确认后记得删除info.php，避免将环境信息暴露在项目目录中。
四、常见的几个坑与排查方法
第一个常见问题是缺少VCRUNTIME140.dll。即使前面安装过运行库，有时因为安装顺序或未重启终端，php.exe仍然会报错。解决办法是重新安装VC运行库，并关闭所有终端窗口后再次测试。第二个常见问题是扩展加载失败。如果你下载的是NTS包，但php.ini中启用了TS版本的扩展，或者手动放置了不匹配的扩展文件，启动时会有警告。一般使用自带ext目录中的扩展不会出现这个问题，但若从别处复制扩展，一定要确认NTS和TS标识一致。
第三个常见问题是php.ini不生效。很多人以为只要把文件改名为php.ini就会自动加载，实际上还需要确认路径。可以在当前PHP目录执行.\php.exe --ini，查看Loaded Configuration File是否指向当前版本的php.ini。如果显示None，说明文件名或位置不对，常见原因是把php.ini放在了外层目录，或者没有把php.ini-development复制为php.ini。
第四个问题与Composer相关。切换PHP版本后，在Laragon终端里运行composer --version若仍然调用旧PHP，可以先执行where php查看PATH中哪个php.exe排在前面。Laragon的终端通常会把当前选择的PHP目录放在PATH最前，但如果系统环境变量中还有全局PHP，顺序可能被打乱。可以在Laragon的设置中调整终端PATH，或者临时在项目目录使用完整路径调用PHP运行Composer。
最后，如果切换后网站没有立即生效，先重启Apache或Nginx，再清一下OPcache。Laragon的版本切换会尽量自动处理，但少数情况下缓存会导致旧的PHP配置还在。另外，老项目从低版本PHP升级到8.3后可能出现动态属性或隐式类型转换的警告，这属于PHP 8系列的向后兼容问题，可以按提示调整代码或错误报告级别，不必担心是Laragon添加过程出错。
总的来说，手动扩展Laragon的PHP版本并不复杂，关键在于下载匹配的二进制包、保证目录层级正确、复制并配置php.ini。完成一次之后，再添加PHP 8.4或未来的版本，都可以沿用同样的流程。