GitLab Runner所用PHP可执行文件与本地不符，php8.2-sockets扩展缺失求助

DevOps 小满

2026-7-16

问题描述

我开发的包通过Docker容器构建后推送到自建Kubernetes Runner的GitLab实例，但Runner使用的容器环境和本地不一致：

本地Dockerfile已安装php8.2-sockets扩展（composer install必需），本地运行正常，但Runner环境中该扩展缺失
本地PHP路径为/usr/bin/php，Runner中为/usr/local/bin/php
不想用--ignore-platform-req=ext-dom跳过依赖检查，避免后续测试失败
顺便求问如何折叠代码片段提升可读性

我的Dockerfile

FROM debian:bullseye-slim

ENV DEBIAN_FRONTEND noninteractive

RUN apt-get update \
    && apt-get install -y zip git curl supervisor lsb-release ca-certificates libzip-dev libxml2-dev libicu-dev \
    && curl -sSLo /usr/share/keyrings/deb.sury.org-php.gpg https://packages.sury.org/php/apt.gpg \
    && sh -c 'echo "deb [signed-by=/usr/share/keyrings/deb.sury.org-php.gpg] https://packages.sury.org/php/ bullseye main" > /etc/apt/sources.list.d/php.list' \
    && apt-get update \
    && apt-get install -y \
       php8.2-cli php8.2-fpm \
       php8.2-curl php8.2-sockets php8.2-dom \
    && apt-get autoremove -y \
    && apt-get clean \
    && rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/*

ENV COMPOSER_ALLOW_SUPERUSER 1

COPY --from=composer:latest /usr/bin/composer /usr/local/bin/composer

WORKDIR /var/www

ENV WWWUSER 1000
ENV WWWGROUP 1001

RUN groupadd --gid $WWWGROUP cbe \
    && useradd -m -g $WWWGROUP -u $WWWUSER cbe

ENTRYPOINT ["/bin/bash"]

我的.gitlab-ci.yml

variables:
  FF_GITLAB_REGISTRY_HELPER_IMAGE: 1
  DOCKER_BUILDKIT: 1
  DOCKER_DRIVER: overlay2
  BUILDKIT_PROGRESS: plain

stages:
  - image
  - build

php-image:
  stage: image
  image: docker
  services: [ docker:dind ]
  before_script:
    - echo ${CI_REGISTRY_PASSWORD} | docker login -u ${CI_REGISTRY_USER} --password-stdin ${CI_REGISTRY}
  script:
    - docker build
      --tag ${CI_REGISTRY_IMAGE}:${CI_COMMIT_REF_SLUG}
      --build-arg BUILDKIT_INLINE_CACHE=1
      --push
      --progress plain
      -f Docker/Dockerfile .

composer:
  stage: build
  image: ${CI_REGISTRY_IMAGE}:${CI_COMMIT_REF_SLUG}
  needs: [ php-image ]
  script:
    - php -m
    - which php
    - cp phpunit.xml.dist phpunit.xml
    - php composer install --optimize-autoloader --no-ansi --no-interaction --no-progress

php -m 输出对比

本地

bash-5.1# php -m
[PHP Modules]
calendar
Core
ctype
curl
date
dom
exif
FFI
fileinfo
filter
ftp
gettext
hash
iconv
json
libxml
openssl
pcntl
pcre
PDO
Phar
posix
random
readline
Reflection
session
shmop
SimpleXML
sockets
sodium
SPL
standard
sysvmsg
sysvsem
sysvshm
tokenizer
xml
xmlreader
xmlwriter
xsl
Zend OPcache
zlib

[Zend Modules]
Zend OPcache

bash-5.1# which php
/usr/bin/php

Runner

$ php -m
[PHP Modules]
Core
ctype
curl
date
dom
fileinfo
filter
ftp
hash
iconv
json
libxml
mbstring
mysqlnd
openssl
pcre
PDO
pdo_sqlite
Phar
posix
random
readline
Reflection
session
SimpleXML
sodium
SPL
sqlite3
standard
tokenizer
xml
xmlreader
xmlwriter
zlib
[Zend Modules]
$ which php
/usr/local/bin/php

问题分析与解决方法

1. PHP路径差异与环境不一致的原因

Runner中出现/usr/local/bin/php，说明容器里存在两个PHP版本：

本地你使用的是通过sury源安装的php8.2-cli，路径为/usr/bin/php
Runner中执行的php来自/usr/local/bin，是composer:latest镜像自带的PHP环境（你复制composer时，该镜像的PHP也被带入容器）

容器启动时，PATH环境变量中/usr/local/bin优先级高于/usr/bin，所以默认执行的是composer镜像的PHP，而非你安装的带sockets扩展的版本。

2. 解决sockets扩展缺失的方法

方案一：调整PATH优先级，强制使用sury源的PHP

在Dockerfile中添加以下命令，将/usr/bin放到PATH最前面，确保优先使用你安装的PHP：

ENV PATH="/usr/bin:$PATH"

方案二：为`/usr/local/bin/php`安装sockets扩展

如果需要保留/usr/local/bin/php作为默认版本，可手动编译安装扩展：
在Dockerfile中添加：

# 安装编译依赖
RUN apt-get update && apt-get install -y php8.2-dev gcc make
# 编译并启用sockets扩展
RUN pecl install sockets && docker-php-ext-enable sockets

注：此方案需确保PHP版本与扩展兼容，优先推荐方案一。

3. 折叠代码片段的方法

在Markdown中使用<details>和<summary>标签实现代码折叠，格式示例：

<details>
<summary>点击展开/折叠内容</summary>

```bash
# 这里放置代码或文本内容

```

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

GitLab Runner所用PHP可执行文件与本地不符，php8.2-sockets扩展缺失求助

本地 #

Runner #

1. PHP路径差异与环境不一致的原因 #

2. 解决sockets扩展缺失的方法 #

方案一：调整PATH优先级，强制使用sury源的PHP #

方案二：为/usr/local/bin/php安装sockets扩展 #

3. 折叠代码片段的方法 #