debian上laravel怎样配置

下面给你一份在 Debian 上配置 Laravel 的完整思路，从系统环境到常见配置，适合新手到中等水平用户。

一、系统准备（Debian）

以 Debian 11 / 12 为例。

1. 更新系统

sudo apt update
sudo apt upgrade -y

二、安装运行环境（PHP + Nginx/Apache + MySQL）

1. 安装 PHP（以 PHP 8.2 为例）

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

查看版本：

php -v

2. 安装 Composer

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

验证：

composer -V

3. 安装 Nginx（推荐）

sudo apt install -y nginx

4. 安装数据库（MySQL / MariaDB）

sudo apt install -y mariadb-server
sudo mysql_secure_installation

创建数据库：

CREATE DATABASE laravel_db;
CREATE USER 'laravel'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON laravel_db.* TO 'laravel'@'localhost';
FLUSH PRIVILEGES;

三、安装 Laravel

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

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

方式二：全局安装 Laravel 安装器

composer global require laravel/installer

四、Laravel 基础配置

1. 目录权限

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

2. 配置 .env

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

编辑数据库配置：

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

五、配置 Nginx（重点）

新建配置文件：

sudo nano /etc/nginx/sites-available/example-app

示例配置：

server {
    listen 80;
    server_name example.com;

    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:/var/run/php/php8.2-fpm.sock;
    }

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

启用站点：

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

六、运行与测试

php artisan migrate

浏览器访问：

http://服务器IP

七、常见问题

1. 500 错误

• 检查 .env
• 检查 storage 权限
• 查看日志：

tail -f storage/logs/laravel.log

2. 路由 404

• Nginx 未配置 try_files
• 未重启 Nginx

3. 队列 / 定时任务（可选）

php artisan queue:work

Cron：

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

如果你愿意，我可以：

• 给你 Debian + Laravel + Docker 方案
• 或 生产环境 HTTPS（Let’s Encrypt） 配置
• 或 Laravel + PostgreSQL / Redis 配置

你现在是本地测试还是服务器部署？