Using Memcached with PHP
In order to use Memcached with PHP you will need a PHP Memcached client. In the following sections, we will demonstrate the use of PECL memcached, an extension that uses the libmemcached library to provide an API for communicating with Memcached servers as well as a session handler (memcached).
Installing PECL memcached
PECL memcached’s installation instructions are given in its “Installation” page. To install it, use the following command:
pecl install memcached
Once installed, you should review the
/etc/php5/mods-available/memcached.ini file or your site’s
php.ini file and verify the following setting in it:
- SASL authentication (
memcached.use_sasl) – to use a SASL-enabled Memcached Cloud bucket, enable this setting by setting it to 1
Note: if you’ve installed PECL memcached, you should consider restarting your web server to apply the changes.
Opening a Connection to Memcached Using PECL memcached
The following code creates a connection to Memcached using PECL memcached:
<?php $mc = new Memcached(); $mc->setOption(Memcached::OPT_BINARY_PROTOCOL, true); $mc->addServer('hostname.redislabs.com', 11211); $mc->setSaslAuthData('username', 'password'); ?>
To adapt this example to your code, make sure that you replace the following values with those of your bucket:
- In line 4, the first argument to
addServershould be your bucket’s hostname or IP address
- In line 4, the second argument to
addServershould be your bucket’s port
- In line 5, the first argument to
setSaslAuthDatashould be your bucket’s username
- In line 5, the second argument to
setSaslAuthDatashould be your bucket’s password
Reading and Writing Data with PECL memcached
Once connected to Memcached, you can start reading and writing data. The following code snippet writes the value
bar to the Memcached key
foo, reads it back, and prints it:
// open a connection to Memcached ... $mc->set('foo', 'bar'); value = $mc->get('foo'); echo value;
The output of the above code should be:
$ php memcached.php bar
Redis Enterprise enables running Redis datasets in a highly available and auto-scalable manner, with predictable top performance.
Redis Enterprise Software lets you install an enterprise grade Memcached cluster in your environment of choice, whether an on-premises data-center or your preferred cloud platform. It gives you full control of your data and configuration – no clustering or sharding knowledge required!
Memcached Cloud is a fully managed cloud service for hosting and running Memcached datasets in a highly available and scalable manner, with predictable and stable top performance. It provides a storage engine for standard Memcached, as well as in-memory replication and instant auto-failover within the same data center or across data centers. The service completely frees developers from dealing with nodes, clusters, scaling, data persistence issues or failure recovery.
For more information on using Redis Labs’ products and services with PHP please see the Howto page.