Debian怎样安装Laravel环境

在 Debian 系统上安装 Laravel 环境，通常包括以下几个步骤：安装 PHP、Composer、Web 服务器（Nginx 或 Apache）、数据库，然后安装 Laravel。下面我给你一个完整、常用、推荐的流程（以 Debian 11/12 为例，Laravel 10/11）。

一、更新系统

sudo apt update
sudo apt upgrade -y

二、安装 PHP 及必要扩展

Laravel 对 PHP 版本有要求（Laravel 10 需要 PHP ≥ 8.1，Laravel 11 需要 PHP ≥ 8.2）。

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

2️⃣ 安装 PHP（以 PHP 8.2 为例）

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-bcmath php8.2-gd php8.2-intl

检查版本：

php -v

三、安装 Composer

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

四、安装 Web 服务器（Nginx 推荐）

1️⃣ 安装 Nginx

sudo apt install -y nginx

2️⃣ 配置 Nginx 支持 PHP

编辑配置文件：

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

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

安装 MariaDB

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

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

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

设置权限：

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

七、配置 Laravel 环境

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

编辑数据库配置：

nano .env

示例：

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=laravel
DB_PASSWORD=password

八、测试访问

浏览器访问：

http://your_server_ip

看到 Laravel 欢迎页面即成功 ✅

九、可选：安装 Node.js（前端资源）

curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install -y nodejs
node -v
npm -v

常见问题

❌ 500 错误

sudo chmod -R 755 storage bootstrap/cache

❌ PHP 版本不对

update-alternatives --config php

总结

✅ Debian 安装 Laravel 的核心步骤：

安装 PHP + 扩展
安装 Composer
安装 Nginx
安装数据库
创建 Laravel 项目
配置 .env 和权限

如果你需要 Laravel + Docker、Laravel + Apache、或 生产环境优化，我也可以继续帮你配置。