新手配PHP 8.3必须闭环三件事：PATH指向正确二进制、php.ini真实加载、mbstring/pdo/opcache在php -m中可见；任一缺失会导致php -v成功但composer报错或Laravel启动失败。
新手配 PHP 8.3，不是“装完就跑”，而是三件事必须闭环：PATH 指向对的二进制、php.ini 真正加载、关键扩展（mbstring、pdo、opcache）在 php -m 里能看见。漏掉任意一环，php -v 成功但 composer install 报错、Laravel 启动直接 Class 'PDO' not found，都是常态。
确认 PATH 指向 Homebrew / 官方 ZIP 的 php，不是系统残留
macOS 和 Windows 新手最容易卡在这一步：php -v 显示 8.3，但其实是旧版缓存或 alias 干扰。
- macOS Apple Silicon：运行
which php，输出必须是/opt/homebrew/bin/php；如果是/usr/bin/php，说明没改对~/.zshrc或没source ~/.zshrc - Windows：打开 CMD，执行
where php，结果应只有一行且指向你解压的目录（如C:\php\php.exe）；若出现C:\Windows\System32\php.exe，说明 PATH 里混进了旧路径或注册表残留 - Linux（Ubuntu）：
ls -l $(which php)应指向/usr/bin/php8.3，而非/usr/bin/php7.4；用sudo update-alternatives --config php切换主版本
php.ini 必须手动复制并启用基础扩展
Homebrew 和官方 ZIP 都只提供 php.ini.default，不复制 = 所有扩展默认关闭。
- macOS：先查真实路径 ——
php --ini输出 “Loaded Configuration File”，例如/opt/homebrew/etc/php/8.3/php.ini；若显示(none)，立刻执行：cp /opt/homebrew/etc/php/8.3/php.ini.default /opt/homebrew/etc/php/8.3/php.ini - Windows：从
C:\php\php.ini-development复制为C:\php\php.ini（别用production版，它关死了所有扩展） - 编辑该文件，取消注释以下三行：
extension=mbstringextension=pdo_sqliteextension=opcache
MySQL 项目再加extension=pdo_mysql - 验证：运行
php -m | grep -E '^(mbstring|pdo|opcache)$'，每项都应出现在输出里
CLI 和 Web 服务用的是不同 php.ini，别搞混
你在终端里改好了 php.ini，Web 页面却还是报错？大概率你改的是 CLI 的配置，而 Apache/Nginx/FPM 用的是另一份。
立即学习“PHP免费学习笔记（深入）”；
- macOS + Apache：Homebrew 的
httpd默认走 FPM，所以 Web 请求实际读的是/opt/homebrew/etc/php/8.3/php-fpm.d/www.conf里指定的php_admin_value[php_ini]路径，不是 CLI 的那个 - Linux Ubuntu：CLI 用
/etc/php/8.3/cli/php.ini，Apache 用/etc/php/8.3/apache2/php.ini，PHP-FPM 用/etc/php/8.3/fpm/php.ini—— 改完要对应重启服务：sudo systemctl restart apache2或sudo systemctl restart php8.3-fpm - Windows + Apache：
PHPIniDir "C:/php"必须写在httpd.conf里，且路径不能含空格或中文；否则 Apache 加载模块时会静默失败，phpinfo()里 Server API 显示 “Apache 2.0 Handler” 就说明生效了
memory_limit 不是越大越好，先定位真瓶颈
看到 Fatal error: Allowed memory size of ... exhausted 就去改 memory_limit，90% 是掩盖问题。PHP 8.3 内存管理更严格，泄漏或误加载更容易暴露。
- 先打点实测：
echo memory_get_usage(true), "\n";放在可疑操作前后（比如json_decode($big_json)前后），看增长是否异常 - CLI 场景临时调高最安全：
php -d memory_limit=512M script.php，不影响 Web 服务 - 改
php.ini时注意区分环境：CLI 的memory_limit影响composer，FPM 的影响 Web 请求；设成-1（无限制）只应在调试阶段，上线前必须收窄 - 某些托管平台（如部分云函数）会锁定内存上限，
ini_set()和.htaccess全部无效，只能联系服务商或换环境
真正卡住新手的，从来不是下载和解压，而是 PATH 没刷新、php.ini 没复制、CLI 和 Web 配置文件搞混这三处。每个环节都得用命令验证，而不是凭感觉认为“应该没问题”。
