use Illuminate\Support\Facades\Route;

// 1. GET: Digunakan untuk mengambil atau menampilkan data (Idempotent)
Route::get('/', function () {
    return 'Selamat Datang di Situs SuryaSSH!';
});

// 2. POST: Digunakan untuk mengirimkan payload data baru (Simpan Form)
Route::post('/users', function (\Illuminate\Http\Request $request) {
    return 'Data user berhasil disimpan ke database.';
});

// 3. PUT/PATCH: Digunakan untuk memperbarui data yang sudah ada
Route::put('/users/{id}', function (string $id) {
    return 'Pembaruan data user ID: ' . $id;
});

// 4. DELETE: Digunakan untuk menghapus entitas data dari sistem
Route::delete('/users/{id}', function (string $id) {
    return 'Penghapusan data user ID: ' . $id;
});

Pemberian Nama Rute (Named Routes)

*Named Routes* memungkinkan Anda membuat alias atau nama unik untuk sebuah rute. Ini sangat direkomendasikan agar saat Anda mengubah struktur URL (misal dari `/akun-saya` menjadi `/profile`), Anda tidak perlu mengubah tautan di ratusan file Blade individual:

// Mendefinisikan nama alias rute menggunakan method name()
Route::get('/user/dashboard/profile-panel', [UserController::class, 'show'])->name('profile');

// 1. Contoh memanggil rute untuk pembuatan URL link di berkas Blade HTML:
<a href="{{ route('profile') }}">Lihat Profil Saya</a>

// 2. Contoh memicu pengalihan (Redirect) di dalam komponen Controller:
return redirect()->route('profile');

// 3. Menghasikan rute pembawa parameter dinamis
Route::get('/posts/{post_id}', [PostController::class, 'show'])->name('posts.show');
$url = route('posts.show', ['post_id' => 120]); // Menghasilkan: /posts/120

2. Pengelompokan Rute Massal (Route Groups)

*Route Groups* mengizinkan Anda membagikan atribut konfigurasi (seperti proteksi Middleware, penambahan awalan URL/Prefix, atau penamaan Name Prefix) ke banyak rute sekaligus tanpa perlu menulisnya satu per satu:

// Menggabungkan pembatasan hak akses (Middleware) dan awalan URL (Prefix)
Route::middleware(['auth'])->prefix('admin')->name('admin.')->group(function () {
    
    // URL jalur ini otomatis menjadi: /admin/dashboard
    // Nama rute otomatis diidentifikasi sebagai: admin.dashboard
    Route::get('/dashboard', [AdminController::class, 'index'])->name('dashboard');
    
    // URL jalur ini otomatis menjadi: /admin/settings
    Route::get('/settings', [AdminController::class, 'settings'])->name('settings');
});

3. Otomatisasi Endpoint via Resource Routes

Fungsi Route::resource memetakan satu jalur kata kunci menjadi 7 jenis rute terproteksi untuk menangani operasi CRUD standar secara otomatis sesuai konvensi RESTful:

// Otomatis men-generate rute index, create, store, show, edit, update, dan destroy
Route::resource('products', ProductController::class);

// Membatasi hanya memuat rute tertentu saja (Partial Resource)
Route::resource('photos', PhotoController::class)->only([
    'index', 'show'
]);

// Membuat rute resource dengan mengecualikan rute tertentu
Route::resource('videos', VideoController::class)->except([
    'create', 'store'
]);

// 1. Parameter Opsional (Gunakan tanda tanya '?' dan set nilai default di fungsi argumen)
Route::get('/orders/{id?}', function (string $id = null) {
    return $id ? "Membuka manifes Order ID: " . $id : "Menampilkan seluruh manifes order.";
});

// 2. Validasi Parameter Menggunakan Regex (Klausa where)
// Memastikan parameter {id} wajib diisi oleh deretan angka numerik (0-9)
Route::get('/vless/{id}', [TunnelController::class, 'vless'])->where('id', '[0-9]+');

// 3. Validasi Multi Parameter
Route::get('/file/{category}/{slug}', [FileController::class, 'index'])->where([
    'category' => '[a-zA-Z]+', // Hanya menerima karakter alphabet huruf besar/kecil
    'slug' => '[a-z0-9\-]+'   // Hanya menerima format string slug lowercase, angka, dan dash (-)
]);

Praktik Terbaik Optimasi Sistem Routing Laravel

Terapkan prinsip standarisasi berikut untuk menjaga arsitektur perutean situs Anda tetap aman dan berperforma tinggi:

• Aktifkan Route Caching di Server Produksi: Saat mendistribusikan aplikasi Anda ke server operasional harian (seperti NAT VPS atau cloud server), jalankan baris perintah kompilasi php artisan route:cache. Ini akan mengubah seluruh berkas rute menjadi file array tunggal terkompilasi yang mempercepat waktu respons web server Anda secara drastis.
• Gunakan Route Model Binding: Alih-alih meloloskan parameter ID mentah lalu memproses fungsi find() di dalam Controller, manfaatkan *Route Model Binding* (misal: Route::get('/users/{user}', ...)) agar pencarian instans objek dieksekusi otomatis oleh core engine Laravel.
• Hindari Kompleksitas Logika di Berkas Route: Jangan menuliskan logika kueri database yang rumit langsung di dalam berkas *Closure* rute web. Selalu arahkan panggilan rute menuju metode tindakan di dalam berkas **Controller** demi kemudahan proses debugging dan kerapian kode proyek.