Route

• Einfache Straße Umgeleitet von
  • Route
  • Route anzeigen
• Routenparameter
  • Erforderliche Parameter
  • Optionale Parameter
  • Parameter für reguläre Ausdrücke
• Benannt Route
• Routengruppe
  • Middleware
  • Namespace
  • Subdomain-Routing
  • Routenpräfix
  • Routenbenennungspräfix
• Routenmodellbindung
  • Implizite Bindung
  • Explizite Bindung
• Fallback-Routing
• Frequenzlimit
• Formularmethode gefälscht
• Auf aktuelle Route zugreifen

Basisroute

Für den Aufbau einer Basisroute ist nur Folgendes erforderlich: URI mit einem 闭包 bietet hier eine sehr einfache und elegante Möglichkeit, Routen zu definieren:

Route::get('foo', function () {  
  return 'Hello World';
  });

Standard-Routing-Datei

Alle Laravel-Routen sind in Routing-Dateien im Verzeichnis routes definiert, und diese Dateien werden automatisch vom Framework geladen. routes/web.php-Dateien werden zum Definieren von Routen für die web-Schnittstelle verwendet. Die Routen werden hier der Middleware-Gruppe web zugewiesen, die Funktionen wie Sitzungsstatus und CSRF-Schutz bereitstellt. In routes/api.php definierte Routen sind zustandslos und der Middleware-Gruppe api zugewiesen.

Die meisten Anwendungskonstruktionen beginnen mit der Definition von Routen in der routes/web.php-Datei. Auf die in routes/web.php definierten Routen kann durch Eingabe der definierten Routen-URL in einen Browser zugegriffen werden. Sie können beispielsweise http://your-app.dev/user in Ihren Browser eingeben, um auf die folgende Route zuzugreifen:

Route::get('/user', 'UserController@index');

routes/api.php Die in der Datei definierten Routen werden über RouteServiceProvider in einer Routengruppe verschachtelt. Innerhalb dieser Routengruppe wird das URL-Präfix /api automatisch zu jeder Route in dieser Datei hinzugefügt, sodass Sie es nicht manuell hinzufügen müssen. Sie können dieses Präfix und andere Routengruppenoptionen in der Klasse RouteServiceProvider ändern.

Verfügbare Routing-Methoden

Mit dem Router können Sie eine Route registrieren, die auf jede HTTP-Anfrage antworten kann:

Route::get($uri, $callback);
Route::post($uri, $callback);
Route::put($uri, $callback);
Route::patch($uri, $callback);
Route::delete($uri, $callback);
Route::options($uri, $callback);

Manchmal müssen Sie sich möglicherweise registrieren Eine Route, die auf jede HTTP-Anfrage antworten kann: Route zur Antwort auf mehrere HTTP-Anfragen. In diesem Fall können Sie die Methode match verwenden oder die Methode any verwenden, um eine Implementierung zu registrieren, die auf alle HTTP-Anfragen antwortet . Angeforderte Route:

Route::match(['get', 'post'], '/', function () { 
   //
});
Route::any('foo', function () {  
  //
});

CSRF-Schutz

Jedes HTML-Formular, das auf eine web-, POST- oder PUT-Route zeigt, die in der Routendatei DELETE definiert ist Alle sollten ein CSRF-Token-Feld enthalten, andernfalls wird die Anfrage abgelehnt. Weitere Informationen zu CSRF finden Sie in der CSRF-Dokumentation:

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

Redirect route

wenn Sie To definieren möchten Um zu einem anderen URI umzuleiten, verwenden Sie die Methode Route::redirect. Mit dieser Methode kann eine Umleitung schnell implementiert werden, ohne dass eine vollständige Route oder ein Controller definiert werden muss:

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

Route::redirect gibt standardmäßig den Statuscode 302 zurück. Sie können den Rückgabecode über den dritten Parameter anpassen:

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

Sie können auch die Route::permanentRedirect-Methode verwenden, um den 301-Statuscode zurückzugeben:

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

Routenansicht anzeigen

Wenn Ihre Route nur eine Ansicht zurückgeben muss, können Sie die Methode Route::view verwenden. Es ist genauso praktisch wie redirect und erfordert keine Definition einer vollständigen Route oder eines Controllers. Die view-Methode verfügt über drei Parameter, von denen der erste erforderlich ist und der URI ist, der den Ansichtsnamen enthält. Der zweite und erforderliche Parameter ist der Name der Ansicht, die gerendert werden muss. Der dritte Parameter ist ein optionaler Parameter. Sie können ein Array übergeben, und die Daten im Array werden an die Ansicht übergeben:

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

Routenparameter

Erforderliche Parameter

Natürlich muss man manchmal einige erfassen die Route URL-Fragment. Um beispielsweise die Benutzer-ID aus der URL zu erfassen, können Sie dies tun, indem Sie Routenparameter definieren:

Route::get('user/{id}', function ($id) { 
   return 'User '.$id;
 });

Sie können bei Bedarf auch mehrere Parameter in der Route definieren:

Route::get('posts/{post}/comments/{comment}', function ($postId, $commentId) { 
   //
});

Die Parameter von Die Route wird normalerweise innerhalb von {} platziert und Parameternamen dürfen nur Buchstaben enthalten. Gleichzeitig können Routing-Parameter keine --Symbole enthalten. Sie können bei Bedarf durch Unterstriche (_) ersetzt werden. Routenparameter werden der Reihe nach in Routenrückrufe oder Controller eingefügt, unabhängig von den Parameternamen der Rückrufe oder Controller.

Optionale Parameter

Manchmal müssen Sie möglicherweise einen Routenparameter angeben, möchten aber, dass dieser Parameter vorhanden ist verfügbar Ausgewählt. Sie können nach dem Parameter das Tag ? hinzufügen, um dies zu erreichen. Voraussetzung ist jedoch, dass die entsprechende Variable der Route einen Standardwert

Route::get('user/{name?}', function ($name = null) { 
   return $name;
});
Route::get('user/{name?}', function ($name = 'John') {  
  return $name;
});

Einschränkungen für reguläre Ausdrücke

Sie können where für die Routeninstanz verwenden Die Methode schränkt das Format der Routenparameter ein. where Die Methode akzeptiert Parameternamen und reguläre Ausdrücke, die definieren, wie die Parameter eingeschränkt werden sollen:

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

Globale Einschränkungen

Wenn Sie möchten, dass ein bestimmter Routenparameter alle dem gleichen folgt Regulärer Ausdruck Für Ausdruckseinschränkungen verwenden Sie die Methode pattern in RouteServiceProvider Definieren Sie diese Muster in der Methode boot:

/**
 * 定义你的路由模型绑定, pattern 过滤器等。
 *
 * @return void
 */
 public function boot(){
     Route::pattern('id', '[0-9]+');    
     parent::boot();
  }

Sobald diese Regeln definiert sind, werden sie automatisch auf alle Routen angewendet, die diesen Parameternamen verwenden:

Route::get('user/{id}', function ($id) { 
   // 只有在 id 为数字时才执行。
 });

Codierung mit Schrägstrich Charaktere

Laravel Routing-Komponenten erlauben alle Zeichen außer /. Sie müssen where explizit erlauben, Teil eines Platzhalters zu sein, indem Sie den bedingten regulären Ausdruck / verwenden:

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

Hinweis: Kodierte Schrägstriche werden nur im letzten Routensegment unterstützt.

Routenbenennung

Routenbenennung kann ganz einfach URLs oder Weiterleitungen für bestimmte Routen generieren. Sie können den Routennamen angeben, indem Sie die Methode name in der Routendefinition verketten:

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

Sie können auch den Routennamen des Controller-Verhaltens angeben:

Route::get('user/profile', 'UserProfileController@show')->name('profile');

Generieren Sie die geroutete Spezifikation URL

Nachdem Sie einen Namen für die Route angegeben haben, können Sie die globale Hilfsfunktion route verwenden, um einen Link zu generieren oder zur Route weiterzuleiten:

// 生成 URL...
$url = route('profile');
// 生成重定向...
return redirect()->route('profile');

Wenn es sich um eine benannte Route mit definierter Route handelt Parameter können Sie die Parameter als zweiten Parameter der Funktion route übergeben, und die angegebenen Parameter werden automatisch in die URL eingefügt. Die entsprechende Position in:

Route::get('user/{id}/profile', function ($id) {
    //
 })->name('profile');
 $url = route('profile', ['id' => 1]);

Überprüfen Sie die aktuelle Route

Wenn Sie feststellen möchten, ob die aktuelle Anfrage auf eine bestimmte Route verweist, können Sie named aufrufen die Routing-Instanzmethode. Sie können beispielsweise den aktuellen Routennamen in der Routing-Middleware überprüfen:

/**
 * 处理一次请求。
 *
 * @param  \Illuminate\Http\Request  $request
 * @param  \Closure  $next
 * @return mixed
 */
 public function handle($request, Closure $next){
     if ($request->route()->named('profile')) {    
         //  
        } 
    return $next($request);
 }

route group

route group zulässig Sie teilen Routeneigenschaften wie Middleware oder Namespaces über eine große Anzahl von Routen hinweg, ohne diese Eigenschaften für jede Route einzeln zu definieren. Gemeinsame Eigenschaften sollten in Form eines Arrays an den ersten Parameter der Route::group-Methode übergeben werden.

Middleware

Um allen Routen in einer Routinggruppe Middleware zuzuweisen, rufen Sie < vor Gruppe 🎜> auf Methoden und Middleware werden in der Reihenfolge ausgeführt, in der sie im Array aufgeführt sind: middleware

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

zu verwenden, um dasselbe PHP zu konvertieren Der Namespace wird allen Controllern in der Routing-Gruppe zugewiesen: namespace

Route::namespace('Admin')->group(function () {  
  // 在 "App\Http\Controllers\Admin" 命名空间下的控制器
 });

standardmäßig Ihre Routing-Dateien in die Namespace-Gruppe importiert, sodass Sie nicht das vollständige RouteServiceProvider Namespace-Präfix angeben müssen kann zum Registrieren von Controller-Routen verwendet werden. Daher müssen Sie nur den Teil nach dem Namespace AppHttpControllers angeben. AppHttpControllers

-Methode vor der Gruppe aufrufen, um einen Subdomain-Namen anzugeben: domain

Route::domain('{account}.myapp.com')->group(function () { 
   Route::get('user/{id}', function ($account, $id) { 
          //   
    });
 });

Methode fügt der angegebenen URL in der Routinggruppe ein Präfix hinzu. Beispielsweise können Sie den URIs aller Routen in der Gruppe admin voranstellen: prefix

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');});

Route::get('api/users/{user}', function (App\User $user) { 
   return $user->email;
});

/**
 * 获取该模型的路由的自定义键名。
 *
 * @return string
 */
 public function getRouteKeyName(){
     return 'slug';
  }

public function boot(){
    parent::boot();
    Route::model('user', App\User::class);
  }

Route::get('profile/{user}', function (App\User $user) { 
   //
 });

/**
 * 启动应用服务。
 *
 * @return void
 */
 public function boot(){
         parent::boot();        
         Route::bind('user', function ($value) {          
               return App\User::where('name', $value)->first() ?? abort(404);   
               });
    }

/**
 * 检索绑定值的模型。
 *
 * @param  mixed  $value
 * @return \Illuminate\Database\Eloquent\Model|null
 */
 public function resolveRouteBinding($value){ 
    return $this->where('name', $value)->first() ?? abort(404);
 }

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

Route::middleware('auth:api', 'throttle:60,1')->group(function () { 
   Route::get('/user', function () { 
          //   
       });
  });

Route::middleware('auth:api', 'throttle:rate_limit,1')->group(function () {
    Route::get('/user', function () {  
          //  
      });
  });

<form action="/foo/bar" method="POST"> 
  <input type="hidden" name="_method" value="PUT"> 
  <input type="hidden" name="_token" value="{{ csrf_token() }}">
</form>

<form action="/foo/bar" method="POST">
    @method('PUT')
    @csrf
</form>