Why does an error occur when installing an extension using PECL in a Docker environment? How to solve it?

Troubleshooting and repairing failed installation of PECL extension in Docker

When installing PHP extensions using PECL in Docker environment, you often encounter various problems. This article will analyze and resolve fatal error: uncaught error: call to undefined function _parsefeaturesheaderfile() error through a practical case.

Question description:

When trying to install any PHP extensions using PECL in Docker, I get the following error:

 <code>fatal error: uncaught error: call to undefined function _parsefeaturesheaderfile() in /usr/local/lib/php/os/guess.php:248</code>

The Dockerfile is as follows:

 FROM php:7.3-fpm-alpine

ENV swoole_version=4.5.3
ENV php_redis=5.3.1

RUN sed -i 's/dl-cdn.alpinelinux.org/mirrors.aliyun.com/g' /etc/apk/repositories

RUN echo "asia/shanghai" > /etc/timezone

# update
RUN set -ex \
    && apk update \
    && apk add --no-cache libstdc wget openssl bash \
    libmcrypt-dev libzip-dev libpng-dev freetype-dev libjpeg-turbo-dev \
    libc-dev zlib-dev librdkafka-dev libmemcached-dev cyrus-sasl-dev

RUN apk add --no-cache --virtual .build-deps autoconf automake make g gcc libtool dpkg-dev dpkg unzip \
    curl pkgconf file re2c pcre-dev php7-pear php7-dev php7-pear openssl-dev graphviz \
    && docker-php-ext-configure gd --with-freetype-dir=/usr/include/ --with-jpeg-dir=/usr/include/ --with-png-dir=/usr/include/ \
    # Install common php extensions

Problem analysis and solutions:

The reason for the error is that the PHP version (7.3) used in Dockerfile is incompatible with the version of PECL package manager (php7-pear, php7-dev). php7-pear and php7-dev refer to older versions of PHP 7, not 7.3.

The solution is to update the package names related to pear and dev in the Dockerfile to a version compatible with PHP 7.3:

Modified Dockerfile snippet:

 RUN apk add --no-cache --virtual .build-deps autoconf automake make g gcc libtool dpkg-dev dpkg unzip \
    curl pkgconf file re2c pcre-dev php7.3-pear php7.3-dev php7.3-pear openssl-dev graphviz \
    && docker-php-ext-configure gd --with-freetype-dir=/usr/include/ --with-jpeg-dir=/usr/include/ --with-png-dir=/usr/include/ \
    # Install common php extensions

The PECL compatibility with PHP 7.3 version was ensured by replacing php7-pear and php7-dev with php7.3-pear and php7.3-dev , thus resolving the installation error. Remember to rebuild the Docker image after modification. This emphasizes the importance of having to accurately match the PHP version and its associated dependencies when building PHP applications in a Docker environment.

The above is the detailed content of Why does an error occur when installing an extension using PECL in a Docker environment? How to solve it?. For more information, please follow other related articles on the PHP Chinese website!