debian怎么管理laravel

在 Debian 上管理 Laravel，通常包含 系统环境准备、安装 Laravel、日常管理与维护、常见运维操作 等几个方面。下面给你一套比较完整、实战向的指南（适用于 Debian 11/12）。

一、系统环境准备（PHP + 数据库 + 必要工具）

1. 更新系统

sudo apt update && sudo apt upgrade -y

2. 安装 PHP（推荐 PHP 8.2 / 8.3）

sudo apt install -y curl wget gnupg2 ca-certificates lsb-release apt-transport-https

添加 Sury PHP 源（Debian 官方 PHP 版本较旧）：

curl -sSL https://packages.sury.org/php/README.txt
wget -qO - https://packages.sury.org/php/apt.gpg | sudo apt-key add -
echo "deb https://packages.sury.org/php/ $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/sury-php.list

sudo apt update

安装 PHP 及常用扩展：

sudo apt install -y php8.2 php8.2-cli php8.2-fpm \
php8.2-mysql php8.2-pgsql php8.2-sqlite3 \
php8.2-curl php8.2-mbstring php8.2-xml \
php8.2-zip php8.2-gd php8.2-intl php8.2-redis

检查版本：

php -v

3. 安装数据库（MySQL / MariaDB）

sudo apt install -y mariadb-server
sudo mysql_secure_installation

创建 Laravel 数据库：

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

4. 安装 Composer

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

二、安装 Laravel（两种方式）

✅ 方式一：使用 Laravel 安装器（推荐）

composer global require laravel/installer

加入 PATH：

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

创建项目：

laravel new myapp

✅ 方式二：直接用 Composer

composer create-project laravel/laravel myapp

三、目录权限与运行环境

1. 目录权限

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

2. 环境配置

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

配置数据库：

DB_DATABASE=laravel_db
DB_USERNAME=laravel
DB_PASSWORD=password

四、运行 Laravel（三种方式）

✅ 1. 开发环境（Artisan）

php artisan serve

访问：

http://localhost:8000

✅ 2. Nginx + PHP-FPM（生产推荐）

安装 Nginx

sudo apt install -y nginx

配置站点

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

示例配置：

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

启用：

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

✅ 3. Apache（可选）

sudo apt install apache2 libapache2-mod-php8.2
sudo a2enmod rewrite

调整 AllowOverride All

五、日常管理 Laravel（常用命令）

1. 维护模式

php artisan down
php artisan up

2. 缓存管理

php artisan config:cache
php artisan route:cache
php artisan view:cache
php artisan cache:clear

3. 数据库迁移

php artisan migrate
php artisan migrate:rollback
php artisan migrate:fresh --seed

4. 队列（生产环境）

php artisan queue:work

后台运行（推荐 Supervisor）：

sudo apt install supervisor

示例：

[program:laravel-worker]
command=php /var/www/myapp/artisan queue:work
autostart=true
autorestart=true
user=www-data

六、Debian 上 Laravel 运维建议

✅ 使用 systemd / supervisor 管理队列
✅ 使用 cron 管理 Laravel 定时任务

crontab -e

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

✅ 使用 git + deploy 脚本 管理版本
✅ 使用 .env 区分 dev / prod
✅ 定期清理日志：

php artisan log:clear

七、常见问题

❌ 权限问题

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

❌ PHP 版本不匹配

update-alternatives --config php

❌ Composer 内存不足

COMPOSER_MEMORY_LIMIT=-1 composer install

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

✅ 写 Debian + Laravel + Nginx + Supervisor 完整部署脚本
✅ 给你一个 生产环境最佳实践清单
✅ 专门讲 Debian 上 Laravel 开发 vs 生产差异

你可以直接说：你是 开发环境 还是 线上服务器 用？