php 8.3 安装成功需同时满足 cli 可用、扩展加载、配置生效、web 模式就绪四层对齐；仅 php -v 显示 8.3.x 不代表能运行项目，必须通过 php --ini、php -m、phpinfo() 及 test.php 双端验证。
直接看 php -v 不够，必须验证 CLI、Web、扩展、配置四层是否全部对齐——缺一层，PHP 8.3 就算“装了”也跑不起来。
检查 CLI 是否真用上 PHP 8.3
很多人执行 php -v 看到 8.3.x 就以为 OK，但实际可能是旧版本残留或 PATH 指向错误。
- 运行
which php（Linux/macOS）或where php（Windows），确认输出路径不是/usr/bin/php或C:\Windows\System32\php.exe这类系统默认路径 - macOS Apple Silicon 用户：输出应为
/opt/homebrew/bin/php；Intel 用户应为/usr/local/bin/php；否则说明 Homebrew 安装未生效或 shell 配置漏了eval "$(phpenv init -)" - Windows 用户：检查
echo %PATH%是否包含C:\php（且它排在系统路径前面），否则php -v可能调用的是旧版 - 执行
php --ini，确认 “Loaded Configuration File” 指向你预期的php.ini（比如C:\php\php.ini或/etc/php/8.3/cli/php.ini）
验证 Web SAPI 加载的是否真是 PHP 8.3
浏览器里看到的版本和 CLI 完全无关，Apache/Nginx 调用的是另一套加载链。
- 写一个
test.php，内容为<?php phpinfo(); ?>，用浏览器访问 - 重点看三处：
— “PHP Version” 是否为 8.3.x
— “Loaded Configuration File” 路径是否与你修改的 FPM 或 Apache 模块配置文件一致（如/etc/php/8.3/fpm/php.ini）
— “Server API” 显示的是 “Apache 2.0 Handler” 还是 “FPM/FastCGI” ——这决定了你该改哪个php.ini - Nginx + PHP-FPM 场景下，改完
/etc/php/8.3/fpm/php.ini后必须执行sudo systemctl restart php8.3-fpm，否则phpinfo()仍读旧配置 - Apache 用户：确认已禁用旧模块（如
sudo a2dismod php8.2）并启用新模块（sudo a2enmod php8.3），再重启apache2
确认关键扩展是否真正加载
扩展没启，mbstring 缺失会导致 Laravel 路由解析失败，pdo_mysql 缺失会让数据库连接直接报错——这些错误常被误判为代码问题。
- CLI 下运行
php -m | grep -E "mbstring|pdo|curl|zip"，确保关键模块在列表中 - Web 端
phpinfo()页面搜索 “mbstring”、“pdo_mysql”，看对应模块是否显示“enabled” - 常见失败原因：
—extension_dir路径错误（Windows 下写成ext但实际解压结构是C:\php\php-8.3.7\ext）
— 扩展行开头有空格或分号，例如;extension=mbstring或extension=mbstring
— macOS/Homebrew 用户 php.ini 为空？立刻执行cp /opt/homebrew/etc/php/8.3/php.ini.default /opt/homebrew/etc/php/8.3/php.ini
检查运行时兼容性陷阱
PHP 8.3 引入了只读属性、严格类型推导、PCRE3 默认启用等变更，老代码可能“语法合法但运行崩溃”。
- 运行
php -l your-route-file.php（如routes/web.php）做语法预检，会暴露UnhandledMatchError或参数类型缺失等 PHP 8.3 特有报错 - 开启严格错误报告：
— CLI：确认php.ini中error_reporting = E_ALL且display_errors = On
— Web：在phpinfo()页面确认 “error_reporting” 值为32767（即 E_ALL） - 若项目用 FastRoute/Laravel/ThinkPHP，查
composer show输出对应框架版本：
— Laravel ≥ 10.39 或 ≥ 11.0
— ThinkPHP ≥ 6.3.12
— FastRoute ≥ 1.8.0
低于这些版本，路由注册阶段就可能静默失败或抛出致命错误
最易被忽略的点：CLI 和 Web 的 php.ini 是两份独立文件，改错地方等于没改；Windows 下 NTS/TS 包选错，Apache 直接无法加载模块；macOS 上漏执行 source ~/.zshrc，phpenv 切换永远不生效。验证必须分层动手，不能只信 php -v 一行输出。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
