温馨提示×

Ubuntu PHP如何配置环境

小樊
45
2026-08-24 10:59:00
栏目: 编程语言

下面给你一份在 Ubuntu 上配置 PHP 运行环境的完整指南,适合 PHP + Apache / Nginx + MySQL 的常见组合。你可以按需选择。


一、更新系统

sudo apt update
sudo apt upgrade -y

二、安装 PHP(推荐 PHP 8.1 / 8.2)

1️⃣ 添加 PHP 官方 PPA(可选但推荐)

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

2️⃣ 安装 PHP 及常用扩展

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

查看版本:

php -v

三、PHP + Apache 配置(最常见)

1️⃣ 安装 Apache

sudo apt install -y apache2

2️⃣ 安装 Apache PHP 模块

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

3️⃣ 重启 Apache

sudo systemctl restart apache2

4️⃣ 测试 PHP

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

浏览器访问:

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

✅ 看到 PHP 信息页面即成功


四、PHP + Nginx 配置(推荐生产环境)

1️⃣ 安装 Nginx

sudo apt install -y nginx

2️⃣ 安装 PHP-FPM

sudo apt install -y php8.2-fpm

3️⃣ 配置 Nginx 支持 PHP

编辑站点配置:

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

修改 location ~ \.php$ 部分:

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

4️⃣ 重启服务

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

五、安装 MySQL(可选)

sudo apt install -y mysql-server
sudo mysql_secure_installation

PHP 连接 MySQL 需要:

sudo apt install -y php8.2-mysql

六、PHP 配置文件位置

类型 路径
PHP 主配置 /etc/php/8.2/cli/php.ini
Apache PHP /etc/php/8.2/apache2/php.ini
PHP-FPM /etc/php/8.2/fpm/php.ini

常用修改项:

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

修改后重启服务生效。


七、Composer(PHP 依赖管理)

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

八、常见问题排查

❌ 页面不解析 PHP

  • Apache:确认 libapache2-mod-php 已安装
  • Nginx:确认 php-fpm 正在运行

❌ 502 Bad Gateway

sudo systemctl status php8.2-fpm

九、推荐环境组合

场景 推荐
新手 / 本地 Apache + PHP
生产 / 高并发 Nginx + PHP-FPM
现代框架 PHP 8.2 + Composer

如果你告诉我:

  • Ubuntu 版本
  • Apache 还是 Nginx
  • 是否用 Laravel / ThinkPHP / WordPress

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

0