怎么配置Ubuntu PHP环境

下面给你一份在 Ubuntu 上配置 PHP 环境的常见、实用做法，从基础 PHP + Web 服务器到常用扩展和调优，适合新手和日常开发。

一、更新系统（建议先做）

sudo apt update
sudo apt upgrade -y

二、安装 PHP（常用版本）

1️⃣ 默认仓库安装（简单）

Ubuntu 20.04 / 22.04 默认仓库一般包含 PHP 7.4 / 8.1：

sudo apt install php -y

查看版本：

php -v

2️⃣ 安装指定 PHP 版本（推荐）

例如安装 PHP 8.1：

sudo apt install php8.1 php8.1-cli -y

三、安装 Web 服务器（二选一）

✅ 方案一：Apache（最常见）

安装 Apache

sudo apt install apache2 -y

安装 PHP 与 Apache 模块

sudo apt install libapache2-mod-php8.1 -y

重启 Apache

sudo systemctl restart apache2

测试 PHP

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

浏览器访问：

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

⚠️ 测试完建议删除：

sudo rm /var/www/html/info.php

✅ 方案二：Nginx + PHP-FPM（性能更好）

安装 Nginx

sudo apt install nginx -y

安装 PHP-FPM

sudo apt install php8.1-fpm -y

启动服务

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

配置 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;
    }
}

重启 Nginx

sudo systemctl restart nginx

四、安装常用 PHP 扩展

sudo apt install php8.1-mysql php8.1-curl php8.1-gd php8.1-mbstring php8.1-xml php8.1-zip php8.1-opcache -y

常用扩展说明：

mysql：数据库
curl：HTTP 请求
gd：图片处理
mbstring：多字节字符串
xml：XML 解析
zip：压缩

五、配置 PHP（可选但重要）

编辑配置文件：

sudo nano /etc/php/8.1/apache2/php.ini
# 或
sudo nano /etc/php/8.1/fpm/php.ini

常见修改：

upload_max_filesize = 64M
post_max_size = 64M
memory_limit = 256M
date.timezone = Asia/Shanghai

修改后重启：

sudo systemctl restart apache2
# 或
sudo systemctl restart php8.1-fpm

六、安装 Composer（PHP 包管理工具）

curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer

验证：

composer -V

七、常见问题排查

1️⃣ PHP 不解析，直接下载文件

Apache：确认 libapache2-mod-php 已安装
Nginx：fastcgi_pass 是否指向正确 sock 文件

2️⃣ 端口被占用

sudo netstat -tlnp

3️⃣ 权限问题

sudo chown -R www-data:www-data /var/www/html

八、推荐组合（总结）

场景	推荐
新手 / 本地测试	Apache + PHP
生产环境	Nginx + PHP-FPM
现代 PHP 开发	PHP 8.x + Composer

如果你告诉我：

✅ Ubuntu 版本（20.04 / 22.04 / 24.04）
✅ 用 Apache 还是 Nginx
✅ 本地开发还是服务器部署

我可以给你一份完全贴合你环境的配置方案。