flightphp/cache

Viegls, vienkāršs un patstāvīgs PHP failu kešatmiņas klase, kas atdalīta no Wruczek/PHP-File-Cache

Priekšrocības

• Viegls, patstāvīgs un vienkāršs
• Viss kods vienā failā - nav lieku draiveru
• Drošs - katram ģenerētajam kešatmiņas failam ir PHP galvene ar die, padarot tiešu piekļuvi neiespējamu pat tad, ja kāds zina ceļu un jūsu serveris nav pareizi konfigurēts
• Labi dokumentēts un testēts
• Pareizi apstrādā vienlaicīgumu, izmantojot flock
• Atbalsta PHP 7.4+
• Bezmaksas saskaņā ar MIT licenci

Šī dokumentācijas vietne izmanto šo bibliotēku, lai kešotu katru lapu!

Noklikšķiniet šeit, lai skatītu kodu.

Instalējiet, izmantojot composer:

composer require flightphp/cache

Izmantošana ir diezgan vienkārša. Tas saglabā kešatmiņas failu kešatmiņas direktorijā.

use flight\Cache;

$app = Flight::app();

// Jūs nododat direktoriju, kurā tiks saglabāta kešatmiņa, konstruktorā
$app->register('cache', Cache::class, [ __DIR__ . '/../cache/' ], function(Cache $cache) {

    // Tas nodrošina, ka kešatmiņa tiek izmantota tikai ražošanas režīmā
    // ENVIRONMENT ir konstante, kas tiek iestatīta jūsu bootstrap failā vai citur jūsu lietotnē
    $cache->setDevMode(ENVIRONMENT === 'development');
});

Iegūt kešatmiņas vērtību

Jūs izmantojat metodi get(), lai iegūtu kešotu vērtību. Ja vēlaties ērtu metodi, kas atsvaidzinās kešatmiņu, ja tā ir beigusies, varat izmantot refreshIfExpired().

// Iegūt kešatmiņas instanci
$cache = Flight::cache();
$data = $cache->refreshIfExpired('simple-cache-test', function () {
    return date("H:i:s"); // atgriezt datus, kas jākešo
}, 10); // 10 sekundes

// vai
$data = $cache->get('simple-cache-test');
if(empty($data)) {
    $data = date("H:i:s");
    $cache->set('simple-cache-test', $data, 10); // 10 sekundes
}

Saglabāt kešatmiņas vērtību

Jūs izmantojat metodi set(), lai saglabātu vērtību kešatmiņā.

Flight::cache()->set('simple-cache-test', 'my cached data', 10); // 10 sekundes

Dzēst kešatmiņas vērtību

Jūs izmantojat metodi delete(), lai dzēstu vērtību kešatmiņā.

Flight::cache()->delete('simple-cache-test');

Pārbaudīt, vai kešatmiņas vērtība pastāv

Jūs izmantojat metodi exists(), lai pārbaudītu, vai vērtība pastāv kešatmiņā.

if(Flight::cache()->exists('simple-cache-test')) {
    // darīt kaut ko
}

Notīrīt kešatmiņu

Jūs izmantojat metodi flush(), lai notīrītu visu kešatmiņu.

Flight::cache()->flush();

Iegūt metadatus ar kešatmiņu

Ja vēlaties iegūt laika zīmogus un citus metadatus par kešatmiņas ierakstu, pārliecinieties, ka nododat true kā pareizo parametru.

$data = $cache->refreshIfExpired("simple-cache-meta-test", function () {
    echo "Refreshing data!" . PHP_EOL;
    return date("H:i:s"); // atgriezt datus, kas jākešo
}, 10, true); // true = atgriezt ar metadatiem
// vai
$data = $cache->get("simple-cache-meta-test", true); // true = atgriezt ar metadatiem

/*
Kehšatmiņas vienuma piemērs, kas iegūts ar metadatiem:
{
    "time":1511667506, <-- saglabāt unix laika zīmogu
    "expire":10,       <-- derīguma laiks sekundēs
    "data":"04:38:26", <-- deserializēti dati
    "permanent":false
}

Izmantojot metadatus, mēs varam, piemēram, aprēķināt, kad vienums tika saglabāts vai kad tas beidzas
Mēs varam arī piekļūt pašiem datiem, izmantojot atslēgu "data"
*/

$expiresin = ($data["time"] + $data["expire"]) - time(); // iegūt unix laika zīmogu, kad dati beidzas, un atņemt no tā pašreizējo laika zīmogu
$cacheddate = $data["data"]; // mēs piekļūstam pašiem datiem, izmantojot atslēgu "data"

echo "Latest cache save: $cacheddate, expires in $expiresin seconds";

Apmeklējiet https://github.com/flightphp/cache, lai skatītu kodu.