README

Pendahuluan

Package ini menyediakan helper caching untuk model Laravel dengan fallback ke file jika Redis tidak tersedia. Package ini membantu meningkatkan performa aplikasi dengan mengurangi query langsung ke database.

Instalasi

Tambahkan package ini ke proyek Laravel Anda dengan menjalankan perintah berikut:

composer require v-pack/laravel-cache

Konfigurasi

Pastikan Redis sudah dikonfigurasi di .env:

CACHE_DRIVER=redis
REDIS_HOST=127.0.0.1
REDIS_PASSWORD=null
REDIS_PORT=6379

Jika Redis tidak tersedia, package ini akan otomatis menggunakan cache berbasis file.

Penggunaan

1. Menggunakan Cache di Model Laravel

Tambahkan CacheHelper ke dalam model Anda:

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use VPACK\LaravelCache\CacheHelper;

class UserModel extends Model
{
    protected $table = 'm_user';

    public function getById($id)
    {
        $cacheKey = "user:{$id}";
        
        if ($cached = CacheHelper::getCache($cacheKey)) {
            return $cached;
        }

        $user = $this->find($id);

        if ($user) {
            CacheHelper::putCache($cacheKey, $user->toArray());
        }
        
        return $user;
    }

    public function getAll(array $filter, int $page = 1, int $itemPerPage = 0, string $sort = '')
    {
        $cacheKey = "users:all:" . md5(json_encode($filter) . $page . $itemPerPage . $sort);
        
        if ($cached = CacheHelper::getCache($cacheKey)) {
            return $cached;
        }

        $skip = ($page * $itemPerPage) - $itemPerPage;
        $user = $this->query();

        if (!empty($filter['name'])) {
            $user->where('name', 'LIKE', '%'.$filter['name'].'%');
        }

        if (!empty($filter['email'])) {
            $user->where('email', 'LIKE', '%'.$filter['email'].'%');
        }

        $total = $user->count();
        $list = $user->skip($skip)->take($itemPerPage)->get();
        
        $data = [
            'total' => $total,
            'data' => $list,
        ];

        CacheHelper::putCache($cacheKey, $data);

        return $data;
    }

    public function store(array $payload)
    {
        $user = $this->create($payload);
        CacheHelper::clearCache(); // Bersihkan cache agar data tetap sinkron
        return $user;
    }

    public function edit(array $payload, string $id)
    {
        $updated = $this->find($id)->update($payload);
        if ($updated) {
            CacheHelper::clearCache(); // Cache diperbarui saat data diubah
        }
        return $updated;
    }

    public function drop(string $id)
    {
        $deleted = $this->find($id)->delete();
        if ($deleted) {
            CacheHelper::clearCache(); // Cache diperbarui saat data dihapus
        }
        return $deleted;
    }
}

Lisensi

Package ini dirilis di bawah lisensi MIT.