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?

Marijus Ravickas · Accepted Answer · 2024-12-23 10:01:14Z

198

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

RUN pecl install --onlyreqdeps --force 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

Note: The pecl installer accepts default options in these RUN commands. Keep in mind that alternative configuration options are available if needed.

edited Dec 23, 2024 at 10:01

Marijus Ravickas

8736 silver badges6 bronze badges

answered Jul 12, 2015 at 16:17

TimWolla

32.9k8 gold badges67 silver badges97 bronze badges

Sign up to request clarification or add additional context in comments.

11 Comments

starikovs Over a year ago

TimWolla, thanks, I'll try it. So, I need to install pecl as well before all of these?

starikovs Over a year ago

TimWolla, pecl isn't included by default.

Lars Nyström Over a year ago

What do the -o and -f options do?

kingjeffrey Over a year ago

@LarsNyström -o --onlyreqdeps: install all required dependencies, -f --force: will overwrite newer installed packages

Ruslan Over a year ago

"unrecognized option --onlyreqdep", seems there are no such option anymore in PECL comming with "wordpress:6.3-php8.2-apache"

|

Pavel · Accepted Answer · 2016-08-10 00:01:40Z

82

My opinion, the easiest way is:

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

;)

answered Aug 10, 2016 at 0:01

Pavel

4,2672 gold badges33 silver badges35 bronze badges

4 Comments

Yarco Over a year ago

Yes, it is a modern way answer.

Szczepan Hołyszewski Over a year ago

Does NOT work. Specifically docker-php-ext-enable redis does NOT install any configuration files anywhere. It simply does nothing.

Sunil Pachlangia Over a year ago

Gives me error docker-php-ext-enable -- not found. Can you help here ?

Tyler Collier Over a year ago

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!

Community · Accepted Answer · 2017-05-23 12:34:33Z

21

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, 2017 at 12:34

CommunityBot

11 silver badge

answered Jul 25, 2015 at 6:41

starikovs

3,4084 gold badges33 silver badges36 bronze badges

2 Comments

Mouagip Over a year ago

I had to add a mkdir -p /usr/src/php/ext before the mv.

TomLi Over a year ago

I used pecl but had to add RUN apk add --no-cache autoconf git g++ make from this answer: stackoverflow.com/a/44191638/4018940

Community · Accepted Answer · 2017-05-23 12:02:41Z

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, 2017 at 12:02

CommunityBot

11 silver badge

answered Jul 25, 2016 at 12:06

otherguy

1,01511 silver badges16 bronze badges

1 Comment

Matthew Setter Over a year ago

I tried out the answer from @starikovs and I was never able to effectively enable the extension. This answer worked the first time!

skyred · Accepted Answer · 2015-08-25 07:21:28Z

11

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

answered Aug 25, 2015 at 7:21

skyred

3281 silver badge7 bronze badges

Comments

Community · Accepted Answer · 2017-05-23 12:26:17Z

7

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

edited May 23, 2017 at 12:26

CommunityBot

11 silver badge

answered Sep 22, 2015 at 10:16

masakielastic

4,6601 gold badge42 silver badges43 bronze badges

Comments

mihnsen · Accepted Answer · 2020-05-25 03:21:44Z

7

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, 2020 at 3:21

answered May 25, 2020 at 3:15

mihnsen

4254 silver badges10 bronze badges

2 Comments

Calamity Jane Over a year ago

Where is the variable $PHPIZE_DEPS set and what should be in it?

mihnsen Over a year ago

$PHPIZE_DEPTS set by docker alpine. and it use for build pecl extension like Redis php.net/manual/en/install.pecl.phpize.php

Aaron Osborn · Accepted Answer · 2019-08-27 03:14:42Z

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, 2019 at 3:14

Aaron Osborn

597 bronze badges

answered May 29, 2019 at 6:18

grogowar

611 silver badge1 bronze badge

Comments

isp_developer · Accepted Answer · 2015-12-15 03:29:37Z

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, 2015 at 3:29

isp_developer

1114 bronze badges

1 Comment

Mike Doe Over a year ago

Redis PECL extension v3 is available for PHP 7 since 2016-06-10.

trckster · Accepted Answer · 2023-05-09 01:02:58Z

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 9, 2023 at 1:02

trckster

6401 gold badge9 silver badges23 bronze badges

answered Apr 3, 2023 at 12:55

Hossein

4,6872 gold badges37 silver badges44 bronze badges

1 Comment

Ade Over a year ago

A little more detail on this (e.g. a link to the appropriate github repo) would be good

insign · Accepted Answer · 2024-02-21 19:54:16Z

1

Just RUN apk add --no-cache php83-pecl-redis for me.

answered Feb 21, 2024 at 19:54

insign

5,8631 gold badge43 silver badges35 bronze badges

Comments

Sorrymelame · Accepted Answer · 2024-11-27 11:32:56Z

1

I cant install redis from pecl in 2024, now its work > php7.4, i have 7.3 But i cant searching easy way for install, but it is very close

pecl install redis-6.0.2 works for 7.3

answered Nov 27, 2024 at 11:32

Sorrymelame

112 bronze badges

Comments

Community · Accepted Answer · 2017-05-23 12:26:17Z

0

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

edited May 23, 2017 at 12:26

CommunityBot

11 silver badge

answered Jul 19, 2016 at 12:24

selim13

11 bronze badge

Comments

azuax · Accepted Answer · 2019-03-23 18:19:05Z

0

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

answered Mar 23, 2019 at 18:19

azuax

4951 gold badge6 silver badges15 bronze badges

Comments

Gabriel Novaes · Accepted Answer · 2021-03-29 13:04:36Z

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, 2021 at 13:04

Gabriel Novaes

3323 silver badges10 bronze badges

Collectives™ on Stack Overflow

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

15 Answers 15

11 Comments

4 Comments

2 Comments

1 Comment

Comments

Comments

2 Comments

Comments

1 Comment

1 Comment

Comments

Comments

Comments

Comments

Comments

Your Answer

Linked

Hot Network Questions

Collectives™ on Stack Overflow

15 Answers 15

11 Comments

4 Comments

2 Comments

1 Comment

Comments

Comments

2 Comments

Comments

1 Comment

1 Comment

Comments

Comments

Comments

Comments

Comments

Your Answer

Sign up or log in

Post as a guest

Linked

Related