如何在ubuntu中部署php项目

如何在 Ubuntu 中部署 PHP 项目

在 Ubuntu 上搞定 PHP 项目部署，听起来步骤不少，但拆开了看，其实就是环境准备、Web 服务器配置、项目文件上传、数据库连接，再加一道安全防护。把这些环节理顺了，整个过程并没有想象中那么复杂。下面把每一步的关键细节和操作都梳理一遍。

1. 准备系统环境

动手之前，先把系统环境收拾利落。更新软件包是常规操作，确保所有后续安装的组件都基于最新版本，避免因为依赖版本过旧而翻车：

sudo apt update && sudo apt upgrade -y

2. 安装 Web 服务器（Apache / Nginx）

选哪个服务器，取决于项目本身的特性。传统项目图省心，Apache 是个稳妥的选择；如果项目对并发要求较高，Nginx 的表现更抢眼。这里把两种方案都列出来。

2.1 安装 Apache（适合传统项目）

sudo apt install apache2 -y
sudo systemctl start apache2 && sudo systemctl enable apache2

验证一下是否跑起来了：浏览器输入 http://服务器IP，如果看到 Apache 的默认欢迎页面，说明一切正常。

2.2 安装 Nginx（适合高并发项目）

sudo apt install nginx -y
sudo systemctl start nginx && sudo systemctl enable nginx

同样，浏览器访问 http://服务器IP，Nginx 的默认欢迎页出现就表示安装成功。

3. 安装 PHP 及必要扩展

PHP 版本按项目需求来定，这里以 PHP 8.3 为例，它和 MySQL、GD、MBString 这些常用扩展配合得不错。通过 Ondřej Surý 的 PPA 可以拿到最新的稳定版：

# 添加 Ondřej Surý 的 PHP PPA（提供最新稳定版）
sudo apt install software-properties-common -y
sudo add-apt-repository ppa:ondrej/php -y
sudo apt update

# 安装 PHP 及扩展
sudo apt install php8.3 php8.3-fpm php8.3-mysql php8.3-curl php8.3-gd php8.3-mbstring php8.3-xml -y

# 启动 PHP-FPM 并设置开机自启
sudo systemctl start php8.3-fpm && sudo systemctl enable php8.3-fpm

装完之后，跑一下 php -v，如果能输出 PHP 8.3.x 之类的版本信息，这一步就算稳了。

4. 配置 Web 服务器支持 PHP

4.1 Apache 配置（集成 PHP-FPM）

Apache 需要靠 proxy_fcgi 模块来和 PHP-FPM 通信。先打开几个必要的模块：

sudo a2enmod proxy proxy_fcgi rewrite

然后编辑虚拟主机配置（以默认站点为例）：

sudo nano /etc/apache2/sites-a vailable/000-default.conf

在 块里，把项目路径和 PHP 处理规则加进去：

    ServerAdmin webmaster@localhost
    DocumentRoot /var/www/html/your_project  # 替换为项目目录
    ServerName yourdomain.com  # 替换为域名或 IP

    
        Options Indexes FollowSymLinks
        AllowOverride All  # 允许 .htaccess 覆盖
        Require all granted
    

    # PHP-FPM 处理配置
    
        SetHandler "proxy:unix:/run/php/php8.3-fpm.sock|fcgi://localhost"
    

最后启用配置并重载 Apache：

sudo a2ensite 000-default.conf
sudo systemctl reload apache2

4.2 Nginx 配置（支持 PHP 解析）

Nginx 的做法是通过 fastcgi_pass 把 PHP 请求转交给 PHP-FPM。编辑默认站点配置：

sudo nano /etc/nginx/sites-a vailable/default

在 server 块里，核心配置如下：

server {
    listen 80;
    server_name yourdomain.com;  # 替换为域名或 IP
    root /var/www/html/your_project;  # 替换为项目目录
    index index.php index.html index.htm;

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

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.3-fpm.sock;  # 根据 PHP 版本调整
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }

    location ~ /\.ht {
        deny all;
    }
}

配置完后，先测试语法，没问题就重载 Nginx：

sudo nginx -t && sudo systemctl reload nginx

5. 部署 PHP 项目

将本地项目文件上传到 Web 服务器的目录（比如 /var/www/html/your_project），可以用 scp、rsync 或 FileZilla 这类工具：

# 示例：使用 scp 上传项目（本地目录为 ~/project，服务器 IP 为 192.168.1.100）
scp -r ~/project/* user@192.168.1.100:/var/www/html/your_project

文件到位后，调整一下目录权限。Web 服务器的用户 www-data 必须能读写项目文件：

sudo chown -R www-data:www-data /var/www/html/your_project
sudo find /var/www/html/your_project -type f -exec chmod 644 {} \;  # 文件权限 644
sudo find /var/www/html/your_project -type d -exec chmod 755 {} \;  # 目录权限 755

6. 配置数据库（如需）

如果项目需要数据库支持，以 MySQL 为例，先把服务器装上：

sudo apt install mysql-server -y
sudo systemctl start mysql && sudo systemctl enable mysql

接着运行安全设置脚本，配置 root 密码并移除匿名账户等：

sudo mysql_secure_installation

然后登录 MySQL，创建数据库和对应的用户：

sudo mysql -u root -p

在 MySQL shell 中执行：

CREATE DATABASE your_database;  -- 创建数据库
CREATE USER 'your_user'@'localhost' IDENTIFIED BY 'your_password';  -- 创建用户
GRANT ALL PRIVILEGES ON your_database.* TO 'your_user'@'localhost';  -- 授权
FLUSH PRIVILEGES;  -- 刷新权限
EXIT;

最后在项目的配置文件（如 config.php）中填入数据库连接信息：

define('DB_HOST', 'localhost');
define('DB_USER', 'your_user');
define('DB_PASS', 'your_password');
define('DB_NAME', 'your_database');

7. 测试部署

在浏览器里访问 http://yourdomain.com（或服务器 IP），如果项目首页正常渲染，那就说明部署成功了。万一出了问题，别慌，从日志里找线索往往最快：

• Apache 错误日志：/var/log/apache2/error.log
• Nginx 错误日志：/var/log/nginx/error.log
• PHP 错误日志：/var/log/php8.3-fpm.log（记得在 php.ini 中把 log_errors = On 打开）

8. 安全优化（可选但重要）

项目上线前，做几道安全加固能省掉很多麻烦。用 UFW 配置防火墙，只允许 HTTP/HTTPS 流量通过：

sudo ufw allow 'Apache Full'  # 或 'Nginx Full'
sudo ufw enable

HTTPS 现在几乎是标配，用 Let’s Encrypt 可以免费拿到 SSL 证书：

sudo apt install certbot python3-certbot-apache  # Apache
# 或 sudo apt install certbot python3-certbot-nginx  # Nginx
sudo certbot --apache -d yourdomain.com  # 替换为域名
sudo certbot --nginx -d yourdomain.com  # 替换为域名

还有一点很关键：上线后一定要把项目配置里的 display_errors 关掉（设为 Off），否则敏感信息可能直接暴露在用户面前。

走完这些步骤，一个 PHP 项目在 Ubuntu 上的部署就已经成型了。当然，实际项目中可能还会用到 Composer、Redis 或者其他组件，到时候按需调整就行。