跳转到主要内容

​
环境要求

在开始使用 Laravel 之前，你需要以下环境：
  • PHP 8.3 及以上
  • Composer（PHP 的包管理器）
  • Laravel Installer（可选，但推荐）
编译前端资源时还需要 Node.js/npm 或 Bun。

​
安装 PHP 与 Laravel Installer

同时安装 PHP、Composer 与 Laravel Installer 最简单的方式，是根据你的操作系统执行以下命令。 
/bin/bash -c "$(curl -fsSL https://php.new/install/mac/8.4)"

Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://php.new/install/windows/8.4'))

/bin/bash -c "$(curl -fsSL https://php.new/install/linux/8.4)"
执行命令后，请重启终端会话。 如果你已经安装了 PHP 和 Composer，可以只通过 Composer 安装 Laravel Installer。 
composer global require laravel/installer
如果你希望使用图形化的 PHP 管理工具，也可以查看 使用 Laravel Herd 安装。

​
创建新的 Laravel 应用

准备好 PHP、Composer 与 Laravel Installer 后，就可以创建新的 Laravel 应用了。 安装器会引导你选择测试框架、数据库以及启动套件。 
laravel new example-app
应用创建完成后，通过 dev Composer 脚本启动开发服务器。 
cd example-app
npm install && npm run build
composer run dev
开发服务器启动后，在浏览器中访问 http://localhost:8000。
使用启动套件时，会自动生成包含认证功能的项目脚手架。Laravel 13 提供 React、Vue、Svelte、Livewire 四种选择。

​
启动套件的选项

执行 laravel new 命令时，你可以从以下启动套件中选择一种。
基于 Inertia 的 React 前端启动套件。采用 React 19、TypeScript、Tailwind 与 shadcn/ui，提供了将 SPA 与服务端路由结合的现代方案。
基于 Inertia 的 Vue 前端启动套件。采用 Vue Composition API、TypeScript、Tailwind 与 shadcn-vue。
基于 Inertia 的 Svelte 前端启动套件。采用 Svelte 5、TypeScript、Tailwind 与 shadcn-svelte。
基于 Laravel Livewire 的启动套件。只用 PHP 就可以构建动态 UI，最适合以 Blade 模板为主的团队。采用 Tailwind 与 Flux UI。
如果你不确定选择哪种方案，请先在前端中梳理 Blade、Livewire、Inertia、SPA 的差异，会更容易判断。

​
使用 Laravel Herd 安装

Laravel Herd 是面向 macOS 与 Windows 的原生 Laravel / PHP 开发环境。 它可以一次性安装 PHP、Nginx 与 Laravel CLI。

​
macOS

  1. 从 Herd 官网下载安装器。
  2. 运行安装器后，PHP 会被自动配置。
  3. ~/Herd 目录会被设置为停靠目录（parked directory）。
cd ~/Herd
laravel new my-app
cd my-app
herd open

​
Windows

  1. 从 Herd 官网下载 Windows 安装器。
  2. 安装完成后启动 Herd，并完成引导流程。
  3. %USERPROFILE%\Herd 会成为停靠目录。
cd ~\Herd
laravel new my-app
cd my-app
herd open

​
初始配置

​
环境配置

Laravel 中许多配置项会因环境不同而变化。 因此，你需要通过应用根目录的 .env 文件来管理重要的配置。
请不要将 .env 文件提交到版本控制。 否则可能导致机密信息泄露。

​
数据库配置

默认情况下，Laravel 使用 SQLite。 如果要使用 MySQL 或 PostgreSQL，请修改 .env 文件。 
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=root
DB_PASSWORD=
如果使用 SQLite 之外的数据库，请运行迁移来创建数据表。 
php artisan migrate

​
IDE 支持

安装官方的 Laravel VS Code Extension 即可获得语法高亮、代码片段、Artisan 命令集成、Eloquent 模型智能补全等 Laravel 支持。
PhpStorm 对 Laravel 框架有内置支持，可对 Blade 模板、Eloquent 模型、路由、视图与翻译进行智能补全。

​
下一步

目录结构

了解 Laravel 项目的主要目录与文件。
最后修改于 2026年7月13日

相关主题

Laravel ReverbLaravel Boost广播Laravel PintLaravel Telescope