PHP如何配置在Ubuntu

在 Ubuntu 上配置 PHP，通常和 Web 服务器（Apache / Nginx） 一起使用。下面我按 最常见场景 给你一个完整、实用的配置流程。

一、安装 PHP（Ubuntu 20.04 / 22.04 / 24.04 通用）

1️⃣ 更新软件源

sudo apt update
sudo apt upgrade -y

2️⃣ 安装 PHP（默认版本）

sudo apt install php -y

查看版本：

php -v

3️⃣ 安装常用 PHP 扩展（强烈推荐）

sudo apt install php-cli php-fpm php-mysql php-curl php-xml php-mbstring php-zip php-gd -y

常用扩展说明：

php-cli：命令行 PHP
php-fpm：FastCGI（Nginx 必备）
php-mysql：MySQL 支持
php-curl：HTTP 请求
php-xml：XML 处理
php-mbstring：多字节字符串
php-zip：压缩支持

二、配置 PHP（核心配置文件）

PHP 配置文件路径：

/etc/php/{版本}/cli/php.ini      # 命令行
/etc/php/{版本}/fpm/php.ini      # Web 服务（Nginx）
/etc/php/{版本}/apache2/php.ini  # Web 服务（Apache）

例如 PHP 8.1：

/etc/php/8.1/

常用 PHP 配置修改

sudo nano /etc/php/8.1/fpm/php.ini

推荐修改项：

upload_max_filesize = 50M
post_max_size = 50M
memory_limit = 256M
max_execution_time = 300
date.timezone = Asia/Shanghai

保存后重启：

sudo systemctl restart php8.1-fpm

三、与 Apache 配合使用（LAMP）

1️⃣ 安装 Apache

sudo apt install apache2 -y

2️⃣ 安装 Apache PHP 模块

sudo apt install libapache2-mod-php -y

3️⃣ 测试 PHP

echo "<?php phpinfo(); ?>" | sudo tee /var/www/html/info.php

浏览器访问：

http://服务器IP/info.php

✅ 看到 PHP 信息页面即成功

四、与 Nginx 配合使用（LNMP，推荐）

1️⃣ 安装 Nginx

sudo apt install nginx -y

2️⃣ 安装 PHP-FPM

sudo apt install php-fpm -y

3️⃣ 配置 Nginx 支持 PHP

编辑站点配置：

sudo nano /etc/nginx/sites-available/default

关键配置：

server {
    listen 80;
    server_name localhost;

    root /var/www/html;
    index index.php index.html;

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.1-fpm.sock;
    }
}

4️⃣ 重启服务

sudo systemctl restart nginx
sudo systemctl restart php8.1-fpm

5️⃣ 测试

echo "<?php phpinfo(); ?>" | sudo tee /var/www/html/info.php

访问：

http://服务器IP/info.php

五、PHP 服务管理命令

# 查看状态
sudo systemctl status php8.1-fpm

# 重启
sudo systemctl restart php8.1-fpm

# 设置开机启动
sudo systemctl enable php8.1-fpm

六、Ubuntu 安装指定 PHP 版本（如 7.4 / 8.2）

sudo apt install software-properties-common
sudo add-apt-repository ppa:ondrej/php
sudo apt update

sudo apt install php8.2 php8.2-fpm php8.2-mysql

七、常见问题排查

❌ 页面直接显示 PHP 代码

Nginx 未配置 fastcgi_pass
Apache 未安装 libapache2-mod-php

❌ 502 Bad Gateway

sudo systemctl status php8.1-fpm

检查 sock 路径是否一致

八、总结（最简流程）

✅ Apache：

sudo apt install apache2 php libapache2-mod-php

✅ Nginx：

sudo apt install nginx php-fpm

如果你愿意，我也可以帮你：

✅ 配置 PHP + MySQL + Nginx
✅ 部署 Laravel / ThinkPHP
✅ 配置 PHP 多版本共存
✅ 排查 502 / 404 / 权限问题

你现在是 本地 Ubuntu 还是服务器？用 Apache 还是 Nginx？