速率限制
簡介
Laravel 包含一個簡單易用的速率限制抽象層，結合您應用程式的 快取，提供一個簡單的方法來限制在指定時間範圍內的任何操作。
如果您對限制傳入的 HTTP 請求感興趣，請查閱速率限制器中介層文件。
快取設定
通常，速率限制器使用您的預設應用程式快取，如應用程式的 cache 設定檔中的 default 鍵所定義。但是，您可以透過在應用程式的 cache 設定檔中定義 limiter 鍵來指定速率限制器應使用的快取驅動程式
1'default' => env('CACHE_STORE', 'database'),2 3'limiter' => 'redis',基本用法
可以使用 Illuminate\Support\Facades\RateLimiter facade 與速率限制器互動。速率限制器提供的最簡單方法是 attempt 方法，它在給定的秒數內限制給定回呼的速率。
當回呼沒有剩餘的嘗試次數時，attempt 方法返回 false；否則，attempt 方法將返回回呼的結果或 true。attempt 方法接受的第一個引數是速率限制器「鍵」，它可以是您選擇的任何字串，代表正在速率限制的操作
1use Illuminate\Support\Facades\RateLimiter; 2 3$executed = RateLimiter::attempt( 4 'send-message:'.$user->id, 5 $perMinute = 5, 6 function() { 7 // Send message... 8 } 9);10 11if (! $executed) {12 return 'Too many messages sent!';13}如有必要，您可以為 attempt 方法提供第四個引數，即「衰減率」，或可用嘗試次數重置之前的秒數。例如，我們可以修改上面的範例，允許每兩分鐘進行五次嘗試
1$executed = RateLimiter::attempt(2 'send-message:'.$user->id,3 $perTwoMinutes = 5,4 function() {5 // Send message...6 },7 $decayRate = 120,8);手動增加嘗試次數
如果您想手動與速率限制器互動，可以使用各種其他方法。例如，您可以調用 tooManyAttempts 方法來確定給定的速率限制器鍵是否已超過每分鐘允許的最大嘗試次數
1use Illuminate\Support\Facades\RateLimiter;2 3if (RateLimiter::tooManyAttempts('send-message:'.$user->id, $perMinute = 5)) {4 return 'Too many attempts!';5}6 7RateLimiter::increment('send-message:'.$user->id);8 9// Send message...或者，您可以使用 remaining 方法檢索給定鍵的剩餘嘗試次數。如果給定鍵還有剩餘重試次數，您可以調用 increment 方法來增加總嘗試次數
1use Illuminate\Support\Facades\RateLimiter;2 3if (RateLimiter::remaining('send-message:'.$user->id, $perMinute = 5)) {4 RateLimiter::increment('send-message:'.$user->id);5 6 // Send message...7}如果您想將給定速率限制器鍵的值增加超過一個，您可以將所需的數量提供給 increment 方法
1RateLimiter::increment('send-message:'.$user->id, amount: 5);判斷限制器可用性
當一個鍵沒有更多嘗試次數時，availableIn 方法會返回在更多嘗試次數可用之前剩餘的秒數
1use Illuminate\Support\Facades\RateLimiter; 2 3if (RateLimiter::tooManyAttempts('send-message:'.$user->id, $perMinute = 5)) { 4 $seconds = RateLimiter::availableIn('send-message:'.$user->id); 5 6 return 'You may try again in '.$seconds.' seconds.'; 7} 8 9RateLimiter::increment('send-message:'.$user->id);10 11// Send message...清除嘗試次數
您可以使用 clear 方法重置給定速率限制器鍵的嘗試次數。例如，您可以在接收者讀取給定訊息時重置嘗試次數
1use App\Models\Message; 2use Illuminate\Support\Facades\RateLimiter; 3 4/** 5 * Mark the message as read. 6 */ 7public function read(Message $message): Message 8{ 9 $message->markAsRead();10 11 RateLimiter::clear('send-message:'.$message->user_id);12 13 return $message;14}