安装与起步 (Installation)

Laravel 致力于让开发者的整个体验尽善尽美。无论你是初次接触 PHP 还是经验丰富的开发者，都可以通过多种方式快速搭建 Laravel 环境。

系统要求

在安装 Laravel 之前，请确保你的本地开发环境满足以下基本条件：

• PHP >= 8.2 (推荐 PHP 8.3+)
• Composer (PHP 依赖包管理工具)
• Node.js & NPM (用于前端资产编译，推荐 LTS 版本)
• 数据库 (SQLite / MySQL 8.0+ / PostgreSQL 15+ / Redis)

---

快速创建项目

方式一：使用 Composer 一键创建（推荐）

打开你的终端，执行以下命令即可创建一个名为 example-app 的全新 Laravel 项目：

composer create-project laravel/laravel example-app
cd example-app
php artisan serve

随后在浏览器中访问 http://localhost:8000，你将看到令人赏心悦目的 Laravel 欢迎界面！

---

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

如果你经常创建新项目，可以全局安装 Laravel 命令行工具：

composer global require laravel/installer

# 通过交互式向导快速初始化项目（可自由选择数据库、Starter Kit 和 Git 仓库）
laravel new example-app

---

初始配置

环境配置文件

Laravel 的所有核心配置均在 config 目录下。此外，根目录下的 .env 文件用于存放与本地环境相关的敏感配置（如数据库凭证、缓存驱动等）。

APP_NAME=Laravel
APP_ENV=local
APP_KEY=base64:YOUR_GENERATED_APP_KEY
APP_DEBUG=true
APP_TIMEZONE=Asia/Shanghai
APP_URL=http://localhost:8000

DB_CONNECTION=sqlite
# 或配置 MySQL / PostgreSQL
# DB_CONNECTION=mysql
# DB_HOST=127.0.0.1
# DB_PORT=3306
# DB_DATABASE=laravel_db
# DB_USERNAME=root
# DB_PASSWORD=secret

提示：如果项目缺少 APP_KEY，请执行 php artisan key:generate 自动生成应用安全密钥。

---

本地开发服务器

执行以下 Artisan 指令启动内置开发服务器：

php artisan serve

若需同时编译前端资产并启用热重载（Vite HMR），可以另起终端运行：

npm install && npm run dev