- Dasar Perutean
- Parameter Rute
- Penamaan Rute
- Grup Rute
- Pengikatan Rute dan Model
- Rute Fallback
- Pembatasan Laju
- Pemalsuan Method Form
- Mengakses Rute Saat Ini
- Cross-Origin Resource Sharing (CORS)
- Melakukan Cache untuk Rute
Rute (route) Laravel yang paling dasar adalah menerima URI dan closure yang memungkinkan untuk mendefinisikan rute dan perilaku secara sederhana dan ekspresif tanpa file konfigurasi routing yang rumit:
use Illuminate\Support\Facades\Route;
Route::get('/greeting', function () {
return 'Halo Dunia';
});
Semua rute Laravel didefinisikan dalam file rute Anda, yang terletak di direktori routes. File-file ini secara otomatis dimuat oleh App\Providers\RouteServiceProvider aplikasi Anda. File routes/web.php mendefinisikan rute-rute untuk antarmuka web Anda. Rute-rute ini diberi grup middleware web, yang menyediakan fitur-fitur seperti status sesi dan perlindungan CSRF. Rute-rute dalam routes/api.php bersifat stateless dan diberi grup middleware api.
Untuk sebagian besar aplikasi, Anda akan mulai dengan mendefinisikan rute dalam file routes/web.php Anda. Rute-rute yang didefinisikan dalam routes/web.php dapat diakses dengan memasukkan URL rute yang didefinisikan di browser Anda. Sebagai contoh, Anda dapat mengakses rute berikut dengan menavigasi ke http://example.com/user di browser Anda:
use App\Http\Controllers\UserController;
Route::get('/user', [UserController::class, 'index']);
Rute-rute yang didefinisikan dalam file routes/api.php telah tertanam di dalam grup rute RouteServiceProvider. Di dalam grup ini, awalan URI /api secara otomatis diterapkan sehingga Anda tidak perlu menerapkannya secara manual ke setiap rute dalam file. Anda dapat memodifikasi prefiks dan opsi grup rute lainnya dengan memodifikasi kelas RouteServiceProvider Anda.
Router memungkinkan Anda untuk mendaftarkan rute yang merespon setiap verba HTTP:
Route::get($uri, $callback);
Route::post($uri, $callback);
Route::put($uri, $callback);
Route::patch($uri, $callback);
Route::delete($uri, $callback);
Route::options($uri, $callback);
Terkadang Anda mungkin perlu mendaftarkan rute yang merespon beberapa verba HTTP. Anda dapat melakukannya dengan menggunakan metode match. Atau, Anda bahkan dapat mendaftarkan rute yang merespon pada semua verba HTTP menggunakan metode any:
Route::match(['get', 'post'], '/', function () {
//
});
Route::any('/', function () {
//
});
Catatan
Ketika mendefinisikan beberapa rute yang memiliki URI yang sama, rute yang menggunakan metodeget,post,put,patch,delete, danoptionsharus didefinisikan sebelum rute yang menggunakan metodeany,match, danredirect. Hal ini memastikan permintaan yang masuk cocok dengan rute yang benar.
Anda dapat memberikan tipe-hint terhadap kebutuhan dependensi yang dibutuhkan oleh rute Anda dalam signature callback rute Anda. Dependensi yang dideklarasikan akan secara otomatis diselesaikan dan diinjeksikan ke callback oleh service container milik Laravel. Sebagai contoh, Anda dapat memberikan tipe-hint pada kelas Illuminate\Http\Request agar permintaan HTTP saat ini secara otomatis diinjeksikan ke callback rute Anda:
use Illuminate\Http\Request;
Route::get('/users', function (Request $request) {
// ...
});
Ingat, setiap form HTML yang menunjuk ke rute POST, PUT, PATCH, atau DELETE yang didefinisikan dalam file rute web harus menyertakan token CSRF. Jika tidak, permintaan akan ditolak. Anda dapat membaca lebih lanjut tentang perlindungan CSRF di Dokumentasi CSRF:
<form method="POST" action="/profile">
@csrf
...
</form>
Jika Anda mendefinisikan rute yang mengarah ke URI lain, Anda dapat menggunakan metode Route::redirect. Metode ini memberikan pintasan yang praktis sehingga Anda tidak perlu mendefinisikan rute penuh atau kontroller untuk melakukan redirect sederhana:
Jika Anda mendefinisikan rute yang mengarahkan ke URI lain, Anda dapat menggunakan metode Rute::redirect. Metode ini menyediakan jalan pintas yang nyaman sehingga Anda tidak perlu mendefinisikan rute penuh atau rute controller untuk melakukan redirect sederhana:
Route::redirect('/here', '/there');
Secara default, Route::redirect mengembalikan kode status 302. Anda dapat menyesuaikan kode status menggunakan parameter ketiga yang opsional:
Route::redirect('/here', '/there', 301);
Atau, Anda dapat menggunakan metode Route::permanentRedirect untuk mengembalikan kode status 301:
Route::permanentRedirect('/here', '/there');
Peringatan
Ketika menggunakan parameter rute dalam rute redirect, parameter berikut dicadangkan oleh Laravel dan tidak dapat digunakan:destinationdanstatus.
Jika rute Anda hanya perlu mengembalikan view, Anda dapat menggunakan metode Rute::view. Seperti metode redirect, metode ini menyediakan jalan pintas sederhana sehingga Anda tidak perlu mendefinisikan rute penuh atau rute controller. Metode view menerima URI sebagai argumen pertama dan nama view sebagai argumen kedua. Selain itu, Anda dapat menyediakan array data untuk diteruskan ke view sebagai argumen ketiga yang opsional:
Route::view('/welcome', 'welcome');
Route::view('/welcome', 'welcome', ['name' => 'Taylor']);
Peringatan
Ketika menggunakan parameter rute dalam rute view, parameter berikut dicadangkan oleh Laravel dan tidak dapat digunakan:view,data,status, danheaders.
Perintah Artisan route:list dapat dengan mudah memberikan gambaran umum dari semua rute yang telah didefinisikan dalam aplikasi Anda:
php artisan route:listSecara default, middleware rute yang ditugaskan ke setiap rute tidak akan ditampilkan dalam output route:list; namun, Anda dapat menginstruksikan Laravel untuk menampilkan middleware rute dengan menambahkan opsi -v ke perintah:
php artisan route:list -vAnda juga dapat menginstruksikan Laravel untuk hanya menampilkan rute yang dimulai dengan URI tertentu:
php artisan route:list --path=apiSelain itu, Anda dapat menginstruksikan Laravel untuk menyembunyikan rute apa pun yang didefinisikan oleh package dari pihak ketiga dengan memberikan opsi --except-vendor saat menjalankan perintah route:list:
php artisan route:list --except-vendorDemikian juga, Anda juga dapat menginstruksikan Laravel untuk hanya menampilkan rute-rute yang didefinisikan oleh paket-paket pihak ketiga dengan memberikan opsi --only-vendor ketika menjalankan perintah route:list:
php artisan route:list --only-vendorTerkadang Anda perlu menangkap segmen URI dalam rute Anda. Misalnya, Anda mungkin perlu menangkap ID pengguna dari URL. Anda dapat melakukannya dengan mendefinisikan parameter rute:
Route::get('/user/{id}', function ($id) {
return 'User '.$id;
});
Anda dapat mendefinisikan parameter rute sebanyak yang apapun diperlukan pada rute Anda:
Route::get('/posts/{post}/comments/{comment}', function ($postId, $commentId) {
//
});
Parameter rute selalu terbungkus dalam tanda kurung kurawal {} dan harus terdiri dari karakter alfabet. Underscore (_) juga dapat diterima dalam nama parameter rute. Parameter rute diinjeksikan ke dalam rute callback / controller berdasarkan urutannya - nama argumen rute callback / controller tidak menjadi masalah.
Jika rute Anda memiliki dependensi yang ingin disuntikkan secara otomatis ke callback milik rute oleh service container Laravel, Anda sebaiknya mencantumkan parameter rute setelah dependensi Anda:
use Illuminate\Http\Request;
Route::get('/user/{id}', function (Request $request, $id) {
return 'User '.$id;
});
Terkadang Anda mungkin perlu menentukan parameter rute yang mungkin tidak selalu ada di URI. Anda dapat melakukannya dengan menempatkan tanda ? setelah nama parameter. Pastikan untuk memberikan nilai default pada variabel yang sesuai dengan rute:
Route::get('/user/{name?}', function ($name = null) {
return $name;
});
Route::get('/user/{name?}', function ($name = 'John') {
return $name;
});
Anda dapat membatasi format parameter rute Anda dengan menggunakan metode where pada instance rute. Metode where menerima nama parameter dan ekspresi reguler yang menjelaskan bagaimana parameter harus dibatasi:
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]+']);
Untuk kenyamanan, beberapa pola ekspresi reguler yang sering digunakan memiliki metode pembantu yang memungkinkan Anda untuk dengan cepat menambahkan pola batasan ke rute Anda:
Route::get('/user/{id}/{name}', function ($id, $name) {
//
})->whereNumber('id')->whereAlpha('name');
Route::get('/user/{name}', function ($name) {
//
})->whereAlphaNumeric('name');
Route::get('/user/{id}', function ($id) {
//
})->whereUuid('id');
Route::get('/user/{id}', function ($id) {
//
})->whereUlid('id');
Route::get('/category/{category}', function ($category) {
//
})->whereIn('category', ['movie', 'song', 'painting']);
Jika permintaan yang masuk tidak cocok dengan batasan pola rute, maka akan dikembalikan respons HTTP 404.
Jika Anda ingin parameter rute selalu dibatasi oleh ekspresi reguler yang diberikan, Anda dapat menggunakan metode pattern. Anda harus mendefinisikan pola-pola ini dalam metode boot dari kelas App\Providers\RouteServiceProvider:
/**
* Menentukan binding model rute Anda, filter pola, dll.
*
* @return void
*/
public function boot()
{
Route::pattern('id', '[0-9]+');
}
Setelah pola telah didefinisikan, secara otomatis diterapkan pada semua rute yang menggunakan nama parameter tersebut:
Route::get('/user/{id}', function ($id) {
// Only executed if {id} is numeric...
});
Komponen routing Laravel memperbolehkan semua karakter kecuali / untuk hadir di dalam nilai parameter rute. Anda harus secara eksplisit memperbolehkan / untuk menjadi bagian dari placeholder Anda menggunakan ekspresi reguler kondisi where:
Route::get('/search/{search}', function ($search) {
return $search;
})->where('search', '.*');
Perhatian
Garis miring yang dienkode hanya didukung dalam segmen rute terakhir.
Rute yang diberi nama memungkinkan pembuatan URL atau redirect yang nyaman untuk rute tertentu. Anda dapat menentukan nama untuk rute dengan menyambungkan metode name pada pendefinisian rute:
Route::get('/user/profile', function () {
//
})->name('profile');
Anda juga dapat menentukan nama rute untuk aksi controller:
Route::get(
'/user/profile',
[UserProfileController::class, 'show']
)->name('profile');
Perhatian
Nama rute sebaiknya selalu unik.
Menghasilkan URL ke Rute yang Diberi Nama.
Setelah Anda memberikan nama ke rute tertentu, Anda dapat menggunakan nama rute tersebut saat menghasilkan URL atau redirect melalui fungsi helper route dan redirect:
// Menghasilkan URL...
$url = route('profile');
// Menghasilkan Redirect...
return redirect()->route('profile');
return to_route('profile');
Jika terdapat paramete pada rute yang diberi nama, Anda dapat mengirimkan parameter sebagai argumen kedua pada fungsi route. Parameter yang diberikan akan otomatis dimasukkan ke dalam URL yang dihasilkan pada posisi yang tepat:
Route::get('/user/{id}/profile', function ($id) {
//
})->name('profile');
$url = route('profile', ['id' => 1]);
Jika Anda mengirimkan parameter tambahan dalam array, pasangan kunci dan nilai tersebut akan otomatis ditambahkan ke query string URL yang dihasilkan:
Route::get('/user/{id}/profile', function ($id) {
//
})->name('profile');
$url = route('profile', ['id' => 1, 'photos' => 'yes']);
// /user/1/profile?photos=yes
Catatan
Terkadang, Anda mungkin ingin menentukan nilai default untuk parameter URL, seperti locale saat ini. Untuk mencapai ini, Anda dapat menggunakan metode
URL::defaultsmethod.
Jika Anda ingin menentukan apakah request saat ini diarahkan ke nama rute yang sudah ditentukan, Anda dapat menggunakan metode named pada instance Route. Sebagai contoh, Anda dapat memeriksa nama rute saat ini dari middleware rute:
If you would like to determine if the current request was routed to a given named route, you may use the named method on a Route instance. For example, you may check the current route name from a route middleware:
/**
* Menangani request yang dikirimkan.
*
* @param \Illuminate\Http\Request $request
* @param \Closure $next
* @return mixed
*/
public function handle($request, Closure $next)
{
if ($request->route()->named('profile')) {
//
}
return $next($request);
}
Grup rute memungkinkan Anda untuk membagikan atribut-atribut rute, seperti middleware, untuk beberapa rute tanpa perlu mendefinisikan atribut-atribut tersebut pada setiap rute satu-persatu.
Grup di dalam grup digunakan untuk "mengabungkan" atribut secara cerdas dengan kelompok induknya. Middleware dan kondisi where dapat digabungkan saat nama dan prefiks ditambahkan. Pemisah namespace dan garis miring di prefiks URI secara otomatis ditambahkan di tempat yang tepat.
Untuk menetapkan middleware pada semua rute dalam sebuah grup, Anda dapat menggunakan metode middleware sebelum mendefinisikan grup. Middleware dieksekusi dalam urutan yang tercantum dalam array:
Route::middleware(['pertama', 'kedua'])->group(function () {
Route::get('/', function () {
// Menggunakan middleware pertama & kedua...
});
Route::get('/user/profile', function () {
// Menggunakan middleware pertama & kedua...
});
});
Jika sekumpulan rute menggunakan controller yang sama, Anda dapat menggunakan metode controller untuk menentukan controller untuk semua rute dalam kelompok. Kemudian, saat mendefinisikan rute, Anda hanya perlu memberikan metode controller yang ingin dipanggil:
use App\Http\Controllers\OrderController;
Route::controller(OrderController::class)->group(function () {
Route::get('/orders/{id}', 'show');
Route::post('/orders', 'store');
});
Kelompok rute juga dapat digunakan untuk menangani perutean subdomain. Subdomain dapat ditetapkan parameter rute seperti URI rute, sehingga Anda dapat menangkap bagian dari subdomain untuk digunakan dalam rute atau controller Anda. Subdomain dapat ditentukan dengan memanggil metode domain sebelum mendefinisikan grup:
Route::domain('{account}.example.com')->group(function () {
Route::get('user/{id}', function ($account, $id) {
//
});
});
Perhatian
Untuk memastikan rute subdomain Anda dapat dijangkau, Anda sebaiknya mendaftarkan rute subdomain sebelum rute domain root/utama. Ini akan mencegah rute domain root menimpa rute subdomain yang memiliki jalur URI yang sama.
Metode prefix dapat digunakan untuk memberikan prefiks pada setiap rute dalam grup dengan URI tertentu. Sebagai contoh, Anda mungkin ingin memberikan prefiks pada semua URI rute dalam grup dengan admin:
Route::prefix('admin')->group(function () {
Route::get('/users', function () {
// URL akan menjadi "/admin/users"
});
});
Metode name dapat digunakan untuk memberikan prefiks pada setiap nama rute di dalam grup dengan string tertentu. Sebagai contoh, Anda mungkin ingin memberikan prefiks pada semua nama rute di dalam grup dengan nama admin. String tersebut ditambahkan ke nama rute seperti yang sudah ditentukan, jadi kami akan pastikan untuk memberikan karakter . pada akhir prefiks:
Route::name('admin.')->group(function () {
Route::get('/users', function () {
// Nama rute akan menjadi: "admin.users"...
})->name('users');
});
Saat menginjeksi ID model ke rute atau action dari controller, Anda akan sering melakukan kueri basis data untuk mengambil model yang sesuai dengan ID tersebut. Untuk pengikatan (Binding) rute-model, Laravel menyediakan cara yang mudah untuk menginjeksi instance model langsung ke rute Anda secara otomatis. Misalnya, alih-alih menginjeksi ID pengguna, Anda dapat menginjeksi seluruh instance model User yang sesuai dengan ID yang diberikan.
Laravel secara otomatis memberikan model Eloquent yang didefinisikan dalam rute atau action milik controller yang nama variabel dan type-hint-nya serupa dengan nama segmen rute. Sebagai contoh:
use App\Models\User;
Route::get('/users/{user}', function (User $user) {
return $user->email;
});
Karena variabel $user diisyaratkan sebagai model Eloquent App\Models\User dan nama variabel cocok dengan segmen URI {user}, Laravel akan secara otomatis menginjeksikan instance model yang memiliki ID yang cocok dengan nilai yang sesuai dari request URI. Jika instance model tidak ditemukan pada basis data, respons HTTP 404 akan secara otomatis dihasilkan.
Tentu saja, pengikatan implisit juga dimungkinkan ketika menggunakan metode di dalam controller. Sekali lagi, perhatikan segmen URI {user} sesuai dengan variabel $user di controller yang berisi type-hint App\Models\User:
use App\Http\Controllers\UserController;
use App\Models\User;
// Pendefinisian rute...
Route::get('/users/{user}', [UserController::class, 'show']);
// Pendefinisian metode pada controller...
public function show(User $user)
{
return view('user.profile', ['user' => $user]);
}
Biasanya, binding model implisit tidak akan mengambil model yang telah dihapus secara soft. Namun, Anda dapat menyuruh binding implisit untuk mengambil model-model ini dengan merantai method withTrashed pada definisi rute Anda:
use App\Models\User;
Route::get('/users/{user}', function (User $user) {
return $user->email;
})->withTrashed();
Kadang-kadang Anda mungkin ingin mengambil model Eloquent menggunakan kolom selain id. Untuk melakukannya, Anda dapat menentukan kolom dalam pendefinisian parameter untuk rute:
use App\Models\Post;
Route::get('/posts/{post:slug}', function (Post $post) {
return $post;
});
Jika Anda ingin model yang terikat selalu menggunakan kolom database selain id saat mengambil kelas model tertentu, Anda dapat menimpa method getRouteKeyName pada model Eloquent:
/**
* mendapatkan kunci rute untuk model.
*
* @return string
*/
public function getRouteKeyName()
{
return 'slug';
}
Saat melakukan binding beberapa model Eloquent dalam satu definisi rute secara implisit, Anda mungkin ingin membatasi model Eloquent kedua sehingga harus menjadi anak dari model Eloquent sebelumnya. Sebagai contoh, pertimbangkan definisi rute berikut yang mengambil posting-an blog dengan slug untuk pengguna tertentu:
use App\Models\Post;
use App\Models\User;
Route::get('/users/{user}/posts/{post:slug}', function (User $user, Post $post) {
return $post;
});
Ketika menggunakan binding implisit kustom yang ditandai sebagai parameter rute bersarang, Laravel secara otomatis akan membatasi query untuk mengambil model bersarang dengan parent menggunakan konvensi untuk menebak nama hubungan pada parent. Dalam hal ini, akan diasumsikan bahwa model User memiliki hubungan yang diberi nama posts (bentuk jamak dari nama parameter rute) yang dapat digunakan untuk mengambil model Post.
Jika Anda ingin agar Laravel mengikat "anak" secara terbatas bahkan tanpa kunci khusus, Anda dapat memanggil metode scopeBindings saat mendefinisikan rute Anda:
use App\Models\Post;
use App\Models\User;
Route::get('/users/{user}/posts/{post}', function (User $user, Post $post) {
return $post;
})->scopeBindings();
Atau, Anda dapat memberitahu seluruh definisi rute pada grup untuk menggunakan binding yang terbatas:
Route::scopeBindings()->group(function () {
Route::get('/users/{user}/posts/{post}', function (User $user, Post $post) {
return $post;
});
});
Anda juga dapat secara eksplisit menyuruh Laravel untuk tidak melakukan pembatasan dengan menggunakan method withoutScopedBindings:
Route::get('/users/{user}/posts/{post:slug}', function (User $user, Post $post) {
return $post;
})->withoutScopedBindings();
Biasanya, respons HTTP 404 akan dihasilkan jika model yang terikat secara implisit tidak ditemukan. Namun, Anda dapat menyesuaikan perilaku ini dengan memanggil metode missing ketika mendefinisikan rute Anda. Metode missing menerima closure yang akan dipanggil jika model yang terikat secara implisit tidak dapat ditemukan:
use App\Http\Controllers\LocationsController;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Redirect;
Route::get('/locations/{location:slug}', [LocationsController::class, 'show'])
->name('locations.view')
->missing(function (Request $request) {
return Redirect::route('locations.index');
});
PHP 8.1 memperkenalkan dukungan untuk Enum. Untuk melengkapi fitur ini, Laravel memungkinkan Anda untuk type-hint string-backed Enum pada definisi rute Anda dan Laravel hanya akan memanggil rute jika segmen rute tersebut sesuai dengan nilai Enum yang valid. Jika tidak, respons HTTP 404 akan dikembalikan secara otomatis. Sebagai contoh, diberikan Enum sebagai berikut:
<?php
namespace App\Enums;
enum Category: string
{
case Fruits = 'fruits';
case People = 'people';
}Anda dapat mendefinisikan rute yang hanya akan dipanggil jika segmen rute {category} adalah fruits atau people. Jika tidak, Laravel akan mengembalikan respons HTTP 404:
use App\Enums\Category;
use Illuminate\Support\Facades\Route;
Route::get('/categories/{category}', function (Category $category) {
return $category->value;
});Anda tidak diharuskan menggunakan resolusi model implisit berbasis konvensi Laravel untuk menggunakan model binding. Anda juga dapat secara eksplisit mendefinisikan bagaimana parameter rute dapat koresponden dengan model. Untuk mendaftarkan pengikatan eksplisit, gunakan metode model router untuk menentukan kelas untuk parameter yang diberikan. Anda harus mendefinisikan binding model eksplisit Anda di awal metode boot dari kelas RouteServiceProvider Anda:
use App\Models\User;
use Illuminate\Support\Facades\Route;
/**
* Menentukan binding model rute Anda, filter pola, dll.
*
* @return void
*/
public function boot()
{
Route::model('user', User::class);
// ...
}
Selanjutnya, definisikan sebuah rute yang memiliki parameter {user}:
use App\Models\User;
Route::get('/users/{user}', function (User $user) {
//
});
Karena kita telah mengikat semua parameter {user} ke model App\Models\User, sebuah instance dari kelas tersebut akan diinjeksi ke dalam rute. Jadi, misalnya, permintaan ke users/1 akan menginjeksi instance User dari database yang memiliki ID 1.
Jika instance model yang cocok tidak ditemukan dalam database, respons HTTP 404 akan dihasilkan secara otomatis.
Jika Anda ingin mendefinisikan logika resolusi pengikatan model Anda sendiri, Anda dapat menggunakan metode Rute::bind. Closure yang Anda berikan ke metode bind akan menerima nilai segmen URI dan harus mengembalikan instance dari kelas yang harus diinjeksikan ke dalam rute. Sekali lagi, kustomisasi ini harus dilakukan dalam metode boot pada RouteServiceProvider aplikasi Anda:
use App\Models\User;
use Illuminate\Support\Facades\Route;
/**
* Menentukan binding model rute Anda, filter pola, dll.
*
* @return void
*/
public function boot()
{
Route::bind('user', function ($value) {
return User::where('name', $value)->firstOrFail();
});
// ...
}
Sebagai alternatif, Anda dapat meng-override metode resolveRouteBinding pada model Eloquent Anda. Metode ini akan menerima nilai segmen URI dan harus mengembalikan instance dari kelas yang harus diinjeksikan ke dalam rute:
/**
* Mengambil model berdasarkan nilai yang diberikan.
*
* @param mixed $value
* @param string|null $field
* @return \Illuminate\Database\Eloquent\Model|null
*/
public function resolveRouteBinding($value, $field = null)
{
return $this->where('name', $value)->firstOrFail();
}
Jika sebuah rute menggunakan implicit binding scoping, metode resolveChildRouteBinding akan digunakan untuk menyelesaikan pengikatan anak dari model induk:
/**
* Mengambil model anak berdasarkan nilai yang diberikan.
*
* @param string $childType
* @param mixed $value
* @param string|null $field
* @return \Illuminate\Database\Eloquent\Model|null
*/
public function resolveChildRouteBinding($childType, $value, $field)
{
return parent::resolveChildRouteBinding($childType, $value, $field);
}
Dengan menggunakan metode Route::fallback, Anda dapat mendefinisikan rute yang akan dieksekusi ketika tidak ada rute lain yang cocok dengan permintaan yang masuk. Biasanya, permintaan yang tidak tertangani akan secara otomatis me-render halaman "404" melalui exception handler pada aplikasi Anda. Namun, karena Anda biasanya akan mendefinisikan rute fallback di dalam file routes/web.php Anda, semua middleware pada grup middleware web akan menerapkan hal tersebut. Anda bebas menambahkan middleware tambahan ke rute ini sesuai kebutuhan:
Route::fallback(function () {
//
});
Peringatan
Rute fallback harus selalu merupakan rute terakhir yang didaftarkan pada aplikasi Anda.
Laravel menyertakan layanan pembatasan rate (laju) yang kuat dan dapat disesuaikan yang dapat Anda manfaatkan untuk membatasi jumlah lalu lintas untuk rute atau grup rute tertentu. Untuk memulai, Anda harus mendefinisikan konfigurasi pembatas rate yang memenuhi kebutuhan aplikasi Anda. Biasanya, hal ini harus dilakukan di dalam metode configureRateLimiting dari kelas App\Providers\RouteServiceProvider aplikasi Anda, yang mana telah tersedia sebuah definisi pembatas laju yang terterapkan pada file routes/api.php pada aplikasi Anda:
use Illuminate\Cache\RateLimiting\Limit;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\RateLimiter;
/**
* Configure the rate limiters for the application.
*/
protected function configureRateLimiting(): void
{
RateLimiter::for('api', function (Request $request) {
return Limit::perMinute(60)->by($request->user()?->id ?: $request->ip());
});
}Pembatas rate didefinisikan menggunakan metode for facade RateLimiter. Metode for menerima nama pembatas laju dan closure yang mengembalikan konfigurasi batas yang harus diterapkan ke rute yang ditugaskan ke pembatas laju. Konfigurasi limit adalah instance dari kelas Illuminate\Cache\RateLimiting\Limit. Kelas ini berisi metode-metode "builder" yang berguna sehingga Anda dapat dengan cepat mendefinisikan limit Anda. Nama pembatas rate dapat berupa string apa pun yang Anda inginkan:
use Illuminate\Cache\RateLimiting\Limit;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\RateLimiter;
/**
* Konfigurasi pembatas laju untuk aplikasi.
*
* @return void
*/
protected function configureRateLimiting()
{
RateLimiter::for('global', function (Request $request) {
return Limit::perMinute(1000);
});
}
Jika permintaan yang masuk melebihi batas laju yang ditentukan, respons dengan kode status HTTP 429 akan secara otomatis dikembalikan oleh Laravel. Jika Anda ingin menentukan respons Anda sendiri yang harus dikembalikan oleh pembatas laju, Anda dapat menggunakan metode response:
RateLimiter::for('global', function (Request $request) {
return Limit::perMinute(1000)->response(function (Request $request, array $headers) {
return response('Respojlns kustom...', 429, $headers);
});
});
Karena callback dari pembatas laju menerima instance permintaan HTTP yang masuk, Anda dapat membuat batas laju yang dinamis berdasarkan permintaan yang masuk atau pengguna yang diautentikasi:
RateLimiter::for('uploads', function (Request $request) {
return $request->user()->vipCustomer()
? Limit::none()
: Limit::perMinute(100);
});
Kadang-kadang, Anda mungkin ingin membagi batas kecepatan dengan beberapa nilai yang sewenang-wenang. Misalnya, anda mungkin ingin mengizinkan pengguna untuk mengakses rute tertentu 100 kali per menit per alamat IP. Untuk mencapai hal ini, anda dapat menggunakan metode by ketika membangun rate limit anda:
RateLimiter::for('uploads', function (Request $request) {
return $request->user()->vipCustomer()
? Limit::none()
: Limit::perMinute(100)->by($request->ip());
});
Untuk mengilustrasikan fitur ini dengan menggunakan contoh lain, kita bisa membatasi akses ke rute hingga 100 kali per menit per ID pengguna yang diautentikasi atau 10 kali per menit per alamat IP untuk tamu:
RateLimiter::for('uploads', function (Request $request) {
return $request->user()
? Limit::perMinute(100)->by($request->user()->id)
: Limit::perMinute(10)->by($request->ip());
});
Jika diperlukan, Anda dapat mengembalikan array batas laju untuk konfigurasi pembatas tarif yang diberikan. Setiap rate limit akan dievaluasi untuk rute berdasarkan urutan penempatannya dalam array:
RateLimiter::for('login', function (Request $request) {
return [
Limit::perMinute(500),
Limit::perMinute(3)->by($request->input('email')),
];
});
Pembatas laju dapat dilampirkan ke rute atau grup rute menggunakan middleware throttle. Middleware throttle menerima nama pembatas laju yang ingin Anda tetapkan ke rute:
Route::middleware(['throttle:uploads'])->group(function () {
Route::post('/audio', function () {
//
});
Route::post('/video', function () {
//
});
});
Biasanya, middleware throttle dipetakan ke kelas Illuminate\Routing\Middleware\ThrottleRequests. Pemetaan ini didefinisikan dalam kernel HTTP aplikasi Anda (App\Http\Kernel). Namun, jika Anda menggunakan Redis sebagai driver cache aplikasi Anda, Anda mungkin ingin mengubah pemetaan ini untuk menggunakan kelas Illuminate\Routing\Middleware\ThrottleRequestsWithRedis. Kelas ini lebih efisien dalam mengelola pembatasan laju menggunakan Redis:
'throttle' => \Illuminate\Routing\Middleware\ThrottleRequestsWithRedis::class,
Formulir HTML tidak mendukung aksi PUT, PATCH, atau DELETE. Jadi, ketika mendefinisikan rute PUT, PATCH, atau DELETE yang dipanggil dari form HTML, Anda perlu menambahkan field _method yang tersembunyi pada form. Nilai yang dikirim dengan field _method akan digunakan sebagai metode permintaan HTTP:
<form action="/example" method="POST">
<input type="hidden" name="_method" value="PUT">
<input type="hidden" name="_token" value="{{ csrf_token() }}">
</form>
Untuk kenyamanan, anda dapat menggunakan Blade directive @method untuk menghasilkan kolom input _method:
<form action="/example" method="POST">
@method('PUT')
@csrf
</form>
Anda dapat menggunakan metode current, currentRouteName, dan currentRouteAction pada facade Route untuk mengakses informasi tentang rute yang menangani permintaan yang masuk:
use Illuminate\Support\Facades\Route;
$route = Route::current(); // Illuminate\Routing\Route
$name = Route::currentRouteName(); // string
$action = Route::currentRouteAction(); // string
Anda dapat merujuk ke dokumentasi API untuk kelas yang mendasari facade Route dan instance Route untuk meninjau semua metode yang tersedia pada kelas Router dan Route.
Laravel dapat secara otomatis merespons permintaan HTTP CORS OPTIONS dengan nilai-nilai yang Anda konfigurasikan. Semua pengaturan CORS dapat dikonfigurasi dalam file konfigurasi config/cors.php aplikasi Anda. Permintaan OPTIONS secara otomatis akan ditangani oleh HandleCors middleware yang disertakan secara default dalam tumpukan middleware global Anda. Tumpukan middleware global Anda terletak pada kernel HTTP aplikasi Anda (App\Http\Kernel).
Catatan
Untuk informasi lebih lanjut tentang CORS dan header CORS, silakan mengunjungi dokumentasi web MDN tentang CORS.
Saat men-delpoy aplikasi Anda ke lingkungan production, Anda harus memanfaatkan cache rute Laravel. Menggunakan cache rute akan mengurangi jumlah waktu yang diperlukan untuk mendaftarkan semua rute aplikasi Anda secara drastis. Untuk membuat cache rute, jalankan perintah Artisan route:cache:
php artisan route:cacheSetelah menjalankan perintah ini, file rute yang telah di-cache akan dimuat pada setiap permintaan. Ingat, jika Anda menambahkan rute baru, Anda perlu melakukan cache ulang. Karena itu, Anda sebaiknya hanya menjalankan perintah route:cache pada saat deployment saja.
Anda dapat menggunakan perintah route:clear untuk menghapus cache rute:
php artisan route:clear