如何在Debian搭建Laravel

在 Debian 上搭建 Laravel 一般分为 系统准备 → 安装 PHP → 安装数据库 → 安装 Composer → 安装 Laravel → 配置 Web 服务器 几个步骤。下面给你一个从零开始、生产可用的流程（以 Debian 11/12 + PHP 8.2 + Nginx 为例）。

一、系统准备

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

二、安装 Nginx

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

验证：

systemctl status nginx

三、安装 PHP（推荐 8.2）

1️⃣ 添加 Sury PHP 源（Debian 官方 PHP 版本较旧）

sudo apt install -y lsb-release apt-transport-https ca-certificates
curl -sSLo /tmp/debsuryorg-archive-keyring.deb https://packages.sury.org/debsuryorg-archive-keyring.deb
sudo dpkg -i /tmp/debsuryorg-archive-keyring.deb

echo "deb [signed-by=/usr/share/keyrings/deb.sury.org-php.gpg] 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-pgsql \
php8.2-curl php8.2-mbstring \
php8.2-xml php8.2-zip \
php8.2-bcmath php8.2-redis

检查：

php -v

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

安装 MariaDB（推荐）

sudo apt install -y mariadb-server
sudo systemctl enable mariadb
sudo systemctl start mariadb

初始化安全配置

sudo mysql_secure_installation

创建 Laravel 数据库

sudo mysql -u root -p

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;
EXIT;

五、安装 Composer

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php composer-setup.php --install-dir=/usr/local/bin --filename=composer
php -r "unlink('composer-setup.php');"

验证：

composer -V

六、安装 Laravel

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

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

或者指定版本：

composer create-project laravel/laravel:^10.0 example-app

设置权限

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

七、配置 Nginx

新建站点配置

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

server {
    listen 80;
    server_name your_domain_or_ip;

    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;
    }

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

启用站点

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

八、配置 Laravel 环境

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

编辑 .env：

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

生成 key：

php artisan key:generate

九、测试访问

浏览器访问：

http://your_server_ip

看到 Laravel 欢迎页 ✅

十、常见问题排查

1️⃣ 500 错误

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

2️⃣ 权限问题

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

3️⃣ PHP-FPM 没启动

sudo systemctl status php8.2-fpm

十一、可选升级（生产建议）

✅ 使用 PHP 8.3
✅ 配置 HTTPS（Let’s Encrypt）
✅ 使用 Redis 做缓存
✅ 使用 Supervisor 管理队列
✅ 使用 Docker / Sail

如果你愿意，我可以：

✅ 帮你写 Debian + Docker 的 Laravel 部署方案
✅ 帮你配置 HTTPS + 队列 + 定时任务
✅ 帮你排查你当前报错信息

你现在是 本地测试 还是 云服务器？