Middleware (MiddleWare)

Wie erstelle ich schnell Middleware?

Über die Befehlszeile: Erstellen Sie einen Check im Verzeichnis app/middleware Middleware

php think make:middleware Check

Middleware-Code:

<?php

namespace app\middleware;

class Check
{
    public function handle($request, \Closure $next)
    {
        if ($request->param('name') == 'think') {
            return redirect('index/think');
        }

        return $next($request);
    }
}

Die Eintragsausführungsmethode der Middleware muss die Handle-Methode sein, und der erste Parameter ist das Request-Objekt und der zweite Parameter ist ein Abschluss.

Der Rückgabewert der Middleware-Handle-Methode muss ein Response-Objekt sein.

In dieser Middleware führen wir eine Umleitungsverarbeitung durch, wenn wir feststellen, dass der Namensparameter der aktuellen Anforderung gleich ist. Andernfalls wird die Anfrage an die Bewerbung weitergeleitet. Um die Anfrage weiterhin an die Anwendung weiterzuleiten, rufen Sie einfach die Rückruffunktion $next mit $request als Parameter auf.

Unter bestimmten Voraussetzungen können Sie über den dritten Parameter weitere Parameter übergeben.

<?php

namespace app\middleware;

class Check
{
    public function handle($request, \Closure $next, $name)
    {
        if ($name == 'think') {
            return redirect('index/think');
        }

        return $next($request);
    }
}

Endplanung

Middleware unterstützt die Definition eines Rückrufmechanismus, bevor die Anfrage endet. Sie müssen nur die Endmethode in der Middleware-Klasse hinzufügen.

    public function end(\think\Response $response)
    {
        // 回调行为
    }

Beachten Sie, dass in der Endmethode keine Antwortausgabe erfolgen kann. Weil die Ausgabe der Anforderungsantwort abgeschlossen ist, wenn der Rückruf ausgegeben wird.

Pre/Post-Middleware

Ob die Middleware vor oder nach der Anforderung des spezifischen Vorgangs ausgeführt wird, hängt vollständig von der Definition der Middleware selbst ab.

Das Folgende ist eine Middleware für das Vorverhalten

<?php

namespace app\middleware;

class Before
{
    public function handle($request, \Closure $next)
    {
        // 添加中间件执行代码

        return $next($request);
    }
}

Das Folgende ist eine Middleware für das Nachverhalten

<?php

namespace app\middleware;

class After
{
    public function handle($request, \Closure $next)
    {
		$response = $next($request);

        // 添加中间件执行代码

        return $response;
    }
}

Middleware-Methoden können auch die Abhängigkeitsinjektion unterstützen.

Als praktisches Beispiel müssen wir feststellen, ob die aktuelle Browserumgebung WeChat oder Alipay ist

namespace app\middleware;

/**
 * 访问环境检查，是否是微信或支付宝等
 */
class InAppCheck
{
    public function handle($request, \Closure $next)
    {
        if (preg_match('~micromessenger~i', $request->header('user-agent'))) {
            $request->InApp = 'WeChat';
        } else if (preg_match('~alipay~i', $request->header('user-agent'))) {
            $request->InApp = 'Alipay';
        }
        return $next($request);
    }
}

und dann eine middleware.php-Datei zu Ihrer mobilen Anwendung hinzufügen
Zum Beispiel: / Weg /app/mobile/middleware.php

return [
    app\middleware\InAppCheck::class,
];

Dann können Sie in Ihrem Controller den relevanten Wert über $this->request->InApp<🎜 abrufen >

Middleware-Alias ​​definieren

Sie können Middleware direkt in middleware.php im Anwendungskonfigurationsverzeichnis vordefinieren (und tatsächlich eine Alias-ID hinzufügen), zum Beispiel:

return [
    'alias' => [
        'auth'  => app\middleware\Auth::class,
        'check' => app\middleware\Check::class,
    ],
];

Kann die Verwendung anderer unterstützen Definieren Sie eine Gruppe von Middleware nach Namen, zum Beispiel:

return [
    'alias' => [
        'check' => [
            app\middleware\Auth::class,
            app\middleware\Check::class,
        ],
    ],
];

Middleware registrieren

Die neue Version der Middleware ist in globale Middleware und Anwendung unterteilt Middleware (gültig im Multianwendungsmodus), Routing-Middleware und Controller-Middleware.

Die Ausführungsreihenfolge lautet: Globale Middleware->Anwendungs-Middleware->Routing-Middleware->Controller-Middleware

Globale Middleware

Globale Middleware befindet sich im App-Verzeichnis Definiert in der Datei middleware.php unten, verwenden Sie die folgende Methode:

<?php

return [
	\app\middleware\Auth::class,
    'check',
    'Hello',
];

Die Registrierung der Middleware sollte den vollständigen Klassennamen verwenden. Wenn der Middleware-Alias ​​(oder die Gruppe) definiert wurde, kann er direkt verwendet werden.

Die Ausführungsreihenfolge globaler Middleware ist die Definitionsreihenfolge. Beim Definieren globaler Middleware können Middleware-Parameter übergeben werden. Es werden zwei Methoden unterstützt.

<?php

return [
	[\app\http\middleware\Auth::class, 'admin'],
    'Check',
    ['hello','thinkphp'],
];

Die obige Definition bedeutet, dass der Admin-Parameter an die Auth-Middleware und der thinkphp-Parameter an die Hello-Middleware übergeben wird.

Anwendungs-Middleware

Wenn Sie den Multianwendungsmodus verwenden, wird die Definition der Anwendungs-Middleware unterstützt. Sie können die Datei middleware.php direkt im Anwendungsverzeichnis hinzufügen. Die Definitionsmethode ist die gleiche wie die globale Middleware-Definition, sie wird jedoch nur wirksam die Anwendung.

Routing-Middleware

Die am häufigsten verwendete Middleware-Registrierungsmethode ist die Registrierung von Routing-Middleware

Route::rule('hello/:name','hello')
	->middleware(\app\middleware\Auth::class);

Unterstützt die Registrierung mehrerer Middleware Middleware

Route::rule('hello/:name','hello')
	->middleware([\app\middleware\Auth::class, \app\middleware\Check::class]);

kann direkt in middleware.php im Anwendungskonfigurationsverzeichnis vordefiniert werden (tatsächlich wird eine Alias-ID hinzugefügt), zum Beispiel:

return [
	'auth'	=>	app\middleware\Auth::class,
    'check'	=>	app\middleware\Check::class
];

Registrieren Sie es dann direkt in der Route mit dem Middleware-Alias.

Route::rule('hello/:name','hello')
	->middleware(['auth', 'check']);

kann die Verwendung von Aliasen zum Definieren einer Reihe von Middleware unterstützen, zum Beispiel:

return [
	'check'	=>	[
    	app\middleware\Auth::class,
   		app\middleware\Check::class
    ],
];

Verwenden Sie dann direkt die folgende Methode, um die Middleware zu registrieren

Route::rule('hello/:name','hello')
	->middleware('check');

Unterstützt die Registrierung von Middleware für Routinggruppen

Route::group('hello', function(){
	Route::rule('hello/:name','hello');
})->middleware('auth');

Unterstützt die Registrierung einer bestimmten Domainnamen-Registrierungs-Middleware

Route::domain('admin', function(){
	// 注册域名下的路由规则
})->middleware('auth');

Wenn Sie zusätzliche Parameter an die Middleware übergeben müssen, können Sie

Route::rule('hello/:name','hello')
	->middleware('auth', 'admin');

Wenn Sie mehrere Middlewares definieren müssen, verwenden Sie die Array-Methode

Route::rule('hello/:name','hello')
	->middleware([Auth::class, 'Check']);

Übergeben Sie denselben zusätzlichen Parameter

Route::rule('hello/:name','hello')
	->middleware(['auth', 'check'], 'admin');

oder rufen Sie ihn mehrmals separat auf und geben Sie verschiedene Parameter an

Route::rule('hello/:name','hello')
	->middleware('auth', 'admin')
        ->middleware('hello', 'thinkphp');

Wenn Sie möchten, dass eine Routing-Middleware global ausgeführt wird (unabhängig davon, ob die Route übereinstimmt oder nicht), müssen Sie sie nicht im Routing definieren. Sie können sie beispielsweise direkt in der Routing-Konfigurationsdatei definieren. Fügen Sie es in die Konfigurationsdatei config/route.php ein:

'middleware'    =>    [
    app\middleware\Auth::class,
    app\middleware\Check::class,
],

Auf diese Weise führen alle Anforderungen unter der Anwendung die Auth- und Check-Middleware aus.

Verwenden Sie Abschlüsse zum Definieren von Middleware

Sie müssen keine Middleware-Klassen verwenden. In einigen einfachen Situationen können Sie Abschlüsse zum Definieren von Middleware verwenden, aber Abschlüsse Paketfunktionen muss Antwortobjektinstanzen zurückgeben.

Route::group('hello', function(){
	Route::rule('hello/:name','hello');
})->middleware(function($request,\Closure $next){
    if ($request->param('name') == 'think') {
        return redirect('index/think');
    }
    
	return $next($request);
});

Controller-Middleware

Unterstützt die Definition von Middleware für Controller. Sie müssen nur das Middleware-Attribut im Controller definieren, zum Beispiel:

<?php
namespace app\controller;

class Index
{
    protected $middleware = ['auth'];

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

    public function hello()
    {
        return 'hello';
    }
}

Die Authentifizierungs-Middleware wird aufgerufen, wenn der Index-Controller ausgeführt wird, und die Verwendung vollständiger Namespace-Definitionen wird ebenfalls unterstützt.

Wenn Sie den effektiven Betrieb in der Mitte des Controllers festlegen müssen, können Sie ihn wie folgt definieren:

<?php
namespace app\controller;


class Index
{
    protected $middleware = [ 
    	'auth' 	=> ['except' 	=> ['hello'] ],
        'check' => ['only' 		=> ['hello'] ],
    ];

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

    public function hello()
    {
        return 'hello';
    }
}

Die Middleware übergibt Parameter an den Controller

Sie können die Anforderung „Pass-Parameter“ durch Objektzuweisung an den Controller (oder andere Stellen) übergeben. Beispielsweise kann

<?php

namespace app\middleware;

class Hello
{
    public function handle($request, \Closure $next)
    {
        $request->hello = 'ThinkPHP';
        
        return $next($request);
    }
}

direkt in der Controller-Methode verwendet werden.

public function index(Request $request)
{
	return $request->hello; // ThinkPHP
}

Ausführungspriorität

Wenn es eine strenge Ausführungsreihenfolge der Middleware-Anforderungen gibt, Sie können die Ausführungspriorität der Middleware definieren. Fügen Sie

return [
    'alias'    => [
        'check' => [
            app\middleware\Auth::class,
            app\middleware\Check::class,
        ],
    ],
    'priority' => [
        think\middleware\SessionInit::class,
        app\middleware\Auth::class,
        app\middleware\Check::class,
    ],
];

in der Konfigurationsdatei hinzu