Debian怎么安装Laravel

在 Debian 上安装 Laravel，推荐的方式是通过 Composer。下面给你一套 从零开始、稳定可用 的安装流程（适用于 Debian 11 / 12）。

一、更新系统

sudo apt update
sudo apt upgrade -y

二、安装 PHP 及必要扩展

Laravel 对 PHP 版本有要求（以 Laravel 10 为例，需要 PHP ≥ 8.1）。

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

或手动：

wget -qO - https://packages.sury.org/php/apt.gpg | sudo gpg --dearmor -o /usr/share/keyrings/sury-php.gpg
echo "deb [signed-by=/usr/share/keyrings/sury-php.gpg] https://packages.sury.org/php/ $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/sury-php.list
sudo apt update

2️⃣ 安装 PHP 及 Laravel 所需扩展

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

三、安装 Composer

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

四、安装 Laravel

✅ 方式一：全局安装 Laravel 安装器（推荐）

composer global require laravel/installer

添加环境变量：

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

创建项目：

laravel new myapp

✅ 方式二：直接用 Composer 创建（最通用）

composer create-project laravel/laravel myapp

五、运行 Laravel

cd myapp
php artisan serve

访问：

http://localhost:8000

六、Web 服务器配置（可选）

1️⃣ 使用 Nginx（生产推荐）

sudo apt install -y nginx

Nginx 配置示例：

server {
    listen 80;
    server_name your_domain;
    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;
    }
}

sudo apt install -y php8.2-fpm
sudo systemctl restart nginx

七、设置权限（常见坑）

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

八、数据库（可选）

安装 MySQL：

sudo apt install -y mariadb-server

配置 .env：

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

✅ 常见问题

问题	解决
PHP 版本太低	使用 Sury PHP 源
composer 命令不存在	检查 PATH
storage 权限报错	设置 www-data 权限
400 / 500 错误	检查 Nginx + PHP-FPM

如果你愿意，我可以：

✅ 给你一个 Debian + Nginx + MySQL + Laravel 完整一键脚本
✅ 帮你选 Laravel 版本和 PHP 版本对应表
✅ 教你 用 Docker 安装 Laravel（最简单）

你现在用的是 Debian 几？桌面还是服务器？