Route路由

路由配置

php

// routes/web.php

# 接收get请求 http://127.0.0.1:8000/test
Route::get('/test', function () {
    return 'Hello Laravel';
});

# any接收任何请求方式
Route::any('/test', function () {
    return 'Hello Laravel';
});

# 指定提交方式
Route::match(['get', 'post'], '/test', function () {
    return 'Hello Laravel';
});

# 接收参数 http://127.0.0.1:8000/test/5
Route::get('/test/{id}', function ($id) {
    return $id;
});

控制器

bash

php8 artisan make:controller TaskController

自动生成的模板代码

php

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

class TaskController extends Controller
{
    //
}

编写业务代码

php

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

class TaskController extends Controller
{

    public function index()
    {
        return 'task';
    }

    public function read($id)
    {
        return $id;
    }
}

路由配置

php

// routes/web.php
<?php

use App\Http\Controllers\TaskController;
use Illuminate\Support\Facades\Route;

Route::get('/task', [TaskController::class, 'index']);
Route::get('/task/read/{id}', [TaskController::class, 'read']);

路由参数

参数约束

php

// 允许：http://127.0.0.1:8000/user/5
// 报错：http://127.0.0.1:8000/user/ooxx

// 单个参数
Route::get('/user/{id}', function ($id) {
    return $id;
})->where('id', '[0-9]+');

// 多个参数
Route::get('/user/{id}/{name}', function ($id, $name) {
    //
})->where([
    'id'   => '[0-9]+', 
    'name' => '[a-z]+'
]);

全局约束

php

// App\Providers\RouteServiceProvider
<?php

namespace App\Providers;

class RouteServiceProvider extends ServiceProvider
{
    public function boot()
    {
        // 添加全局约束
        Route::pattern('id', '[0-9]+');
    }
}

局部约束

php

Route::get('/user/{id}', function ($id) {
    return $id;
})->where('id', '.*');

重定向路由

php

// 状态码默认302，临时重定向
Route::redirect('/index', '/task');

// 301 永久重定向
Route::redirect('/index', '/task', 301);

// 等价于 永久重定向
Route::permanentRedirect('/index', '/task');

视图路由

视图模板

html

{{-- resources/views/task.blade.php --}}
<!doctype html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport"
          content="width=device-width, user-scalable=no, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0">
    <meta http-equiv="X-UA-Compatible" content="ie=edge">
    <title>Document</title>
</head>
<body>
    {{-- 变量 --}}
    {{$name}}
</body>
</html>

！+ tab 可快速创建HTML模板

php

// http://127.0.0.1:8000/task

// 方式一：
Route::view('/task', 'task', [
    'name'=> 'Tom'
]);

// 方式二：使用助手函数返回view
Route::get('/task', function () {
    return view('task', [
        'name' => 'Tom'
    ]);
});

// 方式三：
Route::get('/task', [TaskController::class, 'index']);

Controller返回view

php

<?php

namespace App\Http\Controllers;

class TaskController extends Controller
{

    public function index()
    {
        return view('task', [
            'name' => 'Tom'
        ]);
    }
}

路由命名

php

// 指定路由的名称
Route::get('/task', function(){
    return 'task';
})->name('index.task');

// 使用助手函数生成URL(URL是URI的子集)
Route::get('/url', function(){
    return route('index.task');
    // http://127.0.0.1:8000/task
});

// 传参
Route::get('/url', function(){
    return route('index.task', ['name'=> 'Tom']);
    // http://127.0.0.1:8000/task?name=Tom
});

// 路由跳转
Route::get('/url', function(){
    return redirect()->route('index.task', ['name'=> 'Tom']);
    // 跳转地址：http://127.0.0.1:8000/task?name=Tom
});

// 生成相对地址
Route::get('/url', function(){
    return route('index.task', ['name'=> 'Tom'], false);
    // /task?name=Tom
});

路由分组

php

// 添加路由前缀
Route::group(['prefix' => 'api'], function () {
    // http://127.0.0.1:8000/api/index
    Route::get('/index', function () {
        return 'index';
    });

    // http://127.0.0.1:8000/api/task
    Route::get('/task', function () {
        return 'task';
    });
});


// 等价于（推荐）
Route::prefix('api')->group(function () {
    // http://127.0.0.1:8000/api/index
    Route::get('/index', function () {
        return 'index';
    });

    // http://127.0.0.1:8000/api/task
    Route::get('/task', function () {
        return 'task';
    });
});

// 路由中间件
Route::middleware('middleware')->group(function () {});

// 子域路由
Route::domain('127.0.0.1')->group(function () {});

// 命名空间
Route::namespace('Admin')->group(function () {});

// 路由名称前缀
Route::name('admin.')->group(function () {
    Route::get('/task', function () {
        return 'task';
    })->name('task');
    // admin.task
});

单动作控制器

bash

php artisan make:controller OneController --invokable

php

<?php

namespace App\Http\Controllers;

class OneController extends Controller
{
    public function __invoke()
    {
       return 'one';
    }
}

路由

php

// http://127.0.0.1:8000/one
Route::get('/one', OneController::class);

回退路由

php

// 错误处理，注意：必须放在所有路由最底部
Route::fallback(function () {
    return 'error';
    // 返回404页面
    // return view('404');
});

当前路由

当前路由信息

php

Route::get('/task', function(){
    return json_encode(Route::current());
});

输出

json

{
    "uri": "task",
    "methods": [
        "GET",
        "HEAD"
    ],
    "action": {
        "middleware": [
            "web"
        ],
        "uses": {},
        "namespace": null,
        "prefix": "",
        "where": []
    },
    "isFallback": false,
    "controller": null,
    "defaults": [],
    "wheres": {
        "id": "[0-9]+"
    },
    "parameters": [],
    "parameterNames": [],
    "computedMiddleware": [
        "web"
    ],
    "compiled": {}
}

当前路由名称

php

Route::get('/task', function(){
    return Route::currentRouteName();
    // index.task
})->name('index.task');

当前路由指向的方法

php

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use Illuminate\Support\Facades\Route;

class TaskController extends Controller
{

    public function index()
    {
        return Route::currentRouteAction();
        // App\Http\Controllers\TaskController@index
    }

}

php

Route::get('/task',[TaskController::class, 'index']);

响应和重定向

1、响应

php

// 返回文本字符串
return 'index';
return response('index');

// 自定义http状态码
return response('index', 201);

// 修改响应头为纯文本
return response('<h1>index</h1>')
    ->header(
        'Content-Type',
        'text/pain; charset=UTF-8'
    );

//返回json
return [1, 2, 3];
return response([1, 2, 3]);
return response()->json([1, 2, 3]);

2、路由重定向

php

// 简写
return redirect('/');

// 完整形式
return redirect()->to('/');

// facade模式
return Redirect::to('/');

// 通过命名路由跳转
return redirect()->route('index');

// 回退到上一页
return redirect()->back();
return back();

// 跳转到控制器方法
return redirect()->action([TaskController::class, 'read']);

// 跳转到外部链接
return redirect()->away('https://www.baidu.com/');

资源控制器

命令行生成资源路由

bash

php8 artisan make:controller BlogController --resource

资源控制器会产生7个方法

php

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

class BlogController extends Controller
{
    /**
     * Display a listing of the resource.
     *
     * @return \Illuminate\Http\Response
     */
    public function index()
    {
        //
    }

    /**
     * Show the form for creating a new resource.
     *
     * @return \Illuminate\Http\Response
     */
    public function create()
    {
        //
    }

    /**
     * Store a newly created resource in storage.
     *
     * @param  \Illuminate\Http\Request  $request
     * @return \Illuminate\Http\Response
     */
    public function store(Request $request)
    {
        //
    }

    /**
     * Display the specified resource.
     *
     * @param  int  $id
     * @return \Illuminate\Http\Response
     */
    public function show($id)
    {
        //
    }

    /**
     * Show the form for editing the specified resource.
     *
     * @param  int  $id
     * @return \Illuminate\Http\Response
     */
    public function edit($id)
    {
        //
    }

    /**
     * Update the specified resource in storage.
     *
     * @param  \Illuminate\Http\Request  $request
     * @param  int  $id
     * @return \Illuminate\Http\Response
     */
    public function update(Request $request, $id)
    {
        //
    }

    /**
     * Remove the specified resource from storage.
     *
     * @param  int  $id
     * @return \Illuminate\Http\Response
     */
    public function destroy($id)
    {
        //
    }
}

HTTP 类型 | 路由 URI | 控制器方法 | 路由命名 | 描述

| - | - | - | - GET | /photos | index | photos.index | 获得数据列表 GET | /photos/create | create | photos.create | 创建页面(表单页) POST | /photos | store | photos.store | 创建页的接受处理 GET | /photos/{photo}| show | photos.show | 获得一条数据 GET | /photos/{photo}/edit | edit | photos.edit | 编辑(表单页) PUT/PATCH | /photos/{photo} | update | photos.update | 从编辑页中接受处理 DELETE | /photos/{photo} | destroy | photos.destroy | 删除一条数据

查看目前可用的路由

php8 artisan route:list

输出

GET|HEAD        / .............................................................. index
POST            _ignition/execute-solution ignition.executeSolution › Spatie\LaravelI…
GET|HEAD        _ignition/health-check ignition.healthCheck › Spatie\LaravelIgnition …
POST            _ignition/update-config ignition.updateConfig › Spatie\LaravelIgnitio…
GET|HEAD        api/user ............................................................. 
GET|HEAD        blogs ............................. blogs.index › BlogController@index
POST            blogs ............................. blogs.store › BlogController@store
GET|HEAD        blogs/create .................... blogs.create › BlogController@create
GET|HEAD        blogs/{blog} ........................ blogs.show › BlogController@show
PUT|PATCH       blogs/{blog} .................... blogs.update › BlogController@update
DELETE          blogs/{blog} .................. blogs.destroy › BlogController@destroy
GET|HEAD        blogs/{blog}/edit ................... blogs.edit › BlogController@edit
GET|HEAD        read ............................................. TaskController@read
GET|HEAD        sanctum/csrf-cookie ...... Laravel\Sanctum › CsrfCookieController@show
GET|HEAD        task ............................................ TaskController@index

资源路由控制

php

// 指定生成
Route::resource('blogs', BlogController::class)
    ->only(['index', 'create']);

// 排除生成
Route::resource('blogs', BlogController::class)
    ->except(['index', 'create']);

API 路由

php

Route::ApiResource('blogs', BlogController::class);

直接使用 api 资源路由

bash

# 不包含 create 或 edit 方法
php artisan make:controller CommentController --api

php

// 浅层嵌套
Route::resource('blogs.comments', 'CommentController')   
    ->shallow();

Route路由 ​

路由配置 ​

控制器 ​

路由参数 ​

重定向路由 ​

视图路由 ​

路由命名 ​

路由分组 ​

单动作控制器 ​

回退路由 ​

当前路由 ​

当前路由信息 ​

当前路由名称 ​

当前路由指向的方法 ​

响应和重定向 ​

资源控制器 ​

Route路由

路由配置

控制器

路由参数

重定向路由

视图路由

路由命名

路由分组

单动作控制器

回退路由

当前路由

当前路由信息

当前路由名称

当前路由指向的方法

响应和重定向

资源控制器