Docker中PECL扩展安装失败的排查与修复
在Docker环境中使用PECL安装PHP扩展时，经常会遇到各种问题。本文将通过一个实际案例，分析并解决fatal error: uncaught error: call to undefined function _parsefeaturesheaderfile()错误。
问题描述:
尝试在Docker中使用PECL安装任何PHP扩展时，出现以下错误：
fatal error: uncaught error: call to undefined function _parsefeaturesheaderfile() in /usr/local/lib/php/os/guess.php:248
Dockerfile如下：
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/ \
# 安装php常用扩展
问题分析与解决方案:
错误原因在于Dockerfile中使用的PHP版本(7.3)与PECL包管理器(php7-pear, php7-dev)的版本不兼容。 php7-pear 和 php7-dev 指的是PHP 7的旧版本，而非7.3。
解决方法是将Dockerfile中与pear和dev相关的包名更新为与PHP 7.3兼容的版本：
修改后的Dockerfile片段：
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/ \
# 安装php常用扩展
通过将php7-pear 和 php7-dev 替换为 php7.3-pear 和 php7.3-dev，确保了PECL与PHP 7.3版本的兼容性，从而解决了安装错误。 记住在修改后重建Docker镜像。 这强调了在Docker环境中构建PHP应用时，必须精确匹配PHP版本及其相关依赖库的重要性。
