Debian下Laravel如何配置

在 Debian 系统下配置 Laravel，一般包含 系统环境准备、PHP、数据库、Composer、Laravel 安装、权限与 Web 服务器配置 等步骤。下面给你一套 完整且常用的配置流程（以 Debian 11/12 + Laravel 10/11 为例）。

一、更新系统

sudo apt update
sudo apt upgrade -y

二、安装 Nginx（或 Apache）

1️⃣ 安装 Nginx（推荐）

sudo apt install nginx -y

启动并设置开机自启：

sudo systemctl enable nginx
sudo systemctl start nginx

三、安装 PHP（Laravel 必需）

Laravel 10+ 要求 PHP ≥ 8.1

1️⃣ 添加 Sury PHP 源（推荐）

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

2️⃣ 安装 PHP 及扩展

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

检查版本：

php -v

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

1️⃣ 安装 MariaDB（推荐）

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

2️⃣ 初始化数据库

sudo mysql_secure_installation

3️⃣ 创建 Laravel 数据库

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

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

六、创建 Laravel 项目

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

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

方式二：已有项目

git clone your_project.git
cd your_project
composer install

七、配置 Laravel 环境

cd /var/www/laravel
cp .env.example .env
php artisan key:generate

编辑 .env：

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

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

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

九、配置 Nginx 虚拟主机

创建配置文件：

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

内容示例：

server {
    listen 80;
    server_name your_domain_or_ip;

    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

浏览器访问：

http://your_server_ip

或本地：

php artisan serve

十一、常见问题排查

1️⃣ 500 错误

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

2️⃣ PHP 不解析

sudo systemctl status php8.2-fpm

3️⃣ 权限错误

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

十二、可选优化

✅ Redis / Memcached
✅ Supervisor（队列）
✅ HTTPS（Let’s Encrypt）
✅ Laravel Octane（Swoole/RoadRunner）

如果你愿意，我可以帮你：

✅ 写一份 Debian + Laravel 生产环境完整部署脚本
✅ 配置 HTTPS
✅ Docker + Laravel
✅ Laravel 队列 / 定时任务

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