debian上laravel怎么配置

下面按在 Debian 上从零配置 Laravel的思路给你一个清晰、可操作的步骤（以 Debian 11/12 + Nginx + PHP 8.2 + MySQL 为例，Laravel 10/11 通用）。

一、系统准备

sudo apt update
sudo apt upgrade -y
sudo apt install -y curl git unzip software-properties-common

二、安装 PHP 及扩展

1. 添加 PHP 源（可选但推荐）

sudo apt install -y lsb-release ca-certificates
sudo curl -sSL https://packages.sury.org/php/README.txt

（按官方说明添加 sury 源，或直接用 Debian 自带 PHP）

2. 安装 PHP 8.2

sudo apt install -y php8.2 php8.2-cli 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

三、安装 Composer

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

四、安装 Nginx

sudo apt install -y nginx

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

sudo apt install -y mariadb-server
sudo mysql_secure_installation

创建数据库：

CREATE DATABASE laravel_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'laravel'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON laravel_db.* TO 'laravel'@'localhost';
FLUSH PRIVILEGES;

六、部署 Laravel 项目

1. 创建项目

cd /var/www
composer create-project laravel/laravel laravel

或已有代码：

git clone your_repo laravel
cd laravel
composer install

2. 配置权限

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

七、配置 .env

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

编辑：

APP_NAME=Laravel
APP_ENV=production
APP_DEBUG=false

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

八、配置 Nginx

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

示例配置：

server {
    listen 80;
    server_name your_domain.com;
    root /var/www/laravel/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 restart nginx

九、运行 Laravel

php artisan migrate
php artisan config:cache
php artisan route:cache

访问：

http://your_domain.com

十、常见问题

1. 403 Forbidden

检查 root 是否指向 public
检查权限和 www-data

2. PHP 版本不对

sudo update-alternatives --set php /usr/bin/php8.2

3. 队列 / 定时任务

php artisan queue:work

Cron：

* * * * * cd /var/www/laravel && php artisan schedule:run >> /dev/null 2>&1

如果你告诉我：

Debian 版本
Laravel 版本
用 Apache 还是 Nginx
是否 Docker / 宝塔 / 云服务器

我可以给你更精确的配置方案。