GitLab CI执行php artisan optimize报错：php命令未找到的解决方法

报错的核心原因是执行optimize_job的CI环境未安装PHP，以下是几种针对性的解决办法：

方法1：使用预装PHP的Docker镜像（推荐） #

GitLab CI默认使用的基础镜像通常不含PHP，直接指定带PHP的官方镜像或Laravel适配镜像即可：

stages:
  - pull
  - optimize

# 你的pull阶段配置
pull_job:
  stage: pull
  script:
    - echo "执行拉取操作..."

optimize_job:
  stage: optimize
  # 指定带PHP的CLI镜像，版本根据你的Laravel项目需求调整
  image: php:8.2-cli
  script:
    # 若项目需要Laravel扩展，先安装（可选）
    - apt-get update && apt-get install -y git unzip
    - docker-php-ext-install mbstring pdo_mysql
    # 执行缓存清理命令
    - php artisan optimize
  # 依赖pull阶段完成后再执行
  needs: ["pull_job"]

如果你的项目依赖Composer，也可以直接使用composer镜像（内置PHP和Composer）：

optimize_job:
  stage: optimize
  image: composer:latest
  script:
    - php artisan optimize
  needs: ["pull_job"]

方法2：在Shell执行器的Runner服务器上安装PHP #

如果你的GitLab Runner使用的是shell执行器（而非Docker），直接在Runner所在服务器安装PHP及必要扩展：

Ubuntu/Debian系统 #

sudo apt update && sudo apt install -y php-cli php-mbstring php-xml php-zip

CentOS/RHEL系统 #

sudo dnf install -y php-cli php-mbstring php-xml php-zip

安装完成后，验证php命令是否可用：

php -v

方法3：复用Pull阶段的PHP环境 #

如果你的pull_job已经使用了带PHP的镜像，可以让optimize_job复用该镜像，减少重复配置：

optimize_job:
  stage: optimize
  # 直接使用pull_job的镜像
  image: $CI_JOB_IMAGE
  script:
    - php artisan optimize
  needs: ["pull_job"]

额外注意事项 #

• 确保optimize_job的工作目录是Laravel项目根目录，否则需要先切换目录（比如cd /path/to/laravel）
• 若项目依赖特定PHP版本，务必选择对应版本的镜像（如php:8.1-cli对应PHP 8.1）

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