debian怎么部署laravel

在 Debian 上部署 Laravel，一般流程是：系统准备 → 安装 PHP → 安装 Web 服务器（Nginx/Apache）→ 安装数据库 → 安装 Composer → 部署 Laravel → 配置权限 → 配置 Web 服务器 → 优化。下面给你一个当前主流、生产环境常用的完整示例（以 Debian 11/12 + Nginx + PHP 8.2 + MySQL 为例）。

一、系统准备

sudo apt update
sudo apt upgrade -y
sudo apt install -y curl wget git unzip

二、安装 PHP 8.2（推荐）

Laravel 10/11 要求 PHP ≥ 8.1，建议 8.2。

1️⃣ 添加 PHP 源（Debian 默认版本可能较旧）

sudo apt install -y lsb-release apt-transport-https ca-certificates
curl -sSL https://packages.sury.org/php/README.txt
wget -qO - https://packages.sury.org/php/apt.gpg | sudo apt-key add -
echo "deb https://packages.sury.org/php/ $(lsb_release -sc) main" | \
sudo tee /etc/apt/sources.list.d/sury-php.list

sudo apt update

2️⃣ 安装 PHP 及常用扩展

sudo apt install -y php8.2 php8.2-fpm \
php8.2-mysql php8.2-mbstring php8.2-xml \
php8.2-curl php8.2-zip php8.2-gd php8.2-intl

检查版本：

php -v

三、安装 Nginx

sudo apt install -y nginx

启动并设置开机自启：

sudo systemctl enable nginx
sudo systemctl start nginx

四、安装数据库（MySQL / MariaDB）

安装 MySQL

sudo apt install -y mysql-server
sudo mysql_secure_installation

创建 Laravel 数据库

CREATE DATABASE laravel_db;
CREATE USER 'laravel_user'@'localhost' IDENTIFIED BY 'strong_password';
GRANT ALL PRIVILEGES ON laravel_db.* TO 'laravel_user'@'localhost';
FLUSH PRIVILEGES;

五、安装 Composer

curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer
composer -V

六、部署 Laravel 项目

方式一：从 Git 拉取（推荐）

cd /var/www
sudo git clone https://github.com/yourname/laravel-project.git
cd laravel-project

安装依赖：

composer install --no-dev --optimize-autoloader

方式二：上传项目压缩包（略）

七、配置 Laravel 环境

cp .env.example .env
php artisan key:generate

修改数据库配置：

DB_DATABASE=laravel_db
DB_USERNAME=laravel_user
DB_PASSWORD=strong_password

测试数据库连接：

php artisan migrate

八、设置目录权限（非常重要）

sudo chown -R www-data:www-data /var/www/laravel-project
sudo chmod -R 755 /var/www/laravel-project
sudo chmod -R 777 /var/www/laravel-project/storage
sudo chmod -R 777 /var/www/laravel-project/bootstrap/cache

九、配置 Nginx 虚拟主机

新建配置文件

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

示例配置（PHP 8.2）

server {
    listen 80;
    server_name yourdomain.com;

    root /var/www/laravel-project/public;
    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.2-fpm.sock;
    }

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

启用站点

sudo ln -s /etc/nginx/sites-available/laravel /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

十、优化 Laravel（生产环境）

php artisan config:cache
php artisan route:cache
php artisan view:cache

十一、常见问题排查

❌ 500 错误

tail -f /var/www/laravel-project/storage/logs/laravel.log

❌ PHP 不解析

sudo systemctl status php8.2-fpm

❌ 权限问题

sudo chown -R www-data:www-data /var/www/laravel-project

十二、可选增强

✅ HTTPS（Let’s Encrypt）

sudo apt install certbot python3-certbot-nginx
sudo certbot --nginx

✅ 队列 / 定时任务

php artisan queue:work
crontab -e
# * * * * * php /var/www/laravel-project/artisan schedule:run

如果你愿意，我可以：

✅ 给你 Debian + Apache 版本
✅ 做成 一键部署脚本
✅ 针对 Laravel 11 / 12 单独说明
✅ 帮你排查你当前报错

直接告诉我你用的 Debian 版本 + Laravel 版本 即可。