ubuntu php怎么部署项目

ubuntu

小樊

2026-09-01 11:01:23

栏目: 编程语言

在 Ubuntu 上部署 PHP 项目，通常步骤如下（以 PHP + Nginx/Apache + MySQL 最常见）：

一、更新系统

sudo apt update
sudo apt upgrade -y

二、安装 Web 服务器（选一个）

方式 1：Nginx（推荐）

sudo apt install nginx -y

方式 2：Apache

sudo apt install apache2 -y

三、安装 PHP

sudo apt install php php-fpm php-mysql php-cli php-curl php-mbstring php-xml php-zip -y

查看版本：

php -v

四、部署项目代码

1. 上传项目

假设项目放在：

/var/www/my_project

可用方式：

scp
git clone
FTP

示例：

sudo mkdir -p /var/www/my_project
sudo chown -R $USER:$USER /var/www/my_project

五、配置 Nginx（以 Nginx 为例）

1. 创建站点配置

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

示例配置：

server {
    listen 80;
    server_name your_domain_or_ip;

    root /var/www/my_project;
    index index.php index.html;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

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

PHP 版本按实际修改（如 php8.2-fpm.sock）

2. 启用站点

sudo ln -s /etc/nginx/sites-available/my_project /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx

六、配置数据库（可选）

sudo apt install mysql-server -y
sudo mysql_secure_installation

创建数据库：

CREATE DATABASE mydb;
CREATE USER 'user'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON mydb.* TO 'user'@'localhost';
FLUSH PRIVILEGES;

七、设置权限

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

八、访问项目

浏览器访问：

http://服务器IP

九、常见问题

1. 页面显示 404

检查 root 路径
检查 index.php 是否存在

2. PHP 不解析

确认 php-fpm 已启动：

systemctl status php8.1-fpm

3. 权限错误

查看 Nginx 错误日志：

sudo tail -f /var/log/nginx/error.log

如果你用的是 Laravel / ThinkPHP / WordPress，或者想用 Docker / 宝塔面板，可以告诉我，我可以给你更具体的部署方案。