--> -->

Using Redis with PHP

Redis is a popular structured key-value service, supported by Platform.sh. It’s frequently used for caching.

For PHP, Redis support is provided through a PECL extension called PhpRedis . Unfortunately, the extension has been known to break its API between versions, even between minor versions. That makes it difficult for Platform.sh to bundle like other PHP extensions .

Fortunately, the extension is small enough that it’s reasonable to compile as part of the build step and enable yourself. That makes it possible to install the specific version of the extension that your application code requires. All of the necessary tools to compile PHP extensions are included in our PHP containers, so cloning the source code and compiling it on each build is straightforward. That does entail a few minute additions to each build, however.

Alternatively, we have written a shell script that leverages the build cache directory to only compile the extension once, and supports compiling any version of the extension.

Using the Redis builder script 

  1. Copy the following script into a file named install-redis.sh in your application root (as a sibling of your .platform.app.yaml file).
run() {
    # Run the compilation process.
    cd $PLATFORM_CACHE_DIR || exit 1;

    if [ ! -f "${PLATFORM_CACHE_DIR}/phpredis/modules/redis.so" ]; then
        checkout_version "$1"


enable_lib() {
    # Tell PHP to enable the extension.
    echo "Enabling PhpRedis extension."
    echo "extension=${PLATFORM_APP_DIR}/redis.so" >> $PLATFORM_APP_DIR/php.ini

copy_lib() {
    # Copy the compiled library to the application directory.
    echo "Installing PhpRedis extension."
    cp $PLATFORM_CACHE_DIR/phpredis/modules/redis.so $PLATFORM_APP_DIR

checkout_version () {
    # Check out the specific Git tag that we want to build.
    git checkout "$1"

ensure_source() {
    # Ensure that the extension source code is available and up to date.
    if [ -d "phpredis" ]; then
        cd phpredis || exit 1;
        git fetch --all --prune
        git clone https://github.com/phpredis/phpredis.git
        cd phpredis || exit 1;

compile_source() {
    # Compile the extension.

ensure_environment() {
    # If not running in a Platform.sh build environment, do nothing.
    if [ -z "${PLATFORM_CACHE_DIR}" ]; then
        echo "Not running in a Platform.sh build environment.  Aborting Redis installation."
        exit 0;

ensure_arguments() {
    # If no version was specified, don't try to guess.
    if [ -z $1 ]; then
        echo "No version of the PhpRedis extension specified.  You must specify a tagged version on the command line."
        exit 1;

ensure_arguments "$1"
run "$1"
  1. Invoke that script from your build hook, specifying a version. Any tagged version of the library is acceptable:
    build: |
        set -e
        bash install-redis.sh 5.1.1
  1. If you ever wish to change the version of PhpRedis you are using, update the build hook and clear the build cache: platform project:clear-build-cache. The new version will not be used until you clear the build cache.

There is no need to declare the extension in the runtime block. That is only for pre-built extensions.

What the script does 

  1. Downloads the PhpRedis source code.
  2. Checks out the version specified in the build hook.
  3. Compiles the extension.
  4. Copies the resulting redis.so file to your application root.
  5. Adds a line to the php.ini file in your application root to enable the extension, creating the file if necessary.

If the script does not find a $PLATFORM_CACHE_DIR directory defined, it exits silently. That means if you run the build hook locally it will have no effect.