PHP 8.3安装核心是“路径对、配置准、扩展开”三者缺一不可：Windows须用Thread Safe x64 ZIP并规范PATH与php.ini；macOS用Homebrew需按芯片类型设对PATH并确认php.ini真实路径；Linux需添加PPA并区分CLI/Apache/FPM配置文件，扩展必须通过phpenmod或pecl精准启用。
php 8.3 不是“装得越快越好”，而是“路径对、配置准、扩展开”三者缺一不可。手动解压 ZIP 或用包管理器安装都可行，但错在任意一环——比如 PATH 没生效、php.ini 没启用 mbstring、或 macOS 上漏了 source ~/.zshrc——都会导致 php -v 成功但 composer install 报错、phpinfo() 不显示扩展、甚至 Web 请求直接 500。
Windows 直接解压 ZIP 包：别碰安装程序，只认 Thread Safe x64
官方 php.net 提供的 ZIP 包最干净，不写注册表、不改系统文件、可随时删。关键不是“怎么下”，而是“下哪个”和“放哪”。
- 必须选
PHP 8.3 Thread Safe (TS) x64—— NT 版本只适用于 Nginx + PHP-FPM 场景，新手默认用 Apache 或内置服务器，TS 兼容性唯一稳妥选择 - 解压路径严禁含中文、空格、长路径，例如
C:\php可行，C:\Program Files\php或C:\我的PHP环境必然失败 -
PATH要加两处：C:\php（让php命令可用）和C:\php\ext（部分扩展加载依赖该路径，尤其 Windows 下extension_dir设为相对路径时易失效） -
php.ini必须从php.ini-development复制重命名，不能用php.ini-production——后者禁用所有扩展、关闭错误报告，本地开发无法调试 - 启用扩展时，确认
extension_dir指向正确，例如：extension_dir = "ext"（默认结构下成立），若你移动过ext文件夹，就得写绝对路径：extension_dir = "C:/php/ext"
macOS 用 Homebrew 安装：芯片类型决定 PATH 写法，别抄错
Homebrew 是 Mac 上唯一推荐的安装方式，但它默认不把 PHP 加入 PATH，且 Apple Silicon 和 Intel 的二进制路径完全不同——抄错一行，which php 就指向系统旧版。
- Apple Silicon（M1/M2/M3）：PATH 行必须是
export PATH="/opt/homebrew/bin:/opt/homebrew/sbin:$PATH"；Intel Mac 则是/usr/local/bin:/usr/local/sbin，混用会导致php -v显示 8.1 或报 command not found -
php --ini输出的配置文件路径才是真实生效位置，常见误区是去改/etc/php.ini或/usr/local/etc/php/8.3/php.ini（旧路径），而实际路径是/opt/homebrew/etc/php/8.3/php.ini（Apple Silicon） - 扩展如
redis推荐用brew install php@8.3-redis，它会自动写入extension=redis.so到 php.ini；若手动pecl install redis，需确认extension_dir指向/opt/homebrew/lib/php/pecl/20230831这类动态路径，否则加载失败 -
php-fpm默认不启动，php -S可跑，但要用 Apache/Nginx 就必须运行brew services start php，否则 fastcgi_pass 会连接拒绝
Linux（Ubuntu/Debian）绕过系统源旧版陷阱：PPA 是刚需
Ubuntu 自带源里 apt install php 默认装的是 PHP 8.1（22.04）或 8.2（24.04），根本跑不动 Laravel 12 或 Symfony 7 要求的 8.3+。不加 PPA，php -v 永远不是你要的版本。
- 必须执行：
sudo add-apt-repository ppa:ondrej/php，再sudo apt update，否则apt search php8.3找不到任何包 - 安装命令要带版本号后缀：
sudo apt install php8.3-cli php8.3-mysql php8.3-curl，装完二进制名是php8.3，不是php；想全局用php命令，得运行sudo update-alternatives --config php手动切换 - 配置文件分散：CLI 用
/etc/php/8.3/cli/php.ini，Apache 模块用/etc/php/8.3/apache2/php.ini，FPM 用/etc/php/8.3/fpm/php.ini——改错一个，Web 和命令行行为就分裂 - 扩展启用方式统一为
sudo phpenmod -v 8.3 curl，不是手动改 ini；但某些扩展（如sqlsrv）仍需pecl install sqlsrv并手动加extension=sqlsrv.so
验证不是看 php -v，而是看扩展是否真加载
php -v 只说明二进制能跑，php --ini 只说明配置文件被读取，真正卡住项目的是扩展没加载成功。常见假阳性：php -m | grep curl 显示 curl，但 curl_init() 报错“function not found”——因为 CLI 和 Web SAPI 加载的是不同 php.ini。
立即学习“PHP免费学习笔记（深入）”；
- CLI 下验证：运行
php -m | findstr /i "curl mbstring pdo_mysql"（Windows）或php -m | grep -E "(curl|mbstring|pdo_mysql)"（macOS/Linux） - Web 下验证：建
info.php，内容为<?php phpinfo(); ?>，放在 Web 根目录，浏览器访问，搜索 “Loaded Configuration File” 确认路径，再搜扩展名看右侧是否标 “enabled” - 特别注意
openssl：很多 Composer 报错 “failed to open stream: php_network_getaddresses” 实际是openssl扩展未启用，而非网络问题 - Windows 下若
php -m显示扩展但 Web 不生效，大概率是 Apache 的httpd.conf里PHPIniDir指向了错误路径，或LoadModule行末尾多了空格导致解析失败
