How to install php-redis extension using the official PHP Docker image approach?

Question

I want to build my PHP-FPM image with php-redis extension based on the official PHP Docker image, for example, using this Dockerfile: php:5.6-fpm.

The docs say that I can install extensions this way, installing dependencies for extensions manually:

FROM php:5.6-fpm
# Install modules (iconv, mcrypt and gd extensions)
RUN apt-get update && apt-get install -y \
        libfreetype6-dev \
        libjpeg62-turbo-dev \
        libmcrypt-dev \
        libpng12-dev \
    && docker-php-ext-install iconv mcrypt \
    && docker-php-ext-configure gd --with-freetype-dir=/usr/include/ --with-jpeg-dir=/usr/include/ \
    && docker-php-ext-install gd
CMD ["php-fpm"]

Without Docker, I installed it with apt-get install php5-redis. But how can I install it using the approach above?

score 179 · Accepted Answer · edited Nov 24 '21 at 22:25

179

Redis is not an extension that is included in “php-src”, therefore you cannot use docker-php-ext-install. Use PECL:

RUN pecl install -o -f redis \
&&  rm -rf /tmp/pear \
&&  docker-php-ext-enable redis

On alpine php 7.3.5 we can use:

RUN apk add --no-cache pcre-dev $PHPIZE_DEPS \
        && pecl install redis \
        && docker-php-ext-enable redis.so

edited Nov 24 '21 at 22:25

Ngatia Frankline

2,897
2
20
19

answered Jul 12 '15 at 16:17

TimWolla

31,849
8
63
96

1

TimWolla, thanks, I'll try it. So, I need to install `pecl` as well before all of these? – starikovs Jul 12 '15 at 19:53
1

TimWolla, pecl isn't included by default. – starikovs Jul 25 '15 at 06:42
What if I want to use a different image for Redis? – IlGala Dec 17 '19 at 16:35
1

@IlGala This command installs *php extension for redis not redis server itself* – piotrekkr Dec 20 '19 at 10:23
2

What do the -o and -f options do? – Lars Nyström May 28 '20 at 12:20
1

@LarsNyström -o --onlyreqdeps: install all required dependencies, -f --force: will overwrite newer installed packages – kingjeffrey Dec 23 '20 at 23:15
Previously I made the mistake of using `docker-php-ext-enable redis` without first doing `pecl install redis`. As a result, phpinfo made it appear that redis was installed, because all of the .ini configuration was there, but the redis module itself was not. Thank you for you help! – Joe Sadoski Oct 05 '22 at 14:13
The last one worked fine for me on alpine 3.16 with PHP 8.0. – Cyclonecode Aug 24 '23 at 23:25

score 72 · Answer 2 · answered Aug 10 '16 at 00:01

72

My opinion, the easiest way is:

RUN pecl install redis && docker-php-ext-enable redis

;)

answered Aug 10 '16 at 00:01

Pavel

3,967
2
29
35

2

Yes, it is a modern way answer. – Yarco May 10 '17 at 06:26
Works awesome!! Thank you. – Sivaji Jan 08 '19 at 11:12
3

Does NOT work. Specifically docker-php-ext-enable redis does NOT install any configuration files anywhere. It simply does nothing. – Szczepan Hołyszewski Apr 10 '20 at 20:36
1

Gives me error docker-php-ext-enable -- not found. Can you help here ? – Sunil Pachlangia Jun 11 '20 at 09:46
I saw the comment by @SzczepanHołyszewski and just did the first command (`RUN pecl install redis`), not both (`RUN pecl install redis && docker-php-ext-enable redis`). That's all that was needed for me! – Tyler Collier Mar 10 '21 at 23:58

score 21 · Answer 3 · edited May 23 '17 at 12:02

21

Slightly revised version of starikovs and skyred answers for the current PHP 7 version of the docker image (tested on php:7.0.8-fpm-alpine and php:7.0.8-alpine).

Uses the newly released 3.0 version (June 2016) for PHP 7.

ENV PHPREDIS_VERSION 3.0.0

RUN mkdir -p /usr/src/php/ext/redis \
    && curl -L https://github.com/phpredis/phpredis/archive/$PHPREDIS_VERSION.tar.gz | tar xvz -C /usr/src/php/ext/redis --strip 1 \
    && echo 'redis' >> /usr/src/php-available-exts \
    && docker-php-ext-install redis

edited May 23 '17 at 12:02

Community

1
1

answered Jul 25 '16 at 12:06

otherguy

709
6
13

I tried out the answer from @starikovs and I was never able to effectively enable the extension. This answer worked the first time! – Matthew Setter Jun 22 '18 at 12:24

score 19 · Answer 4 · edited May 23 '17 at 12:34

19

I've found two ways to install php-redis extension for official php-fpm Docker image. Here they are:

The first way is to compile redis from sources and install.

RUN curl -L -o /tmp/redis.tar.gz https://github.com/phpredis/phpredis/archive/2.2.7.tar.gz \
    && tar xfz /tmp/redis.tar.gz \
    && rm -r /tmp/redis.tar.gz \
    && mv phpredis-2.2.7 /usr/src/php/ext/redis \
    && docker-php-ext-install redis

docker-php-ext-install script is included in php-fpm image and can compile extensions and install them.

The second way you can do it is with PECL.

As TimWolla answered, you can do it with PECL, but in my case, PECL isn't installed by default.

RUN pecl install -o -f redis \
&&  rm -rf /tmp/pear \
&&  echo "extension=redis.so" > /usr/local/etc/php/conf.d/redis.ini

edited May 23 '17 at 12:34

Community

1
1

answered Jul 25 '15 at 06:41

starikovs

3,240
4
28
33

3

I had to add a `mkdir -p /usr/src/php/ext` before the `mv`. – Mouagip Sep 12 '19 at 11:16
I used pecl but had to add RUN apk add --no-cache autoconf git g++ make from this answer: https://stackoverflow.com/a/44191638/4018940 – TomLi Jun 23 '20 at 12:03

score 11 · Answer 5 · answered Aug 25 '15 at 07:21

Based on @starikovs answer. I added a variable for docker style.

# install phpredis extension
ENV PHPREDIS_VERSION 2.2.7

RUN curl -L -o /tmp/redis.tar.gz https://github.com/phpredis/phpredis/archive/$PHPREDIS_VERSION.tar.gz \
    && tar xfz /tmp/redis.tar.gz \
    && rm -r /tmp/redis.tar.gz \
    && mv phpredis-$PHPREDIS_VERSION /usr/src/php/ext/redis \
    && docker-php-ext-install redis

score 7 · Answer 6 · edited May 23 '17 at 12:26

If you want to use redis as session handler;

RUN { \
    echo 'session.save_handler = redis'; \
    echo 'session.save_path = tcp://redis:6379'; \
} >> /usr/local/etc/php/conf.d/docker-php-ext-redis.ini

If you want to use redis extension with PHP 7 in 2015 (borrowed from skyred's answer);

ENV PHPREDIS_VERSION php7

RUN curl -L -o /tmp/redis.tar.gz https://github.com/phpredis/phpredis/archive/$PHPREDIS_VERSION.tar.gz \
    && tar xfz /tmp/redis.tar.gz \
    && rm -r /tmp/redis.tar.gz \
    && mv phpredis-$PHPREDIS_VERSION /usr/src/php/ext/redis \
    && docker-php-ext-install redis

score 6 · Answer 7 · edited Aug 27 '19 at 03:14

6

This works for alpine images:

RUN set -xe \
    && apk add --no-cache --update --virtual .phpize-deps $PHPIZE_DEPS \
    && pecl install -o -f redis  \
    && echo "extension=redis.so" > /usr/local/etc/php/conf.d/redis.ini \
    && rm -rf /usr/share/php \
    && rm -rf /tmp/* \
    && apk del  .phpize-deps

Edit: Added missing backslash

edited Aug 27 '19 at 03:14

Aaron Osborn

59
7

answered May 29 '19 at 06:18

grogowar

61
1
1

mihnsen · Answer 8 · 2020-05-25T03:21:44.590

6

Tried few ways. On alpine php 7.3.5 we can use:

RUN apk add --no-cache pcre-dev $PHPIZE_DEPS \
        && pecl install redis \
        && docker-php-ext-enable redis.so

edited May 25 '20 at 03:21

answered May 25 '20 at 03:15

mihnsen

385
3
8

Where is the variable $PHPIZE_DEPS set and what should be in it? – Calamity Jane Jun 10 '21 at 09:28
1

$PHPIZE_DEPTS set by docker alpine. and it use for build pecl extension like Redis https://www.php.net/manual/en/install.pecl.phpize.php – mihnsen Jun 11 '21 at 08:36

score 3 · Answer 9 · answered Dec 15 '15 at 03:29

3

I'm using combination of PECL and PHP official docker extension script

RUN pecl bundle -d /usr/src/php/ext redis \
&& rm /usr/src/php/ext/redis-*.tgz \
&& docker-php-ext-install redis

For PHP7 you need to wait for official redis pecl release or use git:

RUN apt-get update \
&& apt-get install git -y -q \
&& git clone -b php7 https://github.com/phpredis/phpredis.git /usr/src/php/ext/redis \
&& docker-php-ext-install redis

answered Dec 15 '15 at 03:29

isp_developer

111
4

1

Redis PECL extension v3 is available for PHP 7 since 2016-06-10. – Mike Doe Jul 14 '16 at 09:51

score 2 · Answer 10 · edited May 09 '23 at 01:02

2

This is a docker solution, use this code in Dockerfile.

COPY --from=mlocati/php-extension-installer /usr/bin/install-php-extensions /usr/local/bin/
RUN install-php-extensions redis

Image sources: https://github.com/mlocati/docker-php-extension-installer

edited May 09 '23 at 01:02

trckster

430
1
6
11

answered Apr 03 '23 at 12:55

Hossein

3,755
2
29
39

1

A little more detail on this (e.g. a link to the appropriate github repo) would be good – Ade May 04 '23 at 11:32

score 0 · Answer 11 · edited May 23 '17 at 12:26

Slightly revised version of starikovs and skyred answers for current version of the docker image. Tested on php:5-fpm-alpine

# install phpredis extension
ENV PHPREDIS_VERSION 2.2.8

ADD https://github.com/phpredis/phpredis/archive/$PHPREDIS_VERSION.tar.gz /tmp/redis.tar.gz
RUN tar xzf /tmp/redis.tar.gz -C /tmp \
    && mkdir -p /usr/src/php/ext \
    && mv /tmp/phpredis-$PHPREDIS_VERSION /usr/src/php/ext/redis \
    && echo 'redis' >> /usr/src/php-available-exts \
    && docker-php-ext-install redis \
    && rm -rf /usr/src/php/ext/redis

score 0 · Answer 12 · answered Mar 23 '19 at 18:19

In your Dockerfile you can clone the repo and install it with:

RUN git clone https://github.com/phpredis/phpredis.git /tmp/phpredis \
&& cd /tmp/phpredis \
&& git checkout -b 3.1.2 \ ## or the release you need #
&& phpize \
&& ./configure \
&& make \
&& make install

score 0 · Answer 13 · answered Mar 29 '21 at 13:04

0

For image php:7.2-fpm-alpine.

RUN apk add autoconf gcc g++ make && pecl install redis && docker-php-ext-enable redis

You may need to update before

apk --update upgrade

answered Mar 29 '21 at 13:04

Gabriel Novaes

51
9

How to install php-redis extension using the official PHP Docker image approach?

13 Answers13

Linked