debian怎么配置laravel环境

下面给你一份在 Debian（以 Debian 11 / 12 为例）上配置 Laravel 运行环境的完整常见方案，涵盖 PHP、Composer、Nginx/Apache、MySQL、权限 等。

一、更新系统

sudo apt update
sudo apt upgrade -y

二、安装 PHP 及必要扩展

Laravel 新版本一般要求 PHP 8.1+

sudo apt install -y php php-cli php-fpm \
php-mysql php-mbstring php-xml \
php-bcmath php-curl php-zip php-gd php-intl

查看 PHP 版本：

php -v

三、安装 Composer

cd /tmp
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php composer-setup.php
php -r "unlink('composer-setup.php');"
sudo mv composer.phar /usr/local/bin/composer

验证：

composer -V

四、安装 Web 服务器（Nginx 示例）

1. 安装 Nginx

sudo apt install -y nginx

2. 配置站点

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

示例配置（假设项目在 /var/www/laravel）：

server {
    listen 80;
    server_name example.com;

    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/php-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 示例）

sudo apt install -y mysql-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 项目

方式一：新建项目

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

方式二：上传已有项目

git clone your-repo.git laravel
cd laravel
composer install

七、配置 Laravel

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

编辑数据库配置：

DB_DATABASE=laravel
DB_USERNAME=laravel
DB_PASSWORD=password

八、权限配置（非常重要）

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

九、运行迁移

php artisan migrate

十、可选优化

队列

php artisan queue:work

定时任务

crontab -e

* * * * * cd /var/www/laravel && php artisan schedule:run >> /dev/null 2>&1

常见问题

500 错误：检查 .env、权限、Nginx 日志 /var/log/nginx/error.log
Composer 内存不足：

php -d memory_limit=-1 composer install

如果你愿意，我可以：

给你 Debian + Apache 版本
给你 Docker 方式
或针对 Laravel 11 / 10 特定版本

你目前用的是 Debian 几？Laravel 几？