Laravel - 面向 Web 工匠的 PHP 框架

你需要的一切，让你变得出色。

开箱即用，Laravel 为所有现代 Web 应用程序所需的常见功能提供了优雅的解决方案。现在是开始构建令人惊叹的应用程序，并停止浪费时间搜索包和重新发明轮子的时候了。

身份验证

验证用户身份就像在 Laravel 路由定义中添加身份验证中间件一样简单

Route::get('/profile', ProfileController::class)
    ->middleware('auth');

用户身份验证后，你可以通过 Auth 门面访问已通过身份验证的用户

use Illuminate\Support\Facades\Auth;
 
// Get the currently authenticated user...
$user = Auth::user();

当然，你可以定义自己的身份验证中间件，从而自定义身份验证过程。

有关 Laravel 身份验证功能的更多信息，请查看身份验证文档。

授权

你经常需要检查已通过身份验证的用户是否被授权执行特定操作。Laravel 的模型策略使之变得轻而易举

php artisan make:policy UserPolicy

在生成的策略类中定义授权规则后，你可以在控制器方法中授权用户的请求

public function update(Request $request, Invoice $invoice)
{
    Gate::authorize('update', $invoice);
 
    $invoice->update(/* ... */);
}

了解更多

Eloquent ORM

害怕数据库？别怕。Laravel 的 Eloquent ORM 使与应用程序的数据交互变得轻松，并且可以快速搭建模型、迁移和关系

php artisan make:model Invoice --migration

定义模型结构和关系后，你可以使用 Eloquent 强大的、富有表现力的语法与数据库进行交互

// Create a related model...
$user->invoices()->create(['amount' => 100]);
 
// Update a model...
$invoice->update(['amount' => 200]);
 
// Retrieve models...
$invoices = Invoice::unpaid()->where('amount', '>=', 100)->get();
 
// Rich API for model interactions...
$invoices->each->pay();

了解更多

数据库迁移

迁移就像数据库的版本控制，允许你的团队定义和共享应用程序的数据库架构定义

public function up(): void
{
    Schema::create('flights', function (Blueprint $table) {
        $table->uuid()->primary();
        $table->foreignUuid('airline_id')->constrained();
        $table->string('name');
        $table->timestamps();
    });
}

了解更多

验证

Laravel 拥有超过 90 条强大的内置验证规则，并且使用 Laravel Precognition，可以在你的前端提供实时验证

public function update(Request $request)
{
    $validated = $request->validate([
        'email' => 'required|email|unique:users',
        'password' => Password::required()->min(8)->uncompromised(),
    ]);
 
    $request->user()->update($validated);
}

了解更多

通知和邮件

使用 Laravel 通过电子邮件、Slack、SMS、应用程序内等方式快速向用户发送精美样式的通知

php artisan make:notification InvoicePaid

生成通知后，你可以轻松地将消息发送给应用程序的某个用户

$user->notify(new InvoicePaid($invoice));

了解更多

文件存储

Laravel 提供了一个强大的文件系统抽象层，为与本地文件系统和基于云的文件系统（如 Amazon S3）交互提供单一、统一的 API

$path = $request->file('avatar')->store('s3');

无论文件存储在何处，都可以使用 Laravel 简单、优雅的语法与它们进行交互

$content = Storage::get('photo.jpg');
 
Storage::put('photo.jpg', $content);

了解更多

作业队列

Laravel 允许你将缓慢的作业卸载到后台队列，从而保持 Web 请求的快速响应

$podcast = Podcast::create(/* ... */);
 
ProcessPodcast::dispatch($podcast)->onQueue('podcasts');

你可以运行任意数量的队列工作进程来处理你的工作负载

php artisan queue:work redis --queue=podcasts

为了更好地了解和控制队列，Laravel Horizon 为 Laravel 驱动的 Redis 队列提供了一个精美的仪表板和代码驱动的配置。

了解更多

任务调度

使用富有表现力的语法调度重复作业和命令，告别复杂的配置文件

$schedule->job(NotifySubscribers::class)->hourly();

Laravel 的调度程序甚至可以处理多个服务器，并提供内置的重叠预防功能

$schedule->job(NotifySubscribers::class)
    ->dailyAt('9:00')
    ->onOneServer()
    ->withoutOverlapping();

了解更多

测试

Laravel 是为测试而构建的。从单元测试到浏览器测试，你都会对部署应用程序更有信心

$user = User::factory()->create();
 
$this->browse(fn (Browser $browser) => $browser
    ->visit('/login')
    ->type('email', $user->email)
    ->type('password', 'password')
    ->press('Login')
    ->assertPathIs('/home')
    ->assertSee("Welcome {$user->name}")
);

了解更多

事件和 WebSockets

Laravel 的事件允许你发送和监听整个应用程序中的事件，并且可以将侦听器轻松地调度到后台队列

OrderShipped::dispatch($order);

class SendShipmentNotification implements ShouldQueue
{
    public function handle(OrderShipped $event): void
    {
        // ...
    }
}

你的前端应用程序甚至可以使用 Laravel Echo 和 WebSockets 订阅你的 Laravel 事件，从而允许你构建实时、动态的应用程序

Echo.private(`orders.${orderId}`)
    .listen('OrderShipped', (e) => {
        console.log(e.order);
    });

了解更多

我们仅仅触及了皮毛。Laravel 涵盖了构建 Web 应用程序所需的一切，包括电子邮件验证、速率限制和自定义控制台命令。查看Laravel 文档以继续学习或立即开始使用我们的Laravel bootcamp。

一个框架，
多种风格。

有数十种方法可以构建应用程序的前端。值得庆幸的是，Laravel 为你提供了广泛的选择。无论你喜欢传统的 PHP 后端、使用 Laravel Livewire 的现代前端，还是对 React 和 Vue 百看不厌，Laravel 都允许你在极短的时间内交付高度精美和可维护的应用程序。

Inertia

使用 React、Vue 或 Svelte 增强 Laravel 的功能

Livewire

使用 PHP 进行响应式服务器渲染模板

传统 SPA 和移动应用

以比以往更快的速度构建强大的 API

Inertia

使用 React、Vue 或 Svelte 增强 Laravel 的功能

Laravel Inertia 处理 Laravel 后端和前端之间的路由和数据传输——无需构建 API 或维护两组路由。您可以轻松地将数据从数据库直接传递到前端页面组件的 props 中，在同一个出色的单体仓库中享受 Laravel 的所有功能。

UserController.php

 1class UserController
 2{
 3    public function index()
 4    {
 5        $users = User::active()
 6            ->orderByName()
 7            ->get(['id', 'name', 'email']);
 8 
 9        return Inertia::render('Users', [
10            'users' => $users,
11        ]);
12    }
13}

Users.jsx

 1import Layout from './Layout'
 2 
 3export default function Users({ users }) {
 4  return (
 5    <Layout>
 6      {users.map(user => (
 7        <Link href={route('users.show', user)}>
 8          {user.name} ({user.email})
 9        </Link>
10      ))}
11    </Layout>
12  )
13}

Inertia 为您提供了创建服务器渲染的多页面应用程序的开发体验和简易性，以及 JavaScript SPA 的用户体验和响应速度。

您的前端组件可以专注于用户交互，而不是 API 调用和数据操作——不再需要手动触发 HTTP 请求和处理响应。

Inertia 甚至为需要搜索引擎优化的应用程序提供了初始页面加载时的服务器端渲染。

了解更多

它是如何工作的？

您应用程序的初始页面加载将返回一个由 Inertia 驱动的 SPA 和页面 props，只需一个请求。后续点击链接或提交表单的请求将自动仅返回所需的页面 props。

当您部署新资源时，Inertia 会自动执行下一次完整页面加载，因此您的用户将拥有最新的资源，而不会错过任何内容。

Livewire 是一种使用服务器渲染模板而不是 JavaScript 框架构建动态界面的现代方法。它将构建服务器渲染应用程序的简洁性和速度与 JavaScript SPA 的用户体验相结合。您必须亲眼看到才能相信。

Search.php

 1use Livewire\Component;
 2 
 3class Search extends Component
 4{
 5    public $search = '';
 6 
 7    public function render()
 8    {
 9        $users = User::search($this->search)->get();
10 
11        return view('livewire.search', [
12            'users' => $users,
13        ]);
14    }
15}

search.blade.php

 1<div>
 2    <input wire:model="search"
 3        type="text"
 4        placeholder="Search users..." />
 5 
 6    <ul>
 7        @foreach ($users as $user)
 8            <li>{{ $user->username }}</li>
 9        @endforeach
10    </ul>
11</div>

使用 Livewire 时，您不需要 JavaScript 来管理 DOM 或状态 - 您只需将其添加到一些深思熟虑的交互中即可。Alpine.js 是与您的 Livewire 应用程序搭配使用的完美轻量级 JavaScript 库。

随着您的 Livewire 组件状态的变化，您的前端将自动更新。但是，Livewire 不仅限于此。还包括对实时验证、事件处理、文件下载、授权等功能的支持。

了解更多

它是如何工作的？

Livewire 使用 Blade 模板语言在服务器上渲染您的 HTML。它会自动添加使页面具有响应性的 JavaScript，并随着数据的更改自动重新渲染组件和更新 DOM。

不需要前端？没问题。Laravel 是您 JavaScript SPA 和移动应用程序的完美后端 API。您将可以使用 Laravel 的所有功能，同时保持您习惯的前端开发工作流程。

UserController.php

1class UserController
2{
3    public function index()
4    {
5        return User::active()
6            ->orderByName()
7            ->paginate(25, ['id', 'name', 'email']);
8    }
9}

result.json

 1{
 2    "data": [
 3        {
 4            "id": 1,
 5            "name": "Taylor Otwell",
 6            "email": "[email protected]",
 7        },
 8        // ...
 9    ],
10    "from": 1,
11    "to": 25,
12    "total": 50,
13    "per_page": 25,
14    "current_page": 1,
15    "last_page": 2,
16    "first_page_url": "https://api.laravel.app/users?page=1",
17    "last_page_url": "https://api.laravel.app/users?page=2",
18    "next_page_url": "https://api.laravel.app/users?page=2",
19    "prev_page_url": null,
20    "path": "https://api.laravel.app/users",
21}

对于身份验证，您可以利用 Laravel 安全的、基于 cookie 的身份验证。或者，如果您正在构建移动应用程序或者您的前端与您的后端 API 分开托管，您可以使用 Laravel Sanctum 或 Laravel Passport。

如果您的 API 在极端规模下运行，请将您的 Laravel 应用程序与 Laravel Octane 和 Laravel Vapor 搭配使用，以便轻松处理您的流量。

它是如何工作的？

它是如何工作的？

背后的力量
你的伟大构想

你需要的一切，让你变得出色。

身份验证

授权

Eloquent ORM

数据库迁移

验证

通知和邮件

文件存储

作业队列

任务调度

测试

事件和 WebSockets

一个框架，
多种风格。

Inertia

Livewire

传统的 SPA & 移动应用程序

Inertia

Livewire

传统 SPA 和移动应用

Inertia

使用
入门套件开始吧。

社区
和生态系统。

背后的力量你的 伟大构想

你需要的一切，让你变得出色。

身份验证

授权

Eloquent ORM

数据库迁移

验证

通知和邮件

文件存储

作业队列

任务调度

测试

事件和 WebSockets

一个框架，多种风格。

Inertia

Livewire

传统的 SPA & 移动应用程序

Inertia

Livewire

传统 SPA 和移动应用

Inertia

它是如何工作的？

它是如何工作的？

使用入门套件开始吧。

社区和生态系统。

背后的力量
你的伟大构想

一个框架，
多种风格。

使用
入门套件开始吧。

社区
和生态系统。