Debian如何配置Laravel

下面给你一份在 Debian 上配置 Laravel 的完整常见流程（以 Debian 11/12 + PHP 8.1/8.2 + Nginx/Apache + MySQL 为例）。你可以按需选择组件。

一、系统准备

1. 更新系统

sudo apt update
sudo apt upgrade -y

2. 安装常用工具

sudo apt install -y curl wget git unzip

二、安装 PHP 及扩展

1. 添加 Sury PHP 源（推荐）

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

（按官方说明添加 GPG 和源后）

sudo apt update

2. 安装 PHP 及 Laravel 所需扩展

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-bcmath

检查：

php -v

三、安装 Composer

cd /tmp
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/.config/composer/vendor/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

创建项目：

laravel new myproject

方式二：Composer 直接创建

composer create-project laravel/laravel myproject

五、配置 Web 服务器

方案 A：Nginx（推荐）

1. 安装 Nginx

sudo apt install -y nginx

2. 配置站点

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

示例配置：

server {
    listen 80;
    server_name your_domain_or_ip;
    root /var/www/myproject/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/myproject /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx

方案 B：Apache

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

修改虚拟主机，指向 public 目录，并允许 .htaccess。

六、配置数据库（MySQL）

sudo apt install -y mariadb-server
sudo mysql_secure_installation

创建数据库：

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

七、配置 Laravel 环境

cd /var/www/myproject
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

生成 key：

php artisan key:generate

迁移数据库：

php artisan migrate

八、权限设置（重要）

sudo chown -R www-data:www-data /var/www/myproject
sudo chmod -R 755 /var/www/myproject
sudo chmod -R 775 /var/www/myproject/storage

九、测试访问

浏览器访问：

http://your_server_ip

看到 Laravel 欢迎页即成功 ✅

十、常见补充

队列：php artisan queue:work
定时任务：配置 crontab -e

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

如果你告诉我：

Debian 版本
用 Nginx 还是 Apache
PHP 版本
是否用 Docker

我可以给你更精确的配置示例。