GitLab CI中docker-php-ext-install命令找不到的解决咨询

问题描述 #

我正在深入学习GitLab CI、Docker和PHP。在GitLab CI脚本执行过程中遇到了命令失败的问题，相关脚本如下：

deploy_to_dev:
  stage: deploy
  image: php:5.6
  allow_failure: true
  tags:
  - arc
  variables:
    PWS_IP: 'x.x.x.x'
  before_script:
  - sudo apt-get update && sudo apt-get install -y libxml2-dev git
  - docker-php-ext-install soap
  script:
  - git config --global http.sslVerify false
  - git diff --name-only origin/DEV | xargs php ./scripts/pws_loadgroovy.php
  only:
   refs:
   - DEV
   variables:
   - $CI_PROJECT_ID == "71"

执行命令docker-php-ext-install soap时，出现错误：bash: line 106: docker-php-ext-install: command not found。我无法确定该命令是在Ubuntu还是php:5.6环境中运行，从apt-get update命令来看似乎是在Ubuntu环境，但不确定docker-php-ext-install命令是否应该在Ubuntu shell中执行，请问该如何解决这个问题？

解决方案 #

1. 明确执行环境 #

你的CI任务指定了image: php:5.6，正常应该在PHP官方镜像的容器内执行命令，但报错说明实际执行环境不对——大概率是你标记为arc的GitLab Runner配置成了shell executor（直接在宿主机Ubuntu系统跑命令），而非docker executor。

2. 容器内环境的修复 #

如果Runner确实是docker executor但仍报错，可直接使用docker-php-ext-install的绝对路径执行，PHP官方镜像中该脚本的固定路径是/usr/local/bin/：

/usr/local/bin/docker-php-ext-install soap

3. 宿主机Ubuntu环境的处理 #

如果Runner是shell executor（命令直接跑在宿主机），此时没有docker-php-ext-install命令，需改用Ubuntu系统的PHP扩展安装方式：

sudo apt-get install -y php5.6-soap

不过更推荐调整Runner为docker executor，这样能保证CI环境的一致性，符合持续集成的最佳实践。

4. 验证当前执行环境 #

可以在before_script中添加以下命令，快速确认当前运行环境：

# 查看系统版本信息
cat /etc/os-release
# 检查docker-php-ext-install是否存在
which docker-php-ext-install

根据输出就能明确是在容器内还是宿主机执行。

内容的提问来源于stack exchange，提问作者IT-Biscuit