Menguasai Pengesahan Laravel dengan Pasport: Panduan Langkah demi Langkah

Pengesahan ialah asas kepada aplikasi web moden. Dalam Laravel, Pasport menyediakan pelaksanaan pelayan OAuth2 penuh, mendayakan pengesahan API dengan lancar. Panduan ini membimbing anda melalui keseluruhan proses menyediakan Pasport Laravel, daripada pemasangan kepada memastikan dan menguji API anda.

Pengenalan

Mengapa Menggunakan Pasport Laravel?

Laravel Passport memudahkan kerumitan pengesahan OAuth2 dengan mengintegrasikannya rapat dengan ekosistem Laravel. Dengan Pasport, anda boleh:

• Sahkan pengguna API dengan selamat.
• Jana token akses peribadi untuk pelanggan mudah alih dan web.
• Urus tamat tempoh dan pembatalan token dengan mudah.

Prasyarat

Sebelum menyelam, pastikan anda mempunyai:

1. Pemahaman asas tentang Laravel.
2. Projek Laravel (v10.x atau lebih baru disyorkan) dipasang dan dikonfigurasikan dengan pangkalan data.
3. PHP 8.0 atau lebih baru dipasang.

Jika anda tidak menyediakan projek, buat projek dengan:

composer create-project --prefer-dist laravel/laravel passport-auth
cd passport-auth

Langkah 1: Pasang Pasport Laravel

Pasang Pakej

Jalankan arahan berikut untuk menambah Pasport pada projek anda:

composer require laravel/passport

Terbitkan dan Pindahkan Fail Pasport

Terbitkan fail migrasi dan konfigurasi Pasport:

php artisan vendor:publish --tag=passport-migrations
php artisan migrate

Langkah 2: Konfigurasi Pasport Laravel

Pasang Kunci Penyulitan dan Pelanggan

Jalankan arahan pemasangan:

php artisan passport:install

Ini menjana kunci penyulitan dan mencipta klien OAuth dalam pangkalan data anda. Perhatikan output, terutamanya ID pelanggan dan rahsia.

Pilihan: Buat Klien Akses Peribadi

Untuk mencipta klien akses peribadi secara eksplisit, jalankan:

php artisan passport:client --personal

Langkah 3: Kemas kini Model

Tambahkan ciri HasApiTokens pada model pengguna anda:

use Laravel\Passport\HasApiTokens;

class User extends Authenticatable
{
    use HasApiTokens, Notifiable;

    // Other properties...
}

Langkah 4: Kemas kini Konfigurasi Pengesahan

Konfigurasikan Pasport sebagai pemandu untuk pengawal API dalam config/auth.php:

'guards' => [
    'api' => [
        'driver' => 'passport',
        'provider' => 'users',
    ],
],

Langkah 5: Daftar Laluan Pasport

Dalam AppProvidersAppServiceProvider, muatkan laluan Pasport:

use Laravel\Passport\Passport;

public function boot(): void
{
    Passport::routes();
    Passport::tokensExpireIn(now()->addDays(15));
    Passport::refreshTokensExpireIn(now()->addDays(30));
    Passport::personalAccessTokensExpireIn(now()->addMonths(6));
}

Langkah 6: Bina Titik Akhir API Pengesahan

Tambah Laluan

Tentukan laluan API dalam route/api.php:

use App\Http\Controllers\AuthController;

Route::post('/register', [AuthController::class, 'register']);
Route::post('/login', [AuthController::class, 'login']);
Route::middleware('auth:api')->get('/user', [AuthController::class, 'user']);

Buat Pengawal Pengesahan

Laksanakan kaedah pengesahan:

composer create-project --prefer-dist laravel/laravel passport-auth
cd passport-auth

Langkah 7: Tetapkan Kebenaran untuk Kunci Penyulitan

Pastikan akses selamat kepada kunci Pasport:

composer require laravel/passport

Sahkan kebenaran:

php artisan vendor:publish --tag=passport-migrations
php artisan migrate

Keluaran yang dijangkakan:

php artisan passport:install

Langkah 8: Uji API

Gunakan Posmen atau mana-mana klien API untuk menguji titik akhir:

1. Daftar: Hantar permintaan POST ke /daftar dengan nama, e-mel dan kata laluan.
2. Log Masuk: Hantar permintaan POST ke /log masuk dengan e-mel dan kata laluan.
3. Dapatkan Data Pengguna: Hantar permintaan GET kepada /pengguna dengan token dalam pengepala Kebenaran.

Amalan Terbaik

• Gunakan HTTPS dalam pengeluaran.
• Putar kunci penyulitan secara berkala.
• Sahkan input dengan teliti.
• Hadkan skop token untuk keselamatan yang lebih baik.

Kesimpulan

Tahniah! Anda telah berjaya melaksanakan pengesahan API menggunakan Pasport Laravel. Persediaan ini menyediakan asas yang kukuh untuk memastikan API anda. Terokai ciri Pasport lanjutan seperti skop, pembatalan token dan kelayakan pelanggan untuk meningkatkan lagi keselamatan aplikasi anda.

Atas ialah kandungan terperinci Pengesahan Laravel Menggunakan Pasport. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!