eloquage / laravel-cache-swoole-table

v0.1.1 2026-11-03 07:51 UTC

Requires

• php: ^8.3|^8.4|^8.5
• ext-swoole: *
• illuminate/contracts: ^11.0|^12.0|^13.0
• illuminate/support: ^11.0|^12.0|^13.0

Requires (Dev)

• orchestra/testbench: ^10.0|^11.0|^12.0
• pestphp/pest: ^4.0
• pestphp/pest-plugin-laravel: ^4.0

MIT

Published on Packagist.org on 2026-11-03 08:14 UTC

README

A Laravel cache driver backed by Swoole\Table. It is intended for persistent Swoole or Octane workers that need a fast, process-shared in-memory cache.

Requires PHP 8.3+ (8.3, 8.4, or 8.5), Laravel 11, 12, or 13, and the Swoole PHP extension.

Install

composer require eloquage/laravel-cache-swoole-table

Add a store to config/cache.php:

'stores' => [
    'swoole-table' => [
        'driver' => 'swoole-table',
        'table_size' => 1024, // Maximum number of cache entries
        'value_size' => 65536, // Maximum serialized value size in bytes
    ],
],

Use it like another Laravel cache store:

use Illuminate\Support\Facades\Cache;

$cache = Cache::store('swoole-table');
$cache->put('visits', 1, 60);
$cache->increment('visits');

$count = $cache->get('visits'); // 2

You can make it the default store with CACHE_STORE=swoole-table.

Notes

• Entries live in memory and are lost when the Swoole table is recreated. This is not a persistent or cross-host cache.
• table_size sets the row capacity. Choose enough rows for the number of keys the application will store.
• value_size must fit the serialized value. Swoole\Table::set() can fail when the table is full or a value exceeds its configured column width.
• TTL expiration is checked when a key is read.

Tests

composer install
composer test

The test environment must have the Swoole extension enabled.

License

MIT. See LICENSE.md.