▶

快取

設定

Laravel 為各種不同的快取系統提供一致的 API。快取設定檔位在 config/cache.php。您可以在此為應用程式指定使用哪一種快取系統， Laravel 支援各種常見的後端快取系統，像是 Memcached 和 Redis。

快取設定檔也包含多個其他選項，在檔案裡都有說明，所以請務必先閱讀過。 Laravel 預設使用檔案 快取系統，該系統會儲存序列化、快取物件在檔案系統中。在大型應用程式上，建議使用儲存在記憶體內的快取系統，像是 Memcached 或 APC 。你甚至可以以同一個快取系統設定多個快取設定。

在 Laravel 中使用 Redis 快取系統前，必須先使用 Composer 安裝 predis/predis 套件 (~1.0)。

快取用法

儲存項目到快取中

Cache::put('key', 'value', $minutes);

使用 Carbon 物件設定快取過期時間

$expiresAt = Carbon::now()->addMinutes(10);

Cache::put('key', 'value', $expiresAt);

若是項目不存在，則將其存入快取中

Cache::add('key', 'value', $minutes);

當項目確實被加入快取時，使用 add 方法將會回傳 true 否則會回傳 false。

確認項目是否存在

if (Cache::has('key'))
{
	//
}

從快取中取得項目

$value = Cache::get('key');

取得項目或是回傳預設值

$value = Cache::get('key', 'default');

$value = Cache::get('key', function() { return 'default'; });

永久儲存項目到快取中

Cache::forever('key', 'value');

有時候您會希望從快取中取得項目，而當此項目不存在時會儲存一筆預設值，您可以使用 Cache::remember 方法：

$value = Cache::remember('users', $minutes, function()
{
	return DB::table('users')->get();
});

您也可以結合 remember 和 forever 方法：

$value = Cache::rememberForever('users', function()
{
	return DB::table('users')->get();
});

請注意所有儲存在快取中的項目皆會被序列化，所以您可以任意儲存各種型別的資料。

從快取拉出項目

如果您需要從快取中取得項目後將它刪除，您可以使用 pull 方法：

$value = Cache::pull('key');

從快取中刪除項目

Cache::forget('key');

獲取特定快取儲存庫

當使用多種快取儲存庫時，你可以藉由 store 方法獲取它們：

$value = Cache::store('foo')->get('key');

遞增與遞減

除了 資料庫 以外的快取系統都支援 遞增 和 遞減 操作：

遞增值

Cache::increment('key');

Cache::increment('key', $amount);

遞減值

Cache::decrement('key');

Cache::decrement('key', $amount);

快取標籤

注意： 檔案或資料庫這類快取系統均不支援快取標籤。此外，使用帶有「forever」的快取標籤時，挑選 memcached 這類快取系統將獲得最好的效能，它會自動清除過期的紀錄。

存取快取標籤

快取標籤允許您標記快取內的相關項目，然後使用特定名稱更新所有快取標籤。要存取快取標籤可以使用 tags 方法。

您可以儲存快取標籤，藉由將有序列表當作參數傳入，或者作為標籤名稱的有序陣列：

Cache::tags('people', 'authors')->put('John', $john, $minutes);

Cache::tags(['people', 'artists'])->put('Anne', $anne, $minutes);

您可以結合使用各種快取儲存方法與標籤，包含 remember, forever, 和 rememberForever 。您也可以從已標記的快取中存取項目，以及使用其他快取方法像是 increment 和 decrement 。

從已標記的快取中存取項目

要存取已標記的快取，可傳入相同的有序標籤列表。

$anne = Cache::tags('people', 'artists')->get('Anne');

$john = Cache::tags(['people', 'authors'])->get('John');

您可以更新所有已標記的項目，使用指定名稱或名稱列表。例如，以下範例將會移除帶有 people 或 authors 或者兩者皆有的所有快取標籤，所以「Anne」和「John」皆會從快取中被移除：

Cache::tags('people', 'authors')->flush();

對照來看，以下範例將只會移除帶有 authors 的標籤，所以「John」會被移除，但是「Anne」不會。

Cache::tags('authors')->flush();

快取事件

想要對每個快取操作執行程式碼的話，你可以監聽快取觸發的事件：

Event::listen('cache.hit', function($key, $value) {
	//
});

Event::listen('cache.missed', function($key) {
	//
});

Event::listen('cache.write', function($key, $value, $minutes) {
	//
});

Event::listen('cache.delete', function($key) {
	//
});

資料庫快取

當使用資料庫快取系統時，您必須設定一張資料表來儲存快取項目。資料表的 Schema 宣告範例如下：

Schema::create('cache', function($table)
{
	$table->string('key')->unique();
	$table->text('value');
	$table->integer('expiration');
});

Memcached 快取

Using the Memcached cache requires the Memcached PECL package to be installed.

The default configuration uses TCP/IP based on Memcached::addServer:

'memcached' => array(
	array('host' => '127.0.0.1', 'port' => 11211, 'weight' => 100),
),

You may also set the host option to a UNIX socket path. If you do this, the port option should be set to 0:

'memcached' => array(
	array('host' => '/var/run/memcached/memcached.sock', 'port' => 0, 'weight' => 100),
),

Redis 快取

See Redis Configuration