Ubuntu下怎么配置PHP

在 Ubuntu 下配置 PHP，通常分为 安装 PHP、配置 PHP 运行环境（CLI / Apache / Nginx） 以及 常见参数调整。下面按常见场景一步步说明（以 Ubuntu 20.04 / 22.04 为例，PHP 8.x）。

一、更新系统

sudo apt update
sudo apt upgrade -y

二、安装 PHP（推荐方式：ondrej PPA）

Ubuntu 自带源里的 PHP 版本可能较旧，推荐使用 ondrej PPA。

1️⃣ 添加 PPA

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

2️⃣ 安装 PHP（以 8.2 为例）

sudo apt install -y php8.2

查看版本：

php -v

三、安装常用 PHP 扩展

sudo apt install -y \
php8.2-cli \
php8.2-fpm \
php8.2-mysql \
php8.2-curl \
php8.2-gd \
php8.2-mbstring \
php8.2-xml \
php8.2-zip \
php8.2-opcache

如果是 Laravel / ThinkPHP / WordPress，这些基本够用。

四、PHP 运行模式选择

✅ 1. CLI（命令行）

安装后默认可用：

php test.php

配置文件路径：

/etc/php/8.2/cli/php.ini

五、与 Web 服务器集成

✅ 场景一：Apache + PHP

安装 Apache

sudo apt install -y apache2

安装 Apache PHP 模块

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

重启 Apache

sudo systemctl restart apache2

测试

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 -y nginx

启动 PHP-FPM

sudo systemctl start php8.2-fpm
sudo systemctl enable php8.2-fpm

配置 Nginx

编辑站点配置：

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

关键配置：

server {
    listen 80;
    server_name localhost;

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

    location / {
        try_files $uri $uri/ =404;
    }

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

重启服务

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

六、PHP 配置文件位置

模式	配置文件
CLI	`/etc/php/8.2/cli/php.ini`
FPM	`/etc/php/8.2/fpm/php.ini`
FPM Pool	`/etc/php/8.2/fpm/pool.d/www.conf`

七、常用 PHP 配置调整

编辑：

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

常见修改：

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

修改后重启：

sudo systemctl restart php8.2-fpm

八、查看 PHP 错误日志

sudo tail -f /var/log/php8.2-fpm.log

或：

/var/log/nginx/error.log

九、多 PHP 版本共存（可选）

sudo apt install php7.4 php8.1 php8.2

切换 CLI 版本：

sudo update-alternatives --config php

十、快速检查清单 ✅

[ ] php -v 正常
[ ] php-fpm 正常运行
[ ] phpinfo() 可访问
[ ] 网站能解析 .php

如果你能告诉我：

✅ Ubuntu 版本
✅ Apache 还是 Nginx
✅ 是本地开发还是服务器
✅ 是否用于 Laravel / WordPress / 自研项目

我可以给你 更精确的配置方案。