PHP卸载不干净会残留配置文件、服务、环境变量和扩展目录，导致新版本安装报错；需手动终止进程、删除配置与扩展路径、清理包管理器缓存、检查shell和动态库路径，并验证php命令是否彻底消失。
PHP 卸载不干净会留下配置文件、服务注册、环境变量或扩展目录，导致新版本安装时提示 conflicting packages、port already in use 或 extension_dir mismatch 等错误。必须手动清理残留才能正常安装。
检查并终止残留的 PHP 进程和服务
即使卸载了 PHP 包，php-fpm 或 apache2 可能仍在用旧的 PHP SAPI 模块运行，或 php 命令仍指向旧二进制。
- 运行
ps aux | grep php查看是否有php-fpm、php-cgi进程残留，用kill -9强制终止 - 检查服务状态：
sudo systemctl list-units | grep php，若有php7.4-fpm类似项，执行sudo systemctl stop php7.4-fpm && sudo systemctl disable php7.4-fpm - 验证命令路径：
which php和php -v，若仍输出版本，说明/usr/bin/php或/usr/local/bin/php未被清除，直接sudo rm /usr/bin/php（注意备份）
删除残留配置与扩展目录
不同安装方式（apt/yum/brew/源码编译）残留位置不同，但核心路径高度重合：
-
/etc/php/（Debian/Ubuntu 的多版本共存结构）：删掉整个目录，或只删对应版本子目录如/etc/php/8.1/ -
/usr/lib/php/和/usr/share/php/：含扩展和 PEAR，建议sudo rm -rf /usr/lib/php/*（保留空目录结构以防新包依赖） -
/usr/include/php/：头文件，源码编译安装后常遗留，影响新编译，直接sudo rm -rf /usr/include/php - Apache/Nginx 配置中硬编码的 PHP 处理器路径（如
fastcgi_pass 127.0.0.1:9000或SetHandler application/x-httpd-php），需检查/etc/apache2/mods-enabled/php*.load和/etc/nginx/conf.d/*.conf
清理包管理器缓存与依赖标记
APT/YUM 有时标记 PHP 包为“已删除”但未清除配置，后续安装同名包会被拒绝。
立即学习“PHP免费学习笔记（深入）”；
- Debian/Ubuntu：
dpkg -l | grep php查看状态为rc（removed config）的包，用sudo dpkg --purge $(dpkg -l | awk '/^rc.*php/ {print $2}')彻底清除 - CentOS/RHEL：
rpm -qa | grep php，对每个结果执行sudo rpm -e --nodeps <package-name></package-name>（慎用--nodeps，仅用于彻底清理） - 运行
sudo apt autoremove && sudo apt clean或sudo yum clean all，避免旧元数据干扰
验证 PATH 与动态库路径是否污染
用户级 shell 配置（如 ~/.bashrc、~/.zshrc）可能仍包含 export PATH="/opt/php/bin:$PATH"；/etc/ld.so.conf.d/php.conf 也可能残留 /usr/lib/php/20210902 类路径。
- 搜索所有 shell 配置：
grep -r "php" ~/.bash* ~/.zsh* /etc/profile.d/ 2>/dev/null，注释或删除相关行 - 检查动态库：
cat /etc/ld.so.conf.d/php.conf 2>/dev/null，若存在则sudo rm /etc/ld.so.conf.d/php.conf && sudo ldconfig - 执行
hash -r清除 shell 命令哈希缓存，再运行php -v应报command not found才算清干净
真正麻烦的不是删文件，而是某些 Docker 容器、IDE 内置解释器或 CI 脚本里固化了旧 PHP 路径——这些不会随系统卸载消失，得逐个检查调用链。动手前先 ls -la $(which php) 2>/dev/null 看它到底连向哪，比盲目删更省时间。
