Install Laravel API

Sejak pembaruan Laravel 11, konfigurasi untuk API tidak disertakan secara default saat instalasi proyek baru. Oleh karena itu, Anda perlu melakukan instalasi secara manual. Silakan masukkan perintah berikut di terminal:

php artisan install:api

Perintah ini akan menginstal modul yang diperlukan untuk API, termasuk file konfigurasi, middleware, dan struktur rute yang sesuai.

Setelah proses instalasi selesai, Laravel akan menampilkan pertanyaan apakah Anda ingin melakukan migrasi tambahan. Silakan ketik yes lalu tekan Enter. Sistem secara otomatis akan menjalankan migrasi seperti pada gambar berikut:

Migrasi ini mencakup tabel yang diperlukan untuk fitur API, seperti tabel tokens jika Anda menggunakan Laravel Sanctum untuk otentikasi API.

Konfigurasi app.php

Untuk mengatur pengecualian CSRF (Cross-Site Request Forgery) pada rute API, buka file app.php di dalam folder bootstrap. Kemudian tambahkan kode berikut ke dalam file tersebut:

->withMiddleware(function (Middleware $middleware) {
        $middleware->validateCsrfTokens(except: [
            '/api/*',
        ]);
    })

Kode ini berfungsi untuk mengecualikan token CSRF pada rute yang diawali dengan /api/*. Hal ini penting karena API biasanya diakses oleh klien eksternal seperti aplikasi seluler atau frontend berbasis JavaScript, yang tidak selalu dapat mengelola token CSRF dengan baik.

Setelah menambahkan kode tersebut, file app.php Anda secara keseluruhan akan terlihat seperti ini:

<?php

use Illuminate\Foundation\Application;
use Illuminate\Foundation\Configuration\Exceptions;
use Illuminate\Foundation\Configuration\Middleware;

return Application::configure(basePath: dirname(__DIR__))
    ->withRouting(
        web: __DIR__.'/../routes/web.php',
        api: __DIR__.'/../routes/api.php',
        commands: __DIR__.'/../routes/console.php',
        health: '/up',
    )
    ->withMiddleware(function (Middleware $middleware) {
        $middleware->validateCsrfTokens(except: [
            '/api/*',
        ]);
    })
    ->withExceptions(function (Exceptions $exceptions) {
        //
    })->create();

Pada materi berikutnya, kita akan membuat Auth Controller.