Bump version to 2.37.2

Update Node.js dependencies

.eslintrc.json

@@ -1,23 +0,0 @@
-{
-  "env": { "node": true, "jest": true },
-  "parser": "@typescript-eslint/parser",
-  "parserOptions": { "ecmaVersion": 2020, "sourceType": "module" },
-  "extends": [
-    "eslint:recommended",
-    "plugin:@typescript-eslint/eslint-recommended",
-    "plugin:@typescript-eslint/recommended",
-    "plugin:import/errors",
-    "plugin:import/warnings",
-    "plugin:import/typescript",
-    "plugin:prettier/recommended",
-    "prettier/@typescript-eslint"
-  ],
-  "plugins": ["@typescript-eslint", "jest"],
-  "rules": {
-    "camelcase": "off",
-    "require-atomic-updates": "off",
-    "@typescript-eslint/ban-ts-ignore": "off",
-    "@typescript-eslint/camelcase": "off",
-    "@typescript-eslint/no-unused-vars": "off"
-  }
-}

.github/CODEOWNERS

@@ -0,0 +1 @@
+* @shivammathur

.github/CONTRIBUTING.md

@@ -1,63 +1,83 @@
 # Contributing to setup-php
 
+## Welcome!
+
+We look forward to your contributions! Here are some examples how you can contribute:
+
+* [Ask any questions you may have](https://github.com/shivammathur/setup-php/discussions/new?category=Q-A-Help)
+* [Report a bug](https://github.com/shivammathur/setup-php/issues/new?labels=type/bug&template=bug.md)
+* [Propose a new feature](https://github.com/shivammathur/setup-php/issues/new?labels=enhancement&template=feature.md)
+* [Send a pull request](https://github.com/shivammathur/setup-php/pulls)
+
 ## Contributor Code of Conduct
 
 Please note that this project is released with a [Contributor Code of Conduct](CODE_OF_CONDUCT.md). By participating in this project you agree to abide by its terms.
 
-## Workflow
+## Getting Started
 
-* Fork the project.
+To get started fork `setup-php` and clone it using git:
+
+```bash
+git clone https://github.com/<your-username>/setup-php.git
+
+cd setup-php
+```
+
+If you are using `Windows` configure `git` to handle line endings.
+
+```cmd
+git config --local core.autocrlf true
+```
+
+Install `setup-php` dependencies using [npm](https://www.npmjs.com/):
+
+```bash
+npm install
+```
+
+## Workflow to create Pull Requests
+
+* Fork the `setup-php` project and clone it.
+* Create a new branch from the develop branch.
 * Make your bug fix or feature addition.
-* Add tests for it. This is important so we don't break it in a future version unintentionally.
-* Send a pull request to the develop branch.
+* Add tests for it, so we don't break it in a future version unintentionally.
+* Ensure the test suite passes and the code complies with our coding guidelines (see below).
+* Send a pull request to the develop branch with all the details.
+* If possible, create a GitHub Actions workflow with an integration test for the change in a demo repository and link it in your pull request.
 
 Please make sure that you have [set up your user name and email address](https://git-scm.com/book/en/v2/Getting-Started-First-Time-Git-Setup) for use with Git. Strings such as `silly nick name <root@localhost>` look really stupid in the commit history of a project.
 
-Due to time constraints, you may not always get a quick response. Please do not take delays personal and feel free to remind.
+Due to time constraints, you may not always get a quick response. Please do not take delays personally and feel free to remind.
 
 ## Coding Guidelines
 
-This project comes with `.prettierrc.json` and `eslintrc.json` configuration files. Please run the following commands to format the code before committing it.
+This project comes with `.prettierrc.json` and `eslintrc.json` configuration files. Please run the following commands to fix and verify the code quality.
 
 ```bash
-$ npm run format
-$ npm run lint
+npm run format
+npm run lint
 ```
 
-## Using setup-php from a Git checkout
-
-The following commands can be used to perform the initial checkout of setup-php:
-
-```bash
-$ git clone https://github.com/shivammathur/setup-php.git
-
-$ cd setup-php
-```
-
-Install setup-php dependencies using [npm](https://www.npmjs.com/):
-
-```bash
-$ npm install
-```
-
-## Running the test suite
+### Running the test suite
 
 After following the steps shown above, The `setup-php` tests in the `__tests__` directory can be run using this command:
 
 ```bash
-$ npm test
+npm test
 ```
 
-## Creating a release
+### Creating a release
 
-Create a release before you push your changes.
+Creating a release means compiling all the TypeScript code to a single file which `setup-php` can run. Run this, before you push your changes.
 
 ```bash
-$ npm run release
+npm run build
+npm run release
 ```
 
-## Reporting issues
+### Reporting issues and discussions
 
-Please submit the issue using the appropriate template provided for a bug report or a feature request:
+For questions or support, we prefer GitHub Discussions. For any bugs or new features you can create an issue using the appropriate template:
 
-* [Issues](https://github.com/shivammathur/setup-php/issues)
+* [Discussions](https://github.com/shivammathur/setup-php/discussions)
+* [Issues](https://github.com/shivammathur/setup-php/issues)

.github/FUNDING.yml

@@ -1,8 +1,4 @@
 # These are supported funding model platforms
 
 github: shivammathur
-community_bridge: setup-php
-issuehunt: shivammathur
-patreon: shivammathur
-liberapay: shivammathur
-custom: https://www.paypal.me/shivammathur
+open_collective: setup-php

.github/ISSUE_TEMPLATE/bug.yml

@@ -0,0 +1,94 @@
+name: Bug report
+description: Nice, you found a bug!
+title: "Bug: "
+labels: ["bug"]
+assignees: ["shivammathur"]
+body:
+  - type: markdown
+    attributes:
+      value: "Please fill out the sections below to help us address your issue."
+
+  - type: textarea
+    id: bug-description
+    attributes:
+      label: "Describe the bug"
+      placeholder: "Please describe the bug concisely."
+    validations:
+      required: true
+
+  - type: checkboxes
+    id: version
+    attributes:
+      label: "Version"
+      description: "I have checked releases, and the bug exists in the latest patch version of `v1` or `v2`."
+      options:
+        - label: "v2"
+        - label: "v1"
+    validations:
+      required: true
+
+  - type: dropdown
+    id: runners
+    attributes:
+      label: "Runners"
+      description: "Please choose the GitHub Action runner your workflow uses."
+      options:
+        - "GitHub Hosted"
+        - "Self Hosted"
+    validations:
+      required: true
+
+  - type: textarea
+    id: operating-systems
+    attributes:
+      label: "Operating systems"
+      placeholder: "e.g., Ubuntu 22.04, Windows Server 2022, etc."
+    validations:
+      required: true
+
+  - type: textarea
+    id: php-versions
+    attributes:
+      label: "PHP versions"
+      placeholder: "e.g., PHP 7.4, PHP 8.0, etc."
+    validations:
+      required: true
+
+  - type: textarea
+    id: steps-to-reproduce
+    attributes:
+      label: "To Reproduce"
+      placeholder: "Please provide the relevant steps of your workflow `.yml` file."
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected-behavior
+    attributes:
+      label: "Expected behavior"
+      placeholder: "A clear and concise description of what you expected to happen."
+    validations:
+      required: true
+
+  - type: textarea
+    id: screenshots-logs
+    attributes:
+      label: "Screenshots/Logs"
+      placeholder: "Drag and drop images or paste logs here..."
+
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: "Additional context"
+      placeholder: "Add any other context about the problem here."
+
+  - type: dropdown
+    id: willing-to-submit-pr
+    attributes:
+      label: "Are you willing to submit a PR?"
+      description: "We accept pull requests targeting the develop branch."
+      options:
+        - "Yes"
+        - "No"
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,23 +0,0 @@
----
-name: Bug report
-about: Create a report to help us improve
-title: ''
-labels: ''
-assignees: ''
-
----
-
-**Describe the bug**
-A clear and concise description of what the bug is.
-
-**To Reproduce**
-Please provide the GitHub Action `.yml` file.
-
-**Expected behavior**
-A clear and concise description of what you expected to happen.
-
-**Screenshots**
-If applicable, add screenshots to help explain your problem.
-
-**Additional context**
-Add any other context about the problem here.

.github/ISSUE_TEMPLATE/feature.yml

@@ -0,0 +1,58 @@
+name: Feature request
+description: Suggest a new feature
+title: "Feature: "
+labels: ["enhancement"]
+assignees: ["shivammathur"]
+body:
+  - type: markdown
+    attributes:
+      value: "Please fill out the sections below to help us understand your new feature proposal."
+
+  - type: textarea
+    id: feature-description
+    attributes:
+      label: "Describe the feature"
+      placeholder: "A clear and concise description of what you want and why."
+    validations:
+      required: true
+
+  - type: checkboxes
+    id: version-check
+    attributes:
+      label: "Please check the latest release"
+      options:
+        - label: "I have checked releases, and the feature is missing in the latest patch version of `v2`."
+          required: true
+
+  - type: textarea
+    id: underlying-issue
+    attributes:
+      label: "Underlying issue"
+      placeholder: "Please describe the issue this would solve."
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: "Describe alternatives"
+      placeholder: "Please mention any alternative solutions you've considered."
+    validations:
+      required: false
+
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: "Additional context"
+      placeholder: "Drag and drop images or paste any additional information here..."
+
+  - type: dropdown
+    id: willing-to-submit-pr
+    attributes:
+      label: "Are you willing to submit a PR?"
+      description: "We accept pull requests targeting the develop branch."
+      options:
+        - "Yes"
+        - "No"
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/feature_request.md

@@ -1,20 +0,0 @@
----
-name: Feature request
-about: Suggest an idea for this project
-title: ''
-labels: ''
-assignees: ''
-
----
-
-**Is your feature request related to a problem? Please describe.**
-A clear and concise description of what the problem is. Ex. I want to improve [...]
-
-**Describe the solution you'd like**
-A clear and concise description of what you want to happen.
-
-**Describe alternatives you've considered**
-A clear and concise description of any alternative solutions or features you've considered.
-
-**Additional context**
-Add any other context or screenshots about the feature request here.

.github/PULL_REQUEST_TEMPLATE.md

@@ -5,16 +5,15 @@ labels: bug or enhancement
 
 ---
 
-## A Pull Request should be associated with an Issue.
+## A Pull Request should be associated with a Discussion.
 
-> We wish to have discussions in Issues. A single issue may be targeted by multiple PRs.
-> If you're offering a new feature or fixing anything, we'd like to know beforehand in Issues,
-> and potentially we'll be able to point development in a particular direction.
+> If you're fixing a bug, adding a new feature or improving something please provide the details in discussions,
+> so that the development can be pointed in the intended direction.
 
-Related issue: 
+Related discussion: <!-- Please link the related discussion -->
 
 > Further notes in [Contribution Guidelines](.github/CONTRIBUTING.md)
-> Thank you! We are open to PRs, but please understand if for technical reasons we are unable to accept each and any PR
+> Thank you for your contribution.
 
 ### Description
 
@@ -26,7 +25,12 @@ This PR [briefly explain what it does]
 - [ ] I have run `npm run format` before the commit.
 - [ ] I have run `npm run lint` before the commit.
 - [ ] I have run `npm run release` before the commit.
-- [ ] `npm test` returns with no unit test errors.
+- [ ] `npm test` returns with no unit test errors and all code covered.
+
+> In case this PR edits any scripts:
+
+- [ ] I have checked the edited scripts for syntax.
+- [ ] I have tested the changes in an integration test (If yes, provide workflow YAML and link).
 
 <!--
 - Please target the develop branch when submitting the pull request.

.github/PULL_REQUEST_TEMPLATE/FIX.md

@@ -1,33 +0,0 @@
----
-name: 🐞 Bug Fix
-about: You have a fix for a bug?
-labels: bug
-
----
-
-## A Pull Request should be associated with an Issue.
-
-> We wish to have discussions in Issues. A single issue may be targeted by multiple PRs.
-> If you're offering a new feature or fixing anything, we'd like to know beforehand in Issues,
-> and potentially we'll be able to point development in a particular direction.
-
-Related issue: 
-
-> Further notes in [Contribution Guidelines](.github/CONTRIBUTING.md)
-> Thank you! We are open to PRs, but please understand if for technical reasons we are unable to accept each and any PR
-
-### Description
-
-This PR [briefly explain what it does]
-
-> In case this PR introduced TypeScript/JavaScript code changes:
-
-- [ ] I have written test cases for the changes in this pull request.
-- [ ] I have run `npm run format` before the commit.
-- [ ] I have run `npm run lint` before the commit.
-- [ ] I have run `npm run release` before the commit.
-- [ ] `npm test` returns with no unit test errors.
-
-<!--
-- Please target the develop branch when submitting the pull request.
--->

.github/PULL_REQUEST_TEMPLATE/IMPROVEMENT.md

@@ -1,33 +0,0 @@
----
-name: ⚙ Improvement
-about: You have some improvement to make setup-php better?
-labels: enhancement
-
----
-
-## A Pull Request should be associated with an Issue.
-
-> We wish to have discussions in Issues. A single issue may be targeted by multiple PRs.
-> If you're offering a new feature or fixing anything, we'd like to know beforehand in Issues,
-> and potentially we'll be able to point development in a particular direction.
-
-Related issue: 
-
-> Further notes in [Contribution Guidelines](.github/CONTRIBUTING.md)
-> Thank you! We are open to PRs, but please understand if for technical reasons we are unable to accept each and any PR
-
-### Description
-
-This PR [briefly explain what it does]
-
-> In case this PR introduced TypeScript/JavaScript code changes:
-
-- [ ] I have written test cases for the changes in this pull request.
-- [ ] I have run `npm run format` before the commit.
-- [ ] I have run `npm run lint` before the commit.
-- [ ] I have run `npm run release` before the commit.
-- [ ] `npm test` returns with no unit test errors.
-
-<!--
-- Please target the develop branch when submitting the pull request.
--->

.github/PULL_REQUEST_TEMPLATE/NEW_FEATURE.md

@@ -1,33 +0,0 @@
----
-name: 🎉 New Feature
-about: You have implemented some neat idea that you want to make part of setup-php?
-labels: enhancement
-
----
-
-## A Pull Request should be associated with an Issue.
-
-> We wish to have discussions in Issues. A single issue may be targeted by multiple PRs.
-> If you're offering a new feature or fixing anything, we'd like to know beforehand in Issues,
-> and potentially we'll be able to point development in a particular direction.
-
-Related issue: 
-
-> Further notes in [Contribution Guidelines](.github/CONTRIBUTING.md)
-> Thank you! We are open to PRs, but please understand if for technical reasons we are unable to accept each and any PR
-
-### Description
-
-This PR [briefly explain what it does]
-
-> In case this PR introduced TypeScript/JavaScript code changes:
-
-- [ ] I have written test cases for the changes in this pull request.
-- [ ] I have run `npm run format` before the commit.
-- [ ] I have run `npm run lint` before the commit.
-- [ ] I have run `npm run release` before the commit.
-- [ ] `npm test` returns with no unit test errors.
-
-<!--
-- Please target the develop branch when submitting the pull request.
--->

.github/SECURITY.md

@@ -0,0 +1,21 @@
+# Security Policy
+
+## Supported Versions
+
+The latest patch version of `v2` release of this project is supported for security updates.
+
+## Supported PHP Versions
+
+This security policy only applies to the latest patch releases of the following PHP versions.
+
+| Version | Supported          |
+|---------|--------------------|
+| 8.2     | :white_check_mark: |
+| 8.3     | :white_check_mark: |
+| 8.4     | :white_check_mark: |
+| 8.5     | :white_check_mark: |
+
+## Reporting a Vulnerability
+
+If you have found any issues that might have security implications in the versions supported, please send a report privately to [contact@setup-php.com](mailto:contact@setup-php.com).
+Do not report security reports publicly.

.github/codeql/codeql-configuration.yml

@@ -0,0 +1,4 @@
+name : CodeQL Configuration
+
+paths:
+  - './src'

.github/dependabot.yml

@@ -0,0 +1,13 @@
+version: 2
+updates:
+  - package-ecosystem: 'github-actions'
+    directory: '/'
+    target-branch: 'develop'
+    schedule:
+      interval: 'weekly'
+    groups:
+      github-actions:
+        patterns:
+          - '*'
+    cooldown:
+      default-days: 7

.github/workflows/codeql.yml

@@ -0,0 +1,38 @@
+name: CodeQL Workflow
+on:
+  workflow_dispatch:
+  schedule:
+    - cron: '0 15 * * 6'
+permissions:
+  contents: read
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  codeql:
+    name: CodeQL Analysis
+    if: github.event.repository.fork == false
+    permissions:
+      actions: read  # for github/codeql-action/init to get workflow details
+      contents: read  # for actions/checkout to fetch code
+      security-events: write  # for github/codeql-action/autobuild to send a status report
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+        with:
+          fetch-depth: 2
+          persist-credentials: false
+
+      - name: Initialize CodeQL
+        uses: github/codeql-action/init@7211b7c8077ea37d8641b6271f6a365a22a5fbfa # v4
+        with:
+          config-file: ./.github/codeql/codeql-configuration.yml
+          languages: javascript
+
+      - name: Autobuild
+        uses: github/codeql-action/autobuild@7211b7c8077ea37d8641b6271f6a365a22a5fbfa # v4
+
+      - name: Perform CodeQL Analysis
+        uses: github/codeql-action/analyze@7211b7c8077ea37d8641b6271f6a365a22a5fbfa # v4

.github/workflows/docs.yml

@@ -0,0 +1,148 @@
+name: Docs workflow
+on:
+  workflow_dispatch:
+  schedule:
+    - cron: '0 15 * * 6'
+permissions:
+  contents: read
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  create:
+    if: github.event.repository.fork == false
+    permissions:
+      contents: none # this job only prepares artifacts and uploads them, no repository writes
+    name: Create
+    runs-on: ${{ matrix.operating-system }}
+    strategy:
+      fail-fast: false
+      matrix:
+        operating-system: [ubuntu-24.04, ubuntu-22.04, windows-2022, macos-15-intel]
+        php-versions: ['5.3', '5.4', '5.5', '5.6', '7.0', '7.1', '7.2', '7.3', '7.4', '8.0', '8.1', '8.2', '8.3', '8.4', '8.5', '8.6']
+    steps:
+      - name: Setup PHP
+        uses: shivammathur/setup-php@7c071dfe9dc99bdf297fa79cb49ea005b9fcadbc # v2
+        with:
+          php-version: ${{ matrix.php-versions }}
+          tools: none
+      - name: Create file with all extensions for Linux and macOS
+        env:
+          file: php${{ matrix.php-versions }}-${{ matrix.operating-system }}.md
+          version: ${{ matrix.php-versions }}
+        if: matrix.operating-system != 'windows-2022'
+        run: |
+          php -m >> "$file.all"
+      - name: Create file with all extensions for Windows
+        env:
+          file: php${{ matrix.php-versions }}-${{ matrix.operating-system }}.md
+          version: ${{ matrix.php-versions }}
+        if: matrix.operating-system == 'windows-2022'
+        run: |
+          php -m | Out-File -FilePath "$env:file.all" -Append
+      - name: Setup PHP
+        uses: shivammathur/setup-php@7c071dfe9dc99bdf297fa79cb49ea005b9fcadbc # v2
+        with:
+          php-version: ${{ matrix.php-versions }}
+          extensions: none
+          tools: none
+      - name: Create final file for Linux and macOS
+        env:
+          file: php${{ matrix.php-versions }}-${{ matrix.operating-system }}.md
+          version: ${{ matrix.php-versions }}
+        if: matrix.operating-system != 'windows-2022'
+        run: |
+          echo "## PHP $version" >> "$file"
+          printf "\n" >> "$file"
+          echo "\`\`\`" >> "$file"
+          php -m >> "$file.builtin"
+          while IFS= read -r line; do
+            if [[ $line == [* || -z "${line// }" ]]; then
+              echo "$line" >> "$file"
+            elif grep -q "^$line" "$file.builtin"; then
+              echo "$line (builtin)" >> "$file"
+            else
+              echo "$line (shared)" >> "$file"
+            fi
+          done < "$file.all"
+          echo "\`\`\`" >> "$file"
+          printf "\n" >> "$file"
+          rm "$file.all" "$file.builtin"
+      - name: Create final file for Windows
+        env:
+          file: php${{ matrix.php-versions }}-${{ matrix.operating-system }}.md
+          version: ${{ matrix.php-versions }}
+        if: matrix.operating-system == 'windows-2022'
+        run: |
+          Write-Output "## PHP $env:version`n" | Out-File -FilePath "$env:file"
+          Write-Output "``````" | Out-File -FilePath "$env:file" -Append
+          php -m | Out-File -FilePath "$env:file.builtin" -Append
+          Get-Content "$env:file.all" | ForEach-Object {
+              if ($_.startsWith('[') -or -not $_.trim()) {
+                Write-Output "$_" | Out-File -FilePath "$env:file" -Append
+              } elseif ($_ -in (Get-Content "$env:file.builtin")) {
+                Write-Output "$_ (builtin)" | Out-File -FilePath "$env:file" -Append
+              } else {
+                Write-Output "$_ (shared)" | Out-File -FilePath "$env:file" -Append
+              }
+          }
+          Write-Output "```````n" | Out-File -FilePath "$env:file" -Append
+          Remove-Item "$env:file.all" -Force
+          Remove-Item "$env:file.builtin" -Force
+      - name: Upload artifacts
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
+        with:
+          name: lists-php${{ matrix.php-versions }}-${{ matrix.operating-system }}.md
+          path: php${{ matrix.php-versions }}-${{ matrix.operating-system }}.md
+  update:
+    if: github.event.repository.fork == false
+    permissions:
+      contents: write  # for Git to git push
+    name: Update
+    needs: create
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+        with:
+          repository: ${{ github.repository }}.wiki
+          persist-credentials: false
+      - name: Download artifacts
+        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8
+        with:
+          path: ${{ github.workspace }}/lists
+          pattern: lists-*
+          merge-multiple: true
+      - name: Configure Git
+        env:
+          GIT_USER_EMAIL: 41898282+github-actions[bot]@users.noreply.github.com
+          GIT_USER_NAME: github-actions[bot]
+        run : |
+          git config --local user.email "$GIT_USER_EMAIL"
+          git config --local user.name "$GIT_USER_NAME"
+      - name: Combine
+        run: |
+          for os in ubuntu-24.04 ubuntu-22.04 windows-2025 windows-2022 windows-2019 macos-13 macos-14 macos-15 macos-26; do
+            echo "These are extensions which are loaded by default on the following PHP versions. More extensions which are available as packages and available on pecl are supported by setup-php. Refer to [php extension support](https://github.com/shivammathur/setup-php#heavy_plus_sign-php-extension-support) for more details." > Php-extensions-loaded-on-"$os".md
+            for version in 5.3 5.4 5.5 5.6 7.0 7.1 7.2 7.3 7.4 8.0 8.1 8.2 8.3 8.4 8.5 8.6; do
+              if [[ "${os%-*}" = "macos" ]]; then
+                cat lists/php"$version"-macos-15-intel.md >> Php-extensions-loaded-on-"$os".md
+              elif [ "${os%-*}" = "windows" ]; then
+                cat lists/php"$version"-windows-2022.md >> Php-extensions-loaded-on-"$os".md
+              else
+                cat lists/php"$version"-"$os".md >> Php-extensions-loaded-on-"$os".md
+              fi
+            done
+          done
+          rm -rf ./lists
+      - name: Update
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          WIKI_REPOSITORY: ${{ github.repository }}
+        run: |
+          if [ "$(git status --porcelain=v1 2>/dev/null | wc -l)" != "0" ]; then
+            git add .
+            git commit -m "Update PHP extensions on wiki - $(date +'%d-%m-%y')"
+            git push -f https://x-access-token:${GITHUB_TOKEN}@github.com/${WIKI_REPOSITORY}.wiki.git master || true
+          fi

.github/workflows/node.yml

@@ -0,0 +1,68 @@
+name: Node workflow
+on:
+  pull_request:
+    branches:
+      - main
+      - develop
+      - verbose
+    paths-ignore:
+      - '**.md'
+      - 'examples/**'
+  push:
+    branches:
+      - main
+      - develop
+      - verbose
+    paths-ignore:
+      - '**.md'
+      - 'examples/**'
+permissions:
+  contents: read
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  run:
+    name: Run
+    environment: codecov
+    runs-on: ${{ matrix.operating-system }}
+    strategy:
+      fail-fast: false
+      matrix:
+        operating-system: [ubuntu-latest, windows-latest, macos-latest]
+    steps:
+      - name: Checkout
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+        with:
+          fetch-depth: 2
+          persist-credentials: false
+
+      - name: Setup Node.js 24.x
+        uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
+        with:
+          node-version: 24.x
+
+      - name: Install dependencies
+        run: npm install
+
+      - name: Prettier Format Check
+        run: npm run format-check
+
+      - name: ESLint Check
+        run: npm run lint
+
+      - name: Run tests
+        run: npm test
+
+      - name: Run npm audit
+        run: npm audit
+
+      - name: Send Coverage
+        uses: codecov/codecov-action@e79a6962e0d4c0c17b229090214935d2e33f8354 # v6
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          files: coverage/lcov.info
+          name: github-actions-codecov-${{ matrix.operating-system }}
+          fail_ci_if_error: false
+          verbose: true

.github/workflows/php.yml

@@ -0,0 +1,102 @@
+name: Main workflow
+on:
+  workflow_dispatch:
+  pull_request:
+    branches:
+      - main
+      - develop
+      - verbose
+    paths-ignore:
+      - '**.md'
+      - 'examples/**'
+  push:
+    branches:
+      - main
+      - develop
+      - verbose
+    paths-ignore:
+      - '**.md'
+      - 'examples/**'
+permissions:
+  contents: read
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+env:
+  default-php-version: '8.5'
+jobs:
+  run:
+    name: Run
+    runs-on: ${{ matrix.operating-system }}
+    strategy:
+      fail-fast: false
+      matrix:
+        operating-system: [ubuntu-24.04, ubuntu-22.04, windows-2022, macos-15-intel]
+        php-versions: ['5.3', '5.4', '5.5', '5.6', '7.0', '7.1', '7.2', '7.3', '7.4', '8.0', '8.1', '8.2', '8.3', '8.4', '8.5', '8.6']
+        include:
+          - operating-system: ubuntu-24.04
+            php-versions: ''
+            php-version-file: 'php-version-file'
+    env:
+      extensions: xml, opcache, xdebug, pcov, gd
+      key: cache-v5
+    steps:
+      - name: Checkout
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+        with:
+          persist-credentials: false
+
+      - name: Setup cache environment
+        id: cache-env
+        uses: shivammathur/cache-extensions@256729b5fef535345e27904657f78048c0990f81 # v1
+        with:
+          php-version: ${{ matrix.php-versions || env.default-php-version }}
+          extensions: ${{ env.extensions }}
+          key: ${{ env.key }}
+
+      - name: Cache extensions
+        uses: actions/cache@27d5ce7f107fe9357f9df03efb73ab90386fccae # v5
+        with:
+          path: ${{ steps.cache-env.outputs.dir }}
+          key: ${{ steps.cache-env.outputs.key }}
+          restore-keys: ${{ steps.cache-env.outputs.key }}
+
+      - name: Stage php-version-file
+        if: ${{ matrix.php-version-file == 'php-version-file' }}
+        env:
+          DEFAULT_PHP_VERSION: ${{ env.default-php-version }}
+        run: |
+          echo "$DEFAULT_PHP_VERSION" > php-version-file
+
+      - name: Setup PHP with extensions and custom config
+        run: node dist/index.js
+        env:
+          php-version: ${{ matrix.php-versions }}
+          php-version-file: ${{ matrix.php-version-file }}
+          extensions: ${{ env.extensions }}
+          ini-values: post_max_size=256M, short_open_tag=On, date.timezone=Asia/Kolkata
+
+      - name: Testing PHP version
+        env:
+          EXPECTED_PHP_VERSION: ${{ matrix.php-versions || env.default-php-version }}
+        run: |
+          php -v
+          php -r '$expected = getenv("EXPECTED_PHP_VERSION"); if(strpos(phpversion(), $expected) === false) {throw new Exception("Wrong PHP version Installed");}'
+
+      - name: Testing Composer version
+        run: |
+          composer -V
+          php -r "if(strpos(@exec('composer -V'), 'Composer version') === false) {throw new Exception('Composer not found');}"
+      - name: Testing Extensions
+        run: |
+          php -m
+          php -r "if(! extension_loaded('gd')) {throw new Exception('gd not found');}"
+          php -r "if(! extension_loaded('xml')) {throw new Exception('xml not found');}"
+          php -r "if(! extension_loaded('Xdebug')) {throw new Exception('Xdebug not found');}"
+          php -r "if(phpversion()>=7.1 && ! extension_loaded('pcov')) {throw new Exception('PCOV not found');}"
+      - name: Testing ini values
+        run: |
+          php -r "if(ini_get('memory_limit')!='-1') {throw new Exception('memory_limit not disabled');}"
+          php -r "if(ini_get('post_max_size')!='256M') {throw new Exception('post_max_size not added');}"
+          php -r "if(ini_get('short_open_tag')!=1) {throw new Exception('short_open_tag not added');}"
+          php -r "if(ini_get('date.timezone')!='Asia/Kolkata') {throw new Exception('date.timezone not added');}"

.github/workflows/publish.yml

@@ -0,0 +1,72 @@
+name: Publish Package
+on:
+  release:
+    types: [created]
+  workflow_dispatch:
+    inputs:
+      skip:
+        description: Skip release to repository
+        required: false
+      tag:
+        description: Tag name
+        required: true
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: false
+permissions:
+  contents: read
+jobs:
+  build:
+    name: Build and Publish
+    permissions:
+      contents: read # for actions/checkout
+      packages: write # For publishing to GitHub Packages
+      id-token: write # For authentication with npm registry
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout release
+        if: github.event_name != 'workflow_dispatch'
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+        with:
+          persist-credentials: false
+
+      - name: Checkout tag
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+        if: github.event_name == 'workflow_dispatch'
+        with:
+          ref: ${{ github.event.inputs.tag }}
+          persist-credentials: false
+
+      - name: Setup Node.js
+        uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
+        with:
+          node-version: '24.x'
+          registry-url: https://registry.npmjs.org
+          package-manager-cache: false
+
+      - name: Install dependencies and add lib
+        run: |
+          npm install
+          npm run build
+          sed -i -e '/lib\//d' .gitignore
+
+      - name: Publish to NPM
+        if: "!contains(github.event.inputs.skip, 'skip-npm')"
+        run: npm publish --access public
+
+      - name: Change to GitHub Packages registry
+        uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
+        with:
+          registry-url: https://npm.pkg.github.com
+          package-manager-cache: false
+          scope: '@shivammathur'
+
+      - name: Patch package.json
+        run: |
+          sed -i 's#"name": "#"name": "@shivammathur/#' package.json
+
+      - name: Publish to GitHub Packages
+        if: "!contains(github.event.inputs.skip, 'skip-github-packages')"
+        run: npm publish
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/workflow.yml

@@ -1,82 +0,0 @@
-name: Main workflow
-on:
-  pull_request:
-    branches:
-      - master
-      - develop
-      - verbose
-    paths-ignore:
-      - '**.md'
-      - 'examples/**'
-  push:
-    branches:
-      - master
-      - develop
-      - verbose
-    paths-ignore:
-      - '**.md'
-      - 'examples/**'
-jobs:
-  run:
-    name: Run
-    runs-on: ${{ matrix.operating-system }}
-    strategy:
-      fail-fast: false
-      matrix:
-        operating-system: [ubuntu-latest, windows-latest, macOS-latest]
-        php-versions: ['5.6', '7.0', '7.1', '7.2', '7.3', '7.4']
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v1
-        with:
-          fetch-depth: 1
-
-      - name: Setup Node.js 12.x
-        uses: actions/setup-node@v1
-        with:
-          node-version: 12.x
-
-      - name: Install dependencies
-        run: npm install
-
-      - name: Prettier Format Check
-        run: npm run format-check
-
-      - name: ESLint Check
-        run: npm run lint
-
-      - name: Run tests
-        run: npm test
-
-      - name: Send Coverage
-        continue-on-error: true
-        timeout-minutes: 1
-        run: curl -s https://codecov.io/bash | bash -s -- -t ${{secrets.CODECOV_TOKEN}} -f coverage/clover.xml -n github-actions-codecov-${{ matrix.operating-system }}-php${{ matrix.php-versions }}
-
-      - name: Setup PHP with extensions and custom config
-        run: node dist/index.js
-        env:
-          php-version: ${{ matrix.php-versions }}
-          extension-csv: mbstring, xdebug, pcov #optional
-          ini-values-csv: post_max_size=256M, short_open_tag=On, date.timezone=Asia/Kolkata #optional
-
-      - name: Testing PHP version
-        run: |
-          php -v
-          php -r "if(strpos(phpversion(), '${{ matrix.php-versions }}') === false) {throw new Exception('Wrong PHP version Installed');}"
-
-      - name: Testing Composer version
-        run: |
-          composer -V
-          php -r "if(strpos(@exec('composer -V'), 'Composer version') === false) {throw new Exception('Composer not found');}"
-      - name: Testing Extensions
-        run: |
-          php -m
-          php -r "if(! extension_loaded('mbstring')) {throw new Exception('mbstring not found');}"
-          php -r "if(! extension_loaded('Xdebug')) {throw new Exception('Xdebug not found');}"
-          php -r "if(phpversion()>=7.1 && ! extension_loaded('pcov')) {throw new Exception('PCOV not found');}"
-      - name: Testing ini values
-        run: |
-          php -r "if(ini_get('post_max_size')!='256M') {throw new Exception('post_max_size not added');}"
-          php -r "if(ini_get('short_open_tag')!=1) {throw new Exception('short_open_tag not added');}"
-          php -r "if(ini_get('date.timezone')!='Asia/Kolkata') {throw new Exception('date.timezone not added');}"

.gitignore

@@ -3,7 +3,7 @@ node_modules/
 __tests__/runner/*
 lib/
 
-# Rest of the file pulled from https://github.com/github/gitignore/blob/master/Node.gitignore
+# Rest of the file pulled from https://github.com/github/gitignore/blob/main/Node.gitignore
 # Logs
 logs
 *.log

.node-version

@@ -0,0 +1 @@
+20

.prettierrc.json

@@ -1,11 +1,12 @@
 {
+    "arrowParens": "avoid",
+    "bracketSpacing": false,
+    "endOfLine": "auto",
+    "parser": "typescript",
     "printWidth": 80,
-    "tabWidth": 2,
-    "useTabs": false,
     "semi": true,
     "singleQuote": true,
+    "tabWidth": 2,
     "trailingComma": "none",
-    "bracketSpacing": false,
-    "arrowParens": "avoid",
-    "parser": "typescript"
-  }
+    "useTabs": false
+}

LICENSE

@@ -1,7 +1,7 @@
 
 The MIT License (MIT)
 
-Copyright (c) 2019 shivammathur and contributors
+Copyright (c) shivammathur and contributors
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

__tests__/config.test.ts

@@ -1,52 +1,20 @@
 import * as config from '../src/config';
 
 describe('Config tests', () => {
-  it('checking addINIValuesOnWindows', async () => {
-    let win32: string = await config.addINIValues(
-      'post_max_size=256M, short_open_tag=On, date.timezone=Asia/Kolkata',
-      'win32'
-    );
-    expect(win32).toContain(
-      'Add-Content C:\\tools\\php\\php.ini "post_max_size=256M\nshort_open_tag=On\ndate.timezone=Asia/Kolkata"'
-    );
-
-    win32 = await config.addINIValues(
-      'post_max_size=256M, short_open_tag=On, date.timezone=Asia/Kolkata',
-      'fedora'
-    );
-    expect(win32).toContain('Platform fedora is not supported');
-  });
-
-  it('checking addINIValuesOnLinux', async () => {
-    let linux: string = await config.addINIValues(
-      'post_max_size=256M, short_open_tag=On, date.timezone=Asia/Kolkata',
-      'linux',
-      true
-    );
-    expect(linux).toContain(
-      'echo "post_max_size=256M\nshort_open_tag=On\ndate.timezone=Asia/Kolkata"'
-    );
-
-    linux = await config.addINIValues(
-      'post_max_size=256M, short_open_tag=On, date.timezone=Asia/Kolkata',
-      'fedora'
-    );
-    expect(linux).toContain('Platform fedora is not supported');
-  });
-
-  it('checking addINIValuesOnDarwin', async () => {
-    let darwin: string = await config.addINIValues(
-      'post_max_size=256M, short_open_tag=On, date.timezone=Asia/Kolkata',
-      'darwin'
-    );
-    expect(darwin).toContain(
-      'echo "post_max_size=256M\nshort_open_tag=On\ndate.timezone=Asia/Kolkata"'
-    );
-
-    darwin = await config.addINIValues(
-      'post_max_size=256M, short_open_tag=On, date.timezone=Asia/Kolkata',
-      'fedora'
-    );
-    expect(darwin).toContain('Platform fedora is not supported');
+  it.each`
+    ini_values                           | os           | output
+    ${'a=b, c=d'}                        | ${'win32'}   | ${'Add-Content "$php_dir\\php.ini" "a=b\nc=d"'}
+    ${'a=b, c=d'}                        | ${'linux'}   | ${'echo "a=b\nc=d" | sudo tee -a "${pecl_file:-${ini_file[@]}}"'}
+    ${'a=b, c=d'}                        | ${'darwin'}  | ${'echo "a=b\nc=d" | sudo tee -a "${pecl_file:-${ini_file[@]}}"'}
+    ${'a=b & ~c'}                        | ${'win32'}   | ${'Add-Content "$php_dir\\php.ini" "a=\'b & ~c\'"'}
+    ${'a="~(b)"'}                        | ${'win32'}   | ${'Add-Content "$php_dir\\php.ini" "a=\'~(b)\'"'}
+    ${'a="b, c"'}                        | ${'win32'}   | ${'Add-Content "$php_dir\\php.ini" "a=b, c"'}
+    ${'disable_functions="exec,system"'} | ${'linux'}   | ${'echo "disable_functions=exec,system" | sudo tee -a'}
+    ${'disable_functions="exec,system"'} | ${'win32'}   | ${'Add-Content "$php_dir\\php.ini" "disable_functions=exec,system"'}
+    ${'a=$(id)'}                         | ${'linux'}   | ${'echo "a=\'\\$(id)\'"'}
+    ${'a=$(id)'}                         | ${'win32'}   | ${'Add-Content "$php_dir\\php.ini" "a=\'`$(id)\'"'}
+    ${'a=b, c=d'}                        | ${'openbsd'} | ${'Platform openbsd is not supported'}
+  `('checking addINIValues on $os', async ({ini_values, os, output}) => {
+    expect(await config.addINIValues(ini_values, os)).toContain(output);
   });
 });

__tests__/core.test.ts

@@ -0,0 +1,106 @@
+import * as core from '../src/core';
+
+describe('Core tests', () => {
+  const originalEnv = process.env;
+  const originalExitCode = process.exitCode;
+  let stdoutOutput: string;
+  const originalWrite = process.stdout.write;
+
+  beforeEach(() => {
+    process.env = {...originalEnv};
+    process.exitCode = undefined;
+    stdoutOutput = '';
+    process.stdout.write = jest.fn((chunk: string | Uint8Array): boolean => {
+      stdoutOutput += chunk.toString();
+      return true;
+    }) as unknown as typeof process.stdout.write;
+  });
+
+  afterEach(() => {
+    process.env = originalEnv;
+    process.exitCode = originalExitCode;
+    process.stdout.write = originalWrite;
+  });
+
+  it('checking issueCommand with no properties', () => {
+    core.issueCommand('warning', {}, 'test message');
+    expect(stdoutOutput).toContain('::warning::test message');
+  });
+
+  it('checking issueCommand with properties', () => {
+    core.issueCommand('error', {file: 'test.ts', line: '10'}, 'error message');
+    expect(stdoutOutput).toContain(
+      '::error file=test.ts,line=10::error message'
+    );
+  });
+
+  it('checking issueCommand escapes special characters in message', () => {
+    core.issueCommand('warning', {}, 'line1\nline2\rline3%percent');
+    expect(stdoutOutput).toContain(
+      '::warning::line1%0Aline2%0Dline3%25percent'
+    );
+  });
+
+  it('checking issueCommand escapes special characters in properties', () => {
+    core.issueCommand('error', {file: 'path:to,file'}, 'message');
+    expect(stdoutOutput).toContain('::error file=path%3Ato%2Cfile::message');
+  });
+
+  it('checking issueCommand with Error object', () => {
+    const error = new Error('test error');
+    core.issueCommand('error', {}, error);
+    expect(stdoutOutput).toContain('::error::Error: test error');
+  });
+
+  it('checking issueCommand filters empty properties', () => {
+    core.issueCommand('warning', {file: 'test.ts', line: ''}, 'message');
+    expect(stdoutOutput).toContain('::warning file=test.ts::message');
+  });
+
+  it('checking error', () => {
+    core.error('error message');
+    expect(stdoutOutput).toContain('::error::error message');
+  });
+
+  it('checking error with Error object', () => {
+    core.error(new Error('error instance'));
+    expect(stdoutOutput).toContain('::error::Error: error instance');
+  });
+
+  it('checking setFailed', () => {
+    core.setFailed('failure message');
+    expect(process.exitCode).toBe(1);
+    expect(stdoutOutput).toContain('::error::failure message');
+  });
+
+  it('checking setFailed with Error object', () => {
+    core.setFailed(new Error('failure error'));
+    expect(process.exitCode).toBe(1);
+    expect(stdoutOutput).toContain('::error::Error: failure error');
+  });
+
+  it('checking getInput returns value', () => {
+    process.env['INPUT_TEST-INPUT'] = 'test value';
+    expect(core.getInput('test-input')).toBe('test value');
+  });
+
+  it('checking getInput trims value', () => {
+    process.env['INPUT_TEST-INPUT'] = '  trimmed  ';
+    expect(core.getInput('test-input')).toBe('trimmed');
+  });
+
+  it('checking getInput returns empty string for missing input', () => {
+    expect(core.getInput('missing-input')).toBe('');
+  });
+
+  it('checking getInput throws for required missing input', () => {
+    expect(() => core.getInput('missing-input', true)).toThrow(
+      'Input required and not supplied: missing-input'
+    );
+  });
+
+  it('checking getInput handles spaces in name', () => {
+    process.env['INPUT_INPUT_WITH_SPACES'] = 'spaced value';
+    expect(core.getInput('input with spaces')).toBe('spaced value');
+  });
+});

__tests__/coverage.test.ts

@@ -1,82 +1,44 @@
 import * as coverage from '../src/coverage';
 
-jest.mock('../src/extensions', () => ({
-  addExtension: jest.fn().mockImplementation(extension => {
-    return 'addExtension ' + extension + '\n';
-  })
-}));
-
 describe('Config tests', () => {
-  it('checking addCoverage with PCOV on windows', async () => {
-    let win32: string = await coverage.addCoverage('pcov', '7.4', 'win32');
-    expect(win32).toContain('addExtension pcov');
-    expect(win32).toContain(
-      'if(php -m | findstr -i xdebug) { Disable-PhpExtension xdebug C:\\tools\\php'
-    );
-
-    win32 = await coverage.addCoverage('pcov', '7.0', 'win32');
-    expect(win32).toContain('PHP 7.1 or newer is required');
-
-    win32 = await coverage.addCoverage('pcov', '5.6', 'win32');
-    expect(win32).toContain('PHP 7.1 or newer is required');
-  });
-
-  it('checking addCoverage with PCOV on linux', async () => {
-    const linux: string = await coverage.addCoverage('pcov', '7.4', 'linux');
-    expect(linux).toContain('addExtension pcov');
-    expect(linux).toContain('sudo sed -i "/xdebug/d" $ini_file');
-    expect(linux).toContain('sudo phpdismod -v 7.4 xdebug');
-  });
-
-  it('checking addCoverage with PCOV on darwin', async () => {
-    const darwin: string = await coverage.addCoverage('pcov', '7.4', 'darwin');
-    expect(darwin).toContain('addExtension pcov');
-  });
-
-  it('checking addCoverage with Xdebug on windows', async () => {
-    const win32: string = await coverage.addCoverage('xdebug', '7.3', 'win32');
-    expect(win32).toContain('addExtension xdebug');
-  });
-
-  it('checking addCoverage with Xdebug on linux', async () => {
-    const linux: string = await coverage.addCoverage('xdebug', '7.4', 'linux');
-    expect(linux).toContain('addExtension xdebug');
-  });
-
-  it('checking addCoverage with Xdebug on darwin', async () => {
-    const darwin: string = await coverage.addCoverage(
-      'xdebug',
-      '7.4',
-      'darwin'
-    );
-    expect(darwin).toContain('addExtension xdebug');
-  });
-
-  it('checking disableCoverage windows', async () => {
-    const win32 = await coverage.addCoverage('none', '7.4', 'win32');
-    expect(win32).toContain('Disable-PhpExtension xdebug');
-    expect(win32).toContain('Disable-PhpExtension pcov');
-  });
-
-  it('checking disableCoverage on linux', async () => {
-    const linux: string = await coverage.addCoverage('none', '7.4', 'linux');
-    expect(linux).toContain('sudo phpdismod -v 7.4 xdebug');
-    expect(linux).toContain('sudo phpdismod -v 7.4 pcov');
-    expect(linux).toContain('sudo sed -i "/xdebug/d" $ini_file');
-    expect(linux).toContain('sudo sed -i "/pcov/d" $ini_file');
-  });
-
-  it('checking disableCoverage on darwin', async () => {
-    const darwin: string = await coverage.addCoverage('none', '7.4', 'darwin');
-    expect(darwin).toContain('sudo sed -i \'\' "/xdebug/d" $ini_file');
-    expect(darwin).toContain('sudo sed -i \'\' "/pcov/d" $ini_file');
-  });
-
-  it('checking no or invalid coverage driver', async () => {
-    let nocov: string = await coverage.addCoverage('nocov', '7.x', 'any');
-    expect(nocov).toEqual('');
-
-    nocov = await coverage.addCoverage('', '7.x', 'any');
-    expect(nocov).toEqual('');
-  });
+  it.each`
+    driver       | php      | os          | output
+    ${'PCOV'}    | ${'7.4'} | ${'win32'}  | ${'Add-Extension pcov,Disable-Extension xdebug false'}
+    ${'pcov'}    | ${'7.4'} | ${'win32'}  | ${'$pcov_version = php -r "echo phpversion(\'pcov\');"'}
+    ${'pcov'}    | ${'7.4'} | ${'win32'}  | ${'PCOV $pcov_version enabled as coverage driver'}
+    ${'pcov'}    | ${'7.0'} | ${'win32'}  | ${'PHP 7.1 or newer is required'}
+    ${'pcov'}    | ${'5.6'} | ${'win32'}  | ${'PHP 7.1 or newer is required'}
+    ${'pcov'}    | ${'7.4'} | ${'win32'}  | ${'Add-Extension pcov,Disable-Extension xdebug false'}
+    ${'pcov'}    | ${'7.4'} | ${'linux'}  | ${'add_extension pcov,disable_extension xdebug false'}
+    ${'pcov'}    | ${'7.4'} | ${'darwin'} | ${'add_brew_extension pcov,disable_extension xdebug false'}
+    ${'xdebug'}  | ${'7.4'} | ${'win32'}  | ${'Add-Extension xdebug'}
+    ${'xdebug3'} | ${'7.1'} | ${'win32'}  | ${'xdebug3 is not supported on PHP 7.1'}
+    ${'xdebug2'} | ${'7.4'} | ${'win32'}  | ${'Add-Extension xdebug stable 2.9.8'}
+    ${'xdebug'}  | ${'8.0'} | ${'linux'}  | ${'add_extension xdebug'}
+    ${'xdebug3'} | ${'8.0'} | ${'linux'}  | ${'add_extension xdebug'}
+    ${'xdebug2'} | ${'7.4'} | ${'linux'}  | ${'add_pecl_extension xdebug 2.9.8 zend_extension'}
+    ${'xdebug'}  | ${'7.4'} | ${'linux'}  | ${'xdebug_version="$(php -r "echo phpversion(\'xdebug\');")"'}
+    ${'xdebug'}  | ${'7.4'} | ${'linux'}  | ${'Xdebug $xdebug_version enabled as coverage driver'}
+    ${'xdebug'}  | ${'7.4'} | ${'darwin'} | ${'add_brew_extension xdebug'}
+    ${'xdebug3'} | ${'7.1'} | ${'darwin'} | ${'xdebug3 is not supported on PHP 7.1'}
+    ${'xdebug2'} | ${'7.4'} | ${'darwin'} | ${'add_brew_extension xdebug2'}
+    ${'xdebug2'} | ${'8.0'} | ${'darwin'} | ${'xdebug2 is not supported on PHP 8.0'}
+    ${'none'}    | ${'7.4'} | ${'win32'}  | ${'Disable-Extension xdebug false,Disable-Extension pcov false'}
+    ${'none'}    | ${'7.4'} | ${'linux'}  | ${'disable_extension xdebug false,disable_extension pcov false'}
+    ${'none'}    | ${'7.4'} | ${'darwin'} | ${'disable_extension xdebug false,disable_extension pcov false'}
+    ${'nocov'}   | ${'7.x'} | ${'any'}    | ${''}
+    ${''}        | ${'7.x'} | ${'any'}    | ${''}
+  `(
+    'checking addCoverage with $driver on $os',
+    async ({driver, php, os, output}) => {
+      const script: string = await coverage.addCoverage(driver, php, os);
+      if (output) {
+        output.split(',').forEach((command: string) => {
+          expect(script).toContain(command);
+        });
+      } else {
+        expect(script).toEqual(output);
+      }
+    }
+  );
 });

__tests__/extensions.test.ts

@@ -1,97 +1,162 @@
+import * as fs from 'fs';
 import * as extensions from '../src/extensions';
 
 describe('Extension tests', () => {
-  it('checking addExtensionOnWindows', async () => {
-    let win32: string = await extensions.addExtension(
-      'xdebug, pcov, redis',
-      '7.4',
-      'win32'
-    );
-    expect(win32).toContain('Add-Extension xdebug');
-    expect(win32).toContain('Add-Extension pcov');
-    expect(win32).toContain('Add-Extension redis beta');
+  it.each`
+    extension                                    | version  | output
+    ${'none'}                                    | ${'7.4'} | ${'Disable-AllShared'}
+    ${':intl'}                                   | ${'7.4'} | ${'Disable-Extension intl'}
+    ${'ast-beta'}                                | ${'7.4'} | ${'Add-Extension ast beta'}
+    ${'blackfire'}                               | ${'7.3'} | ${'Add-Blackfire blackfire'}
+    ${'blackfire-1.31.0'}                        | ${'7.3'} | ${'Add-Blackfire blackfire-1.31.0'}
+    ${'grpc-1.2.3'}                              | ${'7.4'} | ${'Add-Extension grpc stable 1.2.3'}
+    ${'inotify-1.2.3alpha2'}                     | ${'7.4'} | ${'Add-Extension inotify alpha 1.2.3'}
+    ${'ioncube'}                                 | ${'7.4'} | ${'Add-Ioncube'}
+    ${'mongodb-mongodb/mongo-php-driver@master'} | ${'7.3'} | ${'Add-Log "$cross" "mongodb-mongodb/mongo-php-driver@master" "mongodb-mongodb/mongo-php-driver@master is not supported on PHP 7.3"'}
+    ${'mysql'}                                   | ${'7.4'} | ${'Add-Extension mysqli\nAdd-Extension mysqlnd'}
+    ${'mysql'}                                   | ${'5.5'} | ${'Add-Extension mysql\nAdd-Extension mysqli\nAdd-Extension mysqlnd'}
+    ${'oci8'}                                    | ${'7.4'} | ${'Add-Oci oci8'}
+    ${'pcov'}                                    | ${'5.6'} | ${'Add-Log "$cross" "pcov" "pcov is not supported on PHP 5.6"'}
+    ${'pdo_oci'}                                 | ${'7.4'} | ${'Add-Oci pdo_oci'}
+    ${'ibm_db2'}                                 | ${'7.4'} | ${'Add-Ibm ibm_db2'}
+    ${'pdo_ibm'}                                 | ${'7.4'} | ${'Add-Ibm pdo_ibm'}
+    ${'pecl_http'}                               | ${'7.4'} | ${'Add-Http'}
+    ${'http'}                                    | ${'8.5'} | ${'Add-Http'}
+    ${'pdo_sqlsrv'}                              | ${'7.4'} | ${'Add-Sqlsrv pdo_sqlsrv'}
+    ${'phalcon3'}                                | ${'7.2'} | ${'Add-Phalcon phalcon3'}
+    ${'phalcon4'}                                | ${'7.4'} | ${'Add-Phalcon phalcon4'}
+    ${'sqlite'}                                  | ${'7.4'} | ${'Add-Extension sqlite3'}
+    ${'sqlsrv'}                                  | ${'5.6'} | ${'Add-Extension sqlsrv'}
+    ${'sqlsrv'}                                  | ${'7.4'} | ${'Add-Sqlsrv sqlsrv'}
+    ${'sqlsrv-1.2.3preview1'}                    | ${'7.4'} | ${'Add-Extension sqlsrv devel 1.2.3'}
+    ${'Xdebug'}                                  | ${'7.4'} | ${'Add-Extension xdebug'}
+    ${'xdebug2'}                                 | ${'7.2'} | ${'Add-Extension xdebug stable 2.9.8'}
+    ${'zephir_parser'}                           | ${'7.2'} | ${'Add-ZephirParser zephir_parser'}
+  `(
+    'checking addExtensionOnWindows for extension $extension on version $version',
+    async ({extension, version, output}) => {
+      expect(
+        await extensions.addExtension(extension, version, 'win32')
+      ).toContain(output);
+    }
+  );
 
-    win32 = await extensions.addExtension(
-      'does_not_exist',
-      '7.2',
-      'win32',
-      true
-    );
-    expect(win32).toContain('Add-Extension does_not_exist');
+  it.each`
+    extension                                    | version  | output
+    ${'none'}                                    | ${'7.4'} | ${'disable_all_shared'}
+    ${':intl'}                                   | ${'7.4'} | ${'disable_extension intl'}
+    ${'ast-beta'}                                | ${'7.4'} | ${'add_unstable_extension ast beta extension'}
+    ${'blackfire'}                               | ${'7.3'} | ${'add_blackfire blackfire'}
+    ${'blackfire-1.31.0'}                        | ${'7.3'} | ${'add_blackfire blackfire-1.31.0'}
+    ${'couchbase'}                               | ${'7.4'} | ${'add_couchbase'}
+    ${'gearman'}                                 | ${'5.6'} | ${'add_gearman'}
+    ${'geos'}                                    | ${'7.3'} | ${'add_geos'}
+    ${'grpc-1.2.3'}                              | ${'7.4'} | ${'add_pecl_extension grpc 1.2.3 extension'}
+    ${'http-1.2.3'}                              | ${'7.3'} | ${'add_http http-1.2.3'}
+    ${'intl-65.1'}                               | ${'5.6'} | ${'add_intl intl-65.1'}
+    ${'ioncube'}                                 | ${'7.3'} | ${'add_ioncube'}
+    ${'memcache-8.2'}                            | ${'8.2'} | ${'add_pecl_extension memcache 8.2 extension'}
+    ${'mongodb-mongodb/mongo-php-driver@master'} | ${'7.3'} | ${'add_extension_from_source mongodb https://github.com mongodb mongo-php-driver master extension'}
+    ${'oci8'}                                    | ${'7.3'} | ${'add_oci oci8'}
+    ${'pcov'}                                    | ${'5.6'} | ${'add_log "$cross" "pcov" "pcov is not supported on PHP 5.6'}
+    ${'ibm_db2'}                                 | ${'7.3'} | ${'add_ibm ibm_db2'}
+    ${'pdo-odbc'}                                | ${'7.4'} | ${'add_pdo_extension odbc'}
+    ${'pdo_cubrid'}                              | ${'7.0'} | ${'add_cubrid pdo_cubrid'}
+    ${'pdo_cubrid'}                              | ${'7.4'} | ${'add_pdo_extension cubrid'}
+    ${'pdo_mysql'}                               | ${'7.4'} | ${'add_pdo_extension mysql'}
+    ${'pdo_oci'}                                 | ${'7.3'} | ${'add_oci pdo_oci'}
+    ${'pdo_ibm'}                                 | ${'7.3'} | ${'add_ibm pdo_ibm'}
+    ${'pdo_sqlsrv'}                              | ${'7.4'} | ${'add_sqlsrv pdo_sqlsrv'}
+    ${'pecl_http'}                               | ${'7.3'} | ${'add_http'}
+    ${'phalcon3'}                                | ${'7.3'} | ${'add_phalcon phalcon3'}
+    ${'relay'}                                   | ${'7.4'} | ${'add_relay relay'}
+    ${'relay-v1.2.3'}                            | ${'7.4'} | ${'add_relay relay-v1.2.3'}
+    ${'sqlite'}                                  | ${'7.4'} | ${'add_extension sqlite3'}
+    ${'sqlsrv-1.2.3-beta1'}                      | ${'7.4'} | ${'add_pecl_extension sqlsrv 1.2.3beta1 extension'}
+    ${'Xdebug'}                                  | ${'7.4'} | ${'add_extension xdebug'}
+    ${'xdebug-alpha'}                            | ${'7.4'} | ${'add_unstable_extension xdebug alpha zend_extension'}
+    ${'xdebug2'}                                 | ${'7.2'} | ${'add_pecl_extension xdebug 2.9.8 zend_extension'}
+    ${'zephir_parser-1.2.3'}                     | ${'7.2'} | ${'add_zephir_parser zephir_parser-1.2.3'}
+  `(
+    'checking addExtensionOnLinux for extension $extension on version $version',
+    async ({extension, version, output}) => {
+      expect(
+        await extensions.addExtension(extension, version, 'linux')
+      ).toContain(output);
+    }
+  );
 
-    win32 = await extensions.addExtension('xdebug', '7.2', 'fedora');
-    expect(win32).toContain('Platform fedora is not supported');
-  });
+  it.each`
+    extension                                    | version  | output
+    ${'none'}                                    | ${'7.2'} | ${'disable_all_shared'}
+    ${':intl'}                                   | ${'7.2'} | ${'disable_extension intl'}
+    ${'ast-beta'}                                | ${'7.2'} | ${'add_unstable_extension ast beta extension'}
+    ${'blackfire'}                               | ${'7.3'} | ${'add_blackfire blackfire'}
+    ${'blackfire-1.31.0'}                        | ${'7.3'} | ${'add_blackfire blackfire-1.31.0'}
+    ${'couchbase'}                               | ${'5.6'} | ${'add_couchbase'}
+    ${'does_not_exist'}                          | ${'7.2'} | ${'add_extension does_not_exist'}
+    ${'geos'}                                    | ${'7.3'} | ${'add_geos'}
+    ${'grpc-1.2.3'}                              | ${'7.2'} | ${'add_pecl_extension grpc 1.2.3 extension'}
+    ${'http-1.2.3'}                              | ${'7.3'} | ${'add_http http-1.2.3'}
+    ${'imagick'}                                 | ${'5.5'} | ${'add_extension imagick'}
+    ${'ioncube'}                                 | ${'7.3'} | ${'add_ioncube'}
+    ${'mongodb-mongodb/mongo-php-driver@master'} | ${'7.2'} | ${'add_extension_from_source mongodb https://github.com mongodb mongo-php-driver master extension'}
+    ${'oci8'}                                    | ${'7.3'} | ${'add_oci oci8'}
+    ${'pcov'}                                    | ${'5.6'} | ${'add_log "$cross" "pcov" "pcov is not supported on PHP 5.6"'}
+    ${'pdo_oci'}                                 | ${'7.3'} | ${'add_oci pdo_oci'}
+    ${'pecl_http'}                               | ${'7.3'} | ${'add_http'}
+    ${'relay-1.2.3'}                             | ${'7.4'} | ${'add_relay relay-1.2.3'}
+    ${'sqlite'}                                  | ${'7.2'} | ${'add_extension sqlite3'}
+    ${'zephir_parser-v1.2.3'}                    | ${'7.2'} | ${'add_zephir_parser zephir_parser-v1.2.3'}
+  `(
+    'checking addExtensionOnDarwin for extension $extension on version $version',
+    async ({extension, version, output}) => {
+      expect(
+        await extensions.addExtension(extension, version, 'darwin')
+      ).toContain(output);
+    }
+  );
 
-  it('checking addExtensionOnLinux', async () => {
-    let linux: string = await extensions.addExtension(
-      'xdebug, pcov, redis',
-      '7.4',
-      'linux'
-    );
-    expect(linux).toContain(
-      'sudo DEBIAN_FRONTEND=noninteractive apt-get install -y php7.4-xdebug'
-    );
-    expect(linux).toContain('pecl install xdebug');
-    expect(linux).toContain(
-      'sudo DEBIAN_FRONTEND=noninteractive apt-get install -y php7.4-pcov'
-    );
-    expect(linux).toContain('pecl install pcov');
-    expect(linux).toContain(
-      'sudo DEBIAN_FRONTEND=noninteractive apt-get install -y php7.4-igbinary php7.4-redis'
-    );
+  const data: string[][] = fs
+    .readFileSync('src/configs/brew_extensions')
+    .toString()
+    .split(/\r?\n/)
+    .filter(Boolean)
+    .map(line => {
+      const [formula, extension]: string[] = line.split('=');
+      const prefix: string =
+        extension == 'xdebug' ? 'zend_extension' : 'extension';
+      const ext_name = extension.replace(/\d+|(pdo|pecl)[_-]/, '');
+      const output: string = fs.existsSync(
+        `src/scripts/extensions/${ext_name}.sh`
+      )
+        ? `add_${ext_name}`
+        : `add_brew_extension ${formula} ${prefix}`;
+      return [
+        formula,
+        formula.match(/phalcon3|lua|propro/) ? '7.3' : '8.1',
+        output
+      ];
+    });
 
-    linux = await extensions.addExtension('phalcon3, phalcon4', '7.2', 'linux');
-    expect(linux).toContain('phalcon.sh master 7.2');
-    expect(linux).toContain('phalcon.sh 4.0.x 7.2');
+  it.each(data)(
+    'checking addExtensionOnDarwin for brew extension %s',
+    async (extension, version, output) => {
+      expect(
+        await extensions.addExtension(extension, version, 'darwin')
+      ).toContain(output);
+    }
+  );
 
-    linux = await extensions.addExtension('phalcon3, phalcon4', '7.3', 'linux');
-    expect(linux).toContain('phalcon.sh master 7.3');
-    expect(linux).toContain('phalcon.sh 4.0.x 7.3');
-
-    linux = await extensions.addExtension('phalcon4', '7.4', 'linux');
-    expect(linux).toContain('phalcon.sh 4.0.x 7.4');
-
-    linux = await extensions.addExtension('xdebug', '7.2', 'fedora');
-    expect(linux).toContain('Platform fedora is not supported');
-  });
-
-  it('checking addExtensionOnDarwin', async () => {
-    let darwin: string = await extensions.addExtension(
-      'xdebug, pcov',
-      '7.2',
-      'darwin'
-    );
-    expect(darwin).toContain('sudo pecl install xdebug');
-    expect(darwin).toContain('sudo pecl install pcov');
-
-    darwin = await extensions.addExtension('pcov', '5.6', 'darwin');
-    expect(darwin).toContain('sudo pecl install pcov');
-
-    darwin = await extensions.addExtension('pcov', '7.2', 'darwin');
-    expect(darwin).toContain('sudo pecl install pcov');
-
-    darwin = await extensions.addExtension('xdebug', '5.6', 'darwin');
-    expect(darwin).toContain('sudo pecl install xdebug-2.5.5');
-
-    darwin = await extensions.addExtension('xdebug', '7.2', 'darwin');
-    expect(darwin).toContain('sudo pecl install xdebug');
-
-    darwin = await extensions.addExtension('redis', '5.6', 'darwin');
-    expect(darwin).toContain('sudo pecl install redis-2.2.8');
-
-    darwin = await extensions.addExtension('redis', '7.2', 'darwin');
-    expect(darwin).toContain('sudo pecl install redis');
-
-    darwin = await extensions.addExtension(
-      'does_not_exist',
-      '7.2',
-      'darwin',
-      false
-    );
-    expect(darwin).toContain('add_extension does_not_exist');
-
-    darwin = await extensions.addExtension('xdebug', '7.2', 'fedora');
-    expect(darwin).toContain('Platform fedora is not supported');
-  });
+  it.each`
+    extension   | version  | output
+    ${'xdebug'} | ${'7.2'} | ${'Platform openbsd is not supported'}
+  `(
+    'checking addExtension on openbsd for extension $extension on version $version',
+    async ({extension, version, output}) => {
+      expect(
+        await extensions.addExtension(extension, version, 'openbsd')
+      ).toContain(output);
+    }
+  );
 });

__tests__/fetch.test.ts

@@ -0,0 +1,45 @@
+import * as fetch from '../src/fetch';
+import nock from 'nock';
+
+it('checking fetch', async () => {
+  const host_url = 'https://example.com';
+  const manifest_url = host_url + '/manifest';
+  const ping_url = host_url + '/ping';
+
+  nock(host_url)
+    .get('/manifest')
+    .reply(200, {latest: 'latest'})
+    .get('/manifest', '', {
+      reqheaders: {authorization: 'Bearer invalid_token'}
+    })
+    .reply(401, {error: '401: Unauthorized'})
+    .get('/ping')
+    .twice()
+    .reply(301, undefined, {
+      Location: host_url + '/pong'
+    })
+    .get('/pong')
+    .reply(200, 'pong')
+    .get('/error')
+    .replyWithError('Network failure');
+
+  let response: Record<string, string> = await fetch.fetch(manifest_url);
+  expect(response.error).toBe(undefined);
+  expect(response.data).toContain('latest');
+
+  response = await fetch.fetch(ping_url, '', 1);
+  expect(response.error).toBe(undefined);
+  expect(response.data).toContain('pong');
+
+  response = await fetch.fetch(ping_url, '', 0);
+  expect(response.error).toBe('301: Redirect error');
+  expect(response.data).toBe(undefined);
+
+  response = await fetch.fetch(manifest_url, 'invalid_token');
+  expect(response.error).not.toBe(undefined);
+  expect(response.data).toBe(undefined);
+
+  response = await fetch.fetch(host_url + '/error');
+  expect(response.error).toContain('Fetch error:');
+  expect(response.data).toBe(undefined);
+});

__tests__/install.test.ts

@@ -1,146 +1,87 @@
 import * as install from '../src/install';
+import * as utils from '../src/utils';
 
 /**
  * Mock install.ts
  */
 jest.mock('../src/install', () => ({
-  build: jest.fn().mockImplementation(
-    async (
-      filename: string,
-      version: string,
-      os_version: string
-    ): Promise<string> => {
-      const extension_csv: string = process.env['extension-csv'] || '';
-      const ini_values_csv: string = process.env['ini-values-csv'] || '';
+  getScript: jest
+    .fn()
+    .mockImplementation(async (os: string): Promise<string> => {
+      const filename = os + (await utils.scriptExtension(os));
+      const version: string = await utils.parseVersion(
+        await utils.readPHPVersion()
+      );
+      const ini_file: string = await utils.parseIniFile(
+        await utils.getInput('ini-file', false)
+      );
+      const extension_csv: string = process.env['extensions'] || '';
+      const ini_values_csv: string = process.env['ini-values'] || '';
       const coverage_driver: string = process.env['coverage'] || '';
-
-      let script = 'initial script ' + filename + version + os_version;
-      if (extension_csv) {
-        script += 'install extensions';
-      }
-      if (ini_values_csv) {
-        script += 'edit php.ini';
-      }
-      if (coverage_driver) {
-        script += 'set coverage driver';
-      }
-
+      const tools_csv: string = process.env['tools'] || '';
+      let script = await utils.joins(filename, version, ini_file);
+      script += extension_csv ? ' install extensions' : '';
+      script += tools_csv ? ' add_tool' : '';
+      script += coverage_driver ? ' set coverage driver' : '';
+      script += ini_values_csv ? ' edit php.ini' : '';
       return script;
-    }
-  ),
-  run: jest.fn().mockImplementation(
-    async (): Promise<string> => {
-      const os_version: string = process.env['RUNNER_OS'] || '';
-      const version: string = process.env['php-version'] || '';
-      let script = '';
-      switch (os_version) {
-        case 'darwin':
-          script = await install.build(os_version + '.sh', version, os_version);
-          script += 'sh script.sh ' + version + ' ' + __dirname;
-          break;
-        case 'linux': {
-          const pecl: string = process.env['pecl'] || '';
-          script = await install.build(os_version + '.sh', version, os_version);
-          script += 'sh script.sh ' + version + ' ' + pecl + ' ' + __dirname;
-          break;
-        }
-        case 'win32':
-          script = await install.build(os_version + '.sh', version, os_version);
-          script +=
-            'pwsh script.ps1 -version ' + version + ' -dir ' + __dirname;
-          break;
-        default:
-          script += os_version + ' is not supported';
-      }
-
-      return script;
-    }
-  )
+    }),
+  run: jest.fn().mockImplementation(async (): Promise<string> => {
+    const os: string = process.env['RUNNER_OS'] || '';
+    const tool = await utils.scriptTool(os);
+    return tool + (await install.getScript(os));
+  })
 }));
 
 /**
- * Function to set the process.env
- *
- * @param version
- * @param os
- * @param extension_csv
- * @param ini_values_csv
- * @param coverage_driver
+ * Mock fetch.ts
  */
-function setEnv(
-  version: string,
-  os: string,
-  extension_csv: string,
-  ini_values_csv: string,
-  coverage_driver: string,
-  pecl: string
-): void {
-  process.env['php-version'] = version;
-  process.env['RUNNER_OS'] = os;
-  process.env['extension-csv'] = extension_csv;
-  process.env['ini-values-csv'] = ini_values_csv;
-  process.env['coverage'] = coverage_driver;
-  process.env['pecl'] = pecl;
-}
+jest.mock('../src/fetch', () => ({
+  fetch: jest.fn().mockImplementation(() => {
+    return {
+      data: '{ "latest": "8.3", "lowest": "8.1", "highest": "8.3", "nightly": "8.4", "5.x": "5.6" }'
+    };
+  })
+}));
 
 describe('Install', () => {
-  it('Test install on windows', async () => {
-    setEnv('7.3', 'win32', '', '', '', '');
-    // @ts-ignore
-    let script: string = await install.run();
-    expect(script).toContain('initial script');
-    expect(script).toContain('pwsh script.ps1 -version 7.3 -dir ' + __dirname);
-
-    setEnv('7.3', 'win32', 'a, b', 'a=b', 'x', '');
-    // @ts-ignore
-    script = await install.run();
-    expect(script).toContain('initial script');
-    expect(script).toContain('install extensions');
-    expect(script).toContain('edit php.ini');
-    expect(script).toContain('set coverage driver');
-    expect(script).toContain('pwsh script.ps1 -version 7.3 -dir ' + __dirname);
-  });
-
-  it('Test install on linux', async () => {
-    setEnv('7.3', 'linux', '', '', '', '');
-    // @ts-ignore
-    let script: string = await install.run();
-    expect(script).toContain('initial script');
-    expect(script).toContain('sh script.sh 7.3 ');
-
-    setEnv('7.3', 'linux', 'a, b', 'a=b', 'x', 'true');
-    // @ts-ignore
-    script = await install.run();
-    expect(script).toContain('initial script');
-    expect(script).toContain('install extensions');
-    expect(script).toContain('edit php.ini');
-    expect(script).toContain('set coverage driver');
-    expect(script).toContain('sh script.sh 7.3 true');
-
-    setEnv('7.3', 'linux', 'a, b', 'a=b', 'x', 'true');
-    // @ts-ignore
-    script = await install.run();
-    expect(script).toContain('initial script');
-    expect(script).toContain('install extensions');
-    expect(script).toContain('edit php.ini');
-    expect(script).toContain('set coverage driver');
-    expect(script).toContain('sh script.sh 7.3 true');
-  });
-
-  it('Test install on darwin', async () => {
-    setEnv('7.3', 'darwin', '', '', '', '');
-    // @ts-ignore
-    let script: string = await install.run();
-    expect(script).toContain('initial script');
-    expect(script).toContain('sh script.sh 7.3 ' + __dirname);
-
-    setEnv('7.3', 'darwin', 'a, b', 'a=b', 'x', '');
-    // @ts-ignore
-    script = await install.run();
-    expect(script).toContain('initial script');
-    expect(script).toContain('install extensions');
-    expect(script).toContain('edit php.ini');
-    expect(script).toContain('set coverage driver');
-    expect(script).toContain('sh script.sh 7.3 ' + __dirname);
-  });
+  it.each`
+    version      | os          | extension_csv | ini_file         | ini_values_csv | coverage_driver | tools        | output
+    ${'7.3'}     | ${'darwin'} | ${''}         | ${'production'}  | ${''}          | ${''}           | ${''}        | ${'bash darwin.sh 7.3 production'}
+    ${'7.3'}     | ${'darwin'} | ${'a, b'}     | ${'development'} | ${'a=b'}       | ${'x'}          | ${''}        | ${'bash darwin.sh 7.3 development install extensions set coverage driver edit php.ini'}
+    ${'7.4.1'}   | ${'darwin'} | ${''}         | ${'none'}        | ${''}          | ${''}           | ${''}        | ${'bash darwin.sh 7.4 none'}
+    ${'8'}       | ${'darwin'} | ${''}         | ${''}            | ${''}          | ${''}           | ${''}        | ${'bash darwin.sh 8.0 production'}
+    ${'8.0'}     | ${'darwin'} | ${''}         | ${'development'} | ${''}          | ${''}           | ${''}        | ${'bash darwin.sh 8.0 development'}
+    ${'8.1'}     | ${'darwin'} | ${''}         | ${'none'}        | ${''}          | ${''}           | ${''}        | ${'bash darwin.sh 8.1 none'}
+    ${'7.3'}     | ${'linux'}  | ${''}         | ${'invalid'}     | ${''}          | ${''}           | ${''}        | ${'bash linux.sh 7.3 production'}
+    ${'7.3'}     | ${'linux'}  | ${'a, b'}     | ${'development'} | ${'a=b'}       | ${'x'}          | ${'phpunit'} | ${'bash linux.sh 7.3 development install extensions add_tool set coverage driver edit php.ini'}
+    ${'latest'}  | ${'linux'}  | ${''}         | ${'none'}        | ${''}          | ${''}           | ${''}        | ${'bash linux.sh 8.3 none'}
+    ${'lowest'}  | ${'linux'}  | ${''}         | ${'none'}        | ${''}          | ${''}           | ${''}        | ${'bash linux.sh 8.1 none'}
+    ${'highest'} | ${'linux'}  | ${''}         | ${'none'}        | ${''}          | ${''}           | ${''}        | ${'bash linux.sh 8.3 none'}
+    ${'nightly'} | ${'linux'}  | ${''}         | ${'none'}        | ${''}          | ${''}           | ${''}        | ${'bash linux.sh 8.4 none'}
+    ${'7.0'}     | ${'win32'}  | ${''}         | ${'production'}  | ${''}          | ${''}           | ${''}        | ${'pwsh win32.ps1 7.0 production'}
+    ${'7.3'}     | ${'win32'}  | ${''}         | ${'development'} | ${''}          | ${''}           | ${''}        | ${'pwsh win32.ps1 7.3 development'}
+    ${'7.3'}     | ${'win32'}  | ${'a, b'}     | ${'none'}        | ${'a=b'}       | ${'x'}          | ${''}        | ${'pwsh win32.ps1 7.3 none install extensions set coverage driver edit php.ini'}
+  `(
+    'Test install on $os for $version with extensions=$extension_csv, ini_values=$ini_values_csv, coverage_driver=$coverage_driver, tools=$tools',
+    async ({
+      version,
+      os,
+      extension_csv,
+      ini_file,
+      ini_values_csv,
+      coverage_driver,
+      tools,
+      output
+    }) => {
+      process.env['php-version'] = version.toString();
+      process.env['RUNNER_OS'] = os;
+      process.env['extensions'] = extension_csv;
+      process.env['ini-file'] = ini_file;
+      process.env['ini-values'] = ini_values_csv;
+      process.env['coverage'] = coverage_driver;
+      process.env['tools'] = tools;
+      expect(await install.run()).toBe(output);
+    }
+  );
 });

__tests__/packagist.test.ts

@@ -0,0 +1,50 @@
+import * as packagist from '../src/packagist';
+import nock from 'nock';
+
+describe('search function', () => {
+  const mockResponse = {
+    packages: {
+      'test-package': [
+        {
+          require: {
+            php: '8.0.0'
+          },
+          version: '1.0.0'
+        },
+        {
+          version: '2.0.0'
+        }
+      ]
+    }
+  };
+
+  test('should return the version if matching php version is found', async () => {
+    nock('https://repo.packagist.org')
+      .get('/p2/test-package.json')
+      .reply(200, mockResponse);
+    const result = await packagist.search('test-package', '8.0');
+    expect(result).toBe('1.0.0');
+  });
+
+  test('should return null if no matching php version is found', async () => {
+    nock('https://repo.packagist.org')
+      .get('/p2/test-package.json')
+      .reply(200, mockResponse);
+    const result = await packagist.search('test-package', '5.6');
+    expect(result).toBeNull();
+  });
+
+  test('should return null if fetch fails', async () => {
+    nock('https://repo.packagist.org').get('/p2/test-package.json').reply(404);
+    const result = await packagist.search('test-package', '8.0');
+    expect(result).toBeNull();
+  });
+
+  test('should return null if the response is empty', async () => {
+    nock('https://repo.packagist.org')
+      .get('/p2/test-package.json')
+      .reply(200, {error: true, data: '[]'});
+    const result = await packagist.search('test-package', '8.0');
+    expect(result).toBeNull();
+  });
+});

__tests__/tools.test.ts

@@ -0,0 +1,843 @@
+import * as fs from 'fs';
+import * as tools from '../src/tools';
+import {ToolData, ToolInput} from '../src/tools';
+
+function getData(data: Partial<ToolData>): ToolData {
+  const tool = data.tool || 'tool';
+  const version = data.version || '';
+  return {
+    tool,
+    version,
+    url: data.url || '',
+    domain: data.domain || 'https://example.com',
+    extension: data.extension || '.phar',
+    os: data.os || 'linux',
+    php_version: data.php_version || '7.4',
+    release: data.release || [tool, version].join(':'),
+    repository: data.repository || '',
+    scope: data.scope || 'global',
+    type: data.type || 'phar',
+    fetch_latest: data.fetch_latest || 'false',
+    version_parameter: data.version_parameter || '-V',
+    version_prefix: data.version_prefix || '',
+    github: data.github || 'https://github.com',
+    prefix: data.prefix || 'releases',
+    verb: data.verb || 'download',
+    packagist: data.packagist || data.repository || '',
+    function: data.function,
+    alias: data.alias,
+    uri: data.uri,
+    error: data.error
+  };
+}
+
+function unsetComposerAuthEnv(): void {
+  delete process.env['GITHUB_TOKEN'];
+  delete process.env['COMPOSER_TOKEN'];
+  delete process.env['COMPOSER_AUTH_JSON'];
+}
+
+/**
+ * Mock fetch.ts
+ */
+jest.mock('../src/fetch', () => ({
+  fetch: jest
+    .fn()
+    .mockImplementation(
+      async (url: string, token?: string): Promise<Record<string, string>> => {
+        if (url.includes('deployer')) {
+          return {
+            data: '[{"version": "1.2.3", "url": "https://deployer.org/releases/v1.2.3/deployer.phar"}]'
+          };
+        } else if (url.includes('atom') && !url.includes('no-')) {
+          return {
+            data: '"releases/tag/1.2.3", "releases/tag/3.2.1", "releases/tag/2.3.1"'
+          };
+        } else if (url.includes('no-data')) {
+          return {};
+        } else if (url.includes('no-release')) {
+          return {data: 'no-release'};
+        } else if (!token || token === 'valid_token') {
+          return {data: `[{"ref": "refs/tags/1.2.3", "url": "${url}"}]`};
+        } else if (token === 'beta_token') {
+          return {data: `[{"ref": "refs/tags/1.2.3beta1", "url": "${url}"}]`};
+        } else if (token === 'rc_token') {
+          return {
+            data: `[{"ref":"refs/tags/3.0.0RC1"},{"ref":"refs/tags/3.0.0RC2"}]`
+          };
+        } else if (token === 'non_semver_tags') {
+          return {
+            data: `[{"ref":"refs/tags/release-2025-09-18"},{"ref":"refs/tags/release-2025-09-17"}]`
+          };
+        } else if (token === 'undefined_ref') {
+          return {
+            data: `[{"url":"${url}"},{"ref":"refs/tags/v1.2.4","url":"${url}"}]`
+          };
+        } else if (token === 'multi_refs') {
+          return {
+            data: `[{"ref":"refs/tags/v1.2.3","url":"${url}"},{"ref":"refs/tags/1.2.4","url":"${url}"}]`
+          };
+        } else if (token === 'no_data') {
+          return {data: '[]'};
+        } else {
+          return {error: 'Invalid token'};
+        }
+      }
+    )
+}));
+
+jest.mock('../src/packagist', () => ({
+  search: jest
+    .fn()
+    .mockImplementation(
+      async (
+        package_name: string,
+        php_version: string
+      ): Promise<string | null> => {
+        if (package_name === 'phpunit/phpunit') {
+          return php_version + '.0';
+        }
+        return null;
+      }
+    )
+}));
+
+describe('Tools tests', () => {
+  it.each`
+    token                | version
+    ${'invalid_token'}   | ${'1.2'}
+    ${'valid_token'}     | ${'1.2.3'}
+    ${'beta_token'}      | ${'1.2.3beta1'}
+    ${'undefined_ref'}   | ${'1.2.4'}
+    ${'multi_refs'}      | ${'1.2.4'}
+    ${'non_semver_tags'} | ${'release-2025-09-18'}
+    ${''}                | ${'1.2.3'}
+  `('checking getSemverVersion: $token', async ({token, version}) => {
+    process.env['GITHUB_TOKEN'] = token;
+    expect(
+      await tools.getSemverVersion(getData({tool: 'tool', version: '1.2'}))
+    ).toBe(version);
+  });
+
+  it('checking getSemverVersion triggers ?? fallback via Map#get mock', async () => {
+    process.env['GITHUB_TOKEN'] = 'rc_token';
+    const spy = jest
+      .spyOn(Map.prototype as Map<string, string>, 'get')
+      .mockImplementation(function (
+        this: Map<string, string>,
+        key: string
+      ): string | undefined {
+        if (key === '3.0.0-RC2') {
+          return undefined;
+        }
+        return Map.prototype.get.call(this, key);
+      });
+    const result = await tools.getSemverVersion(
+      getData({tool: 'tool', version: '3.0.0'})
+    );
+    expect(result).toBe('3.0.0-RC2');
+    spy.mockRestore();
+  });
+
+  it.each`
+    tool                 | fetch_latest | version
+    ${'tool'}            | ${'true'}    | ${'3.2.1'}
+    ${'tool-no-data'}    | ${'true'}    | ${'latest'}
+    ${'tool-no-release'} | ${'true'}    | ${'latest'}
+    ${'tool'}            | ${'false'}   | ${'latest'}
+  `(
+    'checking getLatestVersion: $tool, $fetch_latest, $version',
+    async ({tool, fetch_latest, version}) => {
+      expect(
+        await tools.getLatestVersion(
+          getData({
+            tool: tool,
+            repository: 'user/' + tool,
+            fetch_latest: fetch_latest
+          })
+        )
+      ).toBe(version);
+    }
+  );
+
+  it('checking getLatestVersion with fetch_latest=true but no repository', async () => {
+    expect(
+      await tools.getLatestVersion(
+        getData({
+          tool: 'tool',
+          repository: '',
+          fetch_latest: 'true'
+        })
+      )
+    ).toBe('latest');
+  });
+
+  it.each`
+    version            | tool          | type          | expected
+    ${'latest'}        | ${'tool'}     | ${'phar'}     | ${'latest'}
+    ${'1'}             | ${'composer'} | ${'phar'}     | ${'1'}
+    ${'1.2'}           | ${'tool'}     | ${'composer'} | ${'1.2.*'}
+    ${'^1.2.3'}        | ${'tool'}     | ${'phar'}     | ${'1.2.3'}
+    ${'>=1.2.3'}       | ${'tool'}     | ${'phar'}     | ${'1.2.3'}
+    ${'>1.2.3'}        | ${'tool'}     | ${'phar'}     | ${'1.2.3'}
+    ${'1.2.3-ALPHA'}   | ${'tool'}     | ${'phar'}     | ${'1.2.3-ALPHA'}
+    ${'1.2.3-alpha'}   | ${'tool'}     | ${'phar'}     | ${'1.2.3-alpha'}
+    ${'1.2.3-beta'}    | ${'tool'}     | ${'phar'}     | ${'1.2.3-beta'}
+    ${'1.2.3-rc'}      | ${'tool'}     | ${'phar'}     | ${'1.2.3-rc'}
+    ${'1.2.3-dev'}     | ${'tool'}     | ${'phar'}     | ${'1.2.3-dev'}
+    ${'1.2.3-alpha1'}  | ${'tool'}     | ${'phar'}     | ${'1.2.3-alpha1'}
+    ${'1.2.3-alpha.1'} | ${'tool'}     | ${'phar'}     | ${'1.2.3-alpha.1'}
+    ${'1.>=0'}         | ${'tool'}     | ${'phar'}     | ${'1.0'}
+  `(
+    'checking getVersion: $version, $tool, $type',
+    async ({version, tool, type, expected}) => {
+      expect(
+        await tools.getVersion(
+          version,
+          getData({tool: tool, version: version, type: type})
+        )
+      ).toBe(expected);
+    }
+  );
+
+  it.each`
+    input                   | expected
+    ${'tool'}               | ${'tool'}
+    ${'alias:1.2.3'}        | ${'tool:1.2.3'}
+    ${'tool:1.2.3'}         | ${'tool:1.2.3'}
+    ${'tool:^1.2.3'}        | ${'tool:^1.2.3'}
+    ${'tool:>=1.2.3'}       | ${'tool:>=1.2.3'}
+    ${'tool:>1.2.3'}        | ${'tool:>1.2.3'}
+    ${'tool:1.2.3-ALPHA'}   | ${'tool:1.2.3-ALPHA'}
+    ${'tool:1.2.3-beta'}    | ${'tool:1.2.3-beta'}
+    ${'tool:1.2.3-rc'}      | ${'tool:1.2.3-rc'}
+    ${'tool:1.2.3-dev'}     | ${'tool:1.2.3-dev'}
+    ${'tool:1.2.3-alpha1'}  | ${'tool:1.2.3-alpha1'}
+    ${'tool:1.2.3-alpha.1'} | ${'tool:1.2.3-alpha.1'}
+    ${'user/tool:^1.2.3'}   | ${'tool:^1.2.3'}
+  `('checking getRelease: $input', async ({input, expected}) => {
+    expect(
+      await tools.getRelease(input, getData({tool: 'tool', version: 'latest'}))
+    ).toBe(expected);
+  });
+
+  it.each`
+    input_list                   | filtered_list
+    ${'a, b'}                    | ${'composer, a, b'}
+    ${'a, b, composer'}          | ${'composer, a, b'}
+    ${'a, b, composer:1.2.3'}    | ${'composer:1.2.3, a, b'}
+    ${'a, b, composer:v1.2.3'}   | ${'composer:1.2.3, a, b'}
+    ${'a, b, composer:snapshot'} | ${'composer:snapshot, a, b'}
+    ${'a, b, composer:preview'}  | ${'composer:preview, a, b'}
+    ${'a, b, composer:1'}        | ${'composer:1, a, b'}
+    ${'a, b, composer:2'}        | ${'composer:2, a, b'}
+    ${'a, b, composer:v1'}       | ${'composer:1, a, b'}
+    ${'a, b, composer:v2'}       | ${'composer:2, a, b'}
+  `('checking filterList $input_list', async ({input_list, filtered_list}) => {
+    expect(await tools.filterList(input_list.split(', '))).toStrictEqual(
+      filtered_list.split(', ')
+    );
+  });
+
+  it.each`
+    version     | version_prefix | url_suffix
+    ${'latest'} | ${'v'}         | ${'latest/download/tool.phar'}
+    ${'1.2.3'}  | ${'v'}         | ${'download/v1.2.3/tool.phar'}
+    ${'1.2.3'}  | ${''}          | ${'download/1.2.3/tool.phar'}
+  `(
+    'checking getUrl: $version_prefix$version',
+    async ({version, version_prefix, url_suffix}) => {
+      const data = getData({
+        tool: 'tool',
+        version: version,
+        version_prefix: version_prefix
+      });
+      expect(await tools.getUrl(data)).toContain(url_suffix);
+    }
+  );
+
+  it('checking getUrl handles undefined version without double slash', async () => {
+    const data: ToolInput = {
+      ...getData({
+        tool: 'cs2pr',
+        repository: 'staabm/annotate-pull-request-from-checkstyle',
+        domain: 'https://github.com'
+      }),
+      version: undefined
+    };
+    data.extension = '';
+    expect(await tools.getUrl(data)).toBe(
+      'https://github.com/staabm/annotate-pull-request-from-checkstyle/releases/latest/download/cs2pr'
+    );
+  });
+
+  it.each`
+    version     | version_prefix | url
+    ${'latest'} | ${''}          | ${'https://example.com/tool.phar'}
+    ${'1.2.3'}  | ${'v'}         | ${'https://example.com/tool-v1.2.3.phar'}
+  `(
+    'checking getPharUrl: $version_prefix$version',
+    async ({version, version_prefix, url}) => {
+      const data = getData({
+        tool: 'tool',
+        version: version,
+        version_prefix: version_prefix
+      });
+      expect(await tools.getPharUrl(data)).toBe(url);
+    }
+  );
+
+  it.each`
+    os           | script
+    ${'linux'}   | ${'add_tool https://example.com/tool.phar tool "-v"'}
+    ${'darwin'}  | ${'add_tool https://example.com/tool.phar tool "-v"'}
+    ${'win32'}   | ${'Add-Tool https://example.com/tool.phar tool "-v"'}
+    ${'openbsd'} | ${'Platform openbsd is not supported'}
+  `('checking addArchive: $os', async ({os, script}) => {
+    const data = getData({
+      tool: 'tool',
+      version: 'latest',
+      version_parameter: JSON.stringify('-v'),
+      os: os,
+      url: 'https://example.com/tool.phar'
+    });
+    expect(await tools.addArchive(data)).toContain(script);
+  });
+
+  it.each`
+    os           | release           | scope       | script
+    ${'linux'}   | ${'tool:1.2.3'}   | ${'global'} | ${'add_composer_tool tool tool:1.2.3 user/ global'}
+    ${'darwin'}  | ${'tool:1.2.3'}   | ${'scoped'} | ${'add_composer_tool tool tool:1.2.3 user/ scoped'}
+    ${'win32'}   | ${'tool:1.2.3'}   | ${'scoped'} | ${'Add-ComposerTool tool tool:1.2.3 user/ scoped'}
+    ${'linux'}   | ${'tool:>=1.2'}   | ${'global'} | ${'add_composer_tool tool "tool:>=1.2" user/ global'}
+    ${'win32'}   | ${'tool:>=1.2'}   | ${'global'} | ${'Add-ComposerTool tool "tool:>=1.2" user/ global'}
+    ${'linux'}   | ${'tool:1.*'}     | ${'global'} | ${'add_composer_tool tool "tool:1.*" user/ global'}
+    ${'linux'}   | ${'psalm:^5||^6'} | ${'global'} | ${'add_composer_tool tool "psalm:^5||^6" user/ global'}
+    ${'linux'}   | ${'psalm:>=5,<6'} | ${'global'} | ${'add_composer_tool tool "psalm:>=5,<6" user/ global'}
+    ${'openbsd'} | ${'tool:1.2.3'}   | ${'global'} | ${'Platform openbsd is not supported'}
+  `(
+    'checking addPackage: $os, $release',
+    async ({os, release, scope, script}) => {
+      const data = getData({
+        tool: 'tool',
+        version: '1.2.3',
+        repository: 'user/tool',
+        os,
+        scope
+      });
+      data['release'] = release;
+      expect(await tools.addPackage(data)).toContain(script);
+    }
+  );
+
+  it.each`
+    version     | php_version | os          | script
+    ${'latest'} | ${'8.0'}    | ${'linux'}  | ${'add_tool https://github.com/phar-io/phive/releases/download/3.2.1/phive-3.2.1.phar phive'}
+    ${'1.2.3'}  | ${'8.0'}    | ${'darwin'} | ${'add_tool https://github.com/phar-io/phive/releases/download/1.2.3/phive-1.2.3.phar phive'}
+    ${'1.2.3'}  | ${'7.4'}    | ${'win32'}  | ${'Add-Tool https://github.com/phar-io/phive/releases/download/0.15.3/phive-0.15.3.phar phive'}
+    ${'1.2.3'}  | ${'7.2'}    | ${'win32'}  | ${'Add-Tool https://github.com/phar-io/phive/releases/download/0.14.5/phive-0.14.5.phar phive'}
+    ${'1.2.3'}  | ${'7.1'}    | ${'win32'}  | ${'Add-Tool https://github.com/phar-io/phive/releases/download/0.13.5/phive-0.13.5.phar phive'}
+    ${'latest'} | ${'5.6'}    | ${'win32'}  | ${'Add-Tool https://github.com/phar-io/phive/releases/download/0.12.1/phive-0.12.1.phar phive'}
+    ${'latest'} | ${'5.5'}    | ${'win32'}  | ${'Phive is not supported on PHP 5.5'}
+  `(
+    'checking addPhive: $version, $php_version, $os',
+    async ({version, php_version, os, script}) => {
+      const data = getData({
+        tool: 'phive',
+        repository: 'phar-io/phive',
+        version_parameter: 'status',
+        version: version,
+        php_version: php_version,
+        os: os
+      });
+      script = await tools.addPhive(data);
+      expect(script).toContain(script);
+    }
+  );
+
+  it.each`
+    os         | version     | php_version | url
+    ${'linux'} | ${'latest'} | ${'8.1'}    | ${'https://get.blackfire.io/blackfire-player.phar'}
+    ${'linux'} | ${'1.2.3'}  | ${'7.4'}    | ${'https://get.blackfire.io/blackfire-player-v1.2.3.phar'}
+    ${'linux'} | ${'latest'} | ${'7.4'}    | ${'https://get.blackfire.io/blackfire-player-v1.22.0.phar'}
+    ${'linux'} | ${'latest'} | ${'5.5'}    | ${'https://get.blackfire.io/blackfire-player-v1.9.3.phar'}
+    ${'linux'} | ${'latest'} | ${'7.0'}    | ${'https://get.blackfire.io/blackfire-player-v1.9.3.phar'}
+    ${'win32'} | ${'latest'} | ${'7.0'}    | ${'blackfire-player is not a windows tool'}
+  `(
+    'checking addBlackfirePlayer: $os, $version, $php_version',
+    async ({os, version, php_version, url}) => {
+      const data = getData({
+        os: os,
+        tool: 'blackfire-player',
+        domain: 'https://get.blackfire.io',
+        version_prefix: 'v',
+        version: version,
+        php_version: php_version
+      });
+      expect(await tools.addBlackfirePlayer(data)).toContain(url);
+    }
+  );
+
+  it.each`
+    version     | url
+    ${'latest'} | ${'https://deployer.org/deployer.phar'}
+    ${'1.2.3'}  | ${'https://deployer.org/releases/v1.2.3/deployer.phar'}
+    ${'3.2.1'}  | ${'Version missing in deployer manifest'}
+  `('checking addDeployer: $version', async ({version, url}) => {
+    const data = getData({
+      tool: 'deployer',
+      domain: 'https://deployer.org',
+      version: version
+    });
+    expect(await tools.addDeployer(data)).toContain(url);
+  });
+
+  it.each`
+    version        | php_version | no_tool_cache | cache_url                                                                                               | source_url
+    ${'latest'}    | ${'7.4'}    | ${'true'}     | ${'https://github.com/shivammathur/composer-cache/releases/latest/download/composer-7.4-stable.phar'}   | ${'https://getcomposer.org/composer-stable.phar'}
+    ${'stable'}    | ${'7.4'}    | ${'true'}     | ${'https://github.com/shivammathur/composer-cache/releases/latest/download/composer-7.4-stable.phar'}   | ${'https://getcomposer.org/composer-stable.phar'}
+    ${'snapshot'}  | ${'7.4'}    | ${'true'}     | ${'https://github.com/shivammathur/composer-cache/releases/latest/download/composer-7.4-snapshot.phar'} | ${'https://getcomposer.org/composer.phar'}
+    ${'preview'}   | ${'7.4'}    | ${'true'}     | ${'https://github.com/shivammathur/composer-cache/releases/latest/download/composer-7.4-preview.phar'}  | ${'https://getcomposer.org/composer-preview.phar'}
+    ${'1'}         | ${'7.4'}    | ${'false'}    | ${'https://github.com/shivammathur/composer-cache/releases/latest/download/composer-7.4-1.phar'}        | ${'https://getcomposer.org/composer-1.phar'}
+    ${'2'}         | ${'7.4'}    | ${'false'}    | ${'https://github.com/shivammathur/composer-cache/releases/latest/download/composer-7.4-2.phar'}        | ${'https://getcomposer.org/composer-2.phar'}
+    ${'latest'}    | ${'7.4'}    | ${'true'}     | ${'https://dl.cloudsmith.io/public/shivammathur/composer-cache/raw/files/composer-7.4-stable.phar'}     | ${'https://getcomposer.org/composer-stable.phar'}
+    ${'stable'}    | ${'7.4'}    | ${'true'}     | ${'https://dl.cloudsmith.io/public/shivammathur/composer-cache/raw/files/composer-7.4-stable.phar'}     | ${'https://getcomposer.org/composer-stable.phar'}
+    ${'snapshot'}  | ${'7.4'}    | ${'true'}     | ${'https://dl.cloudsmith.io/public/shivammathur/composer-cache/raw/files/composer-7.4-snapshot.phar'}   | ${'https://getcomposer.org/composer.phar'}
+    ${'preview'}   | ${'7.4'}    | ${'true'}     | ${'https://dl.cloudsmith.io/public/shivammathur/composer-cache/raw/files/composer-7.4-preview.phar'}    | ${'https://getcomposer.org/composer-preview.phar'}
+    ${'1'}         | ${'7.4'}    | ${'false'}    | ${'https://dl.cloudsmith.io/public/shivammathur/composer-cache/raw/files/composer-7.4-1.phar'}          | ${'https://getcomposer.org/composer-1.phar'}
+    ${'2'}         | ${'7.4'}    | ${'false'}    | ${'https://dl.cloudsmith.io/public/shivammathur/composer-cache/raw/files/composer-7.4-2.phar'}          | ${'https://getcomposer.org/composer-2.phar'}
+    ${'latest'}    | ${'7.4'}    | ${'true'}     | ${'https://artifacts.setup-php.com/composer/composer-7.4-stable.phar'}                                  | ${'https://getcomposer.org/composer-stable.phar'}
+    ${'stable'}    | ${'7.4'}    | ${'true'}     | ${'https://artifacts.setup-php.com/composer/composer-7.4-stable.phar'}                                  | ${'https://getcomposer.org/composer-stable.phar'}
+    ${'snapshot'}  | ${'7.4'}    | ${'true'}     | ${'https://artifacts.setup-php.com/composer/composer-7.4-snapshot.phar'}                                | ${'https://getcomposer.org/composer.phar'}
+    ${'preview'}   | ${'7.4'}    | ${'true'}     | ${'https://artifacts.setup-php.com/composer/composer-7.4-preview.phar'}                                 | ${'https://getcomposer.org/composer-preview.phar'}
+    ${'1'}         | ${'7.4'}    | ${'false'}    | ${'https://artifacts.setup-php.com/composer/composer-7.4-1.phar'}                                       | ${'https://getcomposer.org/composer-1.phar'}
+    ${'2'}         | ${'7.4'}    | ${'false'}    | ${'https://artifacts.setup-php.com/composer/composer-7.4-2.phar'}                                       | ${'https://getcomposer.org/composer-2.phar'}
+    ${'latest'}    | ${'7.1'}    | ${'true'}     | ${'https://github.com/shivammathur/composer-cache/releases/latest/download/composer-7.1-stable.phar'}   | ${'https://getcomposer.org/download/latest-2.2.x/composer.phar'}
+    ${'stable'}    | ${'7.1'}    | ${'true'}     | ${'https://github.com/shivammathur/composer-cache/releases/latest/download/composer-7.1-stable.phar'}   | ${'https://getcomposer.org/download/latest-2.2.x/composer.phar'}
+    ${'snapshot'}  | ${'7.1'}    | ${'true'}     | ${'https://github.com/shivammathur/composer-cache/releases/latest/download/composer-7.1-snapshot.phar'} | ${'https://getcomposer.org/download/latest-2.2.x/composer.phar'}
+    ${'preview'}   | ${'7.1'}    | ${'true'}     | ${'https://github.com/shivammathur/composer-cache/releases/latest/download/composer-7.1-preview.phar'}  | ${'https://getcomposer.org/download/latest-2.2.x/composer.phar'}
+    ${'1'}         | ${'7.1'}    | ${'false'}    | ${'https://github.com/shivammathur/composer-cache/releases/latest/download/composer-7.1-1.phar'}        | ${'https://getcomposer.org/composer-1.phar'}
+    ${'2'}         | ${'7.1'}    | ${'false'}    | ${'https://github.com/shivammathur/composer-cache/releases/latest/download/composer-7.1-2.phar'}        | ${'https://getcomposer.org/download/latest-2.2.x/composer.phar'}
+    ${'1.2.3'}     | ${'7.4'}    | ${'false'}    | ${'https://github.com/composer/composer/releases/download/1.2.3/composer.phar'}                         | ${'https://getcomposer.org/download/1.2.3/composer.phar'}
+    ${'1.2.3-RC1'} | ${'7.4'}    | ${'false'}    | ${'https://github.com/composer/composer/releases/download/1.2.3-RC1/composer.phar'}                     | ${'https://getcomposer.org/download/1.2.3-RC1/composer.phar'}
+  `(
+    'checking addComposer: $version, $php_version, $no_tool_cache',
+    async ({version, php_version, no_tool_cache, cache_url, source_url}) => {
+      const data = getData({
+        tool: 'composer',
+        php_version: php_version,
+        domain: 'https://getcomposer.org',
+        repository: 'composer/composer',
+        version: version
+      });
+      process.env['no_tools_cache'] = no_tool_cache;
+      expect(await tools.addComposer(data)).toContain(source_url);
+      if (no_tool_cache !== 'true') {
+        expect(await tools.addComposer(data)).toContain(cache_url);
+      }
+    }
+  );
+
+  it.each`
+    version            | affected
+    ${'1'}             | ${false}
+    ${'1.0.0-alpha1'}  | ${true}
+    ${'1.0.0-alpha2'}  | ${true}
+    ${'1.0.0-alpha3'}  | ${true}
+    ${'1.0.0-alpha4'}  | ${true}
+    ${'1.0.0-alpha5'}  | ${true}
+    ${'1.0.0-alpha6'}  | ${true}
+    ${'1.0.0-alpha7'}  | ${true}
+    ${'1.0.0-alpha8'}  | ${true}
+    ${'1.0.0-alpha9'}  | ${true}
+    ${'1.0.0-alpha10'} | ${true}
+    ${'1.0.0-alpha11'} | ${true}
+    ${'1.0.0-beta1'}   | ${true}
+    ${'1.0.0-beta2'}   | ${true}
+    ${'1.0.0'}         | ${true}
+    ${'1.10.27'}       | ${true}
+    ${'1.10.28'}       | ${false}
+    ${'2.0.0-alpha1'}  | ${true}
+    ${'2.0.0-alpha2'}  | ${true}
+    ${'2.0.0-alpha3'}  | ${true}
+    ${'2.0.0-RC1'}     | ${true}
+    ${'2.0.0-RC2'}     | ${true}
+    ${'2.2.27'}        | ${true}
+    ${'2.2.28'}        | ${false}
+    ${'2.3.0-RC1'}     | ${true}
+    ${'2.3.0-RC2'}     | ${true}
+    ${'2.9.7'}         | ${true}
+    ${'2.9.7-RC1'}     | ${true}
+    ${'2.9.8'}         | ${false}
+    ${'2.9.0RC1'}      | ${false}
+    ${'2.9.x-dev'}     | ${false}
+  `('checking affected composer version: $version', ({version, affected}) => {
+    expect(tools.skipGitHubAuthForComposerVersion(version)).toBe(affected);
+  });
+
+  it('checking affected composer version with CRLF ranges', async () => {
+    let affected = false;
+    let fixed = true;
+    await jest.isolateModulesAsync(async () => {
+      jest.doMock('fs', () => ({
+        ...jest.requireActual('fs'),
+        readFileSync: (
+          filePath: fs.PathOrFileDescriptor,
+          options?: unknown
+        ) => {
+          if (String(filePath).includes('composer-gh-auth-no-op')) {
+            return '1.0.0-0 1.10.28\r\n2.0.0-0 2.2.28\r\n2.3.0-0 2.9.8';
+          }
+          return (jest.requireActual('fs') as typeof fs).readFileSync(
+            filePath,
+            options as fs.ObjectEncodingOptions & {flag?: string}
+          );
+        }
+      }));
+      const isolatedTools = await import('../src/tools');
+      affected = isolatedTools.skipGitHubAuthForComposerVersion('2.9.7');
+      fixed = isolatedTools.skipGitHubAuthForComposerVersion('2.9.8');
+    });
+    expect(affected).toBe(true);
+    expect(fixed).toBe(false);
+  });
+
+  it.each`
+    auth_json                                                                                                          | expected
+    ${'{"github-oauth":{"github.com":"ghs_new-token"},"http-basic":{"repo.example":{"username":"u","password":"p"}}}'} | ${'{"http-basic":{"repo.example":{"username":"u","password":"p"}}}'}
+    ${'{"github-oauth":{"github.com":"ghs_new-token"}}'}                                                               | ${undefined}
+    ${'{"http-basic":{"repo.example":{"username":"u","password":"p"}}}'}                                               | ${'{"http-basic":{"repo.example":{"username":"u","password":"p"}}}'}
+    ${'{"nested":{"github-oauth":{"github.com":"ghs_new-token"}}}'}                                                    | ${'{"nested":{"github-oauth":{"github.com":"ghs_new-token"}}}'}
+    ${'{"github-oauth":'}                                                                                              | ${'{"github-oauth":'}
+  `('cleaning composer auth json', ({auth_json, expected}) => {
+    unsetComposerAuthEnv();
+    process.env['COMPOSER_AUTH_JSON'] = auth_json;
+    tools.cleanComposerAuthJson();
+    expect(process.env['COMPOSER_AUTH_JSON']).toBe(expected);
+    unsetComposerAuthEnv();
+  });
+
+  it.each`
+    version     | os         | envs                                                                                       | skip_github_auth
+    ${'latest'} | ${'linux'} | ${{GITHUB_TOKEN: 'ghs_token'}}                                                             | ${false}
+    ${'1'}      | ${'linux'} | ${{GITHUB_TOKEN: 'ghs_token'}}                                                             | ${false}
+    ${'2'}      | ${'linux'} | ${{GITHUB_TOKEN: 'ghs_token'}}                                                             | ${false}
+    ${'2.9.7'}  | ${'linux'} | ${{}}                                                                                      | ${true}
+    ${'2.9.7'}  | ${'linux'} | ${{GITHUB_TOKEN: 'ghs_token'}}                                                             | ${true}
+    ${'2.9.7'}  | ${'linux'} | ${{COMPOSER_TOKEN: 'ghs_token'}}                                                           | ${true}
+    ${'2.9.7'}  | ${'linux'} | ${{COMPOSER_AUTH_JSON: '{"github-oauth":{"github.com":"ghs_new-token"}}'}}                 | ${true}
+    ${'2.9.7'}  | ${'linux'} | ${{COMPOSER_AUTH_JSON: '{"http-basic":{"repo.example":{"username":"u","password":"p"}}}'}} | ${true}
+    ${'2.9.8'}  | ${'linux'} | ${{GITHUB_TOKEN: 'ghs_token'}}                                                             | ${false}
+    ${'2.9.7'}  | ${'win32'} | ${{GITHUB_TOKEN: 'ghs_token'}}                                                             | ${true}
+  `(
+    'checking composer github auth skip flag: $version, $os',
+    async ({version, os, envs, skip_github_auth}) => {
+      unsetComposerAuthEnv();
+      Object.assign(process.env, envs);
+      const data = getData({
+        tool: 'composer',
+        os: os,
+        php_version: '7.4',
+        domain: 'https://getcomposer.org',
+        repository: 'composer/composer',
+        version: version
+      });
+      const script = await tools.addComposer(data);
+      expect(script).toContain(
+        `composer ${version}${skip_github_auth ? ' true' : ''}`
+      );
+      unsetComposerAuthEnv();
+    }
+  );
+
+  it.each`
+    version     | uri
+    ${'latest'} | ${'wp-cli/builds/blob/gh-pages/phar/wp-cli.phar?raw=true'}
+    ${'1.2.3'}  | ${'wp-cli/wp-cli/releases/download/v1.2.3/wp-cli-1.2.3.phar'}
+  `('checking addWPCLI: $version', async ({version, uri}) => {
+    const data = getData({
+      tool: 'wp-cli',
+      repository: 'wp-cli/wp-cli',
+      php_version: '7.4',
+      version_prefix: 'v',
+      version: version
+    });
+    expect(await tools.addWPCLI(data)).toContain(uri);
+  });
+
+  it.each`
+    tool            | os           | script
+    ${'phpize'}     | ${'linux'}   | ${'add_devtools phpize'}
+    ${'php-config'} | ${'linux'}   | ${'add_devtools php-config'}
+    ${'phpize'}     | ${'darwin'}  | ${'add_devtools phpize'}
+    ${'php-config'} | ${'darwin'}  | ${'add_devtools php-config'}
+    ${'phpize'}     | ${'win32'}   | ${'Add-Log "$tick" "phpize" "phpize is not a windows tool"'}
+    ${'php-config'} | ${'win32'}   | ${'Add-Log "$tick" "php-config" "php-config is not a windows tool"'}
+    ${'phpize'}     | ${'openbsd'} | ${'Platform openbsd is not supported'}
+  `('checking addDevTools: $tool, $os', async ({tool, os, script}) => {
+    const data = getData({
+      version: '7.4',
+      tool: tool,
+      os: os
+    });
+    expect(await tools.addDevTools(data)).toContain(script);
+  });
+
+  it.each([
+    [
+      'blackfire, blackfire-player, box, churn, cs2pr, flex, grpc_php_plugin, mago, name-collision-detector, parallel-lint, php-cs-fixer, php-scoper, phpDocumentor, phplint, phpstan, phpunit, pecl, phing, phinx, phinx:1.2.3, phive, phpunit-bridge, phpunit-polyfills, pint, php-config, phpize, protoc, symfony, vapor, wp, pie',
+      [
+        'add_tool https://github.com/shivammathur/composer-cache/releases/latest/download/composer-7.4-stable.phar,https://artifacts.setup-php.com/composer/composer-7.4-stable.phar,https://dl.cloudsmith.io/public/shivammathur/composer-cache/raw/files/composer-7.4-stable.phar,https://getcomposer.org/composer-stable.phar composer',
+        'add_blackfire',
+        'add_tool https://get.blackfire.io/blackfire-player-v1.22.0.phar blackfire-player "-V"',
+        'add_tool https://github.com/box-project/box/releases/latest/download/box.phar box "--version"',
+        'add_tool https://github.com/bmitch/churn-php/releases/latest/download/churn.phar churn "-V"',
+        'add_tool https://github.com/staabm/annotate-pull-request-from-checkstyle/releases/latest/download/cs2pr cs2pr "-V"',
+        'add_composer_tool flex flex symfony/ global',
+        'add_grpc_php_plugin latest',
+        'add_mago',
+        'add_composer_tool name-collision-detector name-collision-detector shipmonk/ scoped',
+        'add_tool https://github.com/php-parallel-lint/PHP-Parallel-Lint/releases/latest/download/parallel-lint.phar parallel-lint "--version"',
+        'add_tool https://github.com/PHP-CS-Fixer/PHP-CS-Fixer/releases/download/v3.2.1/php-cs-fixer.phar php-cs-fixer "-V"',
+        'add_tool https://github.com/humbug/php-scoper/releases/latest/download/php-scoper.phar php-scoper "--version"',
+        'add_tool https://github.com/phpDocumentor/phpDocumentor/releases/latest/download/phpDocumentor.phar phpDocumentor "--version"',
+        'add_composer_tool phplint phplint overtrue/',
+        'add_tool https://github.com/phpstan/phpstan/releases/latest/download/phpstan.phar phpstan "-V"',
+        'add_tool https://phar.phpunit.de/phpunit-7.4.0.phar,https://phar.phpunit.de/phpunit-7.phar phpunit "--version"',
+        'add_pecl',
+        'add_tool https://www.phing.info/get/phing-latest.phar phing "-v"',
+        'add_composer_tool phinx phinx robmorgan/ scoped',
+        'add_composer_tool phinx phinx:1.2.3 robmorgan/ scoped',
+        'add_tool https://github.com/phar-io/phive/releases/download/0.15.3/phive-0.15.3.phar phive "status"',
+        'add_composer_tool phpunit-bridge phpunit-bridge symfony/ global',
+        'add_composer_tool phpunit-polyfills phpunit-polyfills yoast/ global',
+        'add_tool https://github.com/laravel/pint/releases/latest/download/pint.phar pint "-V"',
+        'add_devtools php-config',
+        'add_devtools phpize',
+        'add_protoc latest',
+        'add_symfony latest',
+        'add_composer_tool vapor-cli vapor-cli laravel/ scoped',
+        'add_tool https://github.com/wp-cli/builds/blob/gh-pages/phar/wp-cli.phar?raw=true wp-cli "--version"',
+        'add_tool https://github.com/php/pie/releases/latest/download/pie.phar pie "-V"'
+      ]
+    ]
+  ])('checking addTools on linux', async (tools_csv, scripts) => {
+    const expected = await tools.addTools(tools_csv, '7.4', 'linux');
+    scripts.forEach(script => {
+      expect(expected).toContain(script);
+    });
+  });
+
+  it.each([
+    [
+      'backward-compatibility-check, behat, blackfire, blackfire-player, churn, composer-dependency-analyser, composer-normalize, composer-require-checker, composer-unused, cs2pr:1.2.3, ecs, flex, grpc_php_plugin:1.2.3, infection, mago:0.26.1, name-collision-detector, phan, phan:1.2.3, phing:1.2.3, phinx, phive:1.2.3, php-config, phpcbf, phpcpd, phpcs, phpdoc, phpize, phpmd, phpspec, phpunit-bridge:5.6, phpunit-polyfills:1.0.1, protoc:v1.2.3, psalm, rector, symfony-cli, vapor-cli, wp-cli, pie',
+      [
+        'add_tool https://github.com/shivammathur/composer-cache/releases/latest/download/composer-7.4-stable.phar,https://artifacts.setup-php.com/composer/composer-7.4-stable.phar,https://dl.cloudsmith.io/public/shivammathur/composer-cache/raw/files/composer-7.4-stable.phar,https://getcomposer.org/composer-stable.phar composer',
+        'add_composer_tool behat behat behat/ scoped',
+        'add_blackfire',
+        'add_tool https://get.blackfire.io/blackfire-player-v1.22.0.phar blackfire-player "-V"',
+        'add_tool https://github.com/bmitch/churn-php/releases/latest/download/churn.phar churn "-V"',
+        'add_tool https://github.com/ergebnis/composer-normalize/releases/latest/download/composer-normalize.phar composer-normalize "diagnose"',
+        'add_composer_tool composer-dependency-analyser composer-dependency-analyser shipmonk/ scoped',
+        'add_composer_tool composer-require-checker composer-require-checker maglnet/ scoped',
+        'add_tool https://github.com/composer-unused/composer-unused/releases/latest/download/composer-unused.phar composer-unused "-V"',
+        'add_tool https://github.com/staabm/annotate-pull-request-from-checkstyle/releases/download/1.2.3/cs2pr cs2pr "-V"',
+        'add_composer_tool flex flex symfony/ global',
+        'add_grpc_php_plugin 1.2.3',
+        'add_tool https://github.com/infection/infection/releases/latest/download/infection.phar infection "-V"',
+        'add_mago 0.26.1',
+        'add_composer_tool name-collision-detector name-collision-detector shipmonk/ scoped',
+        'add_tool https://github.com/phan/phan/releases/latest/download/phan.phar phan "-v"',
+        'add_tool https://github.com/phan/phan/releases/download/1.2.3/phan.phar phan "-v"',
+        'add_tool https://www.phing.info/get/phing-1.2.3.phar,https://github.com/phingofficial/phing/releases/download/1.2.3/phing-1.2.3.phar phing "-v"',
+        'add_composer_tool phinx phinx robmorgan/ scoped',
+        'add_tool https://github.com/phar-io/phive/releases/download/0.15.3/phive-0.15.3.phar phive',
+        'add_devtools php-config',
+        'add_tool https://github.com/PHPCSStandards/PHP_CodeSniffer/releases/latest/download/phpcbf.phar phpcbf "--version"',
+        'add_tool https://phar.phpunit.de/phpcpd.phar phpcpd "--version"',
+        'add_tool https://github.com/PHPCSStandards/PHP_CodeSniffer/releases/latest/download/phpcs.phar phpcs "--version"',
+        'add_tool https://github.com/phpDocumentor/phpDocumentor/releases/latest/download/phpDocumentor.phar phpDocumentor "--version"',
+        'add_devtools phpize',
+        'add_tool https://github.com/phpmd/phpmd/releases/latest/download/phpmd.phar phpmd "--version"',
+        'add_tool https://github.com/phpspec/phpspec/releases/latest/download/phpspec.phar phpspec "-V"',
+        'add_composer_tool phpunit-bridge "phpunit-bridge:5.6.*" symfony/ global',
+        'add_composer_tool phpunit-polyfills phpunit-polyfills:1.0.1 yoast/ global',
+        'add_protoc 1.2.3',
+        'add_tool https://github.com/vimeo/psalm/releases/latest/download/psalm.phar psalm "-v"',
+        'add_composer_tool rector rector rector/ scoped',
+        'add_composer_tool backward-compatibility-check backward-compatibility-check roave/ scoped',
+        'add_symfony latest',
+        'add_composer_tool vapor-cli vapor-cli laravel/ scoped',
+        'add_tool https://github.com/wp-cli/builds/blob/gh-pages/phar/wp-cli.phar?raw=true wp-cli "--version"',
+        'add_composer_tool easy-coding-standard easy-coding-standard symplify/ scoped',
+        'add_tool https://github.com/php/pie/releases/latest/download/pie.phar pie "-V"'
+      ]
+    ]
+  ])('checking addTools on darwin', async (tools_csv, scripts) => {
+    const expected = await tools.addTools(tools_csv, '7.4', 'darwin');
+    scripts.forEach(script => {
+      expect(expected).toContain(script);
+    });
+  });
+
+  it.each([
+    [
+      'blackfire, blackfire-player:1.2.3, cs2pr, churn, deployer, does_not_exist, flex, mago, name-collision-detector, phinx, phive:0.13.2, php-config, phpize, phpmd, simple-phpunit, symfony, wp, pie',
+      [
+        'Add-Tool https://github.com/shivammathur/composer-cache/releases/latest/download/composer-7.4-stable.phar,https://artifacts.setup-php.com/composer/composer-7.4-stable.phar,https://dl.cloudsmith.io/public/shivammathur/composer-cache/raw/files/composer-7.4-stable.phar,https://getcomposer.org/composer-stable.phar composer',
+        'Add-Blackfire',
+        'blackfire-player is not a windows tool',
+        'Add-Tool https://github.com/staabm/annotate-pull-request-from-checkstyle/releases/latest/download/cs2pr cs2pr "-V"',
+        'Add-Tool https://github.com/bmitch/churn-php/releases/latest/download/churn.phar churn "-V"',
+        'Add-Tool https://deployer.org/deployer.phar deployer "-V"',
+        'Tool does_not_exist is not supported',
+        'Add-ComposerTool flex flex symfony/ global',
+        'Add-Mago',
+        'Add-ComposerTool name-collision-detector name-collision-detector shipmonk/ scoped',
+        'Add-ComposerTool phinx phinx robmorgan/ scoped',
+        'Add-Tool https://github.com/phar-io/phive/releases/download/0.15.3/phive-0.15.3.phar phive "status"',
+        'php-config is not a windows tool',
+        'phpize is not a windows tool',
+        'Add-Tool https://github.com/phpmd/phpmd/releases/latest/download/phpmd.phar phpmd "--version"',
+        'Add-ComposerTool phpunit-bridge phpunit-bridge symfony/ global',
+        'Add-Symfony',
+        'Add-Tool https://github.com/wp-cli/builds/blob/gh-pages/phar/wp-cli.phar?raw=true wp-cli "--version"',
+        'Add-Tool https://github.com/php/pie/releases/latest/download/pie.phar pie "-V"'
+      ]
+    ]
+  ])('checking addTools on Windows', async (tools_csv, scripts) => {
+    const expected = await tools.addTools(tools_csv, '7.4', 'win32');
+    scripts.forEach(script => {
+      expect(expected).toContain(script);
+    });
+  });
+
+  it.each([
+    [
+      'composer:v1, codeception/codeception, prestissimo, hirak/prestissimo, composer-prefetcher, narrowspark/automatic-composer-prefetcher, phinx: 1.2, robmorgan/phinx: ^1.2, user/tool:1.2.3, user/tool:~1.2',
+      [
+        'Add-Tool https://github.com/shivammathur/composer-cache/releases/latest/download/composer-7.4-1.phar,https://artifacts.setup-php.com/composer/composer-7.4-1.phar,https://dl.cloudsmith.io/public/shivammathur/composer-cache/raw/files/composer-7.4-1.phar,https://getcomposer.org/composer-1.phar composer',
+        'Add-ComposerTool codeception codeception codeception/ global',
+        'Add-ComposerTool prestissimo prestissimo hirak/ global',
+        'Add-ComposerTool automatic-composer-prefetcher automatic-composer-prefetcher narrowspark/ global',
+        'Add-ComposerTool phinx "phinx:1.2.*" robmorgan/ scoped',
+        'Add-ComposerTool phinx phinx:^1.2 robmorgan/ global',
+        'Add-ComposerTool tool tool:1.2.3 user/ global',
+        'Add-ComposerTool tool tool:~1.2 user/ global'
+      ]
+    ]
+  ])(
+    'checking addTools with composer tool using user/tool as input',
+    async (tools_csv, scripts) => {
+      const expected = await tools.addTools(tools_csv, '7.4', 'win32');
+      scripts.forEach(script => {
+        expect(expected).toContain(script);
+      });
+    }
+  );
+
+  it.each`
+    version     | os           | uri
+    ${'latest'} | ${'linux'}   | ${'releases/latest/download/castor.linux-amd64.phar'}
+    ${'0.5.1'}  | ${'linux'}   | ${'releases/download/v0.5.1/castor.linux-amd64.phar'}
+    ${'latest'} | ${'darwin'}  | ${'releases/latest/download/castor.darwin-amd64.phar'}
+    ${'0.5.1'}  | ${'darwin'}  | ${'releases/download/v0.5.1/castor.darwin-amd64.phar'}
+    ${'latest'} | ${'win32'}   | ${'releases/latest/download/castor.windows-amd64.phar'}
+    ${'0.5.1'}  | ${'win32'}   | ${'releases/download/v0.5.1/castor.windows-amd64.phar castor -V'}
+    ${'latest'} | ${'openbsd'} | ${'Platform openbsd is not supported'}
+  `('checking addCastor: $version, $os', async ({version, os, uri}) => {
+    const data = getData({
+      tool: 'castor',
+      php_version: '8.1',
+      version_prefix: 'v',
+      version: version,
+      os: os
+    });
+    if (os === 'win32' && version === '0.5.1') {
+      fs.writeFileSync('castor.php', '');
+      expect(await tools.addCastor(data)).toContain(uri);
+      fs.unlinkSync('castor.php');
+    } else {
+      expect(await tools.addCastor(data)).toContain(uri);
+    }
+  });
+
+  it.each`
+    tools_csv                                             | script
+    ${'none'}                                             | ${''}
+    ${'none, phpunit'}                                    | ${'\nstep_log "Setup Tools"\nadd_tool https://github.com/shivammathur/composer-cache/releases/latest/download/composer-7.4-stable.phar,https://artifacts.setup-php.com/composer/composer-7.4-stable.phar,https://dl.cloudsmith.io/public/shivammathur/composer-cache/raw/files/composer-7.4-stable.phar,https://getcomposer.org/composer-stable.phar composer latest\n\nadd_tool https://phar.phpunit.de/phpunit-7.4.0.phar,https://phar.phpunit.de/phpunit-7.phar phpunit "--version"'}
+    ${'composer:preview'}                                 | ${'add_tool https://github.com/shivammathur/composer-cache/releases/latest/download/composer-7.4-preview.phar,https://artifacts.setup-php.com/composer/composer-7.4-preview.phar,https://dl.cloudsmith.io/public/shivammathur/composer-cache/raw/files/composer-7.4-preview.phar,https://getcomposer.org/composer-preview.phar composer preview'}
+    ${'composer, composer:v1'}                            | ${'add_tool https://github.com/shivammathur/composer-cache/releases/latest/download/composer-7.4-1.phar,https://artifacts.setup-php.com/composer/composer-7.4-1.phar,https://dl.cloudsmith.io/public/shivammathur/composer-cache/raw/files/composer-7.4-1.phar,https://getcomposer.org/composer-1.phar composer'}
+    ${'composer:v1, composer:preview, composer:snapshot'} | ${'add_tool https://github.com/shivammathur/composer-cache/releases/latest/download/composer-7.4-snapshot.phar,https://artifacts.setup-php.com/composer/composer-7.4-snapshot.phar,https://dl.cloudsmith.io/public/shivammathur/composer-cache/raw/files/composer-7.4-snapshot.phar,https://getcomposer.org/composer.phar composer snapshot'}
+    ${'composer:2.9.7'}                                   | ${'add_tool https://github.com/composer/composer/releases/download/2.9.7/composer.phar,https://getcomposer.org/download/2.9.7/composer.phar composer 2.9.7 true'}
+  `('checking composer setup: $tools_csv', async ({tools_csv, script}) => {
+    expect(await tools.addTools(tools_csv, '7.4', 'linux')).toContain(script);
+  });
+
+  it.each`
+    tools_csv        | token              | script
+    ${'cs2pr:1.2'}   | ${'invalid_token'} | ${'add_log "$cross" "cs2pr" "Invalid token"'}
+    ${'phpunit:1.2'} | ${'invalid_token'} | ${'add_log "$cross" "phpunit" "Invalid token"'}
+    ${'phpunit:0.1'} | ${'no_data'}       | ${'add_log "$cross" "phpunit" "No version found with prefix 0.1."'}
+  `('checking error: $tools_csv', async ({tools_csv, token, script}) => {
+    process.env['GITHUB_TOKEN'] = token;
+    expect(await tools.addTools(tools_csv, '7.4', 'linux')).toContain(script);
+  });
+
+  it('checking error when custom-function tool is missing function field', async () => {
+    const brokenToolsJson = JSON.stringify({
+      composer: {
+        type: 'custom-function',
+        domain: 'https://getcomposer.org',
+        repository: 'composer/composer',
+        function: 'composer'
+      },
+      'broken-tool': {
+        type: 'custom-function'
+      }
+    });
+
+    let result: string = '';
+    await jest.isolateModulesAsync(async () => {
+      jest.doMock('fs', () => ({
+        ...jest.requireActual('fs'),
+        readFileSync: (
+          filePath: fs.PathOrFileDescriptor,
+          options?: unknown
+        ) => {
+          if (String(filePath).includes('tools.json')) {
+            return brokenToolsJson;
+          }
+          return (jest.requireActual('fs') as typeof fs).readFileSync(
+            filePath,
+            options as fs.ObjectEncodingOptions & {flag?: string}
+          );
+        }
+      }));
+      const isolatedTools = await import('../src/tools');
+      result = await isolatedTools.addTools('broken-tool', '7.4', 'linux');
+    });
+
+    expect(result).toContain(
+      'add_log "$cross" "broken-tool" "broken-tool has no function defined. Please report this issue."'
+    );
+  });
+
+  it.each`
+    tools_csv    | php_version | resolved
+    ${'phpunit'} | ${'8.2'}    | ${'/phpunit-8.2.0.phar'}
+    ${'phpunit'} | ${'8.1'}    | ${'/phpunit-8.1.0.phar'}
+    ${'phpunit'} | ${'8.0'}    | ${'/phpunit-8.0.0.phar'}
+    ${'phpunit'} | ${'7.3'}    | ${'/phpunit-7.3.0.phar'}
+    ${'phpunit'} | ${'7.2'}    | ${'/phpunit-7.2.0.phar'}
+    ${'phpunit'} | ${'7.1'}    | ${'/phpunit-7.1.0.phar'}
+    ${'phpunit'} | ${'7.0'}    | ${'/phpunit-7.0.0.phar'}
+  `(
+    'checking error: $tools_csv',
+    async ({tools_csv, php_version, resolved}) => {
+      expect(await tools.addTools(tools_csv, php_version, 'linux')).toContain(
+        resolved
+      );
+    }
+  );
+});

__tests__/utils.test.ts

@@ -1,54 +1,97 @@
-import * as fs from 'fs';
+import fs from 'fs';
 import * as path from 'path';
 import * as utils from '../src/utils';
-
-jest.mock('@actions/core', () => ({
-  getInput: jest.fn().mockImplementation(key => {
-    return ['setup-php'].indexOf(key) !== -1 ? key : '';
-  })
-}));
-
-async function cleanup(path: string): Promise<void> {
-  fs.unlink(path, error => {
-    if (error) {
-      console.log(error);
-    }
-  });
-}
+import * as fetchModule from '../src/fetch';
 
 describe('Utils tests', () => {
-  it('checking getInput', async () => {
+  it('checking readEnv', async () => {
     process.env['test'] = 'setup-php';
-    process.env['undefined'] = '';
-    expect(await utils.getInput('test', false)).toBe('setup-php');
-    expect(await utils.getInput('undefined', false)).toBe('');
-    expect(await utils.getInput('setup-php', false)).toBe('setup-php');
-    expect(await utils.getInput('DoesNotExist', false)).toBe('');
+    process.env['test-hyphen'] = 'setup-php';
+    expect(await utils.readEnv('test')).toBe('setup-php');
+    expect(await utils.readEnv('TEST')).toBe('setup-php');
+    expect(await utils.readEnv('test_hyphen')).toBe('setup-php');
+    expect(await utils.readEnv('TEST_HYPHEN')).toBe('setup-php');
+    expect(await utils.readEnv('test invalid')).toBe('');
+    process.env['conflict_hyphen'] = 'setup-php';
+    process.env['conflict-hyphen'] = 'wrong';
+    expect(await utils.readEnv('conflict_hyphen')).toBe('setup-php');
+    delete process.env['conflict_hyphen'];
+    delete process.env['conflict-hyphen'];
+    expect(await utils.readEnv('undefined')).toBe('');
   });
 
-  it('checking getVersion', async () => {
-    process.env['php-version'] = '7.3';
-    expect(await utils.getVersion()).toBe('7.3');
-    process.env['php-version'] = '7.4';
-    expect(await utils.getVersion()).toBe('7.4');
-    process.env['php-version'] = '8.0';
-    expect(await utils.getVersion()).toBe('7.4');
-    process.env['php-version'] = '8.0-dev';
-    expect(await utils.getVersion()).toBe('7.4');
-    process.env['php-version'] = '7.4nightly';
-    expect(await utils.getVersion()).toBe('7.4');
-    process.env['php-version'] = '7.4snapshot';
-    expect(await utils.getVersion()).toBe('7.4');
-    process.env['php-version'] = 'nightly';
-    expect(await utils.getVersion()).toBe('7.4');
+  it('checking getInput', async () => {
+    process.env['test'] = 'setup-php';
+    process.env['INPUT_SETUP-PHP'] = 'setup-php';
+    expect(await utils.getInput('test', false)).toBe('setup-php');
+    expect(await utils.getInput('setup-php', false)).toBe('setup-php');
+    expect(await utils.getInput('DoesNotExist', false)).toBe('');
+    await expect(async () => {
+      await utils.getInput('DoesNotExist', true);
+    }).rejects.toThrow('Input required and not supplied: DoesNotExist');
+    delete process.env['INPUT_SETUP-PHP'];
+  });
+
+  it('checking getManifestURL', async () => {
+    for (const url of await utils.getManifestURLS()) {
+      expect(url).toContain('php-versions.json');
+    }
+  });
+
+  it('checking parseVersion', async () => {
+    const fetchSpy = jest
+      .spyOn(fetchModule, 'fetch')
+      .mockResolvedValue({data: '{ "latest": "8.1", "5.x": "5.6" }'});
+    expect(await utils.parseVersion('latest')).toBe('8.1');
+    expect(await utils.parseVersion('7')).toBe('7.0');
+    expect(await utils.parseVersion('7.4')).toBe('7.4');
+    expect(await utils.parseVersion('5.x')).toBe('5.6');
+    expect(await utils.parseVersion('pre')).toBe('pre');
+    expect(await utils.parseVersion('pre-installed')).toBe('pre');
+    await expect(utils.parseVersion('4.x')).rejects.toThrow(
+      'Invalid PHP version: 4.x'
+    );
+    await expect(utils.parseVersion('foo')).rejects.toThrow(
+      'Invalid PHP version:'
+    );
+
+    fetchSpy.mockResolvedValue({data: '{ "latest": "8.1.0" }'});
+    await expect(utils.parseVersion('latest')).rejects.toThrow(
+      'Invalid PHP version in manifest:'
+    );
+
+    fetchSpy.mockReset();
+    fetchSpy.mockResolvedValueOnce({}).mockResolvedValueOnce({});
+    await expect(utils.parseVersion('latest')).rejects.toThrow(
+      'Could not fetch the PHP version manifest.'
+    );
+    expect(fetchSpy).toHaveBeenCalledTimes(2);
+  });
+
+  it('checking parseIniFile', async () => {
+    expect(await utils.parseIniFile('production')).toBe('production');
+    expect(await utils.parseIniFile('development')).toBe('development');
+    expect(await utils.parseIniFile('none')).toBe('none');
+    expect(await utils.parseIniFile('php.ini-production')).toBe('production');
+    expect(await utils.parseIniFile('php.ini-development')).toBe('development');
+    expect(await utils.parseIniFile('/etc/php.ini-production')).toBe(
+      'production'
+    );
+    expect(await utils.parseIniFile('/a-b/php.ini-development')).toBe(
+      'development'
+    );
+    expect(await utils.parseIniFile('invalid')).toBe('production');
   });
 
   it('checking asyncForEach', async () => {
     const array: Array<string> = ['a', 'b', 'c'];
     let concat = '';
-    await utils.asyncForEach(array, async function(str: string): Promise<void> {
-      concat += str;
-    });
+    await utils.asyncForEach(
+      array,
+      async function (str: string): Promise<void> {
+        concat += str;
+      }
+    );
     expect(concat).toBe('abc');
   });
 
@@ -59,58 +102,60 @@ describe('Utils tests', () => {
     expect(await utils.color('warning')).toBe('33');
   });
 
-  it('checking readScripts', async () => {
-    const darwin: string = fs.readFileSync(
-      path.join(__dirname, '../src/scripts/darwin.sh'),
-      'utf8'
-    );
-    const linux: string = fs.readFileSync(
-      path.join(__dirname, '../src/scripts/linux.sh'),
-      'utf8'
-    );
-    const win32: string = fs.readFileSync(
-      path.join(__dirname, '../src/scripts/win32.ps1'),
-      'utf8'
-    );
-    expect(await utils.readScript('darwin.sh', '7.4', 'darwin')).toBe(darwin);
-    expect(await utils.readScript('darwin.sh', '7.3', 'darwin')).toBe(darwin);
-    expect(await utils.readScript('linux.sh', '7.4', 'linux')).toBe(linux);
-    expect(await utils.readScript('linux.sh', '7.3', 'linux')).toBe(linux);
-    expect(await utils.readScript('win32.ps1', '7.4', 'win32')).toBe(win32);
-    expect(await utils.readScript('win32.ps1', '7.3', 'win32')).toBe(win32);
-  });
-
-  it('checking writeScripts', async () => {
-    const testString = 'sudo apt-get install php';
-    const runner_dir: string = process.env['RUNNER_TOOL_CACHE'] || '';
-    const script_path: string = path.join(runner_dir, 'test.sh');
-    await utils.writeScript('test.sh', testString);
-    await fs.readFile(script_path, function(error: Error | null, data: Buffer) {
-      expect(testString).toBe(data.toString());
-    });
-    await cleanup(script_path);
-  });
-
   it('checking extensionArray', async () => {
-    expect(await utils.extensionArray('a, b, php_c, php-d')).toEqual([
-      'a',
-      'b',
-      'c',
-      'd'
-    ]);
+    expect(
+      await utils.extensionArray('a, :b, php_c, none, php-d, Zend e, :Zend f')
+    ).toEqual(['none', 'a', ':b', 'c', 'd', 'e', ':f']);
 
     expect(await utils.extensionArray('')).toEqual([]);
     expect(await utils.extensionArray(' ')).toEqual([]);
+
+    expect(
+      await utils.extensionArray('apcu, mbstring, \\ pdo_pgsql, posix, session')
+    ).toEqual(['apcu', 'mbstring', 'pdo_pgsql', 'posix', 'session']);
+  });
+
+  it('checking shell helpers', () => {
+    expect(utils.escapeForShell('a$b`c\\d"e', 'linux')).toBe(
+      'a\\$b\\`c\\\\d\\"e'
+    );
+    expect(utils.escapeForShell('a$b`c"d', 'win32')).toBe('a`$b``c`"d');
+    expect(utils.safeArg('vendor-pkg/repo@v1.0.0', 'linux')).toBe(
+      'vendor-pkg/repo@v1.0.0'
+    );
+    expect(utils.safeArg('phpcs:>=3.0', 'linux')).toBe('"phpcs:>=3.0"');
+    expect(utils.safeArg('foo$bar', 'win32')).toBe('"foo`$bar"');
+    expect(utils.sanitizeShellInput('foo;$(`ls`)bar')).toBe('foolsbar');
+    expect(utils.sanitizeShellInput('vendor/foo:1.*', true)).toBe(
+      'vendor/foo:1.'
+    );
   });
 
   it('checking INIArray', async () => {
-    expect(await utils.INIArray('a=1, b=2, c=3')).toEqual([
+    expect(await utils.CSVArray('a=1, b=2, c=3')).toEqual([
       'a=1',
       'b=2',
       'c=3'
     ]);
-    expect(await utils.INIArray('')).toEqual([]);
-    expect(await utils.INIArray(' ')).toEqual([]);
+    expect(await utils.CSVArray('\'a=1,2\', "b=3, 4", c=5, d=~e~')).toEqual([
+      'a=1,2',
+      'b=3, 4',
+      'c=5',
+      "d='~e~'"
+    ]);
+    expect(await utils.CSVArray('a=\'1,2\', b="3, 4", c=5')).toEqual([
+      'a=1,2',
+      'b=3, 4',
+      'c=5'
+    ]);
+    expect(
+      await utils.CSVArray('a=E_ALL, b=E_ALL & ~ E_ALL, c="E_ALL", d=\'E_ALL\'')
+    ).toEqual(['a=E_ALL', 'b=E_ALL & ~ E_ALL', 'c=E_ALL', 'd=E_ALL']);
+    expect(
+      await utils.CSVArray('a="b=c;d=e", b=\'c=d,e\', c="g=h,i=j", d=g=h, a===')
+    ).toEqual(["a='b=c;d=e'", "b='c=d,e'", "c='g=h,i=j'", "d='g=h'", "a='=='"]);
+    expect(await utils.CSVArray('')).toEqual([]);
+    expect(await utils.CSVArray(' ')).toEqual([]);
   });
 
   it('checking log', async () => {
@@ -143,8 +188,8 @@ describe('Utils tests', () => {
     expect(step_log).toEqual('step_log "Test message"');
     step_log = await utils.stepLog(message, 'darwin');
     expect(step_log).toEqual('step_log "Test message"');
-    step_log = await utils.stepLog(message, 'fedora');
-    expect(step_log).toContain('Platform fedora is not supported');
+    step_log = await utils.stepLog(message, 'openbsd');
+    expect(step_log).toContain('Platform openbsd is not supported');
 
     let add_log: string = await utils.addLog(
       'tick',
@@ -157,8 +202,8 @@ describe('Utils tests', () => {
     expect(add_log).toEqual('add_log "tick" "xdebug" "enabled"');
     add_log = await utils.addLog('tick', 'xdebug', 'enabled', 'darwin');
     expect(add_log).toEqual('add_log "tick" "xdebug" "enabled"');
-    add_log = await utils.addLog('tick', 'xdebug', 'enabled', 'fedora');
-    expect(add_log).toContain('Platform fedora is not supported');
+    add_log = await utils.addLog('tick', 'xdebug', 'enabled', 'openbsd');
+    expect(add_log).toContain('Platform openbsd is not supported');
   });
 
   it('checking getExtensionPrefix', async () => {
@@ -167,6 +212,7 @@ describe('Utils tests', () => {
     );
     expect(await utils.getExtensionPrefix('xsl')).toEqual('extension');
     expect(await utils.getExtensionPrefix('xdebug')).toEqual('zend_extension');
+    expect(await utils.getExtensionPrefix('xdebug3')).toEqual('zend_extension');
     expect(await utils.getExtensionPrefix('opcache')).toEqual('zend_extension');
   });
 
@@ -174,8 +220,178 @@ describe('Utils tests', () => {
     expect(await utils.suppressOutput('win32')).toEqual(' >$null 2>&1');
     expect(await utils.suppressOutput('linux')).toEqual(' >/dev/null 2>&1');
     expect(await utils.suppressOutput('darwin')).toEqual(' >/dev/null 2>&1');
-    expect(await utils.suppressOutput('fedora')).toContain(
-      'Platform fedora is not supported'
+    expect(await utils.suppressOutput('openbsd')).toContain(
+      'Platform openbsd is not supported'
     );
   });
+
+  it('checking getUnsupportedLog', async () => {
+    expect(await utils.getUnsupportedLog('ext', '5.6', 'linux')).toContain(
+      'add_log "$cross" "ext" "ext is not supported on PHP 5.6"'
+    );
+  });
+
+  it('checking getCommand', async () => {
+    expect(await utils.getCommand('linux', 'tool')).toBe('add_tool ');
+    expect(await utils.getCommand('darwin', 'tool')).toBe('add_tool ');
+    expect(await utils.getCommand('win32', 'tool')).toBe('Add-Tool ');
+    expect(await utils.getCommand('win32', 'tool_name')).toBe('Add-ToolName ');
+    expect(await utils.getCommand('openbsd', 'tool')).toContain(
+      'Platform openbsd is not supported'
+    );
+  });
+
+  it('checking joins', async () => {
+    expect(await utils.joins('a', 'b', 'c')).toBe('a b c');
+  });
+
+  it('checking scriptExtension', async () => {
+    expect(await utils.scriptExtension('linux')).toBe('.sh');
+    expect(await utils.scriptExtension('darwin')).toBe('.sh');
+    expect(await utils.scriptExtension('win32')).toBe('.ps1');
+    expect(await utils.scriptExtension('openbsd')).toContain(
+      'Platform openbsd is not supported'
+    );
+  });
+
+  it('checking scriptTool', async () => {
+    expect(await utils.scriptTool('linux')).toBe('bash ');
+    expect(await utils.scriptTool('darwin')).toBe('bash ');
+    expect(await utils.scriptTool('win32')).toBe('pwsh ');
+    expect(await utils.scriptTool('openbsd')).toContain(
+      'Platform openbsd is not supported'
+    );
+  });
+
+  it('checking customPackage', async () => {
+    const script_path: string = path.join('ext', 'pkg.sh');
+    expect(await utils.customPackage('pkg', 'ext', '1.2.3', 'linux')).toContain(
+      script_path + '\nadd_pkg 1.2.3'
+    );
+    expect(
+      await utils.customPackage('pdo_pkg', 'ext', '1.2.3', 'linux')
+    ).toContain(script_path + '\nadd_pkg 1.2.3');
+    expect(
+      await utils.customPackage('pkg8', 'ext', '1.2.3', 'linux')
+    ).toContain(script_path + '\nadd_pkg 1.2.3');
+  });
+
+  it('checking parseExtensionSource', async () => {
+    expect(
+      await utils.parseExtensionSource(
+        'ext-org-name/repo-name@release',
+        'extension'
+      )
+    ).toContain(
+      '\nadd_extension_from_source ext https://github.com org-name repo-name release extension'
+    );
+    expect(
+      await utils.parseExtensionSource(
+        'ext-https://sub.domain.tld/org/repo@release',
+        'extension'
+      )
+    ).toContain(
+      '\nadd_extension_from_source ext https://sub.domain.tld org repo release extension'
+    );
+    expect(
+      await utils.parseExtensionSource(
+        'ext-https://sub.domain.XN--tld/org/repo@release',
+        'extension'
+      )
+    ).toContain(
+      '\nadd_extension_from_source ext https://sub.domain.XN--tld org repo release extension'
+    );
+  });
+
+  it('checking readPHPVersion', async () => {
+    expect(await utils.readPHPVersion()).toBe('latest');
+
+    process.env['php-version-file'] = '.phpenv-version';
+    await expect(utils.readPHPVersion()).rejects.toThrow(
+      "Could not find '.phpenv-version' file."
+    );
+
+    const existsSync = jest.spyOn(fs, 'existsSync').mockImplementation();
+    const readFileSync = jest.spyOn(fs, 'readFileSync').mockImplementation();
+
+    existsSync.mockReturnValue(true);
+    readFileSync.mockReturnValue('8.1');
+
+    expect(await utils.readPHPVersion()).toBe('8.1');
+
+    process.env['php-version'] = '8.2';
+    expect(await utils.readPHPVersion()).toBe('8.2');
+
+    process.env['php-version'] = 'pre-installed';
+    expect(await utils.readPHPVersion()).toBe('pre-installed');
+
+    delete process.env['php-version-file'];
+    delete process.env['php-version'];
+
+    existsSync.mockReturnValue(true);
+    readFileSync.mockReturnValue('ruby 1.2.3\nphp 8.4.2\nnode 20.1.2');
+    expect(await utils.readPHPVersion()).toBe('8.4.2');
+
+    existsSync.mockReturnValue(true);
+    readFileSync.mockReturnValue('setup-php');
+    await expect(utils.readPHPVersion()).rejects.toThrow('Invalid PHP version');
+
+    existsSync.mockReturnValueOnce(false).mockReturnValueOnce(true);
+    readFileSync.mockReturnValue(
+      '{ "platform-overrides": { "php": "7.3.25" } }'
+    );
+    expect(await utils.readPHPVersion()).toBe('7.3.25');
+
+    existsSync
+      .mockReturnValueOnce(false)
+      .mockReturnValueOnce(false)
+      .mockReturnValueOnce(true);
+    readFileSync.mockReturnValue(
+      '{ "config": { "platform": { "php": "7.4.33" } } }'
+    );
+    expect(await utils.readPHPVersion()).toBe('7.4.33');
+
+    existsSync.mockClear();
+    readFileSync.mockClear();
+  });
+
+  it('readPHPVersion rejects unsupported values from each source', async () => {
+    const existsSync = jest.spyOn(fs, 'existsSync').mockImplementation();
+    const readFileSync = jest.spyOn(fs, 'readFileSync').mockImplementation();
+
+    process.env['php-version'] = 'bogus';
+    await expect(utils.readPHPVersion()).rejects.toThrow('php-version input');
+    delete process.env['php-version'];
+
+    existsSync.mockReturnValue(true);
+    readFileSync.mockReturnValue('bogus');
+    await expect(utils.readPHPVersion()).rejects.toThrow('.php-version');
+
+    existsSync.mockReturnValueOnce(false).mockReturnValueOnce(true);
+    readFileSync.mockReturnValue('{"platform-overrides":{"php":"bogus"}}');
+    await expect(utils.readPHPVersion()).rejects.toThrow(
+      'composer.lock platform-overrides.php'
+    );
+
+    existsSync
+      .mockReturnValueOnce(false)
+      .mockReturnValueOnce(false)
+      .mockReturnValueOnce(true);
+    readFileSync.mockReturnValue('{"config":{"platform":{"php":"bogus"}}}');
+    await expect(utils.readPHPVersion()).rejects.toThrow(
+      'composer.json config.platform.php'
+    );
+
+    existsSync.mockClear();
+    readFileSync.mockClear();
+  });
+
+  it('checking setVariable', async () => {
+    let script: string = await utils.setVariable('var', 'command', 'linux');
+    expect(script).toEqual('\nvar="$(command)"\n');
+    script = await utils.setVariable('var', 'command', 'darwin');
+    expect(script).toEqual('\nvar="$(command)"\n');
+    script = await utils.setVariable('var', 'command', 'win32');
+    expect(script).toEqual('\n$var = command\n');
+  });
 });

action.yml

@@ -1,25 +1,38 @@
 name: 'Setup PHP Action'
 author: shivammathur
-description: 'GitHub action to setup PHP with required extensions, php.ini configuration, code-coverage support and composer'
+description: 'GitHub Action for PHP'
 branding:
   color: 'purple'
+  icon: 'play-circle'
 inputs:
   php-version:
     description: 'Setup PHP version.'
-    default: '7.4'
-    required: true
-  extension-csv:
+    required: false
+  php-version-file:
+    description: 'Setup PHP version from a file.'
+    required: false
+  extensions:
     description: 'Setup PHP extensions.'
     required: false
-  ini-values-csv: 
+  ini-file:
+    description: 'Set base ini file.'
+    required: false
+    default: 'production'
+  ini-values:
     description: 'Add values to php.ini.'
     required: false
   coverage: 
     description: 'Setup code coverage driver.'
     required: false
-  pecl:
-    description: 'Setup PECL on ubuntu'
+  tools:
+    description: 'Setup popular tools globally.'
     required: false
+  github-token:
+    description: 'GitHub token to use for authentication.'
+    default: ${{ github.token }}
+outputs:
+  php-version:
+    description: 'PHP version in semver format'
 runs:
-  using: 'node12'
+  using: 'node24'
   main: 'dist/index.js'

eslint.config.mjs

@@ -0,0 +1,49 @@
+import typescriptEslint from '@typescript-eslint/eslint-plugin';
+import {importX} from 'eslint-plugin-import-x';
+import jest from 'eslint-plugin-jest';
+import prettierRecommended from 'eslint-plugin-prettier/recommended';
+import eslintConfigPrettier from 'eslint-config-prettier';
+import globals from 'globals';
+import tsParser from '@typescript-eslint/parser';
+import js from '@eslint/js';
+
+export default [
+  js.configs.recommended,
+  ...typescriptEslint.configs['flat/recommended'],
+  importX.flatConfigs.errors,
+  importX.flatConfigs.warnings,
+  importX.flatConfigs.typescript,
+  prettierRecommended,
+  eslintConfigPrettier,
+  {
+    plugins: {
+      jest
+    },
+
+    languageOptions: {
+      globals: {
+        ...globals.node,
+        ...globals.jest
+      },
+
+      parser: tsParser,
+      ecmaVersion: 2021,
+      sourceType: 'module'
+    },
+
+    settings: {
+      'import-x/resolver': {
+        typescript: {
+          alwaysTryTypes: true,
+          project: './tsconfig.json'
+        },
+        node: {
+          extensions: ['.js', '.ts']
+        }
+      },
+      'import-x/parsers': {
+        '@typescript-eslint/parser': ['.ts']
+      }
+    }
+  }
+];

examples/bedrock.yml

@@ -8,23 +8,31 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        php-versions: ['7.1', '7.2', '7.3', '7.4']
+        php-versions: ['8.3', '8.4', '8.5']
     steps:
       - name: Checkout
-        uses: actions/checkout@v1
-      - name: Setup PHP, with composer and extensions
-        uses: shivammathur/setup-php@v1 #https://github.com/shivammathur/setup-php
+        uses: actions/checkout@v6
+
+      # Docs: https://github.com/shivammathur/setup-php
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
         with:
           php-version: ${{ matrix.php-versions }}
+
       - name: Get composer cache directory
         id: composer-cache
-        run: echo "::set-output name=dir::$(composer config cache-files-dir)"
-      - uses: actions/cache@v1
+        run: echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT
+
+      - uses: actions/cache@v5
         with:
           path: ${{ steps.composer-cache.outputs.dir }}
+          # Use composer.json for key, if composer.lock is not committed.
+          # key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.json') }}
           key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
           restore-keys: ${{ runner.os }}-composer-
+
       - name: Install Composer dependencies
-        run: composer install -n --prefer-dist
+        run: composer install --no-progress --prefer-dist --optimize-autoloader
+
       - name: PHP test
-        run: composer test
+        run: composer test

examples/blackfire-player.yml

@@ -0,0 +1,47 @@
+# GitHub Action for Blackfire Player
+name: Play a Blackfire Scenario
+on: [push, pull_request]
+jobs:
+  blackfire-player:
+    name: Blackfire (PHP ${{ matrix.php-versions }})
+    defaults:
+      run:
+        shell: bash
+    # Add your Blackfire credentials securely using GitHub Secrets
+    env:
+      BLACKFIRE_SERVER_ID: ${{ secrets.BLACKFIRE_SERVER_ID }}
+      BLACKFIRE_SERVER_TOKEN: ${{ secrets.BLACKFIRE_SERVER_TOKEN }}
+      BLACKFIRE_CLIENT_ID: ${{ secrets.BLACKFIRE_CLIENT_ID }}
+      BLACKFIRE_CLIENT_TOKEN: ${{ secrets.BLACKFIRE_CLIENT_TOKEN }}
+    runs-on: ${{ matrix.operating-system }}
+    strategy:
+      fail-fast: false
+      matrix:
+        operating-system: [ubuntu-latest, macos-latest]
+        php-versions: ['8.3', '8.4', '8.5']
+        # Blackfire Player supports PHP 8.5 and is available on Ubuntu and macOS.
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      # Docs: https://github.com/shivammathur/setup-php
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ matrix.php-versions }}
+          extensions: blackfire
+          # Setup Blackfire CLI and player
+          tools: blackfire, blackfire-player
+          coverage: none
+
+      - name: Start local endpoint
+        run: |
+          php -S 127.0.0.1:8080 > "$RUNNER_TEMP/blackfire-player.log" 2>&1 &
+          sleep 5
+
+      - name: Validate scenario
+        run: blackfire-player validate scenario.bkf
+
+      # Refer to https://docs.blackfire.io/builds-cookbooks/player
+      - name: Play the scenario
+        run: blackfire-player run scenario.bkf --endpoint=http://127.0.0.1:8080

examples/blackfire.yml

@@ -0,0 +1,49 @@
+# GitHub Action for Blackfire
+name: Profiling with blackfire
+on: [push, pull_request]
+jobs:
+  blackfire:
+    name: Blackfire (PHP ${{ matrix.php-versions }})
+    # Add your Blackfire credentials securely using GitHub Secrets
+    env:
+      BLACKFIRE_SERVER_ID: ${{ secrets.BLACKFIRE_SERVER_ID }}
+      BLACKFIRE_SERVER_TOKEN: ${{ secrets.BLACKFIRE_SERVER_TOKEN }}
+      BLACKFIRE_CLIENT_ID: ${{ secrets.BLACKFIRE_CLIENT_ID }}
+      BLACKFIRE_CLIENT_TOKEN: ${{ secrets.BLACKFIRE_CLIENT_TOKEN }}
+    runs-on: ${{ matrix.operating-system }}
+    strategy:
+      fail-fast: false
+      matrix:
+        operating-system: [ubuntu-latest, windows-latest, macos-latest]
+        php-versions: ['8.3', '8.4', '8.5']
+        # Blackfire supports the current PHP releases on Ubuntu, macOS, and Windows.
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      # Docs: https://github.com/shivammathur/setup-php
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ matrix.php-versions }}
+          # Setup Blackfire extension and CLI.
+          extensions: blackfire, :xdebug
+          tools: blackfire
+          # Disable Xdebug and PCOV coverage drivers
+          coverage: none
+
+      # Refer to https://blackfire.io/docs/cookbooks/profiling-cli
+      - name: Profile
+        shell: bash
+        run: |
+          set +e
+          output=$(blackfire run php my-script.php 2>&1)
+          exit_code=$?
+          printf '%s\n' "$output"
+          if [ "$exit_code" -ne 0 ]; then
+            if printf '%s' "$output" | grep -q "upgrade your subscription"; then
+              echo "Blackfire profiling reached the repository quota limit; treating this as a known non-fatal condition."
+              exit 0
+            fi
+            exit "$exit_code"
+          fi

examples/cakephp-mysql.yml

@@ -0,0 +1,142 @@
+# GitHub Action for CakePHP with MySQL and Redis
+# Tested with https://github.com/cakephp/app
+name: Testing CakePHP with MySQL
+on: [push, pull_request]
+jobs:
+  tests:
+    strategy:
+      matrix:
+        php-versions: ['8.4', '8.5']
+        # The latest cakephp/app release resolves dev dependencies that require PHP 8.4+.
+    runs-on: ubuntu-latest
+
+    # Docs: https://docs.github.com/en/actions/using-containerized-services
+    services:
+      mysql:
+        image: mysql:latest
+        env:
+          MYSQL_ALLOW_EMPTY_PASSWORD: false
+          MYSQL_ROOT_PASSWORD: password
+          MYSQL_DATABASE: cakephp
+        ports:
+          - 3306/tcp
+        options: --health-cmd="mysqladmin ping" --health-interval=10s --health-timeout=5s --health-retries=3
+
+      redis:
+        image: redis
+        ports:
+          - 6379/tcp
+        options: --health-cmd="redis-cli ping" --health-interval=10s --health-timeout=5s --health-retries=3
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      # Docs: https://github.com/shivammathur/setup-php
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ matrix.php-versions }}
+          # You can also use ext-apcu or ext-memcached instead of ext-redis
+          # Install memcached if using ext-memcached
+          extensions: mbstring, intl, redis, apcu, pdo_mysql
+          coverage: pcov
+
+      # Local MySQL service in GitHub hosted environments is disabled by default.
+      # If you are using it instead of service containers, make sure you start it.
+      # - name: Start mysql service
+      #   run: sudo systemctl start mysql.service
+
+      - name: Get composer cache directory
+        id: composer-cache
+        run: echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT
+
+      - name: Cache composer dependencies
+        uses: actions/cache@v5
+        with:
+          path: ${{ steps.composer-cache.outputs.dir }}
+          # Use composer.json for key, if composer.lock is not committed.
+          # key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.json') }}
+          key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
+          restore-keys: ${{ runner.os }}-composer-
+
+      - name: Install dependencies
+        run: |
+          composer install --no-progress --prefer-dist --optimize-autoloader
+          composer run-script post-install-cmd --no-interaction
+
+      # Add a step to run migrations if required
+      - name: Test with phpunit
+        run: vendor/bin/phpunit --coverage-text
+        env:
+          REDIS_PORT: ${{ job.services.redis.ports['6379'] }}
+          DATABASE_URL: "mysql://root:password@127.0.0.1:${{ job.services.mysql.ports['3306'] }}/cakephp?init[]=SET sql_mode = \"STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION\""
+          DATABASE_TEST_URL: "mysql://root:password@127.0.0.1:${{ job.services.mysql.ports['3306'] }}/cakephp?init[]=SET sql_mode = \"STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION\""
+
+  coding-standard:
+    name: Coding Standard
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      # Docs: https://github.com/shivammathur/setup-php
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.5'
+          extensions: mbstring, intl
+
+      - name: Get composer cache directory
+        id: composer-cache
+        run: echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT
+
+      - name: Cache composer dependencies
+        uses: actions/cache@v5
+        with:
+          path: ${{ steps.composer-cache.outputs.dir }}
+          # Use composer.json for key, if composer.lock is not committed.
+          # key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.json') }}
+          key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
+          restore-keys: ${{ runner.os }}-composer-
+
+      - name: Install dependencies
+        run: composer install --no-progress --prefer-dist --optimize-autoloader
+
+      - name: PHP CodeSniffer
+        run: composer cs-check
+
+  static-analysis:
+    name: Static Analysis
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      # Docs: https://github.com/shivammathur/setup-php
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.5'
+          extensions: mbstring, intl
+          tools: phpstan
+
+      - name: Get composer cache directory
+        id: composer-cache
+        run: echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT
+
+      - name: Cache composer dependencies
+        uses: actions/cache@v5
+        with:
+          path: ${{ steps.composer-cache.outputs.dir }}
+          # Use composer.json for key, if composer.lock is not committed.
+          # key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.json') }}
+          key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
+          restore-keys: ${{ runner.os }}-composer-
+
+      - name: Install dependencies
+        run: |
+          composer install --no-progress --prefer-dist --optimize-autoloader
+          composer run-script post-install-cmd --no-interaction
+
+      - name: Static Analysis using PHPStan
+        run: phpstan analyse --no-progress src/

examples/cakephp-postgres.yml

@@ -0,0 +1,143 @@
+# GitHub Action for CakePHP with PostgreSQL and Redis
+# Tested with https://github.com/cakephp/app
+name: Testing CakePHP with PostgreSQL
+on: [push, pull_request]
+jobs:
+  tests:
+    strategy:
+      fail-fast: false
+      matrix:
+        php-versions: ['8.4', '8.5']
+        # The latest cakephp/app release resolves dev dependencies that require PHP 8.4+.
+    runs-on: ubuntu-latest
+
+    # Docs: https://docs.github.com/en/actions/using-containerized-services
+    services:
+      postgres:
+        image: postgres:latest
+        env:
+          POSTGRES_USER: postgres
+          POSTGRES_PASSWORD: postgres
+          POSTGRES_DB: postgres
+        ports:
+          - 5432/tcp
+        options: --health-cmd pg_isready --health-interval 10s --health-timeout 5s --health-retries 3
+
+      redis:
+        image: redis
+        ports:
+          - 6379/tcp
+        options: --health-cmd="redis-cli ping" --health-interval=10s --health-timeout=5s --health-retries=3
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      # Docs: https://github.com/shivammathur/setup-php
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ matrix.php-versions }}
+          # You can also use ext-apcu or ext-memcached instead of ext-redis
+          # Install memcached if using ext-memcached
+          extensions: mbstring, intl, redis, apcu, pdo_pgsql
+          coverage: pcov
+
+      # Local PostgreSQL service in GitHub hosted environments is disabled by default.
+      # If you are using it instead of service containers, make sure you start it.
+      # - name: Start postgresql service
+      #   run: sudo systemctl start postgresql.service
+
+      - name: Get composer cache directory
+        id: composer-cache
+        run: echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT
+
+      - name: Cache composer dependencies
+        uses: actions/cache@v5
+        with:
+          path: ${{ steps.composer-cache.outputs.dir }}
+          # Use composer.json for key, if composer.lock is not committed.
+          # key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.json') }}
+          key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
+          restore-keys: ${{ runner.os }}-composer-
+
+      - name: Install dependencies
+        run: |
+          composer install --no-progress --prefer-dist --optimize-autoloader
+          composer run-script post-install-cmd --no-interaction
+
+      # Add a step to run migrations if required
+      - name: Test with phpunit
+        run: vendor/bin/phpunit --coverage-text
+        env:
+          REDIS_PORT: ${{ job.services.redis.ports['6379'] }}
+          DATABASE_URL: postgres://postgres:postgres@127.0.0.1:${{ job.services.postgres.ports['5432'] }}/postgres?encoding=UTF8
+          DATABASE_TEST_URL: postgres://postgres:postgres@127.0.0.1:${{ job.services.postgres.ports['5432'] }}/postgres?encoding=UTF8
+
+  coding-standard:
+    name: Coding Standard
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      # Docs: https://github.com/shivammathur/setup-php
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.5'
+          extensions: mbstring, intl, apcu
+
+      - name: Get composer cache directory
+        id: composer-cache
+        run: echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT
+
+      - name: Cache composer dependencies
+        uses: actions/cache@v5
+        with:
+          path: ${{ steps.composer-cache.outputs.dir }}
+          # Use composer.json for key, if composer.lock is not committed.
+          # key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.json') }}
+          key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
+          restore-keys: ${{ runner.os }}-composer-
+
+      - name: Install dependencies
+        run: composer install --no-progress --prefer-dist --optimize-autoloader
+
+      - name: PHP CodeSniffer
+        run: composer cs-check
+
+  static-analysis:
+    name: Static Analysis
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      # Docs: https://github.com/shivammathur/setup-php
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.5'
+          extensions: mbstring, intl, apcu
+          tools: phpstan
+
+      - name: Get composer cache directory
+        id: composer-cache
+        run: echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT
+
+      - name: Cache composer dependencies
+        uses: actions/cache@v5
+        with:
+          path: ${{ steps.composer-cache.outputs.dir }}
+          # Use composer.json for key, if composer.lock is not committed.
+          # key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.json') }}
+          key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
+          restore-keys: ${{ runner.os }}-composer-
+
+      - name: Install dependencies
+        run: |
+          composer install --no-progress --prefer-dist --optimize-autoloader
+          composer run-script post-install-cmd --no-interaction
+
+      - name: Static Analysis using PHPStan
+        run: phpstan analyse --no-progress src/

examples/cakephp.yml

@@ -0,0 +1,115 @@
+# GitHub Action for CakePHP
+# Tested with https://github.com/cakephp/app
+name: Testing CakePHP
+on: [push, pull_request]
+jobs:
+  tests:
+    strategy:
+      matrix:
+        operating-system: [ubuntu-latest, windows-latest, macos-latest]
+        php-versions: ['8.4', '8.5']
+        # The latest cakephp/app release resolves dev dependencies that require PHP 8.4+.
+    runs-on: ${{ matrix.operating-system }}
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      # Docs: https://github.com/shivammathur/setup-php
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ matrix.php-versions }}
+          extensions: mbstring, intl, pdo_sqlite, pdo_mysql
+          coverage: pcov
+
+      - name: Get composer cache directory
+        id: composer-cache
+        shell: bash
+        run: echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT
+
+      - name: Cache composer dependencies
+        uses: actions/cache@v5
+        with:
+          path: ${{ steps.composer-cache.outputs.dir }}
+          # Use composer.json for key, if composer.lock is not committed.
+          # key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.json') }}
+          key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
+          restore-keys: ${{ runner.os }}-composer-
+
+      - name: Install dependencies
+        run: |
+          composer install --no-progress --prefer-dist --optimize-autoloader
+          composer run-script post-install-cmd --no-interaction
+
+      - name: Test with phpunit
+        run: vendor/bin/phpunit --coverage-text
+
+  coding-standard:
+    name: Coding Standard
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      # Docs: https://github.com/shivammathur/setup-php
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.5'
+          extensions: mbstring, intl
+      - name: Get composer cache directory
+        id: composer-cache
+        shell: bash
+        run: echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT
+
+      - name: Cache composer dependencies
+        uses: actions/cache@v5
+        with:
+          path: ${{ steps.composer-cache.outputs.dir }}
+          # Use composer.json for key, if composer.lock is not committed.
+          # key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.json') }}
+          key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
+          restore-keys: ${{ runner.os }}-composer-
+
+      - name: Install dependencies
+        run: composer install --no-progress --prefer-dist --optimize-autoloader
+
+      - name: PHP CodeSniffer
+        run: composer cs-check
+
+  static-analysis:
+    name: Static Analysis
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      # Docs: https://github.com/shivammathur/setup-php
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.5'
+          extensions: mbstring, intl
+          tools: phpstan
+
+      - name: Get composer cache directory
+        id: composer-cache
+        shell: bash
+        run: echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT
+
+      - name: Cache composer dependencies
+        uses: actions/cache@v5
+        with:
+          path: ${{ steps.composer-cache.outputs.dir }}
+          # Use composer.json for key, if composer.lock is not committed.
+          # key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.json') }}
+          key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
+          restore-keys: ${{ runner.os }}-composer-
+
+      - name: Install dependencies
+        run: |
+          composer install --no-progress --prefer-dist --optimize-autoloader
+          composer run-script post-install-cmd --no-interaction
+
+      - name: Static Analysis using PHPStan
+        run: phpstan analyse --no-progress src/

examples/codeigniter.yml

@@ -5,28 +5,37 @@ jobs:
   build:
     strategy:
       matrix:
-        operating-system: [ubuntu-latest, windows-latest, macOS-latest]
-        php-versions: ['7.2', '7.3']
+        operating-system: [ubuntu-latest, windows-latest, macos-latest]
+        php-versions: ['8.3', '8.4', '8.5']
     runs-on: ${{ matrix.operating-system }}
     steps:
       - name: Checkout
-        uses: actions/checkout@v1
-      - name: Setup PHP, with composer and extensions
-        uses: shivammathur/setup-php@v1 #https://github.com/shivammathur/setup-php
+        uses: actions/checkout@v6
+
+      # Docs: https://github.com/shivammathur/setup-php
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
         with:
           php-version: ${{ matrix.php-versions }}
-          extension-csv: mbstring, intl, curl, dom
-          coverage: xdebug #optional
+          extensions: mbstring, intl, curl, dom, sqlite3, pdo_sqlite
+          coverage: xdebug
+
       - name: Get composer cache directory
         id: composer-cache
-        run: echo "::set-output name=dir::$(composer config cache-files-dir)"
+        shell: bash
+        run: echo "dir=$(composer config cache-files-dir)" >> "$GITHUB_OUTPUT"
+
       - name: Cache composer dependencies
-        uses: actions/cache@v1
+        uses: actions/cache@v5
         with:
           path: ${{ steps.composer-cache.outputs.dir }}
+          # Use composer.json for key, if composer.lock is not committed.
+          # key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.json') }}
           key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
           restore-keys: ${{ runner.os }}-composer-
+
       - name: Install dependencies
-        run: composer install --no-progress --no-suggest --prefer-dist --optimize-autoloader
+        run: composer install --no-progress --prefer-dist --optimize-autoloader
+
       - name: Test with phpunit
-        run: vendor/bin/phpunit --coverage-text
+        run: vendor/bin/phpunit --coverage-text

examples/drupal.yml

@@ -0,0 +1,59 @@
+# GitHub Action for Drupal 11 composer-managed projects
+# Requires drupal/core-dev in require-dev for vendor/bin/phpunit
+name: Testing Drupal
+on: [push, pull_request]
+jobs:
+  drupal:
+    name: Drupal (PHP ${{ matrix.php-versions }})
+    runs-on: ubuntu-latest
+    env:
+      SIMPLETEST_BASE_URL: http://127.0.0.1:8080
+      SIMPLETEST_DB: sqlite://localhost/sites/default/files/.ht.sqlite
+      BROWSERTEST_OUTPUT_DIRECTORY: /tmp/browser_output
+    strategy:
+      fail-fast: false
+      matrix:
+        php-versions: ['8.3', '8.4', '8.5']
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      # Docs: https://github.com/shivammathur/setup-php
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ matrix.php-versions }}
+          extensions: apcu, ctype, curl, dom, gd, iconv, intl, mbstring, pdo_sqlite, simplexml, xml, zip
+          coverage: none
+
+      - name: Get composer cache directory
+        id: composer-cache
+        run: echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT
+
+      - name: Cache composer dependencies
+        uses: actions/cache@v5
+        with:
+          path: ${{ steps.composer-cache.outputs.dir }}
+          # Use composer.json for key, if composer.lock is not committed.
+          # key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.json') }}
+          key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
+          restore-keys: ${{ runner.os }}-composer-
+
+      - name: Install Composer dependencies
+        run: |
+          if [ "${{ matrix.php-versions }}" = "8.3" ]; then
+            composer require --dev drupal/core-dev:11.2.10 doctrine/instantiator:^2.0.0 --no-interaction --no-update
+            composer update drupal/core-dev doctrine/instantiator --with-all-dependencies --no-interaction --no-progress --prefer-dist --optimize-autoloader
+          else
+            composer install --no-interaction --no-progress --prefer-dist --optimize-autoloader
+          fi
+
+      - name: Prepare Drupal test directories
+        run: mkdir -p web/sites/default/files "$BROWSERTEST_OUTPUT_DIRECTORY"
+
+      - name: Start Drupal web server
+        run: php -S 127.0.0.1:8080 -t web >/tmp/php-server.log 2>&1 &
+
+      - name: Test with phpunit
+        # Adjust the test path to match your custom modules or themes.
+        run: vendor/bin/phpunit -c web/core web/modules/custom

examples/laminas-mvc.yml

@@ -0,0 +1,40 @@
+# GitHub Action for Laminas framework MVC projects
+name: Testing Laminas MVC
+on: [push, pull_request]
+jobs:
+  build:
+    strategy:
+      matrix:
+        operating-system: [ubuntu-latest, windows-latest, macos-latest]
+        php-versions: ['8.1', '8.2', '8.3']
+    runs-on: ${{ matrix.operating-system }}
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      # Docs: https://github.com/shivammathur/setup-php
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ matrix.php-versions }}
+          coverage: xdebug
+
+      - name: Get composer cache directory
+        id: composer-cache
+        shell: bash
+        run: echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT
+
+      - name: Cache composer dependencies
+        uses: actions/cache@v5
+        with:
+          path: ${{ steps.composer-cache.outputs.dir }}
+          # Use composer.json for key, if composer.lock is not committed.
+          # key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.json') }}
+          key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
+          restore-keys: ${{ runner.os }}-composer-
+
+      - name: Install dependencies
+        run: composer install --no-progress --prefer-dist --optimize-autoloader
+
+      - name: Test with phpunit
+        run: vendor/bin/phpunit --coverage-text

examples/laravel-mysql.yml

@@ -6,23 +6,28 @@ jobs:
     name: Laravel (PHP ${{ matrix.php-versions }})
     runs-on: ubuntu-latest
     env:
+      DB_CONNECTION: mysql
+      DB_HOST: 127.0.0.1
       DB_DATABASE: laravel
       DB_USERNAME: root
       DB_PASSWORD: password
-      BROADCAST_DRIVER: log
-      CACHE_DRIVER: redis
+      BROADCAST_CONNECTION: log
+      CACHE_STORE: redis
       QUEUE_CONNECTION: redis
-      SESSION_DRIVER: redis    
+      SESSION_DRIVER: redis
+
+    # Docs: https://docs.github.com/en/actions/using-containerized-services
     services:
       mysql:
-        image: mysql:5.7
+        image: mysql:latest
         env:
           MYSQL_ALLOW_EMPTY_PASSWORD: false
           MYSQL_ROOT_PASSWORD: password
           MYSQL_DATABASE: laravel
         ports:
-          - 3306
+          - 3306/tcp
         options: --health-cmd="mysqladmin ping" --health-interval=10s --health-timeout=5s --health-retries=3
+
       redis:
         image: redis
         ports:
@@ -31,38 +36,56 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        php-versions: ['7.2', '7.3', '7.4']
+        php-versions: ['8.3', '8.4', '8.5']
     steps:
       - name: Checkout
-        uses: actions/checkout@v1
-      - name: Setup PHP, with composer and extensions
-        uses: shivammathur/setup-php@v1 #https://github.com/shivammathur/setup-php
+        uses: actions/checkout@v6
+
+      # Docs: https://github.com/shivammathur/setup-php
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
         with:
           php-version: ${{ matrix.php-versions }}
-          extension-csv: mbstring, dom, fileinfo, mysql
-          coverage: xdebug #optional
+          extensions: mbstring, dom, fileinfo, mysql
+          coverage: xdebug
+
+      # Local MySQL service in GitHub hosted environments is disabled by default.
+      # If you are using it instead of service containers, make sure you start it.
+      # - name: Start mysql service
+      #   run: sudo systemctl start mysql.service
+
       - name: Get composer cache directory
         id: composer-cache
-        run: echo "::set-output name=dir::$(composer config cache-files-dir)"
+        run: echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT
+
       - name: Cache composer dependencies
-        uses: actions/cache@v1
+        uses: actions/cache@v5
         with:
           path: ${{ steps.composer-cache.outputs.dir }}
+          # Use composer.json for key, if composer.lock is not committed.
+          # key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.json') }}
           key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
           restore-keys: ${{ runner.os }}-composer-
+
       - name: Install Composer dependencies
-        run: composer install --no-progress --no-suggest --prefer-dist --optimize-autoloader
+        run: composer install --no-progress --prefer-dist --optimize-autoloader
+
       - name: Prepare the application
         run: |
           php -r "file_exists('.env') || copy('.env.example', '.env');"
           php artisan key:generate
+
       - name: Clear Config
         run: php artisan config:clear
+
       - name: Run Migration
         run: php artisan migrate -v
         env:
           DB_PORT: ${{ job.services.mysql.ports['3306'] }}
+          REDIS_PORT: ${{ job.services.redis.ports['6379'] }}
+
       - name: Test with phpunit
         run: vendor/bin/phpunit --coverage-text
         env:
-          DB_PORT: ${{ job.services.mysql.ports['3306'] }}
+          DB_PORT: ${{ job.services.mysql.ports['3306'] }}
+          REDIS_PORT: ${{ job.services.redis.ports['6379'] }}

examples/laravel-postgres.yml

@@ -11,13 +11,15 @@ jobs:
       QUEUE_CONNECTION: redis
       SESSION_DRIVER: redis
       DB_CONNECTION: pgsql
-      DB_HOST: localhost
+      DB_HOST: 127.0.0.1
       DB_PASSWORD: postgres
       DB_USERNAME: postgres
       DB_DATABASE: postgres
+
+    # Docs: https://docs.github.com/en/actions/using-containerized-services
     services:
       postgres:
-        image: postgres:10.8
+        image: postgres:latest
         env:
           POSTGRES_USER: postgres
           POSTGRES_PASSWORD: postgres
@@ -25,6 +27,7 @@ jobs:
         ports:
           - 5432/tcp
         options: --health-cmd pg_isready --health-interval 10s --health-timeout 5s --health-retries 3
+
       redis:
         image: redis
         ports:
@@ -33,38 +36,56 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        php-versions: ['7.2', '7.3', '7.4']
+        php-versions: ['8.3', '8.4', '8.5']
     steps:
       - name: Checkout
-        uses: actions/checkout@v1
-      - name: Setup PHP, with composer and extensions
-        uses: shivammathur/setup-php@v1 #https://github.com/shivammathur/setup-php
+        uses: actions/checkout@v6
+
+      # Docs: https://github.com/shivammathur/setup-php
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
         with:
           php-version: ${{ matrix.php-versions }}
-          extension-csv: mbstring, dom, fileinfo, pgsql
-          coverage: xdebug #optional
+          extensions: mbstring, dom, fileinfo, pgsql
+          coverage: xdebug
+
+      # Local PostgreSQL service in GitHub hosted environments is disabled by default.
+      # If you are using it instead of service containers, make sure you start it.
+      # - name: Start postgresql service
+      #   run: sudo systemctl start postgresql.service
+
       - name: Get composer cache directory
         id: composer-cache
-        run: echo "::set-output name=dir::$(composer config cache-files-dir)"
+        run: echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT
+
       - name: Cache composer dependencies
-        uses: actions/cache@v1
+        uses: actions/cache@v5
         with:
           path: ${{ steps.composer-cache.outputs.dir }}
+          # Use composer.json for key, if composer.lock is not committed.
+          # key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.json') }}
           key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
           restore-keys: ${{ runner.os }}-composer-
+
       - name: Install Composer dependencies
-        run: composer install --no-progress --no-suggest --prefer-dist --optimize-autoloader
+        run: composer install --no-progress --prefer-dist --optimize-autoloader
+
       - name: Prepare the application
         run: |
           php -r "file_exists('.env') || copy('.env.example', '.env');"
           php artisan key:generate
+
       - name: Clear Config
         run: php artisan config:clear
+
       - name: Run Migration
         run: php artisan migrate -v
         env:
-          DB_PORT: ${{ job.services.postgres.ports[5432] }}
+          DB_PORT: ${{ job.services.postgres.ports['5432'] }}
+          REDIS_PORT: ${{ job.services.redis.ports['6379'] }}
+
       - name: Test with phpunit
         run: vendor/bin/phpunit --coverage-text
         env:
-          DB_PORT: ${{ job.services.postgres.ports[5432] }}
+          DB_PORT: ${{ job.services.postgres.ports['5432'] }}
+          REDIS_PORT: ${{ job.services.redis.ports['6379'] }}

examples/laravel.yml

@@ -8,33 +8,44 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        operating-system: [ubuntu-latest, windows-latest, macOS-latest]
-        php-versions: ['7.2', '7.3']
+        operating-system: [ubuntu-latest, windows-latest, macos-latest]
+        php-versions: ['8.3', '8.4', '8.5']
     steps:
       - name: Checkout
-        uses: actions/checkout@v1
-      - name: Setup PHP, with composer and extensions
-        uses: shivammathur/setup-php@v1 #https://github.com/shivammathur/setup-php
+        uses: actions/checkout@v6
+
+      # Docs: https://github.com/shivammathur/setup-php
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
         with:
           php-version: ${{ matrix.php-versions }}
-          extension-csv: mbstring, dom, fileinfo
-          coverage: xdebug #optional
+          extensions: mbstring, dom, fileinfo
+          coverage: xdebug
+
       - name: Get composer cache directory
         id: composer-cache
-        run: echo "::set-output name=dir::$(composer config cache-files-dir)"
+        shell: bash
+        run: echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT
+
       - name: Cache composer dependencies
-        uses: actions/cache@v1
+        uses: actions/cache@v5
         with:
           path: ${{ steps.composer-cache.outputs.dir }}
+          # Use composer.json for key, if composer.lock is not committed.
+          # key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.json') }}
           key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
           restore-keys: ${{ runner.os }}-composer-
+
       - name: Install Composer dependencies
-        run: composer install --no-progress --no-suggest --prefer-dist --optimize-autoloader
+        run: composer install --no-progress --prefer-dist --optimize-autoloader
+
       - name: Prepare the application
         run: |
           php -r "file_exists('.env') || copy('.env.example', '.env');"
           php artisan key:generate
+
       - name: Clear Config
         run: php artisan config:clear
+
       - name: Test with phpunit
-        run: vendor/bin/phpunit --coverage-text
+        run: vendor/bin/phpunit --coverage-text

examples/lumen-mysql.yml

@@ -13,16 +13,19 @@ jobs:
       CACHE_DRIVER: redis
       QUEUE_CONNECTION: redis
       SESSION_DRIVER: redis
+
+    # Docs: https://docs.github.com/en/actions/using-containerized-services
     services:
       mysql:
-        image: mysql:5.7
+        image: mysql:latest
         env:
           MYSQL_ALLOW_EMPTY_PASSWORD: false
           MYSQL_ROOT_PASSWORD: password
           MYSQL_DATABASE: lumen
         ports:
-          - 3306
+          - 3306/tcp
         options: --health-cmd="mysqladmin ping" --health-interval=10s --health-timeout=5s --health-retries=3
+
       redis:
         image: redis
         ports:
@@ -31,38 +34,56 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        php-versions: ['7.2', '7.3']
+        php-versions: ['8.3', '8.4', '8.5']
     steps:
       - name: Checkout
-        uses: actions/checkout@v1
-      - name: Setup PHP, with composer and extensions
-        uses: shivammathur/setup-php@v1 #https://github.com/shivammathur/setup-php
+        uses: actions/checkout@v6
+
+      # Docs: https://github.com/shivammathur/setup-php
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
         with:
           php-version: ${{ matrix.php-versions }}
-          extension-csv: mbstring, dom, fileinfo, mysql
-          coverage: xdebug #optional
+          extensions: mbstring, dom, fileinfo, mysql
+          coverage: xdebug
+
+      # Local MySQL service in GitHub hosted environments is disabled by default.
+      # If you are using it instead of service containers, make sure you start it.
+      # - name: Start mysql service
+      #   run: sudo systemctl start mysql.service
+
       - name: Get composer cache directory
         id: composer-cache
-        run: echo "::set-output name=dir::$(composer config cache-files-dir)"
+        run: echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT
+
       - name: Cache composer dependencies
-        uses: actions/cache@v1
+        uses: actions/cache@v5
         with:
           path: ${{ steps.composer-cache.outputs.dir }}
+          # Use composer.json for key, if composer.lock is not committed.
+          # key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.json') }}
           key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
           restore-keys: ${{ runner.os }}-composer-
+
       - name: Install Composer dependencies
         run: |
-          composer install --no-progress --no-suggest --prefer-dist --optimize-autoloader
+          composer install --no-progress --prefer-dist --optimize-autoloader
           composer require predis/predis illuminate/redis
+
       - name: Prepare the application
         run: php -r "file_exists('.env') || copy('.env.example', '.env');"
+
       - name: Register Redis as service provider
         run: sed -i '$i\$app->register(Illuminate\\Redis\\RedisServiceProvider::class);' bootstrap/app.php
+
       - name: Run Migration
         run: php artisan migrate -v
         env:
           DB_PORT: ${{ job.services.mysql.ports['3306'] }}
+          REDIS_PORT: ${{ job.services.redis.ports['6379'] }}
+
       - name: Test with phpunit
-        run: vendor/bin/phpunit --coverage-text
+        run: vendor/bin/phpunit --coverage-text --coverage-filter app
         env:
-          DB_PORT: ${{ job.services.mysql.ports['3306'] }}
+          DB_PORT: ${{ job.services.mysql.ports['3306'] }}
+          REDIS_PORT: ${{ job.services.redis.ports['6379'] }}

examples/lumen-postgres.yml

@@ -11,13 +11,15 @@ jobs:
       QUEUE_CONNECTION: redis
       SESSION_DRIVER: redis
       DB_CONNECTION: pgsql
-      DB_HOST: localhost
+      DB_HOST: 127.0.0.1
       DB_PASSWORD: postgres
       DB_USERNAME: postgres
       DB_DATABASE: postgres
+
+    # Docs: https://docs.github.com/en/actions/using-containerized-services
     services:
       postgres:
-        image: postgres:10.8
+        image: postgres:latest
         env:
           POSTGRES_USER: postgres
           POSTGRES_PASSWORD: postgres
@@ -25,6 +27,7 @@ jobs:
         ports:
           - 5432/tcp
         options: --health-cmd pg_isready --health-interval 10s --health-timeout 5s --health-retries 3
+
       redis:
         image: redis
         ports:
@@ -33,38 +36,56 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        php-versions: ['7.2', '7.3']
+        php-versions: ['8.3', '8.4', '8.5']
     steps:
       - name: Checkout
-        uses: actions/checkout@v1
-      - name: Setup PHP, with composer and extensions
-        uses: shivammathur/setup-php@v1 #https://github.com/shivammathur/setup-php
+        uses: actions/checkout@v6
+
+      # Docs: https://github.com/shivammathur/setup-php
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
         with:
           php-version: ${{ matrix.php-versions }}
-          extension-csv: mbstring, dom, fileinfo, pgsql
-          coverage: xdebug #optional
+          extensions: mbstring, dom, fileinfo, pgsql
+          coverage: none
+
+      # Local PostgreSQL service in GitHub hosted environments is disabled by default.
+      # If you are using it instead of service containers, make sure you start it.
+      # - name: Start postgresql service
+      #   run: sudo systemctl start postgresql.service
+
       - name: Get composer cache directory
         id: composer-cache
-        run: echo "::set-output name=dir::$(composer config cache-files-dir)"
+        run: echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT
+
       - name: Cache composer dependencies
-        uses: actions/cache@v1
+        uses: actions/cache@v5
         with:
           path: ${{ steps.composer-cache.outputs.dir }}
+          # Use composer.json for key, if composer.lock is not committed.
+          # key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.json') }}
           key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
           restore-keys: ${{ runner.os }}-composer-
+
       - name: Install Composer dependencies
         run: |
-          composer install --no-progress --no-suggest --prefer-dist --optimize-autoloader
+          composer install --no-progress --prefer-dist --optimize-autoloader
           composer require predis/predis illuminate/redis
+
       - name: Prepare the application
         run: php -r "file_exists('.env') || copy('.env.example', '.env');"
+
       - name: Register Redis as service provider
         run: sed -i '$i\$app->register(Illuminate\\Redis\\RedisServiceProvider::class);' bootstrap/app.php
+
       - name: Run Migration
         run: php artisan migrate -v
         env:
-          DB_PORT: ${{ job.services.postgres.ports[5432] }}
+          DB_PORT: ${{ job.services.postgres.ports['5432'] }}
+          REDIS_PORT: ${{ job.services.redis.ports['6379'] }}
+
       - name: Test with phpunit
-        run: vendor/bin/phpunit --coverage-text
+        run: vendor/bin/phpunit
         env:
-          DB_PORT: ${{ job.services.postgres.ports[5432] }}
+          DB_PORT: ${{ job.services.postgres.ports['5432'] }}
+          REDIS_PORT: ${{ job.services.redis.ports['6379'] }}

examples/lumen.yml

@@ -8,29 +8,39 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        operating-system: [ubuntu-latest, windows-latest, macOS-latest]
-        php-versions: ['7.2', '7.3']
+        operating-system: [ubuntu-latest, windows-latest, macos-latest]
+        php-versions: ['8.3', '8.4', '8.5']
     steps:
       - name: Checkout
-        uses: actions/checkout@v1
-      - name: Setup PHP, with composer and extensions
-        uses: shivammathur/setup-php@v1 #https://github.com/shivammathur/setup-php
+        uses: actions/checkout@v6
+
+      # Docs: https://github.com/shivammathur/setup-php
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
         with:
           php-version: ${{ matrix.php-versions }}
-          extension-csv: mbstring, dom, fileinfo, mysql
-          coverage: xdebug #optional
+          extensions: mbstring, dom, fileinfo, mysql
+          coverage: xdebug
+
       - name: Get composer cache directory
         id: composer-cache
-        run: echo "::set-output name=dir::$(composer config cache-files-dir)"
+        shell: bash
+        run: echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT
+
       - name: Cache composer dependencies
-        uses: actions/cache@v1
+        uses: actions/cache@v5
         with:
           path: ${{ steps.composer-cache.outputs.dir }}
+          # Use composer.json for key, if composer.lock is not committed.
+          # key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.json') }}
           key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
           restore-keys: ${{ runner.os }}-composer-
+
       - name: Install Composer dependencies
-        run: composer install --no-progress --no-suggest --prefer-dist --optimize-autoloader
+        run: composer install --no-progress --prefer-dist --optimize-autoloader
+
       - name: Prepare the application
         run: php -r "file_exists('.env') || copy('.env.example', '.env');"
+
       - name: Test with phpunit
-        run: vendor/bin/phpunit --coverage-text
+        run: vendor/bin/phpunit --coverage-text --coverage-filter app

examples/phalcon-mysql.yml

@@ -11,20 +11,22 @@ jobs:
     env:
       DB_ADAPTER: mysql
       DB_HOST: 127.0.0.1
-      DB_NAME: phalcon
+      DB_NAME: vokuro
       DB_USERNAME: root
       DB_PASSWORD: password
       CODECEPTION_URL: 127.0.0.1
       CODECEPTION_PORT: 8888
+
+    # Docs: https://docs.github.com/en/actions/using-containerized-services
     services:
       mysql:
         image: mysql:5.7
         env:
           MYSQL_ALLOW_EMPTY_PASSWORD: false
           MYSQL_ROOT_PASSWORD: password
-          MYSQL_DATABASE: phalcon
+          MYSQL_DATABASE: vokuro
         ports:
-          - 3306
+          - 3306/tcp
         options: --health-cmd="mysqladmin ping" --health-interval=10s --health-timeout=5s --health-retries=3
     strategy:
       fail-fast: false
@@ -32,37 +34,52 @@ jobs:
         php-versions: ['7.2', '7.3', '7.4']
     steps:
       - name: Checkout
-        uses: actions/checkout@v1
-      - name: Setup PHP, with composer and extensions
-        uses: shivammathur/setup-php@v1 #https://github.com/shivammathur/setup-php
+        uses: actions/checkout@v6
+
+      # Docs: https://github.com/shivammathur/setup-php
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
         with:
           php-version: ${{ matrix.php-versions }}
-          extension-csv: mbstring, dom, zip, phalcon4, mysql #use phalcon3 for the phalcon 3.x.
-          coverage: xdebug #optional
+          # Use phalcon4 for the latest compatible Vokuro sample release.
+          extensions: mbstring, dom, zip, phalcon4, mysql
+          coverage: xdebug
+
+      # Local MySQL service in GitHub hosted environments is disabled by default.
+      # If you are using it instead of service containers, make sure you start it.
+      # - name: Start mysql service
+      #   run: sudo systemctl start mysql.service
+
       - name: Get composer cache directory
         id: composer-cache
-        run: echo "::set-output name=dir::$(composer config cache-files-dir)"
+        run: echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT
+
       - name: Cache composer dependencies
-        uses: actions/cache@v1
+        uses: actions/cache@v5
         with:
           path: ${{ steps.composer-cache.outputs.dir }}
+          # Use composer.json for key, if composer.lock is not committed.
+          # key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.json') }}
           key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
           restore-keys: ${{ runner.os }}-composer-
+
       - name: Install Composer dependencies
-        run: composer install --no-progress --no-suggest --prefer-dist --optimize-autoloader
+        run: composer install --no-progress --prefer-dist --optimize-autoloader
+
       - name: Prepare the application
         run: php -r "file_exists('.env') || copy('.env.example', '.env');"
+
       - name: Run Migration
         run: |
-          if [ ! -e phinx.yml ]; then vendor/bin/phinx init; fi
           vendor/bin/phinx migrate
           vendor/bin/phinx seed:run
         env:
           DB_PORT: ${{ job.services.mysql.ports['3306'] }}
+
       - name: Run Tests
         run: |
           (cd public && nohup php -S $CODECEPTION_URL:$CODECEPTION_PORT > phalcon.log 2>&1 &)
           vendor/bin/codecept build
           vendor/bin/codecept run
         env:
-          DB_PORT: ${{ job.services.mysql.ports['3306'] }}
+          DB_PORT: ${{ job.services.mysql.ports['3306'] }}

examples/phalcon-postgres.yml

@@ -11,19 +11,18 @@ jobs:
     env:
       DB_ADAPTER: pgsql
       DB_HOST: 127.0.0.1
-      DB_NAME: postgres
+      DB_NAME: vokuro
       DB_USERNAME: postgres
       DB_PASSWORD: postgres
       CODECEPTION_URL: 127.0.0.1
       CODECEPTION_PORT: 8888
-      DB_CONNECTION: pgsql
     services:
       postgres:
-        image: postgres:10.8
+        image: postgres:latest
         env:
           POSTGRES_USER: postgres
           POSTGRES_PASSWORD: postgres
-          POSTGRES_DB: postgres
+          POSTGRES_DB: vokuro
         ports:
           - 5432/tcp
         options: --health-cmd pg_isready --health-interval 10s --health-timeout 5s --health-retries 3
@@ -33,37 +32,47 @@ jobs:
         php-versions: ['7.2', '7.3', '7.4']
     steps:
       - name: Checkout
-        uses: actions/checkout@v1
-      - name: Setup PHP, with composer and extensions
-        uses: shivammathur/setup-php@v1 #https://github.com/shivammathur/setup-php
+        uses: actions/checkout@v6
+
+      # Docs: https://github.com/shivammathur/setup-php
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
         with:
           php-version: ${{ matrix.php-versions }}
-          extension-csv: mbstring, dom, zip, phalcon4, pgsql #use phalcon3 for the phalcon 3.x
-          coverage: xdebug #optional
+          extensions: mbstring, dom, zip, phalcon4, pgsql
+          coverage: xdebug
+
       - name: Get composer cache directory
         id: composer-cache
-        run: echo "::set-output name=dir::$(composer config cache-files-dir)"
+        run: echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT
+
       - name: Cache composer dependencies
-        uses: actions/cache@v1
+        uses: actions/cache@v5
         with:
           path: ${{ steps.composer-cache.outputs.dir }}
           key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
           restore-keys: ${{ runner.os }}-composer-
+
       - name: Install Composer dependencies
-        run: composer install --no-progress --no-suggest --prefer-dist --optimize-autoloader
+        run: composer install --no-progress --prefer-dist --optimize-autoloader --no-security-blocking
+
       - name: Prepare the application
-        run: php -r "file_exists('.env') || copy('.env.example', '.env');"
+        run: |
+          php -r "file_exists('.env') || copy('.env.example', '.env');"
+          mkdir -p var/cache/acl var/cache/metaData var/cache/session var/cache/volt var/logs
+          chmod -R 777 var/cache var/logs
+
       - name: Run Migration
         run: |
-          if [ ! -e phinx.yml ]; then vendor/bin/phinx init; fi
           vendor/bin/phinx migrate
           vendor/bin/phinx seed:run
         env:
           DB_PORT: ${{ job.services.postgres.ports['5432'] }}
+
       - name: Run Tests
         run: |
-          (cd public && nohup php -S $CODECEPTION_URL:$CODECEPTION_PORT > phalcon.log 2>&1 &)
+          (cd public && nohup php -S $CODECEPTION_URL:$CODECEPTION_PORT > vokuro.log 2>&1 &)
           vendor/bin/codecept build
           vendor/bin/codecept run
         env:
-          DB_PORT: ${{ job.services.postgres.ports['5432'] }}
+          DB_PORT: ${{ job.services.postgres.ports['5432'] }}

examples/sage.yml

@@ -8,48 +8,55 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        php-versions: ['7.1', '7.2', '7.3', '7.4']
-        node-versions: ['8', '10']
+        php-versions: ['8.3', '8.4', '8.5']
+        node-versions: ['20']
     steps:
       - name: Checkout
-        uses: actions/checkout@v1
+        uses: actions/checkout@v6
+
       - name: Setup Node.js
-        uses: actions/setup-node@v1
+        uses: actions/setup-node@v5
         with:
           node-version: ${{ matrix.node-versions }}
-      - name: Setup PHP, with composer and extensions
-        uses: shivammathur/setup-php@v1 #https://github.com/shivammathur/setup-php
+
+      # Docs: https://github.com/shivammathur/setup-php
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
         with:
           php-version: ${{ matrix.php-versions }}
-          extension-csv: mbstring
+          extensions: mbstring
+
       - name: Check node versions
         run: node -v
+
       - name: Get yarn cache
         id: yarn-cache
-        run: echo "::set-output name=dir::$(yarn cache dir)"
-      - uses: actions/cache@v1
+        run: echo "dir=$(yarn cache dir)" >> $GITHUB_OUTPUT
+
+      - uses: actions/cache@v5
         with:
           path: ${{ steps.yarn-cache.outputs.dir }}
           key: ${{ runner.os }}-yarn-${{ hashFiles('**/yarn.lock') }}
           restore-keys: ${{ runner.os }}-yarn-
+
       - name: Get composer cache directory
         id: composer-cache
-        run: echo "::set-output name=dir::$(composer config cache-files-dir)"
+        run: echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT
+
       - name: Cache composer dependencies
-        uses: actions/cache@v1
+        uses: actions/cache@v5
         with:
           path: ${{ steps.composer-cache.outputs.dir }}
+          # Use composer.json for key, if composer.lock is not committed.
+          # key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.json') }}
           key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
           restore-keys: ${{ runner.os }}-composer-
+
       - name: Install yarn dependencies
-        run: yarn -V
+        run: yarn install --frozen-lockfile --non-interactive
+
       - name: Install Composer dependencies
-        run: composer install -o --prefer-dist --no-interaction
-      - name: Yarn test and build
-        run: |
-          yarn run test
-          yarn run build
-          yarn run rmdist
-          yarn run "build:production"
-      - name: PHP test
-        run: composer test
+        run: composer install --no-progress --prefer-dist --optimize-autoloader
+
+      - name: Yarn build
+        run: yarn build

examples/slim-framework.yml

@@ -5,28 +5,37 @@ jobs:
   build:
     strategy:
       matrix:
-        operating-system: [ubuntu-latest, windows-latest, macOS-latest]
-        php-versions: ['7.2', '7.3']
+        operating-system: [ubuntu-latest, windows-latest, macos-latest]
+        php-versions: ['8.3', '8.4', '8.5']
     runs-on: ${{ matrix.operating-system }}
     steps:
       - name: Checkout
-        uses: actions/checkout@v1
-      - name: Setup PHP, with composer and extensions
-        uses: shivammathur/setup-php@v1 #https://github.com/shivammathur/setup-php
+        uses: actions/checkout@v6
+
+      # Docs: https://github.com/shivammathur/setup-php
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
         with:
           php-version: ${{ matrix.php-versions }}
-          extension-csv: mbstring, simplexml, dom
-          coverage: xdebug #optional
+          extensions: mbstring, simplexml, dom
+          coverage: xdebug
+
       - name: Get composer cache directory
         id: composer-cache
-        run: echo "::set-output name=dir::$(composer config cache-files-dir)"
+        shell: bash
+        run: echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT
+
       - name: Cache composer dependencies
-        uses: actions/cache@v1
+        uses: actions/cache@v5
         with:
           path: ${{ steps.composer-cache.outputs.dir }}
+          # Use composer.json for key, if composer.lock is not committed.
+          # key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.json') }}
           key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
           restore-keys: ${{ runner.os }}-composer-
+
       - name: Install dependencies
-        run: composer install --no-progress --no-suggest --prefer-dist --optimize-autoloader
+        run: composer install --no-progress --prefer-dist --optimize-autoloader
+
       - name: Test with phpunit
-        run: vendor/bin/phpunit --coverage-text
+        run: vendor/bin/phpunit --coverage-text

examples/symfony-mysql.yml

@@ -5,49 +5,66 @@ jobs:
   symfony:
     name: Symfony (PHP ${{ matrix.php-versions }})
     runs-on: ubuntu-latest
+    env:
+      APP_ENV: test
+
+    # Docs: https://docs.github.com/en/actions/using-containerized-services
     services:
       mysql:
-        image: mysql:5.7
+        image: mysql:8.4
         env:
           MYSQL_ALLOW_EMPTY_PASSWORD: false
           MYSQL_ROOT_PASSWORD: symfony
           MYSQL_DATABASE: symfony
         ports:
-          - 3306
+          - 3306/tcp
         options: --health-cmd="mysqladmin ping" --health-interval=10s --health-timeout=5s --health-retries=3
     strategy:
       fail-fast: false
       matrix:
-        php-versions: ['7.3']
+        php-versions: ['8.4', '8.5', '8.6']
     steps:
       - name: Checkout
-        uses: actions/checkout@v1
-      - name: Setup PHP, with composer and extensions
-        uses: shivammathur/setup-php@v1 #https://github.com/shivammathur/setup-php
+        uses: actions/checkout@v6
+
+      # Docs: https://github.com/shivammathur/setup-php
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
         with:
           php-version: ${{ matrix.php-versions }}
-          extension-csv: mbstring, xml, ctype, iconv, mysql
-          coverage: xdebug #optional
+          extensions: mbstring, xml, ctype, iconv, intl, pdo_sqlite, mysql
+          coverage: xdebug
+
+      # Local MySQL service in GitHub hosted environments is disabled by default.
+      # If you are using it instead of service containers, make sure you start it.
+      # - name: Start mysql service
+      #   run: sudo systemctl start mysql.service
+
       - name: Get composer cache directory
         id: composer-cache
-        run: echo "::set-output name=dir::$(composer config cache-files-dir)"
+        run: echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT
+
       - name: Cache composer dependencies
-        uses: actions/cache@v1
+        uses: actions/cache@v5
         with:
           path: ${{ steps.composer-cache.outputs.dir }}
+          # Use composer.json for key, if composer.lock is not committed.
+          # key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.json') }}
           key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
           restore-keys: ${{ runner.os }}-composer-
+
       - name: Install Composer dependencies
+        run: composer install --no-interaction --no-progress --prefer-dist --optimize-autoloader
+
+      - name: Prepare database
         run: |
-          composer install --no-progress --no-suggest --prefer-dist --optimize-autoloader
-      - name: Run Migration
-        run: |
-          composer require symfony/orm-pack
-          php bin/console doctrine:schema:update --force || echo "No migrations found or schema update failed"
-          php bin/console doctrine:migrations:migrate || echo "No migrations found or migration failed"
+          php bin/console doctrine:database:create --if-not-exists --no-interaction
+          php bin/console doctrine:schema:create --no-interaction
+          php bin/console doctrine:fixtures:load --no-interaction
         env:
-          DATABASE_URL: mysql://root:symfony@127.0.0.1:${{ job.services.mysql.ports['3306'] }}/symfony
-      - name: Run Tests
-        run: |
-          composer require phpunit
-          php bin/phpunit --coverage-text
+          DATABASE_URL: mysql://root:symfony@127.0.0.1:${{ job.services.mysql.ports['3306'] }}/symfony?serverVersion=8.4&charset=utf8mb4
+
+      - name: Run tests
+        run: php bin/phpunit --coverage-text
+        env:
+          DATABASE_URL: mysql://root:symfony@127.0.0.1:${{ job.services.mysql.ports['3306'] }}/symfony?serverVersion=8.4&charset=utf8mb4

examples/symfony-postgres.yml

@@ -5,9 +5,13 @@ jobs:
   symfony:
     name: Symfony (PHP ${{ matrix.php-versions }})
     runs-on: ubuntu-latest
+    env:
+      APP_ENV: test
+
+    # Docs: https://docs.github.com/en/actions/using-containerized-services
     services:
       postgres:
-        image: postgres:10.8
+        image: postgres:16
         env:
           POSTGRES_USER: postgres
           POSTGRES_PASSWORD: postgres
@@ -18,36 +22,49 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        php-versions: ['7.3']
+        php-versions: ['8.4', '8.5', '8.6']
     steps:
       - name: Checkout
-        uses: actions/checkout@v1
-      - name: Setup PHP, with composer and extensions
-        uses: shivammathur/setup-php@v1 #https://github.com/shivammathur/setup-php
+        uses: actions/checkout@v6
+
+      # Docs: https://github.com/shivammathur/setup-php
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
         with:
           php-version: ${{ matrix.php-versions }}
-          extension-csv: mbstring, xml, ctype, iconv, pgsql
-          coverage: xdebug #optional
+          extensions: mbstring, xml, ctype, iconv, intl, pdo_pgsql, pgsql
+          coverage: xdebug
+
+      # Local PostgreSQL service in GitHub hosted environments is disabled by default.
+      # If you are using it instead of service containers, make sure you start it.
+      # - name: Start postgresql service
+      #   run: sudo systemctl start postgresql.service
+
       - name: Get composer cache directory
         id: composer-cache
-        run: echo "::set-output name=dir::$(composer config cache-files-dir)"
+        run: echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT
+
       - name: Cache composer dependencies
-        uses: actions/cache@v1
+        uses: actions/cache@v5
         with:
           path: ${{ steps.composer-cache.outputs.dir }}
+          # Use composer.json for key, if composer.lock is not committed.
+          # key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.json') }}
           key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
           restore-keys: ${{ runner.os }}-composer-
+
       - name: Install Composer dependencies
+        run: composer install --no-progress --prefer-dist --optimize-autoloader
+
+      - name: Prepare database
         run: |
-          composer install --no-progress --no-suggest --prefer-dist --optimize-autoloader
-      - name: Run Migration
-        run: |
-          composer require symfony/orm-pack
-          php bin/console doctrine:schema:update --force || echo "No migrations found or schema update failed"
-          php bin/console doctrine:migrations:migrate || echo "No migrations found or migration failed"
+          php bin/console doctrine:database:create --if-not-exists --no-interaction
+          php bin/console doctrine:schema:create --no-interaction
+          php bin/console doctrine:fixtures:load --no-interaction
         env:
-          DATABASE_URL: postgres://postgres:postgres@127.0.0.1:${{ job.services.postgres.ports[5432] }}/postgres?charset=UTF-8
-      - name: Run Tests
-        run: |
-          composer require phpunit
-          php bin/phpunit --coverage-text
+          DATABASE_URL: postgresql://postgres:postgres@127.0.0.1:${{ job.services.postgres.ports[5432] }}/postgres?serverVersion=16.0.0&charset=utf8
+
+      - name: Run tests
+        run: php bin/phpunit --coverage-text
+        env:
+          DATABASE_URL: postgresql://postgres:postgres@127.0.0.1:${{ job.services.postgres.ports[5432] }}/postgres?serverVersion=16.0.0&charset=utf8

examples/symfony.yml

@@ -8,31 +8,36 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        operating-system: [ubuntu-latest, windows-latest, macOS-latest]
-        php-versions: ['7.3']
+        operating-system: [ubuntu-latest, windows-latest, macos-latest]
+        php-versions: ['8.4', '8.5', '8.6']
     steps:
       - name: Checkout
-        uses: actions/checkout@v1
-      - name: Setup PHP, with composer and extensions
-        uses: shivammathur/setup-php@v1 #https://github.com/shivammathur/setup-php
+        uses: actions/checkout@v6
+
+      # Docs: https://github.com/shivammathur/setup-php
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
         with:
           php-version: ${{ matrix.php-versions }}
-          extension-csv: mbstring, xml, ctype, iconv
-          coverage: xdebug #optional
+          extensions: mbstring, xml, ctype, iconv, intl, pdo_sqlite, zip
+          coverage: xdebug
+
       - name: Get composer cache directory
         id: composer-cache
-        run: echo "::set-output name=dir::$(composer config cache-files-dir)"
+        shell: bash
+        run: echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT
+
       - name: Cache composer dependencies
-        uses: actions/cache@v1
+        uses: actions/cache@v5
         with:
           path: ${{ steps.composer-cache.outputs.dir }}
+          # Use composer.json for key, if composer.lock is not committed.
+          # key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.json') }}
           key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
           restore-keys: ${{ runner.os }}-composer-
+
       - name: Install Composer dependencies
-        run: |
-          composer require symfony/orm-pack
-          composer install --no-progress --no-suggest --prefer-dist --optimize-autoloader
-      - name: Run Tests
-        run: |
-          composer require phpunit
-          php bin/phpunit --coverage-text
+        run: composer install --no-progress --prefer-dist --optimize-autoloader
+
+      - name: Run tests
+        run: ./bin/phpunit --coverage-text

examples/wordpress.yml

@@ -0,0 +1,68 @@
+# GitHub Action for WordPress plugins
+# Tested with files scaffolded by wp scaffold plugin-tests --ci=github
+# Requires phpunit/phpunit and yoast/phpunit-polyfills in require-dev for vendor/bin/phpunit
+name: Testing WordPress
+on: [push, pull_request]
+jobs:
+  wordpress:
+    name: WordPress (PHP ${{ matrix.php-versions }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        php-versions: ['8.3', '8.4', '8.5']
+
+    # Docs: https://docs.github.com/en/actions/using-containerized-services
+    services:
+      mysql:
+        image: mysql:latest
+        env:
+          MYSQL_ALLOW_EMPTY_PASSWORD: false
+          MYSQL_ROOT_PASSWORD: root
+          MYSQL_DATABASE: wordpress_test
+        ports:
+          - 3306/tcp
+        options: --health-cmd="mysqladmin ping" --health-interval=10s --health-timeout=5s --health-retries=3
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      # Docs: https://github.com/shivammathur/setup-php
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ matrix.php-versions }}
+          extensions: mbstring, xml, zip, intl, mysql
+          coverage: none
+
+      - name: Get composer cache directory
+        id: composer-cache
+        run: echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT
+
+      - name: Cache composer dependencies
+        uses: actions/cache@v5
+        with:
+          path: ${{ steps.composer-cache.outputs.dir }}
+          # Use composer.json for key, if composer.lock is not committed.
+          # key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.json') }}
+          key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
+          restore-keys: ${{ runner.os }}-composer-
+
+      - name: Install system dependencies
+        run: sudo apt-get update && sudo apt-get install -y subversion default-mysql-client
+
+      - name: Install Composer dependencies
+        run: |
+          if [ "${{ matrix.php-versions }}" = "8.3" ]; then
+            composer require --dev doctrine/instantiator:^2.0.0 --no-interaction --no-update
+            composer update doctrine/instantiator --with-all-dependencies --no-interaction --no-progress --prefer-dist --optimize-autoloader
+          else
+            composer install --no-interaction --no-progress --prefer-dist --optimize-autoloader
+          fi
+
+      - name: Install WordPress test environment
+        run: bash bin/install-wp-tests.sh wordpress_test root root 127.0.0.1:${{ job.services.mysql.ports['3306'] }} latest true
+
+      - name: Test with phpunit
+        run: vendor/bin/phpunit

examples/yii2-mysql.yml

@@ -1,69 +0,0 @@
-# GitHub Action for Yii Framework with MySQL
-name: Testing Yii2 with MySQL
-on: [push, pull_request]
-jobs:
-  yii:
-    name: Yii2 (PHP ${{ matrix.php-versions }})
-    runs-on: ubuntu-latest
-    env:
-      DB_USERNAME: root
-      DB_PASSWORD: yii
-      TEST_DB_USERNAME: root
-      TEST_DB_PASSWORD: yii
-      DB_CHARSET: utf8
-    services:
-      mysql:
-        image: mysql:5.7
-        env:
-          MYSQL_ALLOW_EMPTY_PASSWORD: false
-          MYSQL_ROOT_PASSWORD: yii
-          MYSQL_DATABASE: yii
-        ports:
-          - 3306
-        options: --health-cmd="mysqladmin ping" --health-interval=10s --health-timeout=5s --health-retries=3
-    strategy:
-      fail-fast: false
-      matrix:
-        php-versions: ['7.2', '7.3', '7.4']
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v1
-      - name: Set Node.js 10.x
-        uses: actions/setup-node@v1
-        with:
-          node-version: 10.x
-      - name: Setup PHP, with composer and extensions
-        uses: shivammathur/setup-php@v1 #https://github.com/shivammathur/setup-php
-        with:
-          php-version: ${{ matrix.php-versions }}
-          extension-csv: mbstring, intl, gd, imagick, zip, dom, mysql
-          coverage: xdebug #optional
-      - name: Get composer cache directory
-        id: composer-cache
-        run: echo "::set-output name=dir::$(composer config cache-files-dir)"
-      - name: Cache composer dependencies
-        uses: actions/cache@v1
-        with:
-          path: ${{ steps.composer-cache.outputs.dir }}
-          key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
-          restore-keys: ${{ runner.os }}-composer-
-      - name: Install Composer dependencies
-        run: composer install --no-progress --no-suggest --prefer-dist --optimize-autoloader
-      - name: Prepare the application
-        run: |
-          php -r "file_exists('.env') || copy('.env.dist', '.env');"
-          php console/yii app/setup
-          npm install --development
-          npm run build
-        env:
-          DB_DSN: mysql:host=127.0.0.1;port=${{ job.services.mysql.ports['3306'] }};dbname=yii
-          TEST_DB_DSN: mysql:host=127.0.0.1;port=${{ job.services.mysql.ports['3306'] }};dbname=yii
-      - name: Run Tests
-        run: |
-          vendor/bin/codecept build
-          php tests/bin/yii app/setup --interactive=0
-          nohup php -S localhost:8080 > yii.log 2>&1 &
-          vendor/bin/codecept run
-        env:
-          DB_DSN: mysql:host=127.0.0.1;port=${{ job.services.mysql.ports['3306'] }};dbname=yii
-          TEST_DB_DSN: mysql:host=127.0.0.1;port=${{ job.services.mysql.ports['3306'] }};dbname=yii

examples/yii2-postgres.yml

@@ -1,69 +0,0 @@
-# GitHub Action for Yii Framework with PostgreSQL
-name: Testing Yii2 with PostgreSQL
-on: [push, pull_request]
-jobs:
-  yii:
-    name: Yii2 (PHP ${{ matrix.php-versions }})
-    runs-on: ubuntu-latest
-    env:
-      DB_USERNAME: postgres
-      DB_PASSWORD: postgres
-      TEST_DB_USERNAME: postgres
-      TEST_DB_PASSWORD: postgres
-      DB_CHARSET: utf8
-    services:
-      postgres:
-        image: postgres:10.8
-        env:
-          POSTGRES_USER: postgres
-          POSTGRES_PASSWORD: postgres
-          POSTGRES_DB: postgres
-        ports:
-          - 5432/tcp
-        options: --health-cmd pg_isready --health-interval 10s --health-timeout 5s --health-retries 3
-    strategy:
-      fail-fast: false
-      matrix:
-        php-versions: ['7.2', '7.3', '7.4']
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v1
-      - name: Set Node.js 10.x
-        uses: actions/setup-node@v1
-        with:
-          node-version: 10.x
-      - name: Setup PHP, with composer and extensions
-        uses: shivammathur/setup-php@v1 #https://github.com/shivammathur/setup-php
-        with:
-          php-version: ${{ matrix.php-versions }}
-          extension-csv: mbstring, intl, gd, imagick, zip, dom, pgsql
-          coverage: xdebug #optional
-      - name: Get composer cache directory
-        id: composer-cache
-        run: echo "::set-output name=dir::$(composer config cache-files-dir)"
-      - name: Cache composer dependencies
-        uses: actions/cache@v1
-        with:
-          path: ${{ steps.composer-cache.outputs.dir }}
-          key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
-          restore-keys: ${{ runner.os }}-composer-
-      - name: Install Composer dependencies
-        run: composer install --no-progress --no-suggest --prefer-dist --optimize-autoloader
-      - name: Prepare the application
-        run: |
-          php -r "file_exists('.env') || copy('.env.dist', '.env');"
-          php console/yii app/setup
-          npm install --development
-          npm run build
-        env:
-          DB_DSN: pgsql:host=127.0.0.1;port=${{ job.services.postgres.ports['5432'] }};dbname=postgres
-          TEST_DB_DSN: pgsql:host=127.0.0.1;port=${{ job.services.postgres.ports['5432'] }};dbname=postgres
-      - name: Run Tests
-        run: |
-          vendor/bin/codecept build
-          php tests/bin/yii app/setup --interactive=0
-          nohup php -S localhost:8080 > yii.log 2>&1 &
-          vendor/bin/codecept run
-        env:
-          DB_DSN: pgsql:host=127.0.0.1;port=${{ job.services.postgres.ports['5432'] }};dbname=postgres
-          TEST_DB_DSN: pgsql:host=127.0.0.1;port=${{ job.services.postgres.ports['5432'] }};dbname=postgres

examples/yii3-mysql.yml

@@ -0,0 +1,78 @@
+# GitHub Action for Yii3 web application with MySQL
+# Tested with https://github.com/yiisoft/app
+name: Testing Yii3 with MySQL
+on: [push, pull_request]
+jobs:
+  yii:
+    name: Yii3 (PHP ${{ matrix.php-versions }})
+    runs-on: ubuntu-latest
+    env:
+      APP_C3: true
+      APP_ENV: test
+      APP_DEBUG: false
+
+    # Docs: https://docs.github.com/en/actions/using-containerized-services
+    services:
+      mysql:
+        image: mysql:8.4
+        env:
+          MYSQL_ALLOW_EMPTY_PASSWORD: false
+          MYSQL_ROOT_PASSWORD: password
+          MYSQL_DATABASE: app
+        ports:
+          - 3306/tcp
+        options: --health-cmd="mysqladmin ping" --health-interval=10s --health-timeout=5s --health-retries=3
+    strategy:
+      fail-fast: false
+      matrix:
+        php-versions: ['8.4', '8.5']
+        # The latest yiisoft/app release resolves Symfony 8.0 packages that require PHP 8.4+.
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      # Docs: https://github.com/shivammathur/setup-php
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ matrix.php-versions }}
+          extensions: fileinfo, intl, pdo_mysql
+          ini-values: date.timezone='UTC', register_argc_argv=On
+          coverage: none
+
+      - name: Get composer cache directory
+        id: composer-cache
+        run: echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT
+
+      - name: Cache composer dependencies
+        uses: actions/cache@v5
+        with:
+          path: ${{ steps.composer-cache.outputs.dir }}
+          # Use composer.json for key, if composer.lock is not committed.
+          # key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.json') }}
+          key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
+          restore-keys: ${{ runner.os }}-composer-
+
+      - name: Install Composer dependencies
+        run: composer install --no-progress --prefer-dist --optimize-autoloader
+
+      - name: Run migrations
+        run: php yii migrate:up --no-interaction
+        env:
+          DB_HOST: 127.0.0.1
+          DB_PORT: ${{ job.services.mysql.ports['3306'] }}
+          DB_NAME: app
+          DB_USERNAME: root
+          DB_PASSWORD: password
+
+      - name: Run codeception build
+        run: vendor/bin/codecept build
+
+      - name: Run tests with Codeception
+        run: vendor/bin/codecept run
+        env:
+          DB_HOST: 127.0.0.1
+          DB_PORT: ${{ job.services.mysql.ports['3306'] }}
+          DB_NAME: app
+          DB_USERNAME: root
+          DB_PASSWORD: password

examples/yii3-postgres.yml

@@ -0,0 +1,78 @@
+# GitHub Action for Yii3 web application with PostgreSQL
+# Tested with https://github.com/yiisoft/app
+name: Testing Yii3 with PostgreSQL
+on: [push, pull_request]
+jobs:
+  yii:
+    name: Yii3 (PHP ${{ matrix.php-versions }})
+    runs-on: ubuntu-latest
+    env:
+      APP_C3: true
+      APP_ENV: test
+      APP_DEBUG: false
+
+    # Docs: https://docs.github.com/en/actions/using-containerized-services
+    services:
+      postgres:
+        image: postgres:16
+        env:
+          POSTGRES_USER: postgres
+          POSTGRES_PASSWORD: postgres
+          POSTGRES_DB: app
+        ports:
+          - 5432/tcp
+        options: --health-cmd pg_isready --health-interval 10s --health-timeout 5s --health-retries 3
+    strategy:
+      fail-fast: false
+      matrix:
+        php-versions: ['8.4', '8.5']
+        # The latest yiisoft/app release resolves Symfony 8.0 packages that require PHP 8.4+.
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      # Docs: https://github.com/shivammathur/setup-php
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ matrix.php-versions }}
+          extensions: fileinfo, intl, pdo_pgsql
+          ini-values: date.timezone='UTC', register_argc_argv=On
+          coverage: none
+
+      - name: Get composer cache directory
+        id: composer-cache
+        run: echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT
+
+      - name: Cache composer dependencies
+        uses: actions/cache@v5
+        with:
+          path: ${{ steps.composer-cache.outputs.dir }}
+          # Use composer.json for key, if composer.lock is not committed.
+          # key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.json') }}
+          key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
+          restore-keys: ${{ runner.os }}-composer-
+
+      - name: Install Composer dependencies
+        run: composer install --no-progress --prefer-dist --optimize-autoloader
+
+      - name: Run migrations
+        run: php yii migrate:up --no-interaction
+        env:
+          DB_HOST: 127.0.0.1
+          DB_PORT: ${{ job.services.postgres.ports['5432'] }}
+          DB_NAME: app
+          DB_USERNAME: postgres
+          DB_PASSWORD: postgres
+
+      - name: Run codeception build
+        run: vendor/bin/codecept build
+
+      - name: Run tests with Codeception
+        run: vendor/bin/codecept run
+        env:
+          DB_HOST: 127.0.0.1
+          DB_PORT: ${{ job.services.postgres.ports['5432'] }}
+          DB_NAME: app
+          DB_USERNAME: postgres
+          DB_PASSWORD: postgres

examples/yii3.yml

@@ -0,0 +1,53 @@
+# GitHub Action for Yii3 web application
+# Tested with https://github.com/yiisoft/app
+name: Testing Yii3
+on: [push, pull_request]
+jobs:
+  yii:
+    name: Yii3 (PHP ${{ matrix.php-versions }} on ${{ matrix.operating-system }})
+    runs-on: ${{ matrix.operating-system }}
+    env:
+      APP_C3: true
+      APP_ENV: test
+      APP_DEBUG: false
+    strategy:
+      fail-fast: false
+      matrix:
+        operating-system: [ubuntu-latest, windows-latest]
+        php-versions: ['8.4', '8.5']
+        # The latest yiisoft/app release resolves Symfony 8.0 packages that require PHP 8.4+.
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      # Docs: https://github.com/shivammathur/setup-php
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ matrix.php-versions }}
+          extensions: fileinfo, intl
+          ini-values: date.timezone='UTC', register_argc_argv=On
+          coverage: none
+
+      - name: Get composer cache directory
+        id: composer-cache
+        shell: bash
+        run: echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT
+
+      - name: Cache composer dependencies
+        uses: actions/cache@v5
+        with:
+          path: ${{ steps.composer-cache.outputs.dir }}
+          # Use composer.json for key, if composer.lock is not committed.
+          # key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.json') }}
+          key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
+          restore-keys: ${{ runner.os }}-composer-
+
+      - name: Install Composer dependencies
+        run: composer install --no-progress --prefer-dist --optimize-autoloader
+
+      - name: Run codeception build
+        run: vendor/bin/codecept build
+
+      - name: Run tests with Codeception
+        run: vendor/bin/codecept run

examples/zend-framework.yml

@@ -1,34 +0,0 @@
-# GitHub Action for Zend Framework
-name: Testing Zend Framework
-on: [push, pull_request]
-jobs:
-  build:
-    strategy:
-      matrix:
-        operating-system: [ubuntu-latest, windows-latest, macOS-latest]
-        php-versions: ['7.2', '7.3']
-    runs-on: ${{ matrix.operating-system }}
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v1
-      - name: Setup PHP, with composer and extensions
-        uses: shivammathur/setup-php@v1 #https://github.com/shivammathur/setup-php
-        with:
-          php-version: ${{ matrix.php-versions }}
-          extension-csv: mbstring, bcmath, curl, intl
-          coverage: xdebug #optional
-      - name: Get composer cache directory
-        id: composer-cache
-        run: echo "::set-output name=dir::$(composer config cache-files-dir)"
-      - name: Cache composer dependencies
-        uses: actions/cache@v1
-        with:
-          path: ${{ steps.composer-cache.outputs.dir }}
-          key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
-          restore-keys: ${{ runner.os }}-composer-
-      - name: Install dependencies
-        run: |
-          composer install --no-progress --no-suggest --prefer-dist --optimize-autoloader
-          composer require --dev phpunit/phpunit squizlabs/php_codesniffer zendframework/zend-test
-      - name: Test with phpunit
-        run: vendor/bin/phpunit --coverage-text

jest.config.js

@@ -9,4 +9,4 @@ module.exports = {
   },
   verbose: true,
   collectCoverage: true
-};
+};

package.json

@@ -1,15 +1,25 @@
 {
   "name": "setup-php",
-  "version": "1.5.7",
+  "version": "2.37.2",
   "private": false,
   "description": "Setup PHP for use with GitHub Actions",
-  "main": "dist/index.js",
+  "main": "lib/install.js",
+  "types": "lib/install.d.ts",
+  "directories": {
+    "lib": "lib",
+    "test": "__tests__",
+    "src": "src"
+  },
+  "files": [
+    "lib",
+    "src"
+  ],
   "scripts": {
     "build": "tsc",
-    "lint": "eslint **/*.ts --cache",
-    "format": "prettier --write **/*.ts && git add .",
-    "format-check": "prettier --check **/*.ts",
-    "release": "ncc build src/install.ts -o dist && git add -f dist/",
+    "lint": "eslint **/src/*.ts **/__tests__/*.ts --cache --fix",
+    "format": "prettier --write **/src/*.ts **/__tests__/*.ts && git add -f __tests__/ ",
+    "format-check": "prettier --check **/src/*.ts **/__tests__/*.ts",
+    "release": "ncc build -m -o dist && git add -f dist/",
     "test": "jest"
   },
   "repository": {
@@ -24,32 +34,41 @@
   "author": "shivammathur",
   "license": "MIT",
   "dependencies": {
-    "@actions/core": "^1.2.0",
-    "@actions/exec": "^1.0.1",
-    "fs": "0.0.1-security"
+    "@actions/exec": "^2.0.0",
+    "compare-versions": "^6.1.1"
   },
   "devDependencies": {
-    "@types/jest": "^24.0.21",
-    "@types/node": "^12.12.0",
-    "@typescript-eslint/eslint-plugin": "^2.7.0",
-    "@typescript-eslint/parser": "^2.7.0",
-    "@zeit/ncc": "^0.20.5",
-    "eslint": "^6.6.0",
-    "eslint-config-prettier": "^6.5.0",
-    "eslint-plugin-import": "^2.18.2",
-    "eslint-plugin-jest": "^23.0.3",
-    "eslint-plugin-prettier": "^3.1.1",
-    "husky": "^3.0.9",
-    "jest": "^24.9.0",
-    "jest-circus": "^24.9.0",
-    "prettier": "^1.17.1",
-    "ts-jest": "^24.1.0",
-    "typescript": "^3.6.4"
+    "@eslint/compat": "^2.1.0",
+    "@eslint/js": "^10.0.1",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^25.9.2",
+    "@typescript-eslint/eslint-plugin": "^8.60.1",
+    "@typescript-eslint/parser": "^8.60.1",
+    "@vercel/ncc": "^0.38.4",
+    "eslint": "^10.4.1",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-import-resolver-typescript": "^4.4.5",
+    "eslint-plugin-import-x": "^4.16.2",
+    "eslint-plugin-jest": "^29.15.2",
+    "eslint-plugin-prettier": "^5.5.6",
+    "globals": "^17.6.0",
+    "jest": "^30.4.2",
+    "jest-circus": "^30.4.2",
+    "nock": "^14.0.15",
+    "prettier": "^3.8.3",
+    "simple-git-hooks": "^2.13.1",
+    "ts-jest": "^29.4.11",
+    "typescript": "^5.9.3"
   },
-  "husky": {
-    "skipCI": true,
-    "hooks": {
-      "pre-commit": "npm run build && npm run format && npm run release"
-    }
+  "overrides": {
+    "test-exclude": "^7.0.1",
+    "glob": "^13.0.6",
+    "minimatch": "^10.2.1"
+  },
+  "bugs": {
+    "url": "https://github.com/shivammathur/setup-php/issues"
+  },
+  "simple-git-hooks": {
+    "pre-commit": "npm run format && npm run lint && npm run test && npm run build && npm run release"
   }
 }

src/config.ts

@@ -8,13 +8,18 @@ import * as utils from './utils';
 export async function addINIValuesUnix(
   ini_values_csv: string
 ): Promise<string> {
-  const ini_values: Array<string> = await utils.INIArray(ini_values_csv);
-  let script = '\n';
-  await utils.asyncForEach(ini_values, async function(line: string) {
+  const ini_values: Array<string> = await utils.CSVArray(ini_values_csv);
+  let script = '';
+  await utils.asyncForEach(ini_values, async function (line: string) {
     script +=
-      (await utils.addLog('$tick', line, 'Added to php.ini', 'linux')) + '\n';
+      '\n' + (await utils.addLog('$tick', line, 'Added to php.ini', 'linux'));
   });
-  return 'echo "' + ini_values.join('\n') + '" >> $ini_file' + script;
+  return (
+    'echo "' +
+    ini_values.map(v => utils.escapeForShell(v, 'linux')).join('\n') +
+    '" | sudo tee -a "${pecl_file:-${ini_file[@]}}" >/dev/null 2>&1' +
+    script
+  );
 }
 
 /**
@@ -25,15 +30,15 @@ export async function addINIValuesUnix(
 export async function addINIValuesWindows(
   ini_values_csv: string
 ): Promise<string> {
-  const ini_values: Array<string> = await utils.INIArray(ini_values_csv);
+  const ini_values: Array<string> = await utils.CSVArray(ini_values_csv);
   let script = '\n';
-  await utils.asyncForEach(ini_values, async function(line: string) {
+  await utils.asyncForEach(ini_values, async function (line: string) {
     script +=
       (await utils.addLog('$tick', line, 'Added to php.ini', 'win32')) + '\n';
   });
   return (
-    'Add-Content C:\\tools\\php\\php.ini "' +
-    ini_values.join('\n') +
+    'Add-Content "$php_dir\\php.ini" "' +
+    ini_values.map(v => utils.escapeForShell(v, 'win32')).join('\n') +
     '"' +
     script
   );
@@ -43,27 +48,28 @@ export async function addINIValuesWindows(
  * Function to add custom ini values
  *
  * @param ini_values_csv
- * @param os_version
+ * @param os
+ * @param no_step
  */
 export async function addINIValues(
   ini_values_csv: string,
-  os_version: string,
+  os: string,
   no_step = false
 ): Promise<string> {
   let script = '\n';
   switch (no_step) {
     case true:
       script +=
-        (await utils.stepLog('Add php.ini values', os_version)) +
-        (await utils.suppressOutput(os_version)) +
+        (await utils.stepLog('Add php.ini values', os)) +
+        (await utils.suppressOutput(os)) +
         '\n';
       break;
     case false:
     default:
-      script += (await utils.stepLog('Add php.ini values', os_version)) + '\n';
+      script += (await utils.stepLog('Add php.ini values', os)) + '\n';
       break;
   }
-  switch (os_version) {
+  switch (os) {
     case 'win32':
       return script + (await addINIValuesWindows(ini_values_csv));
     case 'darwin':
@@ -71,8 +77,8 @@ export async function addINIValues(
       return script + (await addINIValuesUnix(ini_values_csv));
     default:
       return await utils.log(
-        'Platform ' + os_version + ' is not supported',
-        os_version,
+        'Platform ' + os + ' is not supported',
+        os,
         'error'
       );
   }

src/configs/brew_extensions

@@ -0,0 +1,65 @@
+amqp=amqp
+apcu=apcu
+ast=ast
+brotli=brotli
+couchbase=couchbase
+ds=ds
+event=event
+excimer=excimer
+expect=expect
+gearman=gearman
+gmagick=gmagick
+gnupg=gnupg
+grpc=grpc
+igbinary=igbinary
+imagick=imagick
+imap=imap
+interbase=interbase
+lua=lua
+mailparse=mailparse
+maxminddb=maxminddb
+mcrypt=mcrypt
+memcache=memcache
+memcached=memcached
+mongodb=mongodb
+mongodb1=mongodb1
+msgpack=msgpack
+newrelic=newrelic
+oauth=oauth
+opentelemetry=opentelemetry
+pcov=pcov
+pdo_firebird=pdo_firebird
+pdo_sqlsrv=pdo_sqlsrv
+pecl_http=http
+phalcon3=phalcon
+phalcon4=phalcon
+phalcon5=phalcon
+pinba=pinba
+propro=propro
+protobuf=protobuf
+psr=psr
+raphf=raphf
+rdkafka=rdkafka
+phpredis=redis
+redis=redis
+seaslog=seaslog
+scalar_objects=scalar_objects
+snmp=snmp
+sqlsrv=sqlsrv
+spx=spx
+ssh2=ssh2
+swoole=swoole
+swow=swow
+uopz=uopz
+uploadprogress=uploadprogress
+uuid=uuid
+v8js=v8js
+vips=vips
+vld=vld
+xdebug=xdebug
+xdebug2=xdebug
+xhprof=xhprof
+xlswriter=xlswriter
+yaml=yaml
+zmq=zmq
+zstd=zstd

src/configs/composer-gh-auth-no-op

@@ -0,0 +1,3 @@
+1.0.0-0 1.10.28
+2.0.0-0 2.2.28
+2.3.0-0 2.9.8

src/configs/composer-gh-auth-warn

@@ -0,0 +1 @@
+Composer %s has a known GitHub token parsing bug that exposes GitHub tokens in the error output. So, GitHub authentication has not been configured for this Composer version. Please update to the latest version of Composer. See: https://github.com/composer/composer/security/advisories/GHSA-f9f8-rm49-7jv2

src/configs/composer.env

@@ -0,0 +1,3 @@
+COMPOSER_PROCESS_TIMEOUT=0
+COMPOSER_NO_INTERACTION=1
+COMPOSER_NO_AUDIT=1

src/configs/config.yaml

@@ -1,58 +0,0 @@
-variants:
-  dev:
-    bcmath:
-    calendar:
-    cli:
-    ctype:
-    dom:
-    fileinfo:
-    filter:
-    ipc:
-    iconv:
-    json:
-    mbregex:
-    mbstring:
-    mhash:
-    mcrypt:
-    pcntl:
-    pcre:
-    pdo:
-    phar:
-    posix:
-    sockets:
-    tokenizer:
-    xml:
-    curl:
-    openssl:
-    zip:
-    gd:
-      - --with-freetype
-      - --with-pdo-mysql=mysqlnd
-      - --with-mysqli=mysqlnd
-      - --with-pgsql
-      - --with-pdo-pgsql
-      - --with-gmp=/usr/local/opt/gmp
-      - --with-openssl
-      - --with-pear
-      - --with-zip
-      - --with-libxml
-      - --with-kerberos
-      - --with-gd
-      - --with-ffi
-      - --with-curl
-      - --with-mhash
-      - --with-readline=/usr/local/opt/readline
-      - --with-iconv=/usr/local/opt/libiconv
-      - --with-icu-dir=/usr/local/opt/icu4c
-      - --with-config-file-path=/etc
-      - --enable-intl
-      - --enable-xml
-      - --enable-sysvsem
-      - --enable-sysvshm
-      - --enable-sysvmsg
-      - --enable-phpdbg
-      - --enable-exif
-      - --enable-gd
-      - --enable-soap
-      - --enable-xmlreader
-      - --enable-zend-test=shared

src/configs/darwin_libs

@@ -0,0 +1,22 @@
+amqp=rabbitmq-c
+decimal=mpdecimal
+ev=libev
+event=libevent
+geoip=geoip
+gmagick=graphicsmagick
+gnupg=gpgme
+grpc=grpc protobuf
+imagick=imagemagick
+memcached=libmemcached libevent
+protobuf=protobuf
+rdkafka=librdkafka
+snappy=snappy
+sodium=libsodium
+ssh2=libssh2
+uv=libuv
+uuid=util-linux
+vips=vips
+yaz=yaz
+yaml=libyaml
+zstd=zstd
+zmq=zeromq

src/configs/ini/jit.ini

@@ -0,0 +1,3 @@
+opcache.enable=1
+opcache.jit_buffer_size=256M
+opcache.jit=1235

src/configs/ini/jit_aarch64.ini

@@ -0,0 +1,3 @@
+opcache.enable=1
+opcache.jit_buffer_size=128M
+opcache.jit=1235

src/configs/ini/php.ini

@@ -0,0 +1,2 @@
+date.timezone=UTC
+memory_limit=-1

src/configs/ini/xdebug.ini

@@ -0,0 +1 @@
+xdebug.mode=coverage

src/configs/linux_libs

@@ -0,0 +1,22 @@
+amqp=librabbitmq-dev
+decimal=libmpdec-dev
+ev=libev-dev
+event=libevent-dev
+geoip=libgeoip-dev
+gmagick=graphicsmagick-libmagick-dev-compat
+gnupg=libgpgme-dev
+grpc=libgrpc-dev libprotobuf-dev protobuf-compiler
+imagick=libmagickwand-dev libmagickcore-dev
+memcached=libmemcached-dev libevent-dev
+protobuf=libprotobuf-dev protobuf-compiler
+rdkafka=librdkafka-dev
+snappy=libsnappy-dev
+sodium=libsodium-dev
+ssh2=libssh2-1-dev
+uv=libuv1-dev
+uuid=uuid-dev
+vips=libvips-dev
+yaz=libyaz-dev
+yaml=libyaml-dev
+zstd=libzstd-dev
+zmq=libzmq3-dev

src/configs/mod_priority

@@ -0,0 +1,31 @@
+apc=25
+apcu_bc=25
+apcu-bc=25
+blackfire=30
+couchbase=30
+decimal=30
+ds=30
+event=30
+ev=30
+grpc=30
+http=25
+pecl_http=25
+pecl-http=25
+inotify=30
+libvirt-php=40
+mailparse=25
+maxminddb=30
+memcached=25
+mysqlnd=10
+mysqlnd_ms=30
+opcache=10
+openswoole=25
+pdo=10
+phalcon=35
+protobuf=30
+psr=15
+rdkafka=30
+swoole=25
+vips=30
+xml=15
+zstd=30

src/configs/os_releases.csv

@@ -0,0 +1,27 @@
+8,jessie
+9,stretch
+10,buster
+11,bullseye
+12,bookworm
+13,trixie
+16.04 LTS,xenial
+16.10,yakkety
+17.04,zesty
+17.10,artful
+18.04 LTS,bionic
+18.10,cosmic
+19.04,disco
+19.10,eoan
+20.04 LTS,focal
+20.10,groovy
+21.04,hirsute
+21.10,impish
+22.04,jammy
+23.04,lunar
+23.10,mantic
+24.04,noble
+24.10,oracular
+25.05,plucky
+25.10,questing
+26.04,resolute
+26.10,stonking

src/configs/php-versions.json

@@ -0,0 +1,10 @@
+{
+  "lowest": "8.1",
+  "highest": "8.5",
+  "latest": "8.5",
+  "nightly": "8.6",
+  "master": "8.6",
+  "5.x": "5.6",
+  "7.x": "7.4",
+  "8.x": "8.5"
+}

src/configs/php_debug_packages

@@ -0,0 +1,11 @@
+cgi
+cli
+curl
+fpm
+intl
+mbstring
+mysql
+opcache
+pgsql
+xml
+zip

src/configs/php_packages

@@ -0,0 +1,12 @@
+cgi
+cli
+curl
+dev
+fpm
+intl
+mbstring
+mysql
+opcache
+pgsql
+xml
+zip

src/configs/pm/php.json

@@ -0,0 +1,29 @@
+{
+  "problemMatcher": [
+    {
+      "owner": "php_native_error",
+      "severity": "error",
+      "pattern": [
+        {
+          "regexp": "^(.*error):\\s+\\s+(.+) in (.+) on line (\\d+)$",
+          "code": 1,
+          "message": 2,
+          "file": 3,
+          "line": 4
+        }
+      ]
+    }, {
+      "owner": "php_native_warning",
+      "severity": "warning",
+      "pattern": [
+        {
+          "regexp": "^(.*Warning|.*Deprecated|.*Notice):\\s+\\s+(.+) in (.+) on line (\\d+)$",
+          "code": 1,
+          "message": 2,
+          "file": 3,
+          "line": 4
+        }
+      ]
+    }
+  ]
+}

src/configs/pm/phpunit.json

@@ -0,0 +1,24 @@
+{
+  "problemMatcher": [
+    {
+      "owner": "phpunit",
+      "pattern": [
+        {
+          "regexp": "^\\d+\\)\\s.*$"
+        },
+        {
+          "regexp": "^(.*Failed\\sasserting\\sthat.*)$",
+          "message": 1
+        },
+        {
+          "regexp": "^\\s*$"
+        },
+        {
+          "regexp": "^(.*):(\\d+)$",
+          "file": 1,
+          "line": 2
+        }
+      ]
+    }
+  ]
+}

src/configs/tools.json

@@ -0,0 +1,358 @@
+{
+  "backward-compatibility-check": {
+    "type": "composer",
+    "repository": "roave/backward-compatibility-check",
+    "scope": "scoped"
+  },
+  "box": {
+    "type": "phar",
+    "repository": "box-project/box",
+    "packagist": "humbug/box",
+    "extension": ".phar",
+    "domain": "https://github.com",
+    "version_prefix": "",
+    "version_parameter": "--version"
+  },
+  "churn": {
+    "type": "phar",
+    "repository": "bmitch/churn-php",
+    "extension": ".phar",
+    "domain": "https://github.com",
+    "version_prefix": "",
+    "version_parameter": "-V"
+  },
+  "composer-dependency-analyser": {
+    "type": "composer",
+    "repository": "shipmonk/composer-dependency-analyser",
+    "scope": "scoped"
+  },
+  "composer-unused": {
+    "type": "phar",
+    "repository": "composer-unused/composer-unused",
+    "extension": ".phar",
+    "domain": "https://github.com",
+    "version_prefix": "",
+    "version_parameter": "-V"
+  },
+  "composer-normalize": {
+    "type": "phar",
+    "repository": "ergebnis/composer-normalize",
+    "extension": ".phar",
+    "domain": "https://github.com",
+    "version_prefix": "",
+    "version_parameter": "diagnose"
+  },
+  "cs2pr": {
+    "type": "phar",
+    "repository": "staabm/annotate-pull-request-from-checkstyle",
+    "extension": "",
+    "domain": "https://github.com",
+    "version_prefix": "",
+    "version_parameter": "-V"
+  },
+  "easy-coding-standard": {
+    "type": "composer",
+    "alias": "ecs",
+    "repository": "symplify/easy-coding-standard",
+    "scope": "scoped"
+  },
+  "infection": {
+    "type": "phar",
+    "repository": "infection/infection",
+    "extension": ".phar",
+    "domain": "https://github.com",
+    "version_prefix": "",
+    "version_parameter": "-V"
+  },
+  "name-collision-detector": {
+    "type": "composer",
+    "repository": "shipmonk/name-collision-detector",
+    "scope": "scoped"
+  },
+  "phan": {
+    "type": "phar",
+    "repository": "phan/phan",
+    "extension": ".phar",
+    "domain": "https://github.com",
+    "version_prefix": "",
+    "version_parameter": "-v"
+  },
+  "parallel-lint": {
+    "type": "phar",
+    "repository": "php-parallel-lint/PHP-Parallel-Lint",
+    "extension": ".phar",
+    "domain": "https://github.com",
+    "version_prefix": "v",
+    "version_parameter": "--version"
+  },
+  "php-cs-fixer": {
+    "type": "phar",
+    "repository": "PHP-CS-Fixer/PHP-CS-Fixer",
+    "extension": ".phar",
+    "domain": "https://github.com",
+    "fetch_latest": "true",
+    "version_prefix": "v",
+    "version_parameter": "-V"
+  },
+  "php-scoper": {
+    "type": "phar",
+    "repository": "humbug/php-scoper",
+    "packagist": "humbug/php-scoper",
+    "extension": ".phar",
+    "domain": "https://github.com",
+    "version_prefix": "",
+    "version_parameter": "--version"
+  },
+  "phpcbf": {
+    "type": "phar",
+    "repository": "PHPCSStandards/PHP_CodeSniffer",
+    "extension": ".phar",
+    "domain": "https://github.com",
+    "version_prefix": "",
+    "version_parameter": "--version"
+  },
+  "phpcs": {
+    "type": "phar",
+    "repository": "PHPCSStandards/PHP_CodeSniffer",
+    "extension": ".phar",
+    "domain": "https://github.com",
+    "version_prefix": "",
+    "version_parameter": "--version"
+  },
+  "phpDocumentor": {
+    "type": "phar",
+    "repository": "phpDocumentor/phpDocumentor",
+    "extension": ".phar",
+    "domain": "https://github.com",
+    "alias": "phpdoc",
+    "version_prefix": "v",
+    "version_parameter": "--version"
+  },
+  "phpmd": {
+    "type": "phar",
+    "repository": "phpmd/phpmd",
+    "extension": ".phar",
+    "domain": "https://github.com",
+    "version_prefix": "",
+    "version_parameter": "--version"
+  },
+  "phpspec": {
+    "type": "phar",
+    "repository": "phpspec/phpspec",
+    "extension": ".phar",
+    "domain": "https://github.com",
+    "version_prefix": "",
+    "version_parameter": "-V"
+  },
+  "phpstan": {
+    "type": "phar",
+    "repository": "phpstan/phpstan",
+    "extension": ".phar",
+    "domain": "https://github.com",
+    "version_prefix": "",
+    "version_parameter": "-V"
+  },
+  "pie": {
+    "type": "phar",
+    "repository": "php/pie",
+    "extension": ".phar",
+    "domain": "https://github.com",
+    "version_prefix": "",
+    "version_parameter": "-V"
+  },
+  "pint": {
+    "type": "phar",
+    "repository": "laravel/pint",
+    "extension": ".phar",
+    "domain": "https://github.com",
+    "version_prefix": "v",
+    "version_parameter": "-V"
+  },
+  "psalm": {
+    "type": "phar",
+    "repository": "vimeo/psalm",
+    "extension": ".phar",
+    "domain": "https://github.com",
+    "version_prefix": "",
+    "version_parameter": "-v"
+  },
+  "behat": {
+    "type": "composer",
+    "repository": "behat/behat",
+    "scope": "scoped"
+  },
+  "codeception": {
+    "type": "composer",
+    "repository": "codeception/codeception",
+    "scope": "scoped"
+  },
+  "automatic-composer-prefetcher": {
+    "type": "composer",
+    "alias": "composer-prefetcher",
+    "repository": "narrowspark/automatic-composer-prefetcher",
+    "scope": "global"
+  },
+  "composer-require-checker": {
+    "type": "composer",
+    "repository": "maglnet/composer-require-checker",
+    "scope": "scoped"
+  },
+  "flex": {
+    "type": "composer",
+    "repository": "symfony/flex",
+    "scope": "global"
+  },
+  "phinx": {
+    "type": "composer",
+    "repository": "robmorgan/phinx",
+    "scope": "scoped"
+  },
+  "phplint": {
+    "type": "composer",
+    "repository": "overtrue/phplint",
+    "scope": "scoped"
+  },
+  "phpunit-bridge": {
+    "alias": "simple-phpunit",
+    "type": "composer",
+    "repository": "symfony/phpunit-bridge",
+    "scope": "global"
+  },
+  "phpunit-polyfills": {
+    "type": "composer",
+    "repository": "yoast/phpunit-polyfills",
+    "scope": "global"
+  },
+  "prestissimo": {
+    "type": "composer",
+    "repository": "hirak/prestissimo",
+    "scope": "global"
+  },
+  "vapor-cli": {
+    "type": "composer",
+    "alias": "vapor",
+    "repository": "laravel/vapor-cli",
+    "scope": "scoped"
+  },
+  "rector": {
+    "type": "composer",
+    "repository": "rector/rector",
+    "scope": "scoped"
+  },
+  "blackfire": {
+    "type": "custom-package",
+    "alias": "blackfire-agent"
+  },
+  "grpc_php_plugin": {
+    "type": "custom-package",
+    "repository": "grpc/grpc",
+    "domain": "https://github.com",
+    "version_prefix": "v"
+  },
+  "mago": {
+    "type": "custom-package",
+    "repository": "carthage-software/mago",
+    "domain": "https://github.com",
+    "version_prefix": ""
+  },
+  "protoc": {
+    "type": "custom-package",
+    "repository": "protocolbuffers/protobuf",
+    "domain": "https://github.com",
+    "version_prefix": "v"
+  },
+  "symfony-cli": {
+    "alias": "symfony",
+    "type": "custom-package",
+    "repository": "symfony-cli/symfony-cli",
+    "domain": "https://github.com",
+    "version_prefix": "v",
+    "version_parameter": "-V"
+  },
+  "blackfire-player": {
+    "type": "custom-function",
+    "domain": "https://get.blackfire.io",
+    "function": "blackfire_player",
+    "version_prefix": "v",
+    "version_parameter": "-V"
+  },
+  "castor": {
+    "type": "custom-function",
+    "domain": "https://github.com",
+    "repository": "jolicode/castor",
+    "function": "castor",
+    "version_prefix": "v",
+    "version_parameter": "-V"
+  },
+  "composer": {
+    "type": "custom-function",
+    "domain": "https://getcomposer.org",
+    "repository": "composer/composer",
+    "function": "composer"
+  },
+  "deployer": {
+    "type": "custom-function",
+    "domain": "https://deployer.org",
+    "repository": "deployphp/deployer",
+    "function": "deployer",
+    "version_prefix": "v",
+    "version_parameter": "-V"
+  },
+  "pecl": {
+    "type": "custom-function",
+    "function": "pecl"
+  },
+  "phing": {
+    "type": "custom-function",
+    "domain": "https://www.phing.info",
+    "repository": "phingofficial/phing",
+    "function": "phing",
+    "extension": ".phar",
+    "version_prefix": "",
+    "version_parameter": "-v"
+  },
+  "phive": {
+    "type": "custom-function",
+    "repository": "phar-io/phive",
+    "domain": "https://github.com",
+    "function": "phive",
+    "version_prefix": "",
+    "version_parameter": "status"
+  },
+  "phpcpd": {
+    "type": "custom-function",
+    "repository": "sebastianbergmann/phpcpd",
+    "domain": "https://phar.phpunit.de",
+    "function": "phpcpd",
+    "version_prefix": "",
+    "version_parameter": "--version"
+  },
+  "phpunit": {
+    "type": "custom-function",
+    "repository": "sebastianbergmann/phpunit",
+    "packagist": "phpunit/phpunit",
+    "domain": "https://phar.phpunit.de",
+    "function": "phpunit",
+    "version_prefix": "",
+    "version_parameter": "--version"
+  },
+  "phpize": {
+    "type": "custom-function",
+    "function": "dev_tools",
+    "alias": "php-config"
+  },
+  "php-config": {
+    "type": "custom-function",
+    "function": "dev_tools"
+  },
+  "wp-cli": {
+    "type": "custom-function",
+    "function": "wp_cli",
+    "repository": "wp-cli/wp-cli",
+    "domain": "https://github.com",
+    "alias": "wp",
+    "extension": ".phar",
+    "version_parameter": "--version",
+    "version_prefix": "v"
+  }
+}

src/configs/tools_schema.json

@@ -0,0 +1,136 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://raw.githubusercontent.com/shivammathur/setup-php/develop/src/configs/tools_schema.json",
+  "type": "object",
+  "title": "Tools",
+  "default": {},
+  "examples": [
+    {
+      "tool": {
+        "alias": "tool_alias",
+        "domain": "https://example.com",
+        "extension": ".ext",
+        "fetch_latest": "true",
+        "function": "function_name",
+        "repository": "user/tool",
+        "packagist": "user/tool",
+        "scope": "global, scoped",
+        "type": "phar, composer, custom-package or custom-function",
+        "version_parameter": "--version",
+        "version_prefix": "v"
+      }
+    }
+  ],
+  "items": {
+    "properties": {
+      "alias": {
+        "$id": "#/items/properties/alias",
+        "type": "string",
+        "title": "The alias schema",
+        "description": "Alias for a tool.",
+        "examples": [
+          "tool_alias"
+        ]
+      },
+      "domain": {
+        "$id": "#/items/properties/domain",
+        "type": "string",
+        "title": "The domain schema",
+        "description": "Domain URL of the tool.",
+        "examples": [
+          "https://example.com"
+        ]
+      },
+      "extension": {
+        "$id": "#/items/properties/extension",
+        "type": "string",
+        "title": "The extension schema",
+        "description": "File extension of the tool.",
+        "examples": [
+          ".ext"
+        ]
+      },
+      "fetch_latest": {
+        "$id": "#/items/properties/fetch_latest",
+        "type": "string",
+        "title": "The fetch_latest schema",
+        "description": "Fetch the latest version from GitHub releases.",
+        "enum": [
+          "true",
+          "false"
+        ]
+      },
+      "function": {
+        "$id": "#/items/properties/function",
+        "type": "string",
+        "title": "The function schema",
+        "description": "Function name in tools.ts which returns the script to setup the tool.",
+        "examples": [
+          "function_name"
+        ]
+      },
+      "repository": {
+        "$id": "#/items/properties/repository",
+        "type": "string",
+        "title": "The repository schema",
+        "description": "GitHub repository of the tool.",
+        "examples": [
+          "user/tool"
+        ]
+      },
+      "packagist": {
+        "$id": "#/items/properties/packagist",
+        "type": "string",
+        "title": "The repository schema",
+        "description": "Packagist repository of the tool in case different from repository.",
+        "examples": [
+          "user/tool"
+        ]
+      },
+      "scope": {
+        "$id": "#/items/properties/scope",
+        "type": "string",
+        "title": "The scope schema",
+        "description": "Scope of tool installation: global or scoped",
+        "enum": [
+          "global",
+          "scoped"
+        ]
+      },
+      "type": {
+        "$id": "#/items/properties/type",
+        "type": "string",
+        "title": "The type schema",
+        "description": "Type of tool: phar, composer, custom-package or custom-function.",
+        "enum": [
+          "phar",
+          "composer",
+          "custom-package",
+          "custom-function"
+        ]
+      },
+      "version_parameter": {
+        "$id": "#/items/properties/version_parameter",
+        "type": "string",
+        "title": "The version_parameter schema",
+        "description": "Parameter to get the tool version.",
+        "examples": [
+          "--version"
+        ]
+      },
+      "version_prefix": {
+        "$id": "#/items/properties/version_prefix",
+        "type": "string",
+        "title": "The version_prefix schema",
+        "description": "Prefix of the version in the download URL.",
+        "examples": [
+          "v"
+        ]
+      }
+    },
+    "required": [
+      "type"
+    ],
+    "additionalProperties": true
+  }
+}

src/configs/windows_extensions

@@ -0,0 +1,2 @@
+xdebug
+pcov

src/core.ts

@@ -0,0 +1,112 @@
+import {EOL} from 'os';
+
+/**
+ * Commands
+ *
+ * Command Format:
+ *   ::name key=value,key=value::message
+ *
+ * @see https://docs.github.com/en/actions/using-workflows/workflow-commands-for-github-actions
+ */
+
+interface CommandProperties {
+  [key: string]: string;
+}
+
+/**
+ * Sanitizes the message for use in a workflow command.
+ * @param message
+ */
+function toCommandValue(message: string | Error): string {
+  if (message instanceof Error) {
+    return message.toString();
+  }
+  return message;
+}
+
+/**
+ * Escapes data for safe use in workflow command messages.
+ * @param s
+ */
+function escapeData(s: string | Error): string {
+  return toCommandValue(s)
+    .replace(/%/g, '%25')
+    .replace(/\r/g, '%0D')
+    .replace(/\n/g, '%0A');
+}
+
+/**
+ * Escapes property values for safe use in workflow command properties.
+ * @param s
+ */
+function escapeProperty(s: string): string {
+  return s
+    .replace(/%/g, '%25')
+    .replace(/\r/g, '%0D')
+    .replace(/\n/g, '%0A')
+    .replace(/:/g, '%3A')
+    .replace(/,/g, '%2C');
+}
+
+/**
+ * Issues a command to the GitHub Actions runner.
+ *
+ * @param command - The command name to issue
+ * @param properties - Additional properties for the command (key-value pairs)
+ * @param message - The message to include with the command
+ */
+export function issueCommand(
+  command: string,
+  properties: CommandProperties,
+  message: string | Error
+): void {
+  let cmdStr = `::${command}`;
+
+  if (properties && Object.keys(properties).length > 0) {
+    cmdStr += ' ';
+    const props = Object.entries(properties)
+      .filter(([, val]) => val)
+      .map(([key, val]) => `${key}=${escapeProperty(val)}`)
+      .join(',');
+    cmdStr += props;
+  }
+
+  cmdStr += `::${escapeData(message)}`;
+  process.stdout.write(cmdStr + EOL);
+}
+
+/**
+ * Adds an error issue.
+ * @param message - error issue message
+ */
+export function error(message: string | Error): void {
+  issueCommand('error', {}, message);
+}
+
+/**
+ * Sets the action status to failed.
+ * When the action exits it will be with an exit code of 1.
+ * @param message - add error issue message
+ */
+export function setFailed(message: string | Error): void {
+  process.exitCode = 1;
+  error(message);
+}
+
+/**
+ * Gets the value of an input.
+ * The value is trimmed.
+ * Returns an empty string if the value is not defined.
+ *
+ * @param name - name of the input to get
+ * @param required - whether the input is required
+ * @returns string
+ */
+export function getInput(name: string, required = false): string {
+  const val: string =
+    process.env[`INPUT_${name.replace(/ /g, '_').toUpperCase()}`] || '';
+  if (required && !val) {
+    throw new Error(`Input required and not supplied: ${name}`);
+  }
+  return val.trim();
+}

src/coverage.ts

@@ -2,85 +2,92 @@ import * as utils from './utils';
 import * as extensions from './extensions';
 import * as config from './config';
 
-/**
- * Function to setup Xdebug
- *
- * @param version
- * @param os_version
- */
-export async function addCoverageXdebug(
-  version: string,
-  os_version: string
+export async function checkXdebugError(
+  extension: string,
+  version: string
 ): Promise<string> {
-  return (
-    (await extensions.addExtension('xdebug', version, os_version, true)) +
-    (await utils.suppressOutput(os_version)) +
-    '\n' +
-    (await utils.addLog(
-      '$tick',
-      'xdebug',
-      'Xdebug enabled as coverage driver',
-      os_version
-    ))
-  );
+  if (
+    (/^5\.[3-6]$|^7\.[0-1]$/.test(version) && extension == 'xdebug3') ||
+    (/^8\.[0-9]$/.test(version) && extension == 'xdebug2')
+  ) {
+    return extension + ' is not supported on PHP ' + version;
+  }
+  return '';
 }
 
 /**
- * Function to setup PCOV
+ * Function to set up Xdebug
+ *
+ * @param extension
+ * @param version
+ * @param os
+ * @param pipe
+ */
+export async function addCoverageXdebug(
+  extension: string,
+  version: string,
+  os: string,
+  pipe: string
+): Promise<string> {
+  let script = '\n';
+  const error: string = await checkXdebugError(extension, version);
+  if (!error) {
+    script +=
+      (await extensions.addExtension(':pcov:false', version, os, true)) + pipe;
+    extension = extension == 'xdebug3' ? 'xdebug' : extension;
+    script +=
+      (await extensions.addExtension(extension, version, os, true)) + pipe;
+    script += await utils.setVariable(
+      'xdebug_version',
+      'php -r "echo phpversion(\'xdebug\');"',
+      os
+    );
+    script +=
+      (await utils.getCommand(os, 'extension_log')) +
+      'xdebug "Xdebug $xdebug_version enabled as coverage driver"';
+  } else {
+    script += await utils.addLog('$cross', extension, error, os);
+  }
+  return script;
+}
+
+/**
+ * Function to set up PCOV
  *
  * @param version
- * @param os_version
+ * @param os
+ * @param pipe
  */
 export async function addCoveragePCOV(
   version: string,
-  os_version: string
+  os: string,
+  pipe: string
 ): Promise<string> {
   let script = '\n';
-  switch (version) {
+  switch (true) {
     default:
       script +=
-        (await extensions.addExtension('pcov', version, os_version, true)) +
-        (await utils.suppressOutput(os_version)) +
-        '\n';
+        (await extensions.addExtension(':xdebug:false', version, os, true)) +
+        pipe;
       script +=
-        (await config.addINIValues('pcov.enabled=1', os_version, true)) + '\n';
-
-      // add command to disable xdebug and enable pcov
-      switch (os_version) {
-        case 'linux':
-          script +=
-            'if [ -e /etc/php/' +
-            version +
-            '/mods-available/xdebug.ini ]; then sudo phpdismod -v ' +
-            version +
-            ' xdebug; fi\n';
-          script += 'sudo sed -i "/xdebug/d" $ini_file\n';
-          break;
-        case 'darwin':
-          script += 'sudo sed -i \'\' "/xdebug/d" $ini_file\n';
-          break;
-        case 'win32':
-          script +=
-            'if(php -m | findstr -i xdebug) { Disable-PhpExtension xdebug C:\\tools\\php }\n';
-          break;
-      }
-
-      // success
-      script += await utils.addLog(
-        '$tick',
-        'coverage: pcov',
-        'PCOV enabled as coverage driver',
-        os_version
+        (await extensions.addExtension('pcov', version, os, true)) + pipe;
+      script += (await config.addINIValues('pcov.enabled=1', os, true)) + '\n';
+      script += await utils.setVariable(
+        'pcov_version',
+        'php -r "echo phpversion(\'pcov\');"',
+        os
       );
-      // version is not supported
+      script +=
+        (await utils.getCommand(os, 'extension_log')) +
+        'pcov "PCOV $pcov_version enabled as coverage driver"';
       break;
-    case '5.6':
-    case '7.0':
+
+    case /5\.[3-6]|7\.0/.test(version):
       script += await utils.addLog(
         '$cross',
         'pcov',
         'PHP 7.1 or newer is required',
-        os_version
+        os
       );
       break;
   }
@@ -92,47 +99,20 @@ export async function addCoveragePCOV(
  * Function to disable Xdebug and PCOV
  *
  * @param version
- * @param os_version
+ * @param os
+ * @param pipe
  */
 export async function disableCoverage(
   version: string,
-  os_version: string
+  os: string,
+  pipe: string
 ): Promise<string> {
   let script = '\n';
-  switch (os_version) {
-    case 'linux':
-      script +=
-        'if [ -e /etc/php/' +
-        version +
-        '/mods-available/xdebug.ini ]; then sudo phpdismod -v ' +
-        version +
-        ' xdebug; fi\n';
-      script +=
-        'if [ -e /etc/php/' +
-        version +
-        '/mods-available/pcov.ini ]; then sudo phpdismod -v ' +
-        version +
-        ' pcov; fi\n';
-      script += 'sudo sed -i "/xdebug/d" $ini_file\n';
-      script += 'sudo sed -i "/pcov/d" $ini_file\n';
-      break;
-    case 'darwin':
-      script += 'sudo sed -i \'\' "/xdebug/d" $ini_file\n';
-      script += 'sudo sed -i \'\' "/pcov/d" $ini_file\n';
-      break;
-    case 'win32':
-      script +=
-        'if(php -m | findstr -i xdebug) { Disable-PhpExtension xdebug C:\\tools\\php }\n';
-      script +=
-        'if(php -m | findstr -i pcov) { Disable-PhpExtension pcov C:\\tools\\php }\n';
-      break;
-  }
-  script += await utils.addLog(
-    '$tick',
-    'none',
-    'Disabled Xdebug and PCOV',
-    os_version
-  );
+  script +=
+    (await extensions.addExtension(':pcov:false', version, os, true)) + pipe;
+  script +=
+    (await extensions.addExtension(':xdebug:false', version, os, true)) + pipe;
+  script += await utils.addLog('$tick', 'none', 'Disabled Xdebug and PCOV', os);
 
   return script;
 }
@@ -142,23 +122,27 @@ export async function disableCoverage(
  *
  * @param coverage_driver
  * @param version
- * @param os_version
+ * @param os
  */
 export async function addCoverage(
   coverage_driver: string,
   version: string,
-  os_version: string
+  os: string
 ): Promise<string> {
-  coverage_driver.toLowerCase();
-  const script: string =
-    '\n' + (await utils.stepLog('Setup Coverage', os_version));
+  coverage_driver = coverage_driver.toLowerCase();
+  const script: string = '\n' + (await utils.stepLog('Setup Coverage', os));
+  const pipe: string = (await utils.suppressOutput(os)) + '\n';
   switch (coverage_driver) {
     case 'pcov':
-      return script + (await addCoveragePCOV(version, os_version));
+      return script + (await addCoveragePCOV(version, os, pipe));
     case 'xdebug':
-      return script + (await addCoverageXdebug(version, os_version));
+    case 'xdebug2':
+    case 'xdebug3':
+      return (
+        script + (await addCoverageXdebug(coverage_driver, version, os, pipe))
+      );
     case 'none':
-      return script + (await disableCoverage(version, os_version));
+      return script + (await disableCoverage(version, os, pipe));
     default:
       return '';
   }

src/extensions.ts

@@ -1,4 +1,3 @@
-import * as path from 'path';
 import * as utils from './utils';
 
 /**
@@ -12,31 +11,104 @@ export async function addExtensionDarwin(
   version: string
 ): Promise<string> {
   const extensions: Array<string> = await utils.extensionArray(extension_csv);
-  let script = '\n';
-  await utils.asyncForEach(extensions, async function(extension: string) {
-    extension = extension.toLowerCase();
-    // add script to enable extension is already installed along with php
-    let install_command = '';
-    switch (version + extension) {
-      case '5.6xdebug':
-        install_command = 'sudo pecl install xdebug-2.5.5 >/dev/null 2>&1';
-        break;
-      case '5.6redis':
-        install_command = 'sudo pecl install redis-2.2.8 >/dev/null 2>&1';
+  let add_script = '\n';
+  let remove_script = '';
+  await utils.asyncForEach(extensions, async function (extension: string) {
+    const version_extension: string = version + extension;
+    const [ext_name, ext_version]: string[] = extension.split('-');
+    const ext_prefix = await utils.getExtensionPrefix(ext_name);
+
+    switch (true) {
+      // match :extension
+      case /^:/.test(ext_name):
+        remove_script += '\ndisable_extension' + ext_name.replace(/:/g, ' ');
+        return;
+      // Match none
+      case /^none$/.test(ext_name):
+        add_script += '\ndisable_all_shared';
+        return;
+      // match extensions for compiling from source
+      case /.+-.+\/.+@.+/.test(extension):
+        add_script += await utils.parseExtensionSource(extension, ext_prefix);
+        return;
+      // match 7.4relay...8.5relay
+      // match 5.3blackfire...8.5blackfire
+      // match 5.3blackfire-(semver)...8.5blackfire-(semver)
+      // match couchbase, event, geos, ibm_db2, pdo_ibm, pdo_oci, oci8, http, pecl_http
+      // match 5.3ioncube...8.5ioncube
+      // match 7.0phalcon3...7.3phalcon3, 7.2phalcon4...7.4phalcon4, and 7.4phalcon5...8.4phalcon5
+      // match 7.0zephir_parser...8.5zephir_parser
+      case /^(7\.4|8\.[0-5])relay(-v?\d+\.\d+\.\d+|-nightly)?$/.test(
+        version_extension
+      ):
+      case /^(5\.[3-6]|7\.[0-4]|8\.[0-5])blackfire(-\d+\.\d+\.\d+)?$/.test(
+        version_extension
+      ):
+      case /^couchbase|^event|^gearman$|^geos$|^ibm_db2$|^pdo_ibm$|^pdo_oci$|^oci8$|^(pecl_)?http|^pdo_firebird$/.test(
+        extension
+      ):
+      case /^(5\.[3-6]|7\.[0-4]|8\.[0-5])ioncube$/.test(version_extension):
+      case /(5\.6|7\.[0-3])phalcon3|7\.[2-4]phalcon4|(7\.4|8\.[0-4])phalcon5?/.test(
+        version_extension
+      ):
+      case /(?<!5\.[3-6])(pdo_)?sqlsrv$/.test(version_extension):
+      case /^(7\.[0-4]|8\.[0-5])zephir_parser(-v?\d+\.\d+\.\d+)?$/.test(
+        version_extension
+      ):
+        add_script += await utils.customPackage(
+          ext_name,
+          'extensions',
+          extension,
+          'darwin'
+        );
+        return;
+      // match pre-release versions. For example - xdebug-beta
+      case /.+-(stable|beta|alpha|devel|snapshot|rc|preview)/.test(extension):
+        add_script += await utils.joins(
+          '\nadd_unstable_extension',
+          ext_name,
+          ext_version,
+          ext_prefix
+        );
+        return;
+      // match semver
+      case /.+-\d+(\.\d+\.\d+.*)?/.test(extension):
+        add_script += await utils.joins(
+          '\nadd_pecl_extension',
+          ext_name,
+          ext_version,
+          ext_prefix
+        );
+        return;
+      // match 5.3pcov to 7.0pcov
+      case /(5\.[3-6]|7\.0)pcov/.test(version_extension):
+        add_script += await utils.getUnsupportedLog('pcov', version, 'darwin');
+        return;
+      // match brew extensions
+      case /(?<!5\.[3-5])(amqp|apcu|brotli|excimer|expect|gmagick|gnupg|grpc|igbinary|imagick|imap|interbase|mailparse|maxminddb|mcrypt|memcache|memcached|mongodb|mongodb1|msgpack|newrelic|oauth|opentelemetry|pdo_firebird|pinba|protobuf|psr|raphf|rdkafka|redis|scalar_objects|seaslog|snmp|spx|ssh2|swoole|uopz|uploadprogress|uuid|vld|xdebug|xdebug2|xhprof|yaml|zmq|zstd)/.test(
+        version_extension
+      ):
+      case /(?<!5\.[3-6])(ds|v8js)/.test(version_extension):
+      case /(5\.6|7\.[0-4])(propro|lua)/.test(version_extension):
+      case /(?<!5\.[3-6]|7\.0)pcov/.test(version_extension):
+      case /(?<!5\.[3-6])(ast|vips|xlswriter)/.test(version_extension):
+      case /^(8\.[0-5])swow$/.test(version_extension):
+        add_script += await utils.joins(
+          '\nadd_brew_extension',
+          ext_name,
+          ext_prefix
+        );
+        return;
+      // match sqlite
+      case /^sqlite$/.test(extension):
+        extension = 'sqlite3';
         break;
       default:
-        install_command = 'sudo pecl install ' + extension + ' >/dev/null 2>&1';
         break;
     }
-    script +=
-      '\nadd_extension ' +
-      extension +
-      ' "' +
-      install_command +
-      '" ' +
-      (await utils.getExtensionPrefix(extension));
+    add_script += await utils.joins('\nadd_extension', extension, ext_prefix);
   });
-  return script;
+  return add_script + remove_script;
 }
 
 /**
@@ -50,19 +122,117 @@ export async function addExtensionWindows(
   version: string
 ): Promise<string> {
   const extensions: Array<string> = await utils.extensionArray(extension_csv);
-  let script = '\n';
-  await utils.asyncForEach(extensions, async function(extension: string) {
-    // add script to enable extension is already installed along with php
-    switch (version + extension) {
-      case '7.4redis':
-        script += '\nAdd-Extension ' + extension + ' beta';
+  let add_script = '\n';
+  let remove_script = '';
+  await utils.asyncForEach(extensions, async function (extension: string) {
+    const [ext_name, ext_version]: string[] = extension.split('-');
+    const version_extension: string = version + extension;
+    let matches: RegExpExecArray;
+    switch (true) {
+      // Match :extension
+      case /^:/.test(ext_name):
+        remove_script += '\nDisable-Extension' + ext_name.replace(/:/g, ' ');
+        break;
+      // Match none
+      case /^none$/.test(ext_name):
+        add_script += '\nDisable-AllShared';
+        break;
+      // match 5.3blackfire...8.5blackfire
+      // match 5.3blackfire-(semver)...8.5blackfire-(semver)
+      // match ibm_db2, pdo_ibm, pdo_oci and oci8
+      // match 5.3ioncube...8.5ioncube
+      // match 7.0phalcon3...7.3phalcon3, 7.2phalcon4...7.4phalcon4, and 7.4phalcon5...8.4phalcon5
+      // match 7.1pecl_http...8.5pecl_http and 7.1http...8.5http
+      // match 7.0zephir_parser...8.5zephir_parser
+      case /^(5\.[3-6]|7\.[0-4]|8\.[0-5])blackfire(-\d+\.\d+\.\d+)?$/.test(
+        version_extension
+      ):
+      case /^ibm_db2$|^pdo_ibm$|^pdo_oci$|^oci8$|^pdo_firebird$/.test(
+        extension
+      ):
+      case /^(5\.[3-6]|7\.[0-4]|8\.[0-5])ioncube$/.test(version_extension):
+      case /^7\.[0-3]phalcon3$|^7\.[2-4]phalcon4$|^(7\.4|8\.[0-4])phalcon5?$/.test(
+        version_extension
+      ):
+      case /^(7\.[1-4]|8\.[0-5])(pecl_)?http/.test(version_extension):
+      case /(?<!5\.[3-6])(pdo_)?sqlsrv$/.test(version_extension):
+      case /^(7\.[0-4]|8\.[0-5])zephir_parser(-v?\d+\.\d+\.\d+)?$/.test(
+        version_extension
+      ):
+        add_script += await utils.customPackage(
+          ext_name,
+          'extensions',
+          extension,
+          'win32'
+        );
+        return;
+      // match pre-release versions. For example - xdebug-beta
+      case /.+-(stable|beta|alpha|devel|snapshot)/.test(extension):
+        add_script += await utils.joins(
+          '\nAdd-Extension',
+          ext_name,
+          ext_version.replace('stable', '')
+        );
+        break;
+      // match extensions for compiling from source
+      case /.+-.+\/.+@.+/.test(extension):
+        add_script += await utils.getUnsupportedLog(
+          extension,
+          version,
+          'win32'
+        );
+        break;
+      // match semver with state
+      case /.+-\d+\.\d+\.\d+[a-zA-Z]+\d*/.test(extension):
+        matches = /.+-(\d+\.\d+\.\d+)([a-zA-Z]+)\d*/.exec(
+          version_extension
+        ) as RegExpExecArray;
+        add_script += await utils.joins(
+          '\nAdd-Extension',
+          ext_name,
+          matches[2].replace('preview', 'devel'),
+          matches[1]
+        );
+        break;
+      // match semver without state
+      case /.+-\d+(\.\d+\.\d+.*)?/.test(extension):
+        add_script += await utils.joins(
+          '\nAdd-Extension',
+          ext_name,
+          'stable',
+          ext_version
+        );
+        break;
+      // match 7.2xdebug2 to 7.4xdebug2
+      case /7\.[2-4]xdebug2/.test(version_extension):
+        add_script += '\nAdd-Extension xdebug stable 2.9.8';
+        break;
+      // match 5.3pcov to 7.0pcov
+      case /(5\.[3-6]|7\.0)pcov/.test(version_extension):
+        add_script += await utils.getUnsupportedLog('pcov', version, 'win32');
+        break;
+      // match 5.3 to 5.6 - mysql, mysqli, mysqlnd
+      case /^5\.[3-6](?<!pdo_)(mysql|mysqli|mysqlnd)$/.test(version_extension):
+        add_script +=
+          '\nAdd-Extension mysql\nAdd-Extension mysqli\nAdd-Extension mysqlnd';
+        break;
+      // match 7.0 and newer mysql, mysqli and mysqlnd
+      case /(?<!5\.[3-6])(?<!pdo_)(mysql|mysqli|mysqlnd)$/.test(
+        version_extension
+      ):
+        add_script += '\nAdd-Extension mysqli\nAdd-Extension mysqlnd';
+        break;
+      // match sqlite
+      case /^sqlite$/.test(extension):
+        extension = 'sqlite3';
+        add_script += await utils.joins('\nAdd-Extension', extension);
         break;
       default:
-        script += '\nAdd-Extension ' + extension;
+        add_script += '\nAdd-Extension ' + extension;
         break;
     }
   });
-  return script;
+  return add_script + remove_script;
 }
 
 /**
@@ -76,56 +246,110 @@ export async function addExtensionLinux(
   version: string
 ): Promise<string> {
   const extensions: Array<string> = await utils.extensionArray(extension_csv);
-  let script = '\n';
-  await utils.asyncForEach(extensions, async function(extension: string) {
-    extension = extension.toLowerCase();
-    // add script to enable extension is already installed along with php
+  let add_script = '\n';
+  let remove_script = '';
+  await utils.asyncForEach(extensions, async function (extension: string) {
+    const version_extension: string = version + extension;
+    const [ext_name, ext_version]: string[] = extension
+      .split(/-(.+)/)
+      .filter(Boolean);
+    const ext_prefix = await utils.getExtensionPrefix(ext_name);
 
-    let install_command = '';
-    switch (version + extension) {
-      case '7.4redis':
-        install_command =
-          'sudo DEBIAN_FRONTEND=noninteractive apt-get install -y php7.4-igbinary php7.4-redis >/dev/null 2>&1';
-        break;
-      case '7.2phalcon3':
-      case '7.3phalcon3':
-        install_command =
-          'sh ' +
-          path.join(__dirname, '../src/scripts/phalcon.sh') +
-          ' master ' +
-          version +
-          ' >/dev/null 2>&1';
-        break;
-      case '7.2phalcon4':
-      case '7.3phalcon4':
-      case '7.4phalcon4':
-        install_command =
-          'sh ' +
-          path.join(__dirname, '../src/scripts/phalcon.sh') +
-          ' 4.0.x ' +
-          version +
-          ' >/dev/null 2>&1';
+    switch (true) {
+      // Match :extension
+      case /^:/.test(ext_name):
+        remove_script += '\ndisable_extension' + ext_name.replace(/:/g, ' ');
+        return;
+      // Match none
+      case /^none$/.test(ext_name):
+        add_script += '\ndisable_all_shared';
+        return;
+      // match extensions for compiling from source
+      case /.+-.+\/.+@.+/.test(extension):
+        add_script += await utils.parseExtensionSource(extension, ext_prefix);
+        return;
+      // match 7.4relay...8.5relay
+      // match 5.3blackfire...8.5blackfire
+      // match 5.3blackfire-(semver)...8.5blackfire-(semver)
+      // match 5.3pdo_cubrid...7.2php_cubrid, 5.3cubrid...7.4cubrid
+      // match couchbase, geos, ibm_db2, pdo_ibm, pdo_oci, oci8, http, pecl_http
+      // match 5.3ioncube...8.5ioncube
+      // match 7.0phalcon3...7.3phalcon3, 7.2phalcon4...7.4phalcon4, 7.4phalcon5...8.4phalcon5
+      // match 7.0zephir_parser...8.5zephir_parser
+      case /^(7\.4|8\.[0-5])relay(-v?\d+\.\d+\.\d+|-nightly)?$/.test(
+        version_extension
+      ):
+      case /^(5\.[3-6]|7\.[0-4]|8\.[0-5])blackfire(-\d+\.\d+\.\d+)?$/.test(
+        version_extension
+      ):
+      case /^((5\.[3-6])|(7\.[0-2]))pdo_cubrid$|^((5\.[3-6])|(7\.[0-4]))cubrid$/.test(
+        version_extension
+      ):
+      case /^couchbase|^event|^gearman$|^geos$|^ibm_db2$|^pdo_ibm$|^pdo_oci$|^oci8$|^(pecl_)?http|^pdo_firebird$/.test(
+        extension
+      ):
+      case /(?<!5\.[3-5])intl-\d+\.\d+$/.test(version_extension):
+      case /^(5\.[3-6]|7\.[0-4]|8\.[0-5])ioncube$/.test(version_extension):
+      case /^7\.[0-3]phalcon3$|^7\.[2-4]phalcon4$|^(7\.4|8\.[0-4])phalcon5?$/.test(
+        version_extension
+      ):
+      case /(?<!5\.[3-6])(pdo_)?sqlsrv$/.test(version_extension):
+      case /^(7\.[0-4]|8\.[0-5])zephir_parser(-v?\d+\.\d+\.\d+)?$/.test(
+        version_extension
+      ):
+        add_script += await utils.customPackage(
+          ext_name,
+          'extensions',
+          extension,
+          'linux'
+        );
+        return;
+      // match pre-release versions. For example - xdebug-beta
+      case /.+-(stable|beta|alpha|devel|snapshot|rc|preview)/.test(extension):
+        add_script += await utils.joins(
+          '\nadd_unstable_extension',
+          ext_name,
+          ext_version,
+          ext_prefix
+        );
+        return;
+      // match semver versions
+      case /.+-\d+(\.\d+\.\d+.*)?/.test(extension):
+        add_script += await utils.joins(
+          '\nadd_pecl_extension',
+          ext_name,
+          ext_version,
+          ext_prefix
+        );
+        return;
+      // match 5.3pcov to 7.0pcov
+      case /(5\.[3-6]|7\.0)pcov/.test(version_extension):
+        add_script += await utils.getUnsupportedLog('pcov', version, 'linux');
+        return;
+      // match 7.2xdebug2...7.4xdebug2
+      case /^7\.[2-4]xdebug2$/.test(version_extension):
+        add_script += await utils.joins(
+          '\nadd_pecl_extension',
+          'xdebug',
+          '2.9.8',
+          ext_prefix
+        );
+        return;
+      // match pdo extensions
+      case /^pdo[_-].+/.test(extension):
+        extension = extension.replace(/pdo[_-]|3/, '');
+        add_script += '\nadd_pdo_extension ' + extension;
+        return;
+      // match sqlite
+      case /^sqlite$/.test(extension):
+        extension = 'sqlite3';
         break;
       default:
-        install_command =
-          'sudo DEBIAN_FRONTEND=noninteractive apt-get install -y php' +
-          version +
-          '-' +
-          extension.replace('pdo_', '').replace('pdo-', '') +
-          ' >/dev/null 2>&1 || sudo pecl install ' +
-          extension +
-          ' >/dev/null 2>&1';
         break;
     }
-    script +=
-      '\nadd_extension ' +
-      extension +
-      ' "' +
-      install_command +
-      '" ' +
-      (await utils.getExtensionPrefix(extension));
+    add_script += await utils.joins('\nadd_extension', extension, ext_prefix);
   });
-  return script;
+  return add_script + remove_script;
 }
 
 /**
@@ -133,29 +357,28 @@ export async function addExtensionLinux(
  *
  * @param extension_csv
  * @param version
- * @param os_version
- * @param log_prefix
+ * @param os
+ * @param no_step
  */
 export async function addExtension(
   extension_csv: string,
   version: string,
-  os_version: string,
+  os: string,
   no_step = false
 ): Promise<string> {
+  const log: string = await utils.stepLog('Setup Extensions', os);
   let script = '\n';
   switch (no_step) {
     case true:
-      script +=
-        (await utils.stepLog('Setup Extensions', os_version)) +
-        (await utils.suppressOutput(os_version));
+      script += log + (await utils.suppressOutput(os));
       break;
     case false:
     default:
-      script += await utils.stepLog('Setup Extensions', os_version);
+      script += log;
       break;
   }
 
-  switch (os_version) {
+  switch (os) {
     case 'win32':
       return script + (await addExtensionWindows(extension_csv, version));
     case 'darwin':
@@ -164,8 +387,8 @@ export async function addExtension(
       return script + (await addExtensionLinux(extension_csv, version));
     default:
       return await utils.log(
-        'Platform ' + os_version + ' is not supported',
-        os_version,
+        'Platform ' + os + ' is not supported',
+        os,
         'error'
       );
   }

src/fetch.ts

@@ -0,0 +1,42 @@
+/**
+ * Redirect status codes set for O(1) lookup
+ */
+const REDIRECT_CODES = new Set([301, 302, 303, 307, 308]);
+
+/**
+ * Function to fetch a URL using native fetch API (Node 24+)
+ *
+ * @param input_url
+ * @param auth_token
+ * @param redirect_count
+ */
+export async function fetch(
+  input_url: string,
+  auth_token?: string,
+  redirect_count = 5
+): Promise<Record<string, string>> {
+  const headers: Record<string, string> = {
+    'User-Agent': `Mozilla/5.0 (${process.platform} ${process.arch}) setup-php`
+  };
+  if (auth_token) {
+    headers['Authorization'] = 'Bearer ' + auth_token;
+  }
+
+  try {
+    const response = await globalThis.fetch(input_url, {
+      headers,
+      redirect: redirect_count > 0 ? 'follow' : 'manual'
+    });
+
+    if (response.ok) {
+      const data = await response.text();
+      return {data};
+    } else if (REDIRECT_CODES.has(response.status) && redirect_count <= 0) {
+      return {error: `${response.status}: Redirect error`};
+    } else {
+      return {error: `${response.status}: ${response.statusText}`};
+    }
+  } catch (error) {
+    return {error: `Fetch error: ${(error as Error).message}`};
+  }
+}

src/install.ts

@@ -1,72 +1,77 @@
-import {exec} from '@actions/exec/lib/exec';
-import * as core from '@actions/core';
+import path from 'path';
+import fs from 'fs';
+import {exec} from '@actions/exec';
 import * as config from './config';
+import * as core from './core';
 import * as coverage from './coverage';
 import * as extensions from './extensions';
+import * as tools from './tools';
 import * as utils from './utils';
 
 /**
  * Build the script
  *
- * @param filename
- * @param version
- * @param os_version
+ * @param os
  */
-export async function build(
-  filename: string,
-  version: string,
-  os_version: string
-): Promise<string> {
-  // taking inputs
-  const extension_csv: string = await utils.getInput('extension-csv', false);
-  const ini_values_csv: string = await utils.getInput('ini-values-csv', false);
+export async function getScript(os: string): Promise<string> {
+  const url = 'https://setup-php.com/sponsor';
+  const filename = os + (await utils.scriptExtension(os));
+  const script_path = path.join(__dirname, '../src/scripts', filename);
+  const run_path = script_path.replace(os, 'run');
+  const extension_csv: string = utils.sanitizeShellInput(
+    await utils.getInput('extensions', false),
+    true
+  );
+  const ini_values_csv: string = await utils.getInput('ini-values', false);
   const coverage_driver: string = await utils.getInput('coverage', false);
-
-  let script: string = await utils.readScript(filename, version, os_version);
+  const tools_csv: string = await utils.getInput('tools', false);
+  const version: string = await utils.parseVersion(
+    await utils.readPHPVersion()
+  );
+  const ini_file: string = await utils.parseIniFile(
+    await utils.getInput('ini-file', false)
+  );
+  let script = await utils.joins('.', script_path, `'${version}'`, ini_file);
   if (extension_csv) {
-    script += await extensions.addExtension(extension_csv, version, os_version);
+    script += await extensions.addExtension(extension_csv, version, os);
+  }
+  script += await tools.addTools(tools_csv, version, os);
+  if (coverage_driver) {
+    script += await coverage.addCoverage(coverage_driver, version, os);
   }
   if (ini_values_csv) {
-    script += await config.addINIValues(ini_values_csv, os_version);
-  }
-  if (coverage_driver) {
-    script += await coverage.addCoverage(coverage_driver, version, os_version);
+    script += await config.addINIValues(ini_values_csv, os);
   }
+  script += '\n' + (await utils.stepLog(`Sponsor setup-php`, os));
+  script += '\n' + (await utils.addLog('$tick', 'setup-php', url, os));
 
-  return await utils.writeScript(filename, script);
+  fs.writeFileSync(run_path, script, {mode: 0o755});
+
+  return run_path;
+}
+
+/**
+ * Function to set environment variables based on inputs.
+ */
+export async function setEnv(): Promise<void> {
+  process.env['fail_fast'] = await utils.getInput('fail-fast', false);
+  process.env['GITHUB_TOKEN'] ??= await utils.getInput('github-token', false);
 }
 
 /**
  * Run the script
  */
 export async function run(): Promise<void> {
-  try {
-    const os_version: string = process.platform;
-    const version: string = await utils.getVersion();
-    // check the os version and run the respective script
-    let script_path = '';
-    switch (os_version) {
-      case 'darwin':
-        script_path = await build(os_version + '.sh', version, os_version);
-        await exec('sh ' + script_path + ' ' + version + ' ' + __dirname);
-        break;
-      case 'linux': {
-        const pecl: string = await utils.getInput('pecl', false);
-        script_path = await build(os_version + '.sh', version, os_version);
-        await exec('sh ' + script_path + ' ' + version + ' ' + pecl);
-        break;
-      }
-      case 'win32':
-        script_path = await build('win32.ps1', version, os_version);
-        await exec(
-          'pwsh ' + script_path + ' -version ' + version + ' -dir ' + __dirname
-        );
-        break;
-    }
-  } catch (error) {
-    core.setFailed(error.message);
-  }
+  await setEnv();
+  const os: string = process.platform;
+  const tool = await utils.scriptTool(os);
+  const run_path = await getScript(os);
+  await exec(tool + run_path);
 }
 
 // call the run function
-run();
+(async () => {
+  await run();
+})().catch(error => {
+  core.setFailed(error.message);
+});

src/packagist.ts

@@ -0,0 +1,37 @@
+import * as cv from 'compare-versions';
+import * as fetch from './fetch';
+
+type RS = Record<string, string>;
+type RSRS = Record<string, RS>;
+
+export async function search(
+  package_name: string,
+  php_version: string
+): Promise<string | null> {
+  const response = await fetch.fetch(
+    `https://repo.packagist.org/p2/${package_name}.json`
+  );
+  if (response.error || response.data === '[]') {
+    return null;
+  }
+
+  const data = JSON.parse(response['data']);
+  if (data && data.packages) {
+    const versions = data.packages[package_name];
+    versions.sort((a: RS, b: RS) => cv.compareVersions(b.version, a.version));
+
+    const result = versions.find((versionData: RSRS) => {
+      if (versionData?.require?.php) {
+        return versionData?.require?.php
+          .split('|')
+          .some(
+            require => require && cv.satisfies(php_version + '.0', require)
+          );
+      }
+      return false;
+    });
+
+    return result ? result.version : null;
+  }
+  return null;
+}

src/scripts/7.4.sh

@@ -1,116 +0,0 @@
-tick="✓"
-cross="✗"
-
-step_log() {
-  message=$1
-  printf "\n\033[90;1m==> \033[0m\033[37;1m%s\033[0m\n" "$message"
-}
-
-add_log() {
-  mark=$1
-  subject=$2
-  message=$3
-  if [ "$mark" = "$tick" ]; then
-    printf "\033[32;1m%s \033[0m\033[34;1m%s \033[0m\033[90;1m%s\033[0m\n" "$mark" "$subject" "$message"
-  else
-    printf "\033[31;1m%s \033[0m\033[34;1m%s \033[0m\033[90;1m%s\033[0m\n" "$mark" "$subject" "$message"
-  fi
-}
-version='7.4.0'
-step_log "Setup dependencies"
-for package in pkg-config autoconf bison re2c openssl@1.1 krb5 enchant libffi freetype intltool icu4c libiconv t1lib gd libzip gmp tidyp libxml2 libxslt postgresql curl;
-do
-  brew install "$package" >/dev/null 2>&1
-  add_log "$tick" "$package" "Installed"
-done
-brew link icu4c gettext --force >/dev/null 2>&1
-
-for package in gettext gmp krb5 icu4c bison openssl@1.1 libxml2 libffi libxslt libiconv pkgconfig enchant krb5 readline libedit freetype;
-do
-  caps_package=$(echo "$package" | tr '[:lower:]' '[:upper:]')
-  {
-  echo 'export PATH="/usr/local/opt/'"$package"'/bin:$PATH"'
-  echo 'export PKG_CONFIG_PATH="/usr/local/opt/'$package'/lib/pkgconfig:$PKG_CONFIG_PATH"'
-  echo 'export '"$caps_package"'_LIBS="-L/usr/local/opt/'$package'/lib"'
-  echo 'export '"$caps_package"'_CFLAGS="-I/usr/local/opt/'$package'/include"'
-  } >> ~/.bash_profile;
-done
-{
-echo 'export ICONV_LIBS="-L/usr/local/opt/libiconv/lib"'
-echo 'export ICONV_CFLAGS="-I/usr/local/opt/libiconv/include"'
-echo 'export LIBXML_LIBS="-L/usr/local/opt/libxml2/lib"'
-echo 'export LIBXML_CFLAGS="-I/usr/local/opt/libxml2/include"'
-echo 'export ICU_LIBS="-L/usr/local/opt/icu4c/lib"'
-echo 'export ICU_CFLAGS="-I/usr/local/opt/icu4c/include"'
-echo 'export OPENSSL_LIBS="-L/usr/local/opt/openssl@1.1/lib -lcrypto"'
-echo 'export OPENSSL_CFLAGS="-I/usr/local/opt/openssl@1.1/include"'
-echo 'export OPENSSL_ROOT_DIR="/usr/local/opt/openssl@1.1/"'
-echo 'export OPENSSL_LIB_DIR="/usr/local/opt/openssl@1.1/lib"'
-echo 'export OPENSSL_INCLUDE_DIR="/usr/local/opt/openssl@1.1/include"'
-echo 'export PKG_CONFIG="/usr/local/opt/pkgconfig/bin/pkg-config"'
-echo 'export EXTRA_LIBS="/usr/local/opt/readline/lib/libhistory.dylib
-/usr/local/opt/readline/lib/libreadline.dylib
-/usr/local/opt/openssl@1.1/lib/libssl.dylib
-/usr/local/opt/openssl@1.1/lib/libcrypto.dylib
-/usr/local/opt/icu4c/lib/libicudata.dylib
-/usr/local/opt/icu4c/lib/libicui18n.dylib
-/usr/local/opt/icu4c/lib/libicuio.dylib
-/usr/local/opt/icu4c/lib/libicutu.dylib
-/usr/local/opt/icu4c/lib/libicuuc.dylib"'
-} >> ~/.bash_profile
-config_file=$2/../src/configs/config.yaml
-
-step_log "Setup PHPBrew"
-curl -L -O https://github.com/phpbrew/phpbrew/raw/master/phpbrew >/dev/null 2>&1
-chmod +x ./phpbrew
-sudo mv phpbrew /usr/local/bin/phpbrew
-sudo mkdir -p /opt/phpbrew
-sudo mkdir -p /usr/local/lib
-sudo mkdir -p /usr/local/bin
-sudo phpbrew init --root=/opt/phpbrew --config="$config_file" >/dev/null 2>&1
-sudo chmod -R 777 /opt/phpbrew
-export PHPBREW_ROOT=/opt/phpbrew
-export PHPBREW_HOME=/opt/phpbrew
-echo "[[ -e ~/.phpbrew/bashrc ]] && source ~/.phpbrew/bashrc" >> ~/.bashrc
-add_log "$tick" "PHPBrew" "Installed"
-
-source ~/.bash_profile >/dev/null 2>&1
-source ~/.bashrc >/dev/null 2>&1
-
-step_log "Setup PHP and Composer"
-phpbrew install -j 6 github:php/php-src@PHP-$version as php-$version +dev >/dev/null 2>&1
-phpbrew switch $version
-sudo ln -sf /opt/phpbrew/php/php-$version/bin/* /usr/local/bin/
-sudo ln -sf /opt/phpbrew/php/php-$version/etc/php.ini /etc/php.ini
-ini_file=$(php --ini | grep "Loaded Configuration" | sed -e "s|.*:s*||" | sed "s/ //g")
-ext_dir=$(php -i | grep "extension_dir => /opt" | sed -e "s|.*=> s*||")
-pecl config-set php_ini "$ini_file" >/dev/null 2>&1
-pear config-set php_ini "$ini_file" >/dev/null 2>&1
-sudo chmod 777 "$ini_file"
-brew install composer >/dev/null 2>&1
-
-add_log "$tick" "PHP" "Installed PHP$version"
-add_log "$tick" "Composer" "Installed"
-
-add_extension() {
-  extension=$1
-  install_command=$2
-  prefix=$3
-  if ! php -m | grep -i -q "$extension" && [ -e "$ext_dir/$extension.so" ]; then
-    echo "$prefix=$extension" >>"$ini_file" && add_log "$tick" "$extension" "Enabled"
-  elif php -m | grep -i -q "$extension"; then
-    add_log "$tick" "$extension" "Enabled"
-  elif ! php -m | grep -i -q "$extension"; then
-    exists=$(curl -sL https://pecl.php.net/json.php?package="$extension" -w "%{http_code}" -o /dev/null)
-    if [ "$exists" = "200" ]; then
-      (
-        eval "$install_command" && \
-        add_log "$tick" "$extension" "Installed and enabled"
-      ) || add_log "$cross" "$extension" "Could not install $extension on PHP$version"
-    else
-      if ! php -m | grep -i -q "$extension"; then
-        add_log "$cross" "$extension" "Could not find $extension for PHP$version on PECL"
-      fi
-    fi
-  fi
-}