PHP如何适配Ubuntu系统

PHP 适配 Ubuntu 系统，通常指的是在 Ubuntu 上安装、配置并运行 PHP，以及让它与 Web 服务器（如 Nginx / Apache） 和 数据库（如 MySQL） 协同工作。下面按从零到可用的流程说明。

一、在 Ubuntu 上安装 PHP

1️⃣ 更新系统

sudo apt update
sudo apt upgrade -y

2️⃣ 安装 PHP（推荐方式）

✅ Ubuntu 20.04 / 22.04 默认安装

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 与 Web 服务器适配

✅ 方案一：PHP + Apache（最简单）

sudo apt install apache2 libapache2-mod-php -y

重启 Apache：

sudo systemctl restart apache2

测试：

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

访问：

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

✅ 方案二：PHP + Nginx（生产环境推荐）

1️⃣ 安装 Nginx 和 PHP-FPM

sudo apt install nginx php-fpm -y

2️⃣ 修改 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/php-fpm.sock;
    }
}

3️⃣ 重启服务

sudo systemctl restart nginx
sudo systemctl restart php-fpm

三、PHP 运行环境适配（路径 & 权限）

1️⃣ PHP 配置文件位置

/etc/php/8.x/

• php.ini → 主配置
• fpm/pool.d/www.conf → PHP-FPM 配置

2️⃣ 常见配置调整

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

修改后重启：

sudo systemctl restart php-fpm

3️⃣ 权限问题（非常重要）

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

四、PHP 与数据库适配（MySQL）

sudo apt install mysql-server php-mysql -y

测试连接：

<?php
$mysqli = new mysqli("localhost", "user", "password", "db");
if ($mysqli->connect_error) {
    die("连接失败: " . $mysqli->connect_error);
}
echo "MySQL 连接成功";

五、Ubuntu 版本与 PHP 版本对照

如需新版本 PHP：

sudo apt install software-properties-common
sudo add-apt-repository ppa:ondrej/php
sudo apt update
sudo apt install php8.2 php8.2-fpm

六、常见问题排查

❌ PHP 文件直接下载

✅ 原因：Web 服务器未解析 PHP
✅ 解决：检查 PHP-FPM / Apache mod_php

❌ 502 Bad Gateway

✅ 检查：

ls /run/php/

Nginx 中 fastcgi_pass 路径是否一致

七、总结一句话

PHP 适配 Ubuntu = 安装 PHP + 配置 Web 服务 + 调整权限 + 安装扩展

如果你有具体场景（比如 Laravel / ThinkPHP / WordPress / Docker / 宝塔），可以告诉我，我可以给你针对性配置方案。