已安装pdo_mysql为何php-actions/composer仍报错？如何修复？

可能的原因 #

• setup-php扩展配置不规范：比如扩展名拼写错误、参数格式错误（如未用引号包裹多扩展列表），导致pdo_mysql未实际安装。
• composer步骤未复用已配置的PHP环境：php-actions/composer@v6默认会自行初始化独立的PHP环境，忽略了之前setup-php配置好的带扩展的PHP版本。
• 缓存干扰：GitHub Actions的composer缓存或PHP环境缓存保留了旧状态，导致新安装的扩展未被加载。

修复方案 #

1. 修正setup-php的扩展配置 #

确保setup-php步骤中正确指定扩展，格式无误，可添加验证步骤确认扩展安装状态：

- name: Setup PHP 8.2
  uses: shivammathur/setup-php@v2
  with:
    php-version: '8.2'
    extensions: pdo_mysql, mbstring # 扩展名小写，用逗号分隔，确保pdo_mysql在列表内
    coverage: none

# 添加验证步骤，确认扩展已安装
- name: Verify pdo_mysql extension
  run: php -m | grep pdo_mysql

如果验证步骤输出pdo_mysql，说明扩展已成功安装，问题出在后续composer步骤。

2. 让composer步骤复用当前PHP环境 #

在php-actions/composer步骤中添加php-version: system参数，强制使用setup-php配置好的PHP环境：

- name: Install Composer dependencies
  uses: php-actions/composer@v6
  with:
    php-version: system # 关键：复用当前已配置的PHP环境
    args: install --no-progress --prefer-dist

3. 清理缓存排查问题 #

若缓存导致旧状态残留，可临时清理composer缓存或禁用缓存：

# 清理composer缓存
- name: Clear Composer cache
  run: composer clear-cache

# 或者在composer步骤中禁用缓存
- name: Install Composer dependencies
  uses: php-actions/composer@v6
  with:
    php-version: system
    cache: false
    args: install --no-progress --prefer-dist

完整工作流示例 #

name: PR Unit Tests
on:
  pull_request:
    branches: [ main ]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4

      - name: Setup PHP 8.2 with extensions
        uses: shivammathur/setup-php@v2
        with:
          php-version: '8.2'
          extensions: pdo_mysql, mbstring
          ini-values: post_max_size=256M
          coverage: none

      - name: Verify pdo_mysql installation
        run: php -m | grep pdo_mysql

      - name: Install dependencies
        uses: php-actions/composer@v6
        with:
          php-version: system
          args: install --no-progress --prefer-dist

      - name: Run unit tests
        run: php vendor/bin/phpunit

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