Download the PHP package b3it/laravel-memcached-plus without Composer
On this page you can find all versions of the php package b3it/laravel-memcached-plus. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download b3it/laravel-memcached-plus
More information about b3it/laravel-memcached-plus
Files in b3it/laravel-memcached-plus
Package laravel-memcached-plus
Short Description Extends the built-in Laravel 5 Cache Memcached driver adding support for persistent connections, SASL and Memcached options.
License MIT
Informations about the package laravel-memcached-plus
laravel-memcached-plus
Summary
This package is useful for Laravel 5.0 - 5.2. From 5.3 onwards two PRs I submitted to laravel/framework
have been merged, therefore the features of this package are available out-the-box with Laravel 5.3 onwards.
Integrating with cloud memcached services such as MemCachier and memcached cloud can require memcached features not available with the built-in Laravel Cache memcached driver from version 5.0 to 5.2.
These include:
- SASL authentication
- custom options
- persistent connections
Adding 3 new configuration items, this package enhances the built-in Laravel 5 Cache memcached driver. Optionally, this package also allows these extra configuration items to be used for memcached Sessions.
Read on for detailed instructions - you may find it useful to reference the demo app at the same time.
Requirements
-
= PHP 5.4 with ext-memcached
- To use SASL it must be compiled with SASL support. This is the default on Heroku
Installation
Available to install as a Composer package on Packagist, all you need to do is:
composer require b3it/laravel-memcached-plus
If your local environment does not meet the requirements you may need to append the
ignore-platform-reqs
option:
composer require b3it/laravel-memcached-plus --ignore-platform-reqs
Configuration
Once installed you can use this package to enhance the Laravel Cache and Session services.
Providers
This section discusses the Laravel application configuration file app/config.php
.
In the providers
array you need to replace following built-in Service Providers:
Illuminate\Cache\CacheServiceProvider
andIlluminate\Session\SessionServiceProvider
(optional)
A recommended approach is to comment out the built-in providers and append the Service Providers from this package:
The B3IT\MemcachedPlus\SessionServiceProvider
is optional. You only need to add this if:
- You want to specify a non-default memcached store to use for sessions, default is "memcached", or
- You want to use the memcached features provided by this package for sessions
Cache
This section discusses the Laravel cache configuration file config/cache.php
.
This package makes the following extra configuration items available for use with a memcached store:
persistent_id
- [Memcached::__construct
] (http://php.net/manual/en/memcached.construct.php) explains how this is usedsasl
- used byMemcached::setSaslAuthData
options
- seeMemcached::setOptions
These may be used in a store config like so:
Note that as this package enhances the built-in Laravel 5 memcached Cache driver, the driver string
remains memcached
.
In case you are unfamiliar with how to use multiple cache stores in Laravel, you would access this store from your application code like so:
Session
This section discusses the Laravel session configuration file config/session.php
.
If you are using memcached sessions you will have set the driver
configuration item to 'memcached'.
If you have added the B3IT\MemcachedPlus\SessionServiceProvider
as discussed above, the
store
configuration item is available. This is explained in the following new snippet
you can paste into your session configuration file:
To use the previous memcached 'plus' store example with sessions you would set this as follows:
Breaking changes between v3 and v4
The configuration of Memcached options has been updated to use the Memcached constants rather than the string constant name.
The session.memcached_store
variable has been renamed to session.store
.
laravel-memcached-plus in action
I created a demo app for you to see how this package integrates with Laravel 5 and how you could run it on Heroku.
Support
Please do let me know if you have any comments or queries.
Thanks!
All versions of laravel-memcached-plus with dependencies
ext-memcached Version *
illuminate/cache Version 5.*
illuminate/session Version 5.*