Redis Library

Also See:   redis_connect redis_disconnect redis_last_error

Redis allows building advanced caching mechanisms into Miva Script applications.

Miva Script Redis implementation uses the Hiredis library, which states: Hiredis only supports the binary-safe Redis protocol, so you can use it with any Redis version >= 1.2.0.

Redis Resources

View the Redis Function list.

Redis is an open source (BSD licensed), in-memory data structure store, used as a database, cache and message broker. It supports data structures such as strings, hashes, lists, sets, sorted sets with range queries, bitmaps, hyperloglogs, geospatial indexes with radius queries and streams. Redis has built-in replication, Lua scripting, LRU eviction, transactions and different levels of on-disk persistence, and provides high availability via Redis Sentinel and automatic partitioning with Redis Cluster. Learn More...

Redis Applications

Example:

This is a basic example that open a redis connection and keep track of how many times a user has viewed your website.

<MvIF EXPR = "{ NOT redis_connect( 'localhost', '6379', l.conn_id ) }">
    <MvEVAL EXPR = "{ 'Failed to connect to redis: ' $ redis_last_error() }">
    <MvEXIT>
</MvIF>

<MvASSIGN NAME = "l.null" VALUE = "{ redis_incr( l.conn_id, 'unique_counter_' $ s.remote_addr ) }">

<MvEVAL EXPR = "{ 'You have visited my site ' $ redis_get( l.conn_id, 'unique_counter_' $ s.remote_addr ) $ ' times' }">

<MvASSIGN NAME = "l.null" VALUE = "{ redis_disconnect( l.conn_id ) }">

Example:

In this example we cache frequently accessed data for 3 days. Assume you have a page that performs costly operations and takes more than 3 seconds to load. This page will be viewed by frequently multiple users but the data doesn't change often. 

<mvt:assign name="l.data" value="redis_get( l.conn_id, 'some_storage_key' )" />

<mvt:if expr="NOT ISNULL l.data">
<mvt:comment> The key data still exists so serve up the cached version </mvt:comment>
    <mvt:eval expr="l.data" />
<mvt:else>
    <mvt:comment> The key data does not exist so build it all again </mvt:comment>

    /* some very costly operations are performed here and the result is stored in l.costly_calculated_storage */

    <mvt:comment> The data is stored in redis for 60 * 60 * 24 * 3 seconds (which is 3 days and then redis will auto purge it). </mvt:comment>
    <mvt:assign name="l.null" value="redis_set( l.conn_id, 'some_storage_key,' l.costly_calculated_storage, miva_array_deserialize(':EX=' $ 60*60*24*3 ') )" />
</mvt:if>

The following are implementations of Redis functions. All functions take a Redis connection reference and work as described by redis.io.