Debian怎么搭建Laravel环境

在 Debian 上搭建 Laravel 运行环境，一般包含以下步骤：
✅ 安装 Nginx / Apache
✅ 安装 PHP + 必要扩展
✅ 安装 Composer
✅ 安装 MySQL / MariaDB（可选）
✅ 部署 Laravel 项目

下面以 Debian 11 / 12 + Nginx + PHP 8.2 + MySQL 为例，给你一套完整流程。

一、更新系统

sudo apt update
sudo apt upgrade -y

二、安装 Nginx

sudo apt install nginx -y

启动并设置开机自启：

sudo systemctl enable nginx
sudo systemctl start nginx

浏览器访问服务器 IP，看到 Nginx 欢迎页说明成功。

三、安装 PHP 8.2（推荐）

Laravel 10/11 推荐使用 PHP 8.2 或 8.3。

1️⃣ 添加 PHP 源（Debian 默认版本可能较旧）

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

sudo 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 及 Laravel 所需扩展

sudo apt install php8.2 php8.2-fpm \
php8.2-mysql php8.2-curl php8.2-xml \
php8.2-mbstring php8.2-zip php8.2-gd \
php8.2-tokenizer php8.2-fileinfo -y

检查版本：

php -v

四、安装 Composer

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

验证：

composer -V

五、安装 MySQL / MariaDB（可选）

安装 MariaDB

sudo apt install mariadb-server -y

初始化安全配置：

sudo mysql_secure_installation

登录数据库：

sudo mysql -u root -p

创建 Laravel 数据库：

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

六、创建 Laravel 项目

方式一：新建项目

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

方式二：上传已有项目

cd /var/www
git clone your_project.git
cd your_project
composer install

七、配置目录权限

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

八、配置 Nginx

编辑配置文件：

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

示例配置：

server {
    listen 80;
    server_name your_domain_or_ip;

    root /var/www/example-app/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 reload nginx

九、配置 Laravel 环境

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

编辑数据库配置：

DB_DATABASE=laravel
DB_USERNAME=laravel
DB_PASSWORD=password

十、测试

浏览器访问：

http://服务器IP

看到 Laravel 欢迎页 ✅

十一、常见问题

❌ 500 错误

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

❌ PHP 扩展缺失

php -m

❌ 权限问题

sudo chown -R www-data:www-data /var/www/example-app

十二、可选优化

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

如果你愿意，我可以： ✅ 给你 一键安装脚本
✅ 帮你 适配 Debian 10 / 12
✅ 教你 部署 Docker + Laravel
✅ 配置 生产环境优化方案

你现在是 本地测试 还是 线上服务器？