Debian怎么搭建Laravel

下面给你一个在 Debian（10/11/12 通用）上从零搭建 Laravel 的完整流程，适合新手照着做。

一、准备环境（系统更新）

sudo apt update
sudo apt upgrade -y

二、安装 Nginx（Web 服务器）

sudo apt install nginx -y

启动并设置开机自启：

sudo systemctl enable nginx
sudo systemctl start nginx

浏览器访问服务器 IP，看到 Nginx 欢迎页说明成功。

三、安装 PHP（Laravel 必需）

1️⃣ 安装 PHP 及常用扩展

Laravel 需要 PHP 8.1+（以 8.2 为例）：

sudo apt install -y \
php8.2 \
php8.2-fpm \
php8.2-mysql \
php8.2-xml \
php8.2-curl \
php8.2-mbstring \
php8.2-zip \
php8.2-bcmath \
php8.2-tokenizer \
php8.2-fileinfo

检查版本：

php -v

四、安装 MySQL（数据库）

sudo apt install mysql-server -y
sudo mysql_secure_installation

创建数据库

sudo mysql -u root -p

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

五、安装 Composer（PHP 依赖管理）

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

六、创建 Laravel 项目

方式一：新建项目（推荐）

cd /var/www
sudo composer create-project laravel/laravel example-app

方式二：已有项目

git clone your_project.git
cd your_project
composer install

七、配置权限（非常重要）

sudo chown -R www-data:www-data /var/www/example-app
sudo chmod -R 755 /var/www/example-app
sudo chmod -R 777 /var/www/example-app/storage
sudo chmod -R 777 /var/www/example-app/bootstrap/cache

八、配置 .env 文件

cd /var/www/example-app
cp .env.example .env

编辑：

nano .env

重点修改：

APP_ENV=production
APP_DEBUG=false
APP_URL=http://your_ip

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel_db
DB_USERNAME=laravel_user
DB_PASSWORD=password

生成 key：

php artisan key:generate

九、配置 Nginx 站点

新建配置文件：

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

内容如下（重点）：

server {
    listen 80;
    server_name your_ip_or_domain;

    root /var/www/example-app/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;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }

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

启用站点：

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

十、测试 Laravel

浏览器访问：

http://服务器IP

看到 Laravel 欢迎页 ✅

十一、常见问题排查

❌ 502 Bad Gateway

sudo systemctl status php8.2-fpm

❌ 权限问题

sudo chown -R www-data:www-data /var/www/example-app

❌ 白屏

tail -f /var/www/example-app/storage/logs/laravel.log

十二、可选（生产环境建议）

✅ 安装 Redis
✅ 配置 HTTPS（Let’s Encrypt）
✅ 使用 Supervisor 管理队列
✅ 开启 OPCache

如果你愿意，我可以：

• 给你 Debian + Docker 搭建 Laravel
• 或 一步步帮你排查报错
• 或 直接给你生产环境完整配置

你现在是 本地 / 云服务器 / 虚拟机？