gnu-social

History

Diogo Cordeiro 8c0601816f [CORE] Move core plugins to a new modules directory For reference (raised by rozzin in IRC): * http://foldoc.org/module * http://foldoc.org/library * http://foldoc.org/plugin As noted by XRevan86, modules are not necessarily non-essential. As we will keep the modules directory in GS root [therefore, near to plugins/], it is evidenced the difference between both. This is a simple yet fundamental structural change. It doesn't change functionality but makes clearer the way we understand GNU social's internals.		2019-08-22 03:13:58 +01:00
..
locale	[CORE] Move core plugins to a new modules directory	2019-08-22 03:13:58 +01:00
MemcachedPlugin.php	[Memcached] Merged useful features from Memcache	2019-08-15 22:33:37 +01:00
README	[PLUGINS] Updated and reviewed the Memcached plugin	2019-08-15 22:33:37 +01:00

README

The Memcached plugin implements cache interface for memcached.

See: http://memcached.org/

The difference between the former `MemcachePlugin` and `MemcachedPlugin` is that they use,
respectively, `memcache` and `memcached` as the underlying php libraries. These are similar
libraries, made by different authors with slightly different cacpabilities, therefore `memcached`
was selected.

Installation
============

Tell your `config.php` to use this plugin (replace `tcp://localhost:6379` with the address/port
of your Memcache backend server):

`addPlugin('Memcached');`

Note that this typically requires configuring the `memcached` extension for `php`, which is
typically available as a binary package from your system's package manager. In Debian based systems
and on Arch based systems, this is likely available under the `php-memcached` package. Note the
final `d`. On Arch, uncomment the line in `/etc/php/conf.d/memcached.ini` and restart your webserver
and/or php-fpm or similar.

Settings
========

servers: Array of memcached servers addresses. Each server address should be either a string with
address or an array where the first element is a string with the address an optional second element
with the port.

defaultExpiry: How long before cache expires (in seconds)

Example
=======

addPlugin('Memcached', [ 'servers' => ['127.0.0.1', 11211],
                         'defaultExpiry' => 86400 // 24h
                       ]);