Docker搭建PHP8 FPM Laravel环境mbstring扩展安装报错问题

• mbstring扩展编译依赖oniguruma正则库的开发文件，首次构建报错由该依赖缺失直接导致。后续添加的libonig-dev是Debian/Ubuntu发行版的对应包名，Alpine Linux中该依赖的包名为oniguruma-dev，因此触发包不存在的错误。
• 现有Dockerfile存在两处隐藏问题，即使解决包名问题，后续仍会出现构建或运行失败：
  • PHP 8.0版本编译gd扩展的配置规则已调整，旧版--with-freetype-dir/--with-jpeg-dir/--with-png-dir参数已被废弃，继续使用会触发编译错误。
  • 启动脚本start_script.sh的赋权操作在切换到普通用户www之后执行，普通用户无修改文件权限的操作权限，容器启动时会触发权限拒绝错误。

方案1：最小改动修复现有配置 #

仅修正错误配置点，保留原有编写逻辑：

1. 将apk依赖列表中的libonig-dev替换为oniguruma-dev
2. 更新gd扩展的编译配置参数，适配PHP8.0要求
3. 将启动脚本的赋权操作移动到切换用户之前执行

修改后的完整Dockerfile如下：

FROM php:8.0.5-fpm-alpine

WORKDIR /var/www

ADD https://github.com/mlocati/docker-php-extension-installer/releases/latest/download/install-php-extensions /usr/local/bin/

RUN apk update && apk add \
    build-base \
    oniguruma-dev \
    freetype-dev \
    libjpeg-turbo-dev \
    libpng-dev \
    libzip-dev \
    zip \
    jpegoptim optipng pngquant gifsicle \
    vim \
    unzip \
    git \
    curl

RUN docker-php-ext-install pdo_mysql mbstring zip exif pcntl
# 适配PHP8的gd扩展配置参数
RUN docker-php-ext-configure gd --with-freetype --with-jpeg
RUN docker-php-ext-install gd

# Install Redis Extension
RUN apk add autoconf && pecl install -o -f redis \
    &&  rm -rf /tmp/pear \
    &&  docker-php-ext-enable redis && apk del autoconf

# Copy config
COPY ./config/php/local.ini /usr/local/etc/php/conf.d/local.ini

RUN addgroup -g 1000 -S www && \
    adduser -u 1000 -S www -G www

# 先复制文件、赋权，再切换用户
COPY --chown=www:www . /var/www
RUN ["chmod", "+x", "./start_script.sh"]

USER www

EXPOSE 9000

CMD ./start_script.sh

方案2：使用扩展安装脚本简化配置（推荐） #

镜像开头已经下载了专门的PHP扩展安装脚本，该脚本会自动匹配PHP版本安装对应系统依赖、处理编译参数，不需要手动查找apk包、记忆版本相关的编译配置，能大幅减少这类构建错误。

简化后的Dockerfile如下：

FROM php:8.0.5-fpm-alpine

WORKDIR /var/www

# 赋予下载的扩展安装脚本执行权限
ADD https://github.com/mlocati/docker-php-extension-installer/releases/latest/download/install-php-extensions /usr/local/bin/
RUN chmod +x /usr/local/bin/install-php-extensions

RUN apk update && apk add \
    build-base \
    zip \
    jpegoptim optipng pngquant gifsicle \
    vim \
    unzip \
    git \
    curl \
    oniguruma-dev

# 一键安装所有PHP扩展，自动处理依赖和编译参数
RUN install-php-extensions pdo_mysql mbstring zip exif pcntl gd redis

# Copy config
COPY ./config/php/local.ini /usr/local/etc/php/conf.d/local.ini

RUN addgroup -g 1000 -S www && \
    adduser -u 1000 -S www -G www

COPY --chown=www:www . /var/www
RUN ["chmod", "+x", "./start_script.sh"]

USER www

EXPOSE 9000

CMD ./start_script.sh

修改完成后先执行docker-compose build --no-cache app清除旧构建缓存重新构建镜像，避免历史缓存层导致的错误，构建成功后再执行docker-compose up启动容器即可。

内容的提问来源于stack exchange，提问作者aceraven777