rah / rah_memcached
Memcached Textpattern CMS templates
Fund package maintenance!
www.paypal.me/jukkasvahn
Installs: 10
Dependents: 0
Suggesters: 0
Security: 0
Stars: 2
Watchers: 3
Forks: 1
Open Issues: 0
Type:textpattern-plugin
Requires
- php: >=8.1
- ext-memcached: *
- textpattern/installer: *
- textpattern/lock: >=4.7.0
Requires (Dev)
- rah/mtxpc: ^0.9.0
- squizlabs/php_codesniffer: 3.*
This package is auto-updated.
Last update: 2024-10-22 23:45:28 UTC
README
A plugin for Textpattern CMS that stores parts of your templates in Memcached, a distributed in-memory key-value caching system.
Install
Using Composer:
$ composer require rah/rah_memcached
Or download an installer package.
Basics
The plugin, rah_memcached, introduces a new container tag to Textpattern’s arsenal. The tag stores the wrapped content, and variables set within it, in Memcached’s in-memory storage.
<rah::memcached>
<txp:variable name="variable1" value="value" />
<txp:article_custom limit="200">
<txp:title />
</txp:article_custom>
</rah::memcached>
On subsequent calls the resulting output markup and variables will be loaded from memory, skipping template parsing and code execution, speeding up your site and alleviating database load.
Requirements
- Textpattern >= 4.7.0.
- PHP >= 8.1.0.
- Memcached PHP extension.
- libmemcached client library.
- Memcached server.
Configuration
Connected server can be configured through Textpattern’s textpattern/config.php
file:
define('RAH_MEMCACHED_HOST', 'localhost');
define('RAH_MEMCACHED_PORT', 11211);
Attributes
<rah::memcached>
...contained statement...
</rah::memcached>
The tag is a container and attributes for it follow.
name
Sets a name, a key, for the cached item. The given name is used identify the item, and save and fetch it from the storage. If a name is not defined, it’s automatically created by hashing the given contained markup. While the name is optional, giving it is more efficient and avoids any potential hash collisions.
Default: undefined Example: name="mykey"
expires
Time in seconds it takes to the stored item to expire and be refreshed. If zero (0
), the cache is kept in memory until the cache is flushed or Memcached is restarted.
Default: 0
Example: expires="3600"
persist
If enabled, ignores content updates as set by site’s lastmod
timestamp. By default, the cache is invalidated when Texptatern’s lastmod timestamp is updated, which is done when any content is updated.
Default: disabled Example: persist
Examples
Store section navigation in memory
<rah::memcached name="navigation">
<txp:section_list wraptag="ul" break="li">
<txp:section />
</txp:section_list>
</rah::memcached>
Store variables in memory
<rah::memcached> <txp:variable name="color" value="red" /> <txp:variable name="size" value="small" /> </rah::memcached>
Color: <txp:variable name="color" /> Size: <txp:variable name="size" />
Changelog
Version 0.3.0 – 2022/04/22
- Fixes PHP >= 8.1 compatibility.
- Now requires PHP >= 8.1.
Version 0.2.0 – 2022/04/17
- Register the tag for Textpattern >= 4.7.0 compatibility.
- Replaced
lastmod
attribute withpersist
. - Now requires PHP >= 7.2.0.
- Now requires Textpattern >= 4.7.0.
Version 0.1.0 – 2014/03/19
- Initial release.