debian如何搭建laravel

在 Debian 系统上搭建 Laravel 开发/运行环境，通常包含以下步骤：安装 PHP、Composer、Web 服务器（Nginx 或 Apache）、数据库（MySQL / MariaDB），然后部署 Laravel 项目。

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

一、更新系统

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 及必要扩展

Debian 默认仓库 PHP 版本可能较低，建议添加 Sury 源。

1️⃣ 添加 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 -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

2️⃣ 安装 PHP 及扩展

sudo apt update
sudo apt install -y php8.2 php8.2-fpm php8.2-cli \
php8.2-mysql php8.2-curl php8.2-mbstring \
php8.2-xml php8.2-zip php8.2-bcmath php8.2-tokenizer

检查 PHP 版本：

php -v

四、安装 Composer

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

五、安装 MySQL / MariaDB

安装 MySQL

sudo apt install mysql-server -y
sudo mysql_secure_installation

创建 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;

六、创建 Laravel 项目

方式一：使用 Composer 创建（推荐）

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

设置权限

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

编辑 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;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }

    location ~ /\.ht {
        deny all;
    }
}

启用配置：

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

八、配置 Laravel 环境

cd /var/www/example-app
cp .env.example .env
nano .env

修改数据库配置：

DB_DATABASE=laravel_db
DB_USERNAME=laravel_user
DB_PASSWORD=password

生成 APP_KEY：

php artisan key:generate

九、测试是否成功

浏览器访问：

http://your_server_ip

看到 Laravel 欢迎页面即成功 ✅

十、常见问题排查

1️⃣ 500 错误

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

2️⃣ 权限问题

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

3️⃣ PHP-FPM 未启动

sudo systemctl status php8.2-fpm

十一、可选（生产环境建议）

✅ 使用 Supervisor 管理队列
✅ 配置 HTTPS（Let’s Encrypt）
✅ 使用 Redis 作为缓存
✅ 关闭 APP_DEBUG=true

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

✅ 部署 Laravel + Docker
✅ 配置 Apache
✅ 部署到 生产环境（含 HTTPS）
✅ 优化 Debian + Laravel 性能

你现在用的是 Debian 几？本地还是服务器？