主流Linux发行版用包管理器安装PHP仅提供基础环境,需手动安装扩展、配置Web服务器集成(mod_php或php-fpm)、校验php.ini参数才能正常运行Web应用。

直接在主流 Linux 发行版(如 Ubuntu/Debian、CentOS/RHEL)上用包管理器安装 PHP,通常就能满足本地开发需求;但要注意默认安装的 PHP 版本可能过旧,且 php 命令可用不等于 mod_php 或 php-fpm 已就绪——LAMP 的「P」只是基础,真正跑 Web 应用还得配好与 Apache/Nginx 的集成。
Ubuntu/Debian 上装 PHP 及常用扩展
Ubuntu 22.04+ 默认源提供 PHP 8.1,但扩展需手动选装。不装扩展会导致 mysqli_connect() 报错、json_encode() 找不到函数等常见问题:
- 运行
sudo apt update && sudo apt install php php-cli php-mysql php-curl php-gd php-mbstring php-xml php-zip -
php -v确认版本,php -m | grep mysql检查mysqli是否已加载 - 若用 Composer,还需
php-zip和php-xml,否则composer install会失败
CentOS 8/9 安装 PHP 要换默认流(stream)
CentOS 8+ 使用 dnf module 管理 PHP 版本,默认是 PHP 8.0,但很多 Laravel 项目需要 8.1+。不显式启用模块,dnf install php 会静默装上旧版或报错:
- 查可用流:
dnf module list php - 启用 PHP 8.1:
sudo dnf module enable php:remi-8.1(需先启用remi仓库) - 再执行:
sudo dnf install php php-mysqlnd php-opcache php-gd php-curl - 注意:
php-mysql在 CentOS 8+ 已废弃,必须用php-mysqlnd
Apache 下启用 PHP 模块(mod_php)
装完 PHP 不代表 Apache 能解析 .php 文件。Ubuntu/Debian 自动启用 libapache2-mod-php,但 CentOS 需手动操作,且 Apache 配置里必须包含 AddType application/x-httpd-php .php:
立即学习“PHP免费学习笔记(深入)”;
- Ubuntu:确认
/etc/apache2/mods-enabled/php8.1.load存在,重启服务:sudo systemctl restart apache2 - CentOS:确保
php模块已加载,检查httpd -M | grep php;若无输出,需确认/etc/httpd/conf.modules.d/15-php.conf存在且未被注释 - 写个
info.php放到/var/www/html/,内容为,用浏览器访问验证是否生效
PHP-FPM + Nginx 组合更常见但配置更敏感
现在多数新项目倾向用 php-fpm 配 Nginx,但容易卡在「502 Bad Gateway」——这几乎全是 socket 权限或 fastcgi_pass 地址不匹配导致:
- Ubuntu 安装后,
php-fpm默认监听/run/php/php8.1-fpm.sock;Nginx 的location ~ \.php$块里必须写fastcgi_pass unix:/run/php/php8.1-fpm.sock; - 检查
ps aux | grep php-fpm确认进程在运行,再看ls -l /run/php/确认 socket 文件属组是www-data(Ubuntu)或nginx(CentOS) - 若改用 TCP 监听(如
127.0.0.1:9000),需同步修改php-fpm.conf中的listen和 Nginx 的fastcgi_pass
真正麻烦的不是装 PHP,而是确认 php.ini 加载路径(php --ini)、时区设置(date.timezone)、上传限制(upload_max_filesize)这些运行时参数——它们不会因重装 PHP 重置,却常导致开发中莫名其妙的失败。











