action.yml

name: Setup PHP and Composer Dependencies
description: Setup PHP, install Composer dependencies when available, and expose a deterministic DevTools runtime.

inputs:
  php-version:
    description: PHP version passed to setup-php.
    required: true
  extensions:
    description: Comma-separated PHP extensions to enable.
    required: false
    default: ''
  coverage:
    description: Coverage driver passed to setup-php.
    required: false
    default: none
  cache-dir:
    description: Composer cache directory.
    required: false
    default: /tmp/composer-cache
  root-version:
    description: Value exported as COMPOSER_ROOT_VERSION during install.
    required: false
    default: ''
  install-options:
    description: Extra options passed to composer install.
    required: false
    default: --prefer-dist --no-progress --no-interaction --no-scripts
  safe-directories:
    description: Additional newline-separated directories to mark as safe for git.
    required: false
    default: ''
  dev-tools-source-directory:
    description: Checked-out DevTools workflow source used to resolve the fallback runtime when the consumer does not install DevTools locally.
    required: false
    default: .dev-tools-actions

outputs:
  dev-tools-binary:
    description: Absolute path to the resolved DevTools binary.
    value: ${{ steps.expose-dev-tools.outputs.binary }}
  dev-tools-autoload:
    description: Absolute path to the runtime autoload file used by packaged workflow helpers.
    value: ${{ steps.expose-dev-tools.outputs.autoload }}
  dev-tools-source:
    description: Runtime source selected for this job, either `local` or `workflow`.
    value: ${{ steps.expose-dev-tools.outputs.source }}

runs:
  using: composite
  steps:
    - name: Setup PHP
      uses: shivammathur/setup-php@v2
      with:
        php-version: ${{ inputs.php-version }}
        extensions: ${{ inputs.extensions }}
        coverage: ${{ inputs.coverage }}

    - name: Mark workspace as safe for git
      shell: bash
      env:
        INPUT_SAFE_DIRECTORIES: ${{ inputs.safe-directories }}
      run: |
        git config --global --add safe.directory "$GITHUB_WORKSPACE"

        if [ -n "${INPUT_SAFE_DIRECTORIES}" ]; then
          printf '%s\n' "${INPUT_SAFE_DIRECTORIES}" | while IFS= read -r directory; do
            if [ -n "${directory}" ]; then
              git config --global --add safe.directory "${directory}"
            fi
          done
        fi

    - name: Detect consumer Composer manifest
      id: consumer-composer
      shell: bash
      run: |
        if [ -f composer.json ]; then
          echo "present=true" >> "$GITHUB_OUTPUT"
        else
          echo "present=false" >> "$GITHUB_OUTPUT"
        fi

    - name: Install consumer dependencies
      if: steps.consumer-composer.outputs.present == 'true'
      uses: ramsey/composer-install@65e4f84970763564f46a70b8a54b90d033b3bdda # 4.0.0
      env:
        COMPOSER_AUTH: '{"github-oauth": {"github.com": "${{ github.token }}"} }'
        COMPOSER_CACHE_DIR: ${{ inputs.cache-dir }}
        COMPOSER_ROOT_VERSION: ${{ inputs.root-version }}
      with:
        composer-options: ${{ inputs.install-options }}

    - name: Resolve DevTools runtime source
      id: resolve-dev-tools
      shell: bash
      env:
        INPUT_DEV_TOOLS_SOURCE_DIRECTORY: ${{ inputs.dev-tools-source-directory }}
      run: ${{ github.action_path }}/detect-dev-tools-runtime.sh

    - name: Install fallback DevTools runtime
      if: steps.resolve-dev-tools.outputs.needs-fallback == 'true'
      uses: ramsey/composer-install@65e4f84970763564f46a70b8a54b90d033b3bdda # 4.0.0
      env:
        COMPOSER_AUTH: '{"github-oauth": {"github.com": "${{ github.token }}"} }'
        COMPOSER_CACHE_DIR: ${{ inputs.cache-dir }}
      with:
        working-directory: ${{ inputs.dev-tools-source-directory }}
        composer-options: --prefer-dist --no-plugins --no-scripts
        require-lock-file: 'true'
        custom-cache-suffix: dev-tools-runtime

    - name: Expose DevTools runtime
      id: expose-dev-tools
      shell: bash
      env:
        INPUT_DEV_TOOLS_SOURCE_DIRECTORY: ${{ inputs.dev-tools-source-directory }}
      run: ${{ github.action_path }}/expose-dev-tools-runtime.sh