debian下laravel怎么配置

在 Debian 下配置 Laravel，一般流程是：安装运行环境 → 安装 Laravel → 配置权限和 Web 服务器。下面给你一个完整、常用、可落地的配置方案（以 Debian 11/12 + PHP 8.2 + Nginx + MySQL 为例）。

一、系统准备

1. 更新系统

sudo apt update
sudo apt upgrade -y

二、安装 PHP 及扩展（Laravel 必需）

1. 安装 PHP 8.2（推荐）

sudo apt install -y curl wget unzip
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（Laravel 依赖管理）

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

四、安装 Laravel

方式一：全局安装 Laravel 安装器（推荐）

composer global require laravel/installer

加入环境变量：

echo 'export PATH="$HOME/.config/composer/vendor/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

创建项目：

laravel new myapp

方式二：用 Composer 直接创建（更常用）

composer create-project laravel/laravel myapp

五、配置目录权限（非常重要）

cd /var/www/myapp
sudo chown -R www-data:www-data storage bootstrap/cache
sudo chmod -R 775 storage bootstrap/cache

如果你用 Nginx + PHP-FPM，用户通常是 www-data

六、配置 Nginx（推荐）

1. 安装 Nginx

sudo apt install -y nginx

2. Nginx 站点配置

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

示例配置：

server {
    listen 80;
    server_name your_domain_or_ip;

    root /var/www/myapp/public;
    index index.php;

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

3. 启用配置

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

七、配置数据库（MySQL / MariaDB）

1. 安装 MySQL

sudo apt install -y mysql-server
sudo mysql_secure_installation

2. 创建数据库

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

八、配置 Laravel 环境文件

cd /var/www/myapp
cp .env.example .env
nano .env

修改数据库部分：

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

生成 APP_KEY：

php artisan key:generate

九、运行迁移测试

php artisan migrate

访问：

http://your_domain_or_ip

看到 Laravel 欢迎页 ✅

十、常见坑（Debian 特有）

1. storage 目录无权限

sudo chown -R www-data:www-data storage

2. PHP-FPM 没启动

sudo systemctl status php8.2-fpm
sudo systemctl restart php8.2-fpm

3. Nginx 403

检查 root 是否指向 public
检查权限

十一、可选优化

安装 Redis：sudo apt install redis-server
安装 Supervisor（队列）
开启 HTTPS（Let’s Encrypt）

如果你愿意，我可以： ✅ 给你 Debian + Apache 版本
✅ 帮你 从零一步步远程配置
✅ 针对 Laravel 10 / 11 单独说明

直接告诉我你用的是 Debian 几 + Nginx/Apache + PHP 几 即可。