彻底卸载再干净安装PHP是最稳妥的选择，需先确认安装方式、清理五类残留、分系统精准卸载、重装后验证CLI与Web SAPI版本一致。
PHP 环境混乱时，强行修修补补往往比重装更耗时，尤其当 php -v 报错、扩展加载失败、CLI 和 Web SAPI 版本不一致、或多个 PHP 版本共存导致 which php 指向不可控路径时，彻底卸载再干净安装是最稳妥的选择。
确认当前 PHP 安装方式和残留路径
不同安装方式（系统包管理器、第三方仓库、源码编译、Homebrew、Windows 手动解压）卸载逻辑完全不同。先查清来源，避免误删系统关键组件：
- Linux（Debian/Ubuntu）：运行
dpkg -l | grep php或apt list --installed | grep php - Linux（CentOS/RHEL）：运行
rpm -qa | grep php - macOS（Homebrew）：运行
brew list | grep php，再用brew info php看安装细节 - Windows：检查「控制面板 → 程序和功能」是否有 PHP 相关条目，同时搜索
C:\php\、C:\xampp\、C:\wamp64\等常见路径 - 无论哪种系统，都执行
which php、php --ini、php -r "echo ini_get('extension_dir');"，记录所有输出路径——这些是必须清理的硬目标
分系统执行精准卸载（不删错、不漏删）
卸载不是删掉 php 命令就完事，关键是清除二进制、配置、扩展、服务注册、环境变量这五类残留：
- Ubuntu/Debian：
sudo apt purge $(dpkg -l | grep '^ii.*php' | awk '{print $2}') && sudo apt autoremove && sudo apt clean；手动删除/etc/php/下全部版本目录和/usr/lib/php/ - CentOS/RHEL：
sudo yum remove $(rpm -qa | grep php) && sudo rm -rf /etc/php.d/ /etc/php*/ /usr/lib64/php/（注意：php-fpm需单独yum remove php-fpm） - macOS（Homebrew）：
brew uninstall --force php@8.2 php@8.1 php@7.4（按实际版本列全），再brew cleanup；删掉~/.composer/vendor/bin中可能存在的 php 软链 - Windows：卸载控制面板中所有 PHP 或集成环境（XAMPP/WAMP/MAMP），再手动删除残留文件夹，并检查系统环境变量
PATH是否还含php.exe路径
完成后务必验证：php -v 应报「command not found」，php --ini 应无输出或报错，ls -la $(which php) 应失败。
立即学习“PHP免费学习笔记（深入）”；
选择安装方式并完成最小可用部署
重装不等于回到老路。推荐优先使用官方支持、版本可控、更新明确的方式：
- Linux（Ubuntu/Debian）：添加 Ondřej Surý PPA（
sudo add-apt-repository ppa:ondrej/php），再sudo apt update && sudo apt install php8.2-cli php8.2-mbstring php8.2-curl php8.2-xml php8.2-zip—— 不装libapache2-mod-php或php-fpm除非真需要 Web SAPI - macOS：用 Homebrew 安装单一版本（如
brew install php@8.2），然后运行brew link --force php@8.2，并把$(brew --prefix)/bin加到PATH开头（修改~/.zshrc） - Windows：直接下载 官方线程安全（TS）VC15 x64 ZIP 包，解压到
C:\php\，复制php.ini-development为php.ini并取消extension_dir和常用扩展（如openssl、mbstring）前的分号，最后把C:\php\加入系统 PATH - 所有平台安装后立即验证：
php -v、php -m | grep mbstring、php -i | grep "Loaded Configuration File"，确保显示的是你刚配的php.ini
Web 服务器与 CLI 版本必须严格对齐
很多人重装后发现浏览器里 phpinfo() 显示 8.1，终端 php -v 却是 8.2——这不是“正常共存”，而是配置错误。关键点在于：
- Apache：确认
LoadModule php_module指向的是你新装 PHP 的libphp.so（Ubuntu 在/usr/lib/apache2/modules/，路径随版本变）；禁用旧版a2dismod php7.4类命令 - Nginx + PHP-FPM：检查
fastcgi_pass指向的 socket 或端口，对应php-fpm.conf中listen配置，且php-fpm -v输出版本必须和php -v一致 - VS Code / IDE：重启编辑器，重新加载 PHP 插件，检查设置中
php.executablePath是否指向新路径 - Composer：运行
composer self-update，再composer diagnose确认它调用的是当前 CLI PHP
最易被忽略的是 shell 初始化文件（~/.bashrc、~/.zshrc）里残留的旧 export PATH=...:/old/php/bin，它会让 which php 指向已删除路径却因缓存不报错——执行 hash -d php 清除命令哈希再测。
