Ubuntu环境下运行PHP项目：从环境搭建到项目部署的完整指南
Ubuntu作为全球最受欢迎的Linux发行版之一,凭借其卓越的稳定性、强大的社区支持及丰富的软件生态，已成为Web开发与服务器部署的首选平台，对于PHP开发者而言，掌握在Ubuntu系统上高效运行PHP项目的技能，是提升开发效率与运维能力的关键，本文将系统阐述从环境准备、软件安装、配置优化到项目部署的全流程，助您快速构建稳定可靠的PHP运行环境。
环境准备：系统基础与工具安装
在部署PHP项目前,需确保Ubuntu系统处于最佳状态，并安装必要的开发工具，以下是详细操作步骤：
更新系统包列表
Ubuntu的软件包仓库会定期更新安全补丁和软件版本,执行以下命令确保系统保持最新状态：
sudo apt update && sudo apt upgrade -y
安装基础开发工具
PHP项目开发与运行依赖多种基础工具,包括文件传输（`curl`）、网络请求（`wget`）、版本控制（`git`）等，通过以下命令批量安装：
sudo apt install -y curl wget git unzip vim htop> **补充说明**：`htop` 提供更直观的系统资源监控，便于后续性能调优。
配置静态IP（推荐）
为保障项目访问地址的稳定性,建议为服务器配置静态IP，以Ubuntu 22.04为例，编辑网络配置文件：
network:
version: 2
ethernets:
ens33: # 替换为实际网卡名称（如eth0）
dhcp4: no
addresses: [192.168.1.100/24] # 自定义静态IP
gateway4: 192.168.1.1
nameservers:
addresses: [8.8.8.8, 114.114.114.114]
配置完成后执行以下命令使配置生效：
sudo netplan apply
安装Web服务器：Nginx与Apache的选型
Web服务器是PHP项目的入口网关,负责接收HTTP请求并转发至PHP解释器，在Ubuntu生态中，Nginx凭借其轻量级架构、高并发处理能力和反向代理优势成为主流选择，本指南以Nginx为例展开说明（Apache用户可参考类似配置逻辑）。
安装Nginx
sudo apt install -y nginx
安装完成后,Nginx将自动启动，验证服务状态：
systemctl status nginx> **测试方法**：在浏览器访问 `http://服务器IP`，若显示 "Welcome to Nginx!" 页面则安装成功。
配置Nginx虚拟主机
虚拟主机技术允许单台服务器托管多个独立网站,以下以部署 `my-php-project` 项目为例，分步配置：
（1）创建项目目录
在Web根目录下创建项目文件夹,并设置正确的权限：
sudo mkdir -p /var/www/my-php-project sudo chown -R www-data:www-data /var/www/my-php-project sudo chmod -R 755 /var/www/my-php-project> **关键点**：`www-data` 是Nginx默认运行用户，必须赋予目录所有权以避免权限问题。
（2）编写Nginx配置文件
在 `/etc/nginx/sites-available/` 创建配置文件 `my-php-project.conf`：
server {
listen 80;
server_name my-php-project.local; # 替换为实际域名或IP
root /var/www/my-php-project;
index index.php index.html index.htm;
# 安全配置：禁止访问隐藏文件
location ~ /\.ht {
deny all;
}
# 主请求处理
location / {
try_files $uri $uri/ /index.php?$query_string;
}
# PHP文件处理
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/var/run/php/php8.1-fpm.sock; # 需与PHP版本匹配
fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
fastcgi_param DOCUMENT_ROOT $realpath_root;
}
配置解析：
try_files 确保URL重写时正确路由到PHP入口fastcgi_param 显式传递脚本路径，避免相对路径问题- PHP-FPM socket路径需与后续安装的PHP版本严格对应
（3）启用虚拟主机
创建配置文件后,通过软链接启用站点：
sudo ln -s /etc/nginx/sites-available/my-php-project.conf /etc/nginx/sites-enabled/
删除默认配置（避免端口冲突）：
sudo rm /etc/nginx/sites-enabled/default
重新加载Nginx配置使更改生效：
sudo nginx -t && sudo systemctl reload nginx
安装PHP与PHP-FPM
**新增章节**：原文缺失PHP安装环节，此为核心步骤
安装PHP及扩展
通过PPA源安装最新稳定版PHP（以PHP 8.1为例）：
sudo apt install -y software-properties-common
sudo add-apt-repository -y ppa:ondrej/php
sudo apt update
sudo apt install -y php8.1 php8.1-fpm php8.1-mysql php8.1-xml php8.1-curl php8.1-zip php8.1-mbstring
> **扩展说明**：根据项目需求安装必要扩展（如`php8.1-gd`处理图像、`php8.1-bcmath`高精度计算等）
配置PHP-FPM
编辑PHP-FPM池配置文件 `/etc/php/8.1/fpm/pool.d/www.conf`：
[www]
user = www-data
group = www-data
listen = /var/run/php/php8.1-fpm.sock
listen.owner = www-data
listen.group = www-data
pm = dynamic
