2017 © Pedro Peláez
 

propel-behavior propel2-data-cache-behavior

A Propel ORM behavior that provide auto data caching for model and collections. Based on snakano/propel-data-cache-behavior

image

thefuriouscoder/propel2-data-cache-behavior

A Propel ORM behavior that provide auto data caching for model and collections. Based on snakano/propel-data-cache-behavior

  • Thursday, November 5, 2015
  • by thefuriouscoder
  • Repository
  • 1 Watchers
  • 4 Stars
  • 220 Installations
  • PHP
  • 1 Dependents
  • 0 Suggesters
  • 3 Forks
  • 1 Open issues
  • 1 Versions
  • 16 % Grown

The README.md

Data Cache Behavior for Propel2

Build Status Latest Stable Version Total Downloads, (*1)

A Propel ORM behavior that provide auto data caching to your model. Based on Propel 1.6 work of SNakano., (*2)

  • support caching system APC, memcached and Redis (via DoctrineCache)
  • auto caching and auto flush.

What's the difference with Query Cache Behavior

Query Cache Behavior is caching transformation of a query object (caching SQL code). This Behavior is caching the results of database. (caching result data), (*3)

Requirements

Install

Composer

Add a dependency on thefuriouscoder/propel2-data-cache-behavior to your project's composer.json file., (*4)

{
    "require": {
        "thefuriouscoder/propel2-data-cache-behavior": "dev-master"
    }
}

Configuration

schema.xml

<table name="book">
  <column name="id" required="true" primaryKey="true" autoIncrement="true" type="INTEGER" />
  <column name="title" type="VARCHAR" required="true" primaryString="true" />
  <behavior name="data_cache">
    <parameter name="backend" value="apc" />     <!-- cache system. "apc" or "memcache", default "apc". (optional) -->
    <parameter name="lifetime" value="3600" />   <!-- cache expire time (second). default 3600 (optional) -->
    <parameter name="auto_cache" value="true" /> <!-- auto cache enable. default true (optional) -->
  </behavior>
</table>

Initialize the Cache Store.

Add the following configuration code to your project bootstraping file depending on the storage you are goinng to use., (*5)

Using Memcached (php5-memcached extension needed)

// configure memcached setting.
TFC\Cache\DoctrineCacheFactory::setOption(
    array(
        'storage'     => 'memcached',
        'prefix'      => 'rlyeh',
        'default_ttl' => 3600,
        'servers'     => array(
            array('server1', 11211, 20),
            array('server2', 11211, 80)
        )
    )
);

Using APC

// configure APC setting.
TFC\Cache\DoctrineCacheFactory::setOption(
    array(
        'storage'     => 'apc',
        'default_ttl' => 3600
    )
);

Using Redis

// configure Redis setting.
TFC\Cache\DoctrineCacheFactory::setOption(
    array(
        'storage'     => 'redis',
        'prefix'      => 'rlyeh',
        'host         => '127.0.0.1',
        'port'        => 6379,
        'default_ttl' => 3600
    )
);

Basic usage

$title = 'Cthulhu Mythos';
BookQuery::create()
    ->filterByTitle($title)
    ->findOne(); // from Database

BookQuery::create()
    ->filterByTitle($title)
    ->findOne(); // from caching system

Disable cache

$title = 'Cthulhu Mythos';
BookQuery::create()
    ->setCacheDisable()  // disable cache
    ->filterByTitle($title)
    ->findOne();
  • setCacheEnable()
  • setCacheDisable()
  • isCacheEnable()
  • setLifetime($ttl)

When cache delete?

$book = new Book;
$book->setId(1);
$book->setTitle("Cthulhu Myhtos");
$book->save();  // purge cache.
  • expire cache lifetime.
  • call save() method.
  • call delete() method.
  • call BookQuery::doDeleteAll() method.
  • call BookQuery::purgeCache() method.

Manually delete cache.

$title = 'Cthulhu Mythos';
$query = BookQuery::create();
$book  = $query->filterByTitle($title)->findOne();
$cacheKey = $query->getCacheKey(); // get cache key.

BookPeer::cacheDelete($cacheKey);  // delete cache by key.

License

MIT License, (*6)

The Versions

05/11 2015

dev-master

9999999-dev

A Propel ORM behavior that provide auto data caching for model and collections. Based on snakano/propel-data-cache-behavior

  Sources   Download

MIT

The Requires

 

by Shinya Nakano
by Diego Rin Martín

cache behavior propel