Laravel 速查表

• #安装 Docker Desktop

• #安装并启用 WSL2

• #确保 Docker Desktop 配置为使用 WSL2

• #在 WSL2 终端中：

  ```shell
  $ curl -s https://laravel.build/example-app | bash
  $ cd example-app
  $ ./vendor/bin/sail up
  ```
  

通过 http://localhost 访问应用程序

• #安装 Docker Desktop

• #在终端中：

  ```shell
  $ curl -s https://laravel.build/example-app | bash
  $ cd example-app
  $ ./vendor/bin/sail up
  ```
  

通过 http://localhost 访问应用程序

$ curl -s https://laravel.build/example-app | bash
$ cd example-app
$ ./vendor/bin/sail up

通过 Composer 安装

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

通过 http://localhost 访问应用程序

开启（本地开发）：

// .env 文件
APP_ENV=local
APP_DEBUG=true
// ...

关闭（生产环境）：

// .env 文件
APP_ENV=production
APP_DEBUG=false
// ...

临时禁用应用程序（503 状态码）

php artisan down

#禁用维护模式

php artisan up

#绕过维护模式

php artisan down --secret="1630542a-246b-4b66-afa1-dd72a4c43515"

访问您的应用程序 URL https://example.com/1630542a-246b-4b66-afa1-dd72a4c43515 以设置 cookie 并绕过 维护屏幕

use Illuminate\Http\Request;

Route::get('/users', function (Request $request) {
    // ...
});

类型提示具体依赖项以实现自动注入

// 参数 1: URI, 参数 2: 视图名称
Route::view('/welcome', 'welcome');

// 带数据
Route::view('/welcome', 'welcome', ['name' => 'Taylor']);

路由只需要返回一个视图。

HTTP 302 状态

Route::redirect('/here', '/there');

设置状态码

Route::redirect('/here', '/there', 301);

永久 301 重定向

Route::permanentRedirect('/here', '/there');

路由名称应始终唯一

Route::get('/user/profile', function () {
    //
})->name('profile');

请参阅：辅助函数

Route::fallback(function () {
    //
});

当没有其他路由匹配时执行

#中间件

Route::middleware(['first', 'second'])->group(function () {
    Route::get('/', function () {
        // 使用 first 和 second 中间件...
    });

    Route::get('/user/profile', function () {
        // 使用 first 和 second 中间件...
    });
});

#URI 前缀

Route::prefix('admin')->group(function () {
    Route::get('/users', function () {
        // 匹配 "/admin/users" URL
    });
});

#名称前缀

Route::name('admin.')->group(function () {
    Route::get('/users', function () {
        // 路由分配的名称为 "admin.users"...
    })->name('users');
});

跨路由共享属性

use Illuminate\Support\Facades\Route;

// Illuminate\Routing\Route
$route = Route::current();

// 字符串
$name = Route::currentRouteName();

// 字符串
$action = Route::currentRouteAction();

为您的应用程序生成任意 URL，这些 URL 将自动使用当前请求的方案（HTTP 或 HTTPS）和主机

$post = App\Models\Post::find(1);

echo url("/posts/{$post->id}");

// http://example.com/posts/1

#当前 URL

// 获取不带查询字符串的当前 URL...
echo url()->current();

// 获取包含查询字符串的当前 URL...
echo url()->full();

// 获取先前请求的完整 URL...
echo url()->previous();

$url = route('profile');

请参阅 命名路由

public function isValid($value)
{
    try {
        // 验证值...
    } catch (Throwable $e) {
        report($e);

        return false;
    }
}

报告异常但继续处理当前请求

// 页面未找到
abort(404);

// 未授权
abort(401);

// 禁止访问
abort(403);

// 服务器错误
abort(500);

使用状态码生成 HTTP 异常响应

namespace App\Http\Controllers;

use App\Http\Controllers\Controller;
use App\Models\User;

class UserController extends Controller
{
    public function show($id)
    {
        return view('user.profile', [
            'user' => User::findOrFail($id)
        ]);
    }
}

为此控制器方法定义路由：

use App\Http\Controllers\UserController;

Route::get('/user/{id}', [UserController::class, 'show']);

Laravel 会为每个活动的用户会话自动生成一个 CSRF “令牌”。 此令牌用于验证经过身份验证的用户是否是实际发出请求的人。

获取当前会话的令牌：

Route::get('/token', function (Request $request) {
    $token = $request->session()->token();

    $token = csrf_token();

    // ...
});

POST、PUT、PATCH 或 DELETE 表单应在表单中包含一个隐藏的 CSRF _token 字段以验证请求。

<form method="POST" action="/profile">
  @csrf

  <!-- 等同于... -->
  <input type="hidden" name="_token" value="{{ csrf_token() }}" />
</form>

请参阅 表单

通过类型提示控制器操作或路由闭包来获取当前请求的实例

// 控制器操作
class UserController extends Controller
{
    public function store(Request $request)
    {
        $name = $request->input('name');
    }
}

// 闭包
Route::get('/', function (Request $request) {
    //
});

请参阅路由

请求的路径信息

$uri = $request->path();

// https://example.com/foo/bar --> foo/bar

#将路径与模式匹配

验证传入的请求路径是否与给定模式匹配

// * 是通配符
if ($request->is('admin/*')) {
    //
}

确定传入的请求是否与命名路由匹配

if ($request->routeIs('admin.*')) {
    //
}

传入请求的完整 URL

// 不带查询字符串的 URL
$url = $request->url();

// 包含查询字符串的 URL
$urlWithQueryString = $request->fullUrl();

// 将数据附加到查询字符串
$request->fullUrlWithQuery(['type' => 'phone']);

$method = $request->method();

// 验证 HTTP 动词是否与给定字符串匹配
if ($request->isMethod('post')) {
    //
}

$ipAddress = $request->ip();

$value = $request->header('X-Header-Name');

$value = $request->header('X-Header-Name', 'default value');

// 确定请求是否包含给定标头
if ($request->hasHeader('X-Header-Name')) {
    //
}

// 从 Authorization 标头中检索持有者令牌
$token = $request->bearerToken();

返回一个包含请求接受的所有内容类型的数组

$contentTypes = $request->getAcceptableContentTypes();

布尔值检查请求是否接受内容类型

if ($request->accepts(['text/html', 'application/json'])) {
    // ...
}

通过属性访问输入。 如果未作为输入找到，则将检查路由参数。

$name = $request->name;

$input = $request->only(['username', 'password']);

$input = $request->only('username', 'password');

$input = $request->except(['credit_card']);

$input = $request->except('credit_card');

确定值是否存在

if ($request->has('name')) {
    //
}

// 检查是否所有值都存在
if ($request->has(['name', 'email'])) {
    //
}

// 如果任何值存在
if ($request->hasAny(['name', 'email'])) {
    //
}

// 如果请求中存在文件
if ($request->hasFile('image')) {
    //
}

从先前的请求中检索输入

$username = $request->old('username');

或者使用 old() 辅助函数

<input type="text" name="username" value="{{ old('username') }}">

请参阅：辅助函数 请参阅：表单

从请求中检索上传的文件

$file = $request->file('photo');

$file = $request->photo;

获取文件路径或扩展名

$path = $request->photo->path();

$extension = $request->photo->extension();

使用随机生成的文件名存储上传的文件

// 文件应存储的路径，相对于
// 文件系统配置的根目录
$path = $request->photo->store('images');

// 可选的第二个参数，用于指定文件系统磁盘
$path = $request->photo->store('images', 's3');

存储上传的文件并指定名称

$path = $request->photo->storeAs('images', 'filename.jpg');

$path = $request->photo->storeAs('images', 'filename.jpg', 's3');

更多信息：Laravel 文件存储

• Laravel 文档 - 视图

<!-- 存储在 resources/views/greeting.blade.php 中的视图 -->

<html>
  <body>
    <h1>你好, <?php echo $name; ?></h1>
  </body>
</html>

通过在 resources/views 目录中放置一个扩展名为 .blade.php 的文件来创建视图。

#作为数组

return view('greetings', ['name' => 'Victoria']);

#使用 with()

return view('greeting')
            ->with('name', 'Victoria')
            ->with('occupation', 'Astronaut');

使用数据的键访问每个值

<html>
  <body>
    <h1>你好, {{ $name }}</h1>
    <!-- 或者 -->
    <h1>你好, <?php echo $name; ?></h1>
  </body>
</html>

使用 view() 辅助函数从路由返回视图

Route::get('/', function () {
    return view('greeting', ['name' => 'James']);
});

请参阅：视图路由 和 辅助函数

// resources/views/admin.profile.blade.php
return view('admin.profile');

• Laravel 文档 - Blade 模板

Blade 是 Laravel 中包含的模板引擎，它也允许您使用纯 PHP。

Blade 视图使用 view() 辅助函数返回

Route::get('/', function () {
    return view('welcome', ['name' => 'Samantha']);
});

请参阅：视图

{{-- 此注释不会出现在渲染的 HTML 中 --}}

Blade 的 echo 语句 {{ }} 会自动通过 PHP 的 htmlspecialchars 函数处理，以防止 XSS 攻击。

显示 name 变量的内容：

你好, {{ $name }}.

显示 PHP 函数的结果：

当前 UNIX 时间戳是 {{ time() }}.

显示数据而不使用 htmlspecialchars 转义

你好, {!! $name !!}.

从另一个视图中包含 Blade 视图。 父视图可用的所有变量也对包含的视图可用

<div>
  <!-- resources/views/shared/errors/blade.php -->
  @include('shared.errors')

  <form>
    <!-- 表单内容 -->
  </form>
</div>

执行纯 PHP 代码块

@php
    $counter = 1;
@endphp

Blade 允许您推送到命名堆栈，这些堆栈可以在另一个视图或布局中渲染。 对于子视图所需的 javascript 库很有用

<!-- 添加到堆栈 -->
@push('scripts')
<script src="/example.js"></script>
@endpush

渲染堆栈

<head>
  <!-- 头部内容 -->

  @stack('scripts')
</head>

前置到堆栈的开头

@push('scripts')
    这将是第二个...
@endpush

// 稍后...

@prepend('scripts')
    这将是第一个...
@endprepend

• Laravel 文档 - 表单

包含一个隐藏的 CSRF 令牌字段以验证请求

<form method="POST" action="/profile">
  @csrf

  ...
</form>

请参阅：CSRF 保护

由于 HTML 表单无法发出 PUT、PATCH 或 DELETE 请求，您需要添加一个隐藏的 _method 字段来伪造这些 HTTP 动词：

<form action="/post/my-post" method="POST">
  @method('PUT')

  ...
</form>

<!-- /resources/views/post/create.blade.php -->

<label for="title">文章标题</label>

<input id="title" type="text" class="@error('title') is-invalid @enderror" />

@error('title')
  <div class="alert alert-danger">{{ $message }}</div>
@enderror

请参阅：验证

由于验证错误而重定向时，请求输入会闪存到会话中。 使用 old 方法从先前的请求中检索输入

$title = $request->old('title');

或者 old() 辅助函数

<input type="text" name="title" value="{{ old('title') }}" />

• Laravel 文档 - 验证

如果验证失败，将生成到先前 URL 的重定向响应。 如果传入的请求是 XHR 请求，则将返回带有验证错误消息的 JSON 响应。

// 在 routes/web.php 中
Route::get('/post/create', [App\Http\Controllers\PostController::class, 'create']);
Route::post('/post', [App\Http\Controllers\PostController::class, 'store']);

// 在 app/Http/Controllers/PostController 中...
public function store(Request $request)
{
    $validated = $request->validate([
        // 输入名称 => 验证规则
        'title' => 'required|unique:posts|max:255',
        'body' => 'required',
    ]);

    // 博客文章有效...
}

确保密码具有足够的复杂度

$validatedData = $request->validate([
    'password' => ['required', 'confirmed', Password::min(8)],
]);

Password 规则对象允许您轻松自定义密码复杂度要求

// 要求至少 8 个字符...
Password::min(8)

// 要求至少一个字母...
Password::min(8)->letters()

// 要求至少一个大写字母和一个小写字母...
Password::min(8)->mixedCase()

// 要求至少一个数字...
Password::min(8)->numbers()

// 要求至少一个符号...
Password::min(8)->symbols()

确保密码未在公共密码数据泄露事件中泄露

Password::min(8)->uncompromised()

使用 k-匿名性 模型，通过 haveibeenpwned.com 服务，而不会牺牲用户的隐私或安全

方法可以链接

Password::min(8)
    ->letters()
    ->mixedCase()
    ->numbers()
    ->symbols()
    ->uncompromised()

<!-- /resources/views/post/create.blade.php -->

<h1>创建文章</h1>

@if ($errors->any())
    <div class="alert alert-danger">
        <ul>
            @foreach ($errors->all() as $error)
                <li><!--swig13--></li>
            @endforeach
        </ul>
    </div>
@endif

<!-- 创建文章表单 -->

请参阅：验证错误

如果您不希望验证器将 null 值视为无效，则通常需要将“可选”请求字段标记为 nullable

// publish_at 字段可以为 null 或有效的日期表示形式
$request->validate([
    'title' => 'required|unique:posts|max:255',
    'body' => 'required',
    'publish_at' => 'nullable|date',
]);

检索经过验证的请求数据

$validated = $request->validated();

或者使用 safe()，它返回 Illuminate\Support\ValidatedInput 的实例

$validated = $request->safe()->only(['name', 'email']);

$validated = $request->safe()->except(['name', 'email']);

$validated = $request->safe()->all();

#迭代

foreach ($request->safe() as $key => $value) {
    //
}

#作为数组访问

$validated = $request->safe();

$email = $validated['email'];

• Laravel 文档 - 会话

Laravel 附带了各种会话后端，可通过统一的 API 进行访问。包括 Memcached、Redis 和数据库支持。

#配置

会话配置在 config/session.php 中。 默认情况下，Laravel 配置为使用文件会话驱动程序

如果项目存在且不为 null，则返回 true：

if ($request->session()->has('users')) {
    //
}

如果存在，即使为 null，也返回 true：

if ($request->session()->exists('users')) {
    //
}

如果项目为 null 或不存在，则返回 true：

if ($request->session()->missing('users')) {
    //
}

通过请求实例

$request->session()->put('key', 'value');

通过全局“session”辅助函数

session(['key' => 'value']);

将新值推送到作为数组的会话值上

// 团队名称数组
$request->session()->push('user.teams', 'developers');

日志记录行为的配置选项在 config/logging.php 中。 默认情况下，Laravel 在记录消息时将使用堆栈通道，该通道将多个日志通道聚合到单个通道中。

use Illuminate\Support\Facades\Log;

Log::info('用户登录失败。', ['id' => $user->id]);

• Laravel 文档 - 部署

确保您的 Web 服务器将所有请求定向到应用程序的 public/index.php 文件

#Composer 的自动加载器映射

composer install --optimize-autoloader --no-dev

#配置加载

确保您只在配置文件中调用 env 函数。 一旦配置被缓存，.env 文件将不会被加载，并且所有对 .env 变量的 env 函数调用都将返回 null

php artisan config:cache

#路由加载

php artisan route:cache

#视图加载

php artisan view:cache

config/app.php 中的调试选项决定了向用户显示多少有关错误的信息。 默认情况下，此选项设置为 .env 文件中 APP_DEBUG 环境变量的值。在生产环境中，此值应始终为 false。 如果在生产环境中将 APP_DEBUG 变量设置为 true，则可能会将敏感配置值暴露给最终用户。