如何在Debian安装Laravel

以下是在 Debian 系统上安装 Laravel 的完整流程（适用于 Debian 11 / 12，其他版本类似）。

一、安装基础依赖

1. 更新系统

sudo apt update
sudo apt upgrade -y

2. 安装必要软件

sudo apt install -y curl wget git unzip

二、安装 PHP 及扩展

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

1. 添加 Sury PHP 源（推荐）

sudo apt install -y lsb-release apt-transport-https ca-certificates
curl -sSLo /tmp/debsuryorg-archive-keyring.deb https://packages.sury.org/debsuryorg-archive-keyring.deb
sudo dpkg -i /tmp/debsuryorg-archive-keyring.deb
echo "deb [signed-by=/usr/share/keyrings/deb.sury.org-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-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-tokenizer \
php8.2-fileinfo

检查版本：

php -v

三、安装 Composer

Laravel 使用 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

五、配置环境

1. 进入项目目录

cd myapp

2. 设置权限

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

3. 配置环境文件

cp .env.example .env
php artisan key:generate

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

方式一：使用 Nginx（推荐）

安装 Nginx

sudo apt install -y nginx

Nginx 配置示例

server {
    listen 80;
    server_name your_domain_or_ip;
    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 systemctl restart nginx
sudo systemctl restart php8.2-fpm

方式二：使用 Apache

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

确保 AllowOverride All 已启用。

七、运行 Laravel（开发环境）

无需 Web 服务器：

php artisan serve

访问：

http://localhost:8000

八、常见问题

1. 权限问题

sudo chmod -R 777 storage bootstrap/cache

2. Composer 内存不足

php -d memory_limit=-1 /usr/local/bin/composer install

九、总结

✅ Debian
✅ PHP + 扩展
✅ Composer
✅ Laravel
✅ Nginx / Apache

如果你需要 指定 Laravel 版本、使用 Docker、配置 MySQL / Redis，可以告诉我你的具体需求。