转载请注明出处，如有问题请联系我们！ Ubuntu VPS 部署 PHP 网站源码的完整步骤

Ubuntu VPS 部署 PHP 网站源码的完整步骤 这篇文章适合刚拿到一套 PHP 源码、准备放到 VPS 上运行的站长。很多源码在本地看起来没问题，但一放到服务器就出现 404、500、数据库连接失败、后台打不开，核心原因通常是环境版本、目录权限、伪静态和数据库配置没有处理好。

一、确认源码要求

部署前先看源码说明，尤其是 PHP 和 MySQL 版本。老源码经常要求 PHP7.3 或 PHP7.4，如果直接用 PHP8.1，可能会出现兼容问题。

• PHP 版本：7.3 / 7.4 / 8.1 是否兼容。
• 数据库版本：MySQL5.7 还是 MySQL8。
• 是否需要伪静态。
• 是否有安装目录或 SQL 文件。
• 后台入口地址和默认账号。

二、安装基础环境

apt update
apt install nginx mysql-server unzip -y
apt install php7.4-fpm php7.4-mysql php7.4-curl php7.4-mbstring php7.4-xml php7.4-zip -y
systemctl enable nginx
systemctl enable php7.4-fpm
systemctl enable mysql

三、上传源码并确认目录

假设网站目录是 /var/www/example，上传后先确认 index.php 是否在根目录。

cd /var/www/example
ls -la
find . -maxdepth 2 -name index.php

如果 index.php 在二级目录，Nginx root 就要指向真正的项目目录，不要指错。

四、导入数据库

mysql -u root -p
CREATE DATABASE example DEFAULT CHARSET utf8mb4 COLLATE utf8mb4_unicode_ci;
exit

mysql -u root -p example < database.sql

导入后检查核心表是否存在：

mysql -u root -p example
SHOW TABLES;

五、配置 Nginx

server {
    listen 80;
    server_name example.com www.example.com;
    root /var/www/example;
    index index.php index.html;

    location / {
        try_files $uri $uri/ /index.php/$uri$is_args$args;
    }

    location ~ .php$ {
        fastcgi_pass unix:/run/php/php7.4-fpm.sock;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

保存后执行：

nginx -t
systemctl reload nginx

六、设置权限

chown -R www-data:www-data /var/www/example
chmod -R 755 /var/www/example
chmod -R 777 cache runtime upload 2>/dev/null || true

七、上线检查

• 首页是否能打开。
• 分类页和文章页是否能打开。
• 后台登录是否正常。
• 上传目录是否可写。
• HTTPS 是否配置成功。

八、总结

Ubuntu 部署 PHP 网站源码的关键不是只会安装环境，而是知道每个环节怎么验证。首页打不开看 Nginx，后台报错看 PHP 日志，数据不显示看数据库和模板缓存。按这个顺序排查，效率会高很多。