Laravel 本地开发指南
使用 Laravel 与 Artisan 在 localhost:8000 运行 PHP 全栈应用，可选 Sail、Herd 或 XAMPP 环境。
Laravel 是 PHP 最流行的 Web 框架之一，适合 API、后台管理与全栈应用。本地开发默认通过 php artisan serve 在 localhost:8000 启动内置服务器。
默认 localhost 访问
| 方式 | 地址 |
|---|---|
php artisan serve | http://localhost:8000 |
| 指定端口 | php artisan serve --port=8080 |
| Laravel Sail（Docker） | 映射端口见 .env 中 APP_PORT |
快速开始
composer create-project laravel/laravel my-app
cd my-app
cp .env.example .env
php artisan key:generate
php artisan serve浏览器打开 http://localhost:8000 看到 Laravel 欢迎页即成功。
数据库配置
.env 示例（MySQL + XAMPP）：
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=root
DB_PASSWORD=迁移：
php artisan migratePostgreSQL 将 DB_CONNECTION=pgsql，DB_PORT=5432。
本地环境选择
| 方案 | 说明 |
|---|---|
| artisan serve | 最快上手，适合学习与小项目 |
| Laravel Sail | Docker 封装 PHP、MySQL、Redis、Mailpit |
| Laravel Herd / Valet | macOS 原生 .test 域名 |
| XAMPP / Laragon | 传统 Apache + PHP，配置虚拟主机指向 public/ |
生产级目录结构：Web 根必须指向 public/，勿将整个项目暴露到 Apache 根目录。
常用命令
php artisan make:controller UserController
php artisan route:list
php artisan queue:work
php artisan tinker
npm run dev # Vite 前端资源（Laravel 9+）Laravel 前端资源同样使用 Vite，dev 时另开 http://localhost:5173 加载 HMR。
常见问题
500 错误 / storage 权限chmod -R 775 storage bootstrap/cache，确保 Web 用户可写。
Vite 资源 404
同时运行 php artisan serve 与 npm run dev。
Composer 内存不足COMPOSER_MEMORY_LIMIT=-1 composer install
小结
Laravel 本地最快路径：php artisan serve → **http://localhost:8000**；团队项目推荐 Sail 或 Laragon/Herd 统一 PHP 版本与扩展。