<?php
  namespace App\Http\Middleware;
  use Illuminate\Support\Facades\Auth;
  class AuthenticateOnceWithBasicAuth{   
       /**
     * 处理传入的请求
     *
     * @param  \Illuminate\Http\Request  $request
     * @param  \Closure  $next
     * @return mixed
     */  
  public function handle($request, $next)  
    {       
       return Auth::onceBasic() ?: $next($request);  
     }
   }

🎜{note} Dalam contoh ini, e-mel bukanlah pilihan yang diperlukan, ia adalah untuk tujuan demonstrasi sahaja . Anda harus menggunakan nama lajur yang sepadan dengan "nama pengguna" dalam pangkalan data anda. 🎜🎜🎜🎜

Akses instance pengawal yang ditentukan

Anda boleh menggunakan kaedah guard fasad Auth untuk menentukan tika guard yang anda mahu gunakan. Ini membolehkan anda menggunakan model atau jadual pengguna yang boleh disahkan sepenuhnya bebas untuk mengurus pengesahan untuk pelbagai bahagian aplikasi anda. Auth facade 的 guard 方法指定想要使用的看守器实例。这允许你使用完全独立的可验证模型或用户表来管理应用程序各个部分的验证。

传递给 guard 方法的看守器名称需要与 auth.php 配置中的配置项之一相匹配：

Route::get('api/user', function () {  
  // 只有认证过的用户可以进入...
})->middleware('auth.basic.once');

登出

用户登出需要使用 Auth facade 的 logout 方法。它会清除用户会话（session）中的用户验证信息：

use Illuminate\Support\Facades\Auth;Auth::logout();

记住用户

如果想在应用中提供 「记住我」功能，可以给 attempt 方法传递一个布尔值作为其第二个参数，这会无限期保持用户身份验证，直到用户手动登出。用户表需要包含字符串类型的 remember_token 列用于存储令牌。

'web' => [   
    // ...
    \Illuminate\Session\Middleware\AuthenticateSession::class,  
    // ...
  ],

{tip} 如果使用了 Laravel 内置的 LoginController，「记住」用户的正确逻辑已经由控制器所用的 traits 实现。

如果启用了「记住用户」，可以使用 viaRemember 方法判断是否使用了「记住我」cookie 对用户做身份验证：

use Illuminate\Support\Facades\Auth;
Auth::logoutOtherDevices($password);

其它身份验证方法

验证用户实例

如果要将已经存在的用户登入应用，可以调用 login 方法，并以用户实例作为其参数 。该对象必须实现 IlluminateContractsAuthAuthenticatable 契约 。Laravel 自带的 AppUser 模型已经实现了这个接口：

<?php
  namespace App\Providers;
  use App\Services\Auth\JwtGuard;
  use Illuminate\Support\Facades\Auth;
  use Illuminate\Foundation\Support\Providers\AuthServiceProvider as ServiceProvider;
  class AuthServiceProvider extends ServiceProvider{   
      /**
     * 注册任意应用认证／授权服务。
     *
     * @return void
     */   
  public function boot()  
   {      
     $this->registerPolicies();        
     Auth::extend('jwt', function ($app, $name, array $config) {         
       // 返回一个 Illuminate\Contracts\Auth\Guard 实例...           
        return new JwtGuard(Auth::createUserProvider($config['provider']));     
         });   
    }}

使用如下方式指定想要的看守器实例：

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

通过 ID 验证用户身份

可以使用 loginUsingId 方法通过 ID 将用户登录到应用。这个方法接受希望验证身份用户的主键：

use App\User;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Auth;
  /**
 * 注册任意应用认证／授权服务。
 *
 * @return void
 */
 public function boot(){  
   $this->registerPolicies();  
    Auth::viaRequest('custom-token', function ($request) {     
       return User::where('token', $request->token)->first();  
       });
     }

仅验证一次用户身份

可以使用 once

Nama pengawal yang dihantar kepada kaedah guard perlu sepadan dengan salah satu item konfigurasi dalam konfigurasi auth.php:

'guards' => [   
 'api' => [      
   'driver' => 'custom-token',  
   ],
 ],

Log Keluar

Pengguna perlu menggunakan kaedah logout fasad Auth untuk log keluar. Ia mengosongkan maklumat pengesahan pengguna dalam sesi pengguna:

<?php
    namespace App\Providers;
    use Illuminate\Support\Facades\Auth;
    use App\Extensions\RiakUserProvider;
    use Illuminate\Foundation\Support\Providers\AuthServiceProvider as ServiceProvider;
    class AuthServiceProvider extends ServiceProvider{   
        /**
     * 注册任意应用身份验证 / 授权服务Register any application authentication / authorization services.
     *
     * @return void
     */   
      public function boot()   
       {      
         $this->registerPolicies();       
         Auth::provider('riak', function ($app, array $config) {         
            // 返回 Illuminate\Contracts\Auth\UserProvider 实例...            
            return new RiakUserProvider($app->make('riak.connection'));       
           });   
        }}

🎜🎜🎜

🎜

Ingat Pengguna

🎜Jika anda ingin menyediakan fungsi "ingat saya" dalam aplikasi anda, anda boleh menghantar nilai boolean kepada kaedah percubaan sebagai parameter kedua, yang akan memastikan pengguna disahkan selama-lamanya sehingga pengguna log keluar secara manual. Jadual pengguna perlu mengandungi lajur remember_token jenis rentetan untuk menyimpan token. 🎜

'providers' => [  
  'users' => [      
    'driver' => 'riak',  
      ],
  ],

🎜{tip} Jika anda menggunakan LoginController terbina dalam Laravel, logik yang betul untuk "mengingat" pengguna sudah dilaksanakan oleh ciri yang digunakan oleh pengawal. 🎜

🎜Jika "Remember User" didayakan, anda boleh menggunakan kaedah viaRemember untuk menentukan sama ada kuki "Remember Me" digunakan untuk mengesahkan pengguna: 🎜

'guards' => [   
    'web' => [     
       'driver' => 'session',        
       'provider' => 'users',    
     ],
  ],

🎜🎜🎜

🎜

Kaedah pengesahan lain

🎜🎜Sahkan contoh pengguna🎜🎜Jika anda ingin log masuk pengguna sedia ada ke aplikasi, anda boleh memanggil kaedah log masuk dan menggunakan contoh pengguna sebagai parameternya. Objek mesti melaksanakan kontrak IlluminateContractsAuthAuthenticatable . Model AppUser Laravel sendiri telah melaksanakan antara muka ini: 🎜

<?php
    namespace Illuminate\Contracts\Auth;
    interface UserProvider {  
      public function retrieveById($identifier);    
      public function retrieveByToken($identifier, $token);    
      public function updateRememberToken(Authenticatable $user, $token);    
      public function retrieveByCredentials(array $credentials);    
      public function validateCredentials(Authenticatable $user, array $credentials);
     }

🎜Nyatakan contoh pengawal yang diingini seperti berikut: 🎜

<?php
   namespace Illuminate\Contracts\Auth;
   interface Authenticatable {   
      public function getAuthIdentifierName();    
      public function getAuthIdentifier();    
      public function getAuthPassword();    
      public function getRememberToken();    
      public function setRememberToken($value);    
      public function getRememberTokenName();
     }

🎜🎜Sahkan identiti pengguna dengan ID🎜🎜Anda boleh menggunakan kaedah loginUsingId untuk log masuk pengguna ke aplikasi melalui ID. Kaedah ini menerima kunci utama pengguna yang ingin anda sahkan: 🎜

/**
 * 应用的事件监听器映射。
 *
 * @var array
 */
 protected $listen = [   
    'Illuminate\Auth\Events\Registered' => [     
       'App\Listeners\LogRegisteredUser',  
       ],  
     'Illuminate\Auth\Events\Attempting' => [     
        'App\Listeners\LogAuthenticationAttempt', 
         ],  
      'Illuminate\Auth\Events\Authenticated' => [    
         'App\Listeners\LogAuthenticated',   
        ],  
      'Illuminate\Auth\Events\Login' => [     
         'App\Listeners\LogSuccessfulLogin',   
        ],  
      'Illuminate\Auth\Events\Failed' => [     
         'App\Listeners\LogFailedLogin',   
        ], 
      'Illuminate\Auth\Events\Logout' => [      
           'App\Listeners\LogSuccessfulLogout',  
           ],   
       'Illuminate\Auth\Events\Lockout' => [     
         'App\Listeners\LogLockout',   
         ],  
       'Illuminate\Auth\Events\PasswordReset' => [     
         'App\Listeners\LogPasswordReset',   
         ],
      ];

🎜🎜Hanya sahkan pengguna sekali sahaja🎜🎜Anda boleh menggunakan sekali kaedah dalam satu laluan Log pengguna ke dalam aplikasi semasa permintaan. Melakukan ini tidak akan menggunakan sesi atau kuki, yang bermaksud kaedah ini membantu membina API tanpa kewarganegaraan: 🎜rrreee🎜🎜🎜🎜🎜🎜

Pengesahan Asas HTTP

Pengesahan Asas HTTP menyediakan cara cepat untuk mengesahkan pengguna dalam aplikasi anda tanpa menyediakan halaman "log masuk" khusus. Sebelum anda mula, lampirkan perisian tengah auth.basic pada laluan anda. Perisian tengah auth.basic sudah disertakan dalam rangka kerja Laravel, jadi anda tidak perlu mentakrifkannya: auth.basic 中间件 附加到你的路由中。auth.basic 中间件已包含在 Laravel 框架中，所以你不需要定义它：

rrreee

将中间件附加到路由后，在浏览器中访问此路由时将自动提示您输入凭据。默认的，auth.basic 中间件把用户记录上的 email 字段 作为「用户名」。

FastCGI 的注意事项

如果你正使用 PHP FastCGI 模式，HTTP 基础认证可能无法正常工作。需要把下面几行添加到你的 .htaccess 文件中：

rrreee

无状态 HTTP 基础认证

你也可以使用 HTTP 基础身份验证，而无需在会话中设置用户标识符 cookie，这对 API 的身份验证特别有用。为此 ，请定义一个中间件 它将调用 onceBasic 方法。如果 onceBasic 方法没有返回任何响应，那么请求就可以进一步传递到应用程序中：

rrreee

接着， 注册路由中间件 并将它附加到路由：

rrreee

退出

要手动把用户从应用中退出登录，你可以使用 Auth facade 上的 logout 方法。这将清除用户会话中的身份认证信息：

rrreee

让其它设备上的 Session 失效

Laravel 还提供了一种机制，用于将其它设备上的用户 Session 失效和「注销」，而不会使其当前设备上的 Session 失效。首先，你需要保证 IlluminateSessionMiddlewareAuthenticateSession 中间件在你的 app/Http/Kernel.php 类中的 web 中间件组中，并且没有被注释掉：

rrreee

然后， 你就可以使用 Auth facade 上的 logoutOtherDevices 方法。此方法要求用户提供其当前密码，你的应用程序应通过输入表单接受该密码：

rrreee

{note} 当调用 logoutOtherDevicesrrreee

Selepas melampirkan perisian tengah pada laluan, anda akan digesa secara automatik untuk input apabila mengakses laluan ini dalam Kredensial penyemak imbas. Secara lalai, perisian tengah auth.basic menggunakan medan e-mel pada rekod pengguna sebagai "nama pengguna".

Nota FastCGI

Jika anda menggunakan mod FastCGI PHP, pengesahan asas HTTP mungkin tidak berfungsi dengan betul. Anda perlu menambah baris berikut pada fail .htaccess anda: rrreee

🎜

Pengesahan Asas HTTP Tanpa Status

🎜Anda juga boleh menggunakan Pengesahan Asas HTTP tanpa menetapkan kuki pengecam pengguna dalam sesi, yang amat berguna untuk pengesahan API. Untuk melakukan ini, tentukan perisian tengah yang memanggil kaedah onceBasic. Jika kaedah onceBasic tidak mengembalikan sebarang respons, permintaan boleh dihantar lebih jauh ke dalam aplikasi: 🎜rrreee🎜 Seterusnya, daftarkan perisian tengah penghalaan dan lampirkannya pada laluan: 🎜rrreee🎜🎜🎜

🎜🎜Logout🎜🎜Untuk log keluar pengguna secara manual daripada aplikasi, anda boleh menggunakan Auth fasad Kaedah logout. Ini akan mengosongkan maklumat pengesahan dalam sesi pengguna: 🎜rrreee🎜🎜🎜

🎜

Batalkan Sesi pada peranti lain

🎜Laravel juga menyediakan mekanisme untuk membatalkan dan "log keluar" pengguna Sesi pada peranti lain tanpa membatalkan Sesi pada peranti semasa. Mula-mula, anda perlu memastikan bahawa IlluminateSessionMiddlewareAuthenticateSession middleware berada dalam kumpulan middleware web dalam kelas app/Http/Kernel.php anda, dan di sana is no Commented out: 🎜rrreee🎜 Kemudian, anda boleh menggunakan kaedah logoutOtherDevices pada fasad Auth. Kaedah ini memerlukan pengguna untuk memberikan kata laluan semasa mereka, yang aplikasi anda harus terima melalui borang input: 🎜rrreee

🎜{note} Apabila kaedah logoutOtherDevices dipanggil, Sesi lain pengguna akan dilumpuhkan sepenuhnya , yang bermaksud mereka akan "keluar" mana-mana pemerhati yang mereka telah disahkan sebelum ini. 🎜🎜🎜🎜🎜🎜🎜🎜

Tambah pemerhati tersuai

Anda boleh menentukan pemerhati pengesahan anda sendiri menggunakan kaedah lanjutkan fasad Auth. Anda harus memanggil kaedah lanjutkan dalam pembekal perkhidmatan. Memandangkan Laravel sudah disertakan dengan AuthServiceProvider, kami boleh meletakkan kod dalam pembekal tersebut: Auth facade 的 extend 方法来定义自己的身份验证看守器。你应该在 服务提供器 中调用  extend 方法。由于 Laravel 已经附带了 AuthServiceProvider，我们可以将代码放在该提供器中：

rrreee

正如你在上面的示例中所看到的，传递给 extend 方法的回调应该返回一个实现 IlluminateContractsAuthGuard 接口的实例。这个接口包含了一些你需要在自定义的看守器中实现的方法。当你的自定义看守器定义完成之后，你可以在 auth.php 配置文件的 guards 配置中使用这个看守器：

rrreee

请求闭包看守器

实现基于 HTTP 请求的自定义身份验证系统的最简单方法，是使用 Auth::viaRequest 方法。此方法允许您使用单个闭包来快速定义身份验证过程。

首先，在 AuthServiceProvider 的 boot 方法中调用 Auth::viaRequest 方法。viaRequest 方法接受一个看守器名称作为其第一个参数。此名称可以是描述你自定义看守器的任何字符串。传递给该方法的第二个参数应该是一个闭包函数，它接收传入的 HTTP 请求并返回一个用户实例，或者，如果验证失败，则为 null：

rrreee

当你完成了自定义看守器后，就可以在 auth.php 配置文件的 guards 配置中使用这个看守器：

rrreee

添加自定义用户提供器

如果不使用传统的关系数据库存储用户，就需要使用自己的身份验证用户提供器扩展 Lavarel。可以使用 Auth facade 的 provider 方法自定义用户提供器：

rrreee

一旦使用 provider 方法注册完毕，就可以在 auth.php 配置文件中切换到新的用户提供器。先定义一个使用新驱动的 provider ：

rrreee

随后就可以在 guardsrrreee

Seperti yang anda lihat dalam contoh di atas, hantar ke lanjutkan Panggilan balik kaedah harus kembali contoh yang melaksanakan antara muka IlluminateContractsAuthGuard. Antara muka ini mengandungi beberapa kaedah yang anda perlu laksanakan dalam pemerhati tersuai anda. Selepas pengawal tersuai anda ditakrifkan, anda boleh menggunakan pengawal ini dalam konfigurasi guards bagi fail konfigurasi auth.php:

rrreee

Minta pengawal penutupan

Cara terbaik untuk melaksanakan sistem pengesahan tersuai berdasarkan permintaan HTTP Cara mudah ialah dengan gunakan kaedah Auth::viaRequest. Kaedah ini membolehkan anda mentakrifkan proses pengesahan dengan cepat menggunakan satu penutupan. 🎜🎜Mula-mula, panggil kaedah Auth::viaRequest dalam kaedah boot AuthServiceProvider. Kaedah viaRequest menerima nama pemerhati sebagai parameter pertamanya. Nama ini boleh menjadi sebarang rentetan yang menerangkan pemerhati tersuai anda. Parameter kedua yang dihantar kepada kaedah ini hendaklah fungsi penutupan yang menerima permintaan HTTP masuk dan mengembalikan contoh pengguna, atau null jika pengesahan gagal: 🎜rrreee🎜Apabila Setelah anda selesai menyesuaikan pengawal, anda boleh menggunakannya dalam konfigurasi guards bagi fail konfigurasi auth.php: 🎜rrreee🎜🎜🎜

🎜🎜Tambah pembekal pengguna tersuai🎜🎜Jika anda tidak menggunakan pangkalan data hubungan tradisional untuk menyimpan pengguna, anda perlu menggunakan sambungan pembekal pengguna Pengesahan identiti anda sendiri Lavarel. Pembekal pengguna boleh disesuaikan menggunakan kaedah pembekal fasad Auth: 🎜rrreee🎜Setelah mendaftar menggunakan kaedah provider, anda boleh menggunakan < code> auth.php fail konfigurasi untuk bertukar kepada pembekal pengguna baharu. Mula-mula tentukan pembekal yang menggunakan pemacu baharu: 🎜rrreee🎜 Kemudian anda boleh menggunakan penyedia ini dalam konfigurasi guards: 🎜rrreee🎜🎜🎜🎜🎜🎜

Kontrak Pembekal Pengguna

Pelaksanaan IlluminateContractsAuthUserProvider hanya bertanggungjawab untuk mengekstrak pelaksanaan IlluminateContractsAuthAuthenticatable daripada sistem storan berterusan seperti MySQL, Riak, dsb. Kedua-dua antara muka membenarkan mekanisme pengesahan Laravel untuk terus berfungsi tanpa mengira cara pengguna disimpan dan jenis kelas yang digunakan untuk mewakilinya: IlluminateContractsAuthUserProvider 实现仅负责从 MySQL、Riak 等持久化存储系统中提取 IlluminateContractsAuthAuthenticatable 实现。无论用户如何存储及用于表示它的类是什么类型，这两个接口都允许 Laravel 身份验证机制继续运行：

我们来看看 IlluminateContractsAuthUserProvider 契约：

rrreee

retrieveById 函数通常接受用于表示类的 key（如 MySQL 数据库中自动递增的 ID）作为参数，并获取和返回与这个 ID 匹配的 Authenticatable 实现。

retrieveByToken 函数通过用户的唯一 $identifier 和存储在 remember_token 列的 「记住我」 令牌获取用户。与前一方法相同，它返回 Authenticatable 实现。

updateRememberToken 方法用新  $token 更新  $user 的 remember_token 列。在「记住我」登录校验成功或者用户登出时分配「刷新令牌」。

在尝试登录到应用时，retrieveByCredentials 方法接受凭证数组传递给 Auth::attempt 方法。此方法在底层持久化存储中「查询」与这些凭证匹配的用户。通常，此方法运行一个基于 $credentials['username'] 的 「where」 条件，它应该返回一个 Authenticatable 实现。此方法不就尝试进行任何密码校验或身份验证。

validateCredentials 方法应该比较给定的 $user 与 $credentials 来验证用户身份。例如，此方法或许应该使用 Hash::check 来比较 $user->getAuthPassword() 的值与 $credentials['password'] 的值。它应该返回 true 或 false

Mari kita lihat kontrak IlluminateContractsAuthUserProvider:

rrreee Fungsi retrieveById biasanya menerima kunci yang digunakan untuk mewakili kelas (seperti ID auto-incrementing dalam pangkalan data MySQL) sebagai parameter dan mendapatkan serta mengembalikan pelaksanaan Authenticatable yang sepadan dengan ini ID.

Fungsi retrieveByToken mendapatkan semula pengguna melalui $identifier unik mereka dan token "ingat saya" yang disimpan dalam lajur token_ingat. Seperti kaedah sebelumnya, ia mengembalikan pelaksanaan Authenticatable.

Kaedah updateRememberToken mengemas kini lajur remember_token $user dengan $token baharu. "Token muat semula" diberikan apabila pengesahan log masuk "Ingat Saya" berjaya atau apabila pengguna log keluar. 🎜🎜Kaedah retrieveByCredentials menerima tatasusunan bukti kelayakan yang diserahkan kepada kaedah Auth::attempt apabila cuba log masuk ke aplikasi. Kaedah ini "mempertanyakan" stor kegigihan asas untuk pengguna yang sepadan dengan kelayakan ini. Biasanya, kaedah ini menjalankan syarat "di mana" berdasarkan $credentials['username'], yang sepatutnya mengembalikan pelaksanaan Authenticatable. Kaedah ini tidak mencuba sebarang pengesahan atau pengesahan kata laluan. Kaedah 🎜🎜validateCredentials harus membandingkan $user yang diberikan dengan $credentials untuk mengesahkan identiti pengguna. Sebagai contoh, kaedah ini mungkin harus menggunakan Hash::check untuk membandingkan nilai $user->getAuthPassword() dengan $credentials['password'] nilai. Ia harus mengembalikan true atau false untuk menunjukkan sama ada kata laluan pengguna adalah sah. 🎜🎜🎜🎜🎜🎜🎜

Kontrak Pengesahan

Kami telah membedah setiap kaedah UserProvider. Mari kita lihat kontrak Boleh Disahkan. Ingat bahawa kaedah retrieveById, retrieveByToken dan retrieveByCredentials pembekal pengguna akan mengembalikan contoh antara muka ini: UserProvider 的每个方法。下面再来看看 Authenticatable 契约。切记，用户提供器的 retrieveById、 retrieveByToken 和 retrieveByCredentials 方法将返回此接口的实例：

rrreee

这个接口很简单。 getAuthIdentifierName 方法应该返回用户 「主键」 列的名字， getAuthIdentifier 方法则返回用户 「主键」。在 MySQL 后台，它会是自增主键。 getAuthPassword 方法应该返回用户的哈希密码。此接口允许身份验证系统与任一 User 类一直工作，不管使用的是哪种 ORM 或抽象存储层。默认情况下，Laravel 的 app 目录会包含一个实现了此接口的 User 类，你可以以这个实现示例作为参考。

事件

在身份验证处理过程中 Laravel 引发了多种 事件 。 可以在  EventServiceProviderrrreee

Antara muka ini mudah. Kaedah getAuthIdentifierName harus mengembalikan nama lajur "kunci utama" pengguna dan kaedah getAuthIdentifier harus mengembalikan "kunci utama" pengguna. Dalam bahagian belakang MySQL, ia akan menjadi kunci utama peningkatan automatik. Kaedah getAuthPassword harus mengembalikan kata laluan cincang pengguna. Antara muka ini membolehkan sistem pengesahan sentiasa berfungsi dengan mana-mana kelas Pengguna, tidak kira ORM atau lapisan storan abstraksi yang digunakan. Secara lalai, direktori app Laravel akan mengandungi kelas User yang melaksanakan antara muka ini Anda boleh menggunakan contoh pelaksanaan ini sebagai rujukan.

Acara

🎜Laravel menimbulkan pelbagai acara semasa proses pengesahan. Pendengar untuk acara ini boleh dilampirkan dalam EventServiceProvider: 🎜rrreee🎜Artikel ini pertama kali diterbitkan di tapak web 🎜LearnKu.com🎜. 🎜🎜

pensijilan API →

serahkan

Laman web PHP Cina

RumahKursusArtikelSoal JawabKamusManualMuat turuncari APPMuat turun