//安装 Breeze

cd D:\laragon\www\engine-api

# 1. 安装 Breeze
composer require laravel/breeze --dev

# 2. 安装 Blade 版本
php artisan breeze:install blade

# 3. 安装前端依赖
npm install

# 4. 编译前端资源
npm run build

验证成功
访问 http://engine-api.test/login → 显示登录页面 ✅
注册账号 → 登录成功 ✅
访问 /dashboard → 显示「You're logged in!」

//安装 Laravel Breeze 过程中遇到的所有坑及解决方案

坑一：访问页面 404 Not Found
现象：安装 Breeze 后，访问 /login 返回 404。
原因：
Nginx 配置缺少 Laravel 重写规则（try_files $uri $uri/ /index.php?$query_string;）
配置中有访问限制（allow 127.0.0.1; deny all;）

解决方案：修改 00-default.conf，替换为 Laravel 标准配置：

即：
server {
    listen 80;
    server_name engine-api.test localhost;
    root D:/laragon/www/engine-api/public;
    index index.php index.html;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        include fastcgi_params;
        fastcgi_pass php_upstream;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }
}

坑二：Laragon 自动生成配置文件导致冲突

现象：修改完配置重启后，auto.build.test.conf 又自动生成，配置被覆盖。
原因：Laragon 默认开启了「Auto-create virtual host」功能。
解决方案：
设置→ 常规 →取消勾选自动创建虚拟主机按钮
删除自动生成的冲突文件，修改 00-default.conf，替换为 Laravel 标准配置：
配置参考坑一

坑三：Breeze 安装后前端资源未编译
现象：访问页面样式混乱或空白。
原因：未运行 npm run build 编译前端资源。
解决方案：
cd D:\laragon\www\engine-api
npm install
npm run build