如何在Ubuntu上重置PHP配置

在Ubuntu上折腾PHP配置，有时候改来改去把自己绕进去了，不如直接重置来得干脆。但这事儿得分几步走——PHP核心、PHP-FPM、还有和Apache/Nginx的集成，各有各的配置路径，不能一股脑儿乱删。下面就把具体操作拆开说清楚。

1. 备份现有配置文件

动手之前，先给现有配置留个底。这不是客气，是血泪教训——万一重置完发现还是原来那套好，至少能退回去。

• PHP核心配置（命令行/CLI模式）：

  sudo cp /etc/php/{version}/cli/php.ini /etc/php/{version}/cli/php.ini.bak

• PHP-FPM配置（Web服务模式）：

  sudo cp /etc/php/{version}/fpm/php.ini /etc/php/{version}/fpm/php.ini.bak
  sudo cp /etc/php/{version}/fpm/pool.d/www.conf /etc/php/{version}/fpm/pool.d/www.conf.bak

  把{version}换成你当前的PHP版本号（比如8.1），具体版本可以通过php -v或php-fpm -v查一下。

2. 停止相关服务

重置配置时，服务还跑着容易出幺蛾子。最好先把PHP-FPM和Web服务器都停下来，干干净净搞操作。

# 停止PHP-FPM（若使用）
sudo systemctl stop php{version}-fpm
# 停止Web服务器（Apache/Nginx）
sudo systemctl stop apache2     # 若使用Apache
sudo systemctl stop nginx       # 若使用Nginx

3. 删除或重命名现有配置文件

把旧配置彻底清掉，为后续生成默认配置腾出位置。直接删有点冒险，建议重命名——加个.disabled后缀，万一需要还能找回。

• PHP核心配置：

  sudo mv /etc/php/{version}/cli/php.ini /etc/php/{version}/cli/php.ini.disabled

• PHP-FPM配置：

  sudo mv /etc/php/{version}/fpm/php.ini /etc/php/{version}/fpm/php.ini.disabled
  sudo mv /etc/php/{version}/fpm/pool.d/www.conf /etc/php/{version}/fpm/pool.d/www.conf.disabled

4. 重新安装PHP及相关组件

通过包管理器重新装一遍PHP，默认配置文件就会自动生成。注意，卸载时如果用--purge会把配置文件也清掉，但这里我们已经手动移走了旧配置，直接用remove就行。

# 卸载现有PHP（保留配置文件，若需完全清除可加--purge）
sudo apt-get remove php php-cli php-fpm php-common
# 重新安装PHP（以PHP 8.1为例）
sudo apt update
sudo apt install php php-cli php-fpm php-mysql php-curl php-gd php-mbstring php-xml php-zip

重新安装完成后，/etc/php/{version}/目录下会自动生成默认的php.ini（核心配置）和www.conf（PHP-FPM池配置）。

5. 恢复默认配置（可选）

如果自动生成的配置还不够“原生”，可以从PHP源码目录中复制官方默认模板。前提是你已经安装了php-dev包，源码通常会放在/usr/src/php/{version}/。

# 进入PHP源代码目录（需提前安装php-dev）
cd /usr/src/php/{version}/
# 复制开发环境（推荐）或生产环境默认配置
sudo cp php.ini-development /etc/php/{version}/cli/php.ini
sudo cp php.ini-production /etc/php/{version}/fpm/php.ini
# 恢复PHP-FPM池默认配置
sudo cp /usr/src/php/{version}/sapi/fpm/php-fpm.conf /etc/php/{version}/fpm/php-fpm.conf

6. 启动服务并验证

配置重置完毕，把服务启动起来，再检查一遍是否一切正常。

# 启动PHP-FPM
sudo systemctl start php{version}-fpm
# 启动Web服务器
sudo systemctl start apache2   # 或 nginx
# 检查服务状态
sudo systemctl status php{version}-fpm
sudo systemctl status apache2   # 或 nginx
# 验证PHP配置（创建info.php文件）
echo "" | sudo tee /var/www/html/info.php

然后在浏览器里访问http://your_server_ip/info.php，确认PHP信息页面能正常显示，同时检查配置是否已经生效。

注意事项

• 如果你用的是Apache，还得确保libapache2-mod-php模块已启用：

  sudo a2enmod php{version}
  sudo systemctl restart apache2

• 如果用的是Nginx，别忘了检查/etc/nginx/sites-a vailable/default里的PHP-FPM配置——关键是fastcgi_pass指向的socket路径是否正确，比如unix:/run/php/php{version}-fpm.sock。一个路径写错，整站就白屏了。