Fix extension setup

Fix shellcheck in darwin.sh

.eslintrc.json

@@ -1,7 +1,7 @@
 {
   "env": { "node": true, "jest": true },
   "parser": "@typescript-eslint/parser",
-  "parserOptions": { "ecmaVersion": 2020, "sourceType": "module" },
+  "parserOptions": { "ecmaVersion": 2019, "sourceType": "module" },
   "extends": [
     "eslint:recommended",
     "plugin:@typescript-eslint/eslint-recommended",
@@ -12,12 +12,5 @@
     "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"
-  }
+  "plugins": ["@typescript-eslint", "jest"]
 }

.github/CONTRIBUTING.md

@@ -8,22 +8,16 @@ Please note that this project is released with a [Contributor Code of Conduct](C
 
 * Fork the project.
 * 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.
+* If editing the scripts, create a demo integration test.
+* Send a pull request to the develop branch with all the details.
 
 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.
-
-```bash
-$ 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:
@@ -40,6 +34,19 @@ Install setup-php dependencies using [npm](https://www.npmjs.com/):
 $ npm install
 ```
 
+If you are using `Windows` configure `git` to handle line endings.
+
+```cmd
+git config --local core.autocrlf true
+```
+
+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
+```
+
 ## Running the test suite
 
 After following the steps shown above, The `setup-php` tests in the `__tests__` directory can be run using this command:
@@ -60,4 +67,4 @@ $ npm run release
 
 Please submit the issue using the appropriate template provided for a bug report or a feature request:
 
-* [Issues](https://github.com/shivammathur/setup-php/issues)
+* [Issues](https://github.com/shivammathur/setup-php/issues)

.github/FUNDING.yml

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

.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,23 +1,42 @@
 ---
 name: Bug report
-about: Create a report to help us improve
+about: Nice, you found a bug!
 title: ''
-labels: ''
-assignees: ''
+labels: 'bug'
+assignees: 'shivammathur'
 
 ---
 
 **Describe the bug**
-A clear and concise description of what the bug is.
+<!-- Please describe the bug concisely. -->
+
+**Version**
+- [ ] I have checked releases, and the bug exists in the latest patch version of `v1` or `v2`.
+- [ ] `v2`
+- [ ] `v1`
+
+**Runners**
+<!-- Please mark the GitHub Action runner your workflow uses. -->
+- [ ] GitHub Hosted
+- [ ] Self Hosted
+
+**Operating systems**
+<!-- Please mention the operating systems your workflow uses. -->
+
+**PHP versions**
+<!-- Please mention the PHP versions your workflow uses. -->
 
 **To Reproduce**
-Please provide the GitHub Action `.yml` file.
+<!-- Please provide the relevant steps of your workflow `.yml` file. -->
 
 **Expected behavior**
-A clear and concise description of what you expected to happen.
+<!-- A clear and concise description of what you expected to happen. -->
 
-**Screenshots**
-If applicable, add screenshots to help explain your problem.
+**Screenshots/Logs**
+<!-- If applicable, add screenshots or logs to help explain your problem. -->
 
 **Additional context**
-Add any other context about the problem here.
+<!-- Add any other context about the problem here. -->
+
+**Are you willing to submit a PR?**
+<!-- We accept pull requests targeting the develop branch. -->

.github/ISSUE_TEMPLATE/feature_request.md

@@ -1,20 +1,26 @@
 ---
 name: Feature request
-about: Suggest an idea for this project
+about: Suggest a new feature
 title: ''
-labels: ''
-assignees: ''
+labels: 'enhancement'
+assignees: 'shivammathur'
 
 ---
 
-**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 feature**
+<!-- Please describe concisely the feature you want to add. -->
 
-**Describe the solution you'd like**
-A clear and concise description of what you want to happen.
+**Version**
+- [ ] I have checked releases, and the feature is missing in the latest patch version of `v2`.
 
-**Describe alternatives you've considered**
-A clear and concise description of any alternative solutions or features you've considered.
+**Underlying issue**
+<!-- Please describe the issue this would solve. -->
+
+**Describe alternatives**
+<!-- Please mention any alternative solutions you've considered. -->
 
 **Additional context**
-Add any other context or screenshots about the feature request here.
+<!-- Add any other context or screenshots about the feature request here. -->
+
+**Are you willing to submit a PR?**
+<!-- We accept pull requests targeting the develop branch. -->

.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,30 @@
+# Security Policy
+
+## Supported Versions
+
+The following versions of this project are supported for security updates.
+
+| Version | Supported          |
+| ------- | ------------------ |
+| 1.10.x  | :white_check_mark: |
+| 2.8.x   | :white_check_mark: |
+
+## Supported PHP Versions
+
+This security policy only applies to the latest patches of the following PHP versions.
+
+| Version | Supported          |
+| ------- | ------------------ |
+| 7.2     | :white_check_mark: |
+| 7.3     | :white_check_mark: |
+| 7.4     | :white_check_mark: |
+| 8.0     | :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@shivammathur.com](mailto:contact@shivammathur.com).
+Do not report security reports publicly.
+
+## Tidelift
+
+If you use this GitHub Action through a Tidelift subscription, please refer to [https://tidelift.com/security](https://tidelift.com/security).

.github/workflows/docs.yml

@@ -0,0 +1,73 @@
+name: Docs workflow
+on:
+  workflow_dispatch:
+  schedule:
+    - cron: '0 15 * * 2'
+jobs:
+  create:
+    name: Create
+    runs-on: ${{ matrix.operating-system }}
+    strategy:
+      fail-fast: false
+      matrix:
+        operating-system: [ubuntu-20.04, ubuntu-18.04, ubuntu-16.04, windows-2019, macos-10.15, macos-11.0]
+        php-versions: ['5.3', '5.4', '5.5', '5.6', '7.0', '7.1', '7.2', '7.3', '7.4', '8.0', '8.1']
+    steps:
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ matrix.php-versions }}
+      - name: Save unix
+        env:
+          file: php${{ matrix.php-versions }}-${{ matrix.operating-system }}.md
+          version: ${{ matrix.php-versions }}
+        if: matrix.operating-system != 'windows-2019'
+        run: |
+          echo "## PHP $version" >> "$file"
+          printf "\n" >> "$file"
+          echo "\`\`\`" >> "$file"
+          php -m >> "$file"
+          echo "\`\`\`" >> "$file"
+          printf "\n" >> "$file"
+      - name: Save Windows
+        env:
+          file: php${{ matrix.php-versions }}-${{ matrix.operating-system }}.md
+          version: ${{ matrix.php-versions }}
+        if: matrix.operating-system == 'windows-2019'
+        run: |
+          Write-Output "## PHP ${{ matrix.php-versions }}`n" | Out-File -FilePath "$env:file"
+          Write-Output "``````" | Out-File -FilePath "$env:file" -Append
+          php -m | Out-File -FilePath "$env:file" -Append
+          Write-Output "```````n" | Out-File -FilePath "$env:file" -Append
+      - uses: actions/upload-artifact@v2
+        with:
+          name: lists
+          path: php${{ matrix.php-versions }}-${{ matrix.operating-system }}.md
+  update:
+    name: Update
+    needs: create
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+        with:
+          repository: ${{ github.repository }}.wiki
+      - uses: actions/download-artifact@v2
+        with:
+          path: ${{ github.workspace }}
+      - name: Combine
+        run: |
+          git config --local user.email "${{ secrets.email }}"
+          git config --local user.name "${{ github.repository_owner }}"
+          for os in ubuntu-20.04 ubuntu-18.04 ubuntu-16.04 windows-2019 macos-10.15 macos-11.0; 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; do
+              cat lists/php"$version"-"$os".md >> Php-extensions-loaded-on-"$os".md
+            done
+          done
+          rm -rf ./lists
+          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://${{ github.repository_owner }}:${{ secrets.GITHUB_TOKEN }}@github.com/${{ github.repository }}.wiki.git master || true
+          fi

.github/workflows/node-workflow.yml

@@ -0,0 +1,51 @@
+name: Node 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]
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+
+      - name: Setup Node.js 14.x
+        uses: actions/setup-node@v1
+        with:
+          node-version: 14.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 }}

.github/workflows/workflow.yml

@@ -1,5 +1,6 @@
 name: Main workflow
 on:
+  workflow_dispatch:
   pull_request:
     branches:
       - master
@@ -23,42 +24,36 @@ jobs:
     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']
+        operating-system: [ubuntu-20.04, ubuntu-18.04, ubuntu-16.04, windows-latest, macos-latest]
+        php-versions: ['5.3', '5.4', '5.5', '5.6', '7.0', '7.1', '7.2', '7.3', '7.4', '8.0', '8.1']
+    env:
+      extensions: xml, opcache, xdebug, pcov
+      key: cache-v3
     steps:
       - name: Checkout
-        uses: actions/checkout@v1
+        uses: actions/checkout@v2
+
+      - name: Setup cache environment
+        id: cache-env
+        uses: shivammathur/cache-extensions@develop
         with:
-          fetch-depth: 1
+          php-version: ${{ matrix.php-versions }}
+          extensions: ${{ env.extensions }}
+          key: ${{ env.key }}
 
-      - name: Setup Node.js 12.x
-        uses: actions/setup-node@v1
+      - name: Cache extensions
+        uses: actions/cache@v2
         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 }}
+          path: ${{ steps.cache-env.outputs.dir }}
+          key: ${{ steps.cache-env.outputs.key }}
+          restore-keys: ${{ steps.cache-env.outputs.key }}
 
       - 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
+          extensions: ${{ env.extensions }}
+          ini-values: post_max_size=256M, short_open_tag=On, date.timezone=Asia/Kolkata
 
       - name: Testing PHP version
         run: |
@@ -72,11 +67,12 @@ jobs:
       - name: Testing Extensions
         run: |
           php -m
-          php -r "if(! extension_loaded('mbstring')) {throw new Exception('mbstring 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');}"

.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) 2019-2020 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

README.md

@@ -8,206 +8,778 @@
 
 <p align="center">
   <a href="https://github.com/shivammathur/setup-php" title="GitHub action to setup PHP"><img alt="GitHub Actions status" src="https://github.com/shivammathur/setup-php/workflows/Main%20workflow/badge.svg"></a>
-  <a href="https://codecov.io/gh/shivammathur/setup-php" title="Code coverage"><img alt="Codecov Code Coverage" src="https://codecov.io/gh/shivammathur/setup-php/branch/master/graph/badge.svg"></a>
-  <a href="https://github.com/shivammathur/setup-php/blob/master/LICENSE" title="license"><img alt="LICENSE" src="https://img.shields.io/badge/license-MIT-428f7e.svg"></a>
-  <a href="#tada-php-support" title="PHP Versions Supported"><img alt="PHP Versions Supported" src="https://img.shields.io/badge/php-%3E%3D%205.6-8892BF.svg"></a>  
+  <a href="https://codecov.io/gh/shivammathur/setup-php" title="Code coverage"><img alt="Codecov Code Coverage" src="https://img.shields.io/codecov/c/github/shivammathur/setup-php?logo=codecov"></a>
+  <a href="https://github.com/shivammathur/setup-php/blob/master/LICENSE" title="license"><img alt="LICENSE" src="https://img.shields.io/badge/license-MIT-428f7e.svg?logo=open%20source%20initiative&logoColor=white&labelColor=555555"></a>
+  <a href="#tada-php-support" title="PHP Versions Supported"><img alt="PHP Versions Supported" src="https://img.shields.io/badge/php-5.3%20to%208.1-777bb3.svg?logo=php&logoColor=white&labelColor=555555"></a>  
+</p>
+<p align="center">  
+  <a href="https://reddit.com/r/setup_php" title="setup-php reddit"><img alt="setup-php reddit" src="https://img.shields.io/badge/reddit-join-FF5700?logo=reddit&logoColor=FF5700&labelColor=555555"></a>
+  <a href="https://twitter.com/setup_php" title="setup-php twitter"><img alt="setup-php twitter" src="https://img.shields.io/badge/twitter-follow-1DA1F2?logo=twitter&logoColor=1DA1F2&labelColor=555555"></a>
+  <a href="https://setup-php.statuspage.io/" title="setup-php status"><img alt="setup-php status" src="https://img.shields.io/badge/status-subscribe-28A745?logo=statuspage&logoColor=28A745&labelColor=555555"></a>  
 </p>
 
-Setup PHP with required extensions, php.ini configuration and composer in [GitHub Actions](https://github.com/features/actions "GitHub Actions"). This action can be added as a step in your action workflow and it will setup the PHP environment you need to test your application. Refer to [Usage](#memo-usage "How to use this") section and [examples](#examples "Examples of use") to see how to use this.
+Setup PHP with required extensions, php.ini configuration, code-coverage support and various tools like composer in [GitHub Actions](https://github.com/features/actions "GitHub Actions"). This action gives you a cross platform interface to set up the PHP environment you need to test your application. Refer to [Usage](#memo-usage "How to use this") section and [examples](#examples "Examples of use") to see how to use this.
 
 ## Contents
 
-- [PHP Support](#tada-php-support)
 - [OS/Platform Support](#cloud-osplatform-support)
-- [PHP Extension Support](#wrench-php-extension-support)
-- [Coverage support](#signal_strength-coverage-support)
+  - [GitHub-Hosted Runners](#github-hosted-runners)
+  - [Self-Hosted Runners](#self-hosted-runners)
+- [PHP Support](#tada-php-support)  
+- [PHP Extension Support](#heavy_plus_sign-php-extension-support)
+- [Tools Support](#wrench-tools-support)
+- [Coverage Support](#signal_strength-coverage-support)
   - [Xdebug](#xdebug)
   - [PCOV](#pcov)
-  - [Disable coverage](#disable-coverage)
+  - [Disable Coverage](#disable-coverage)
 - [Usage](#memo-usage)
-  - [Basic Usage](#basic-usage)
-  - [Matrix Testing](#matrix-testing)
-  - [Cache dependencies](#cache-dependencies)
+  - [Inputs](#inputs)
+  - [Flags](#flags)
+  - [Basic Setup](#basic-setup)
+  - [Matrix Setup](#matrix-setup)  
+  - [Nightly Build Setup](#nightly-build-setup)
+  - [Thread Safe Setup](#thread-safe-setup)
+  - [Force Update Setup](#force-update-setup)
+  - [Verbose Setup](#verbose-setup)  
+  - [Multi-Arch Setup](#multi-arch-setup)
+  - [Self Hosted Setup](#self-hosted-setup)
+  - [Local Testing Setup](#local-testing-setup)
+  - [JIT Configuration](#jit-configuration)
+  - [Cache Extensions](#cache-extensions)
+  - [Cache Composer Dependencies](#cache-composer-dependencies)
+  - [Cache Node.js Dependencies](#cache-nodejs-dependencies)
+  - [Composer GitHub OAuth](#composer-github-oauth)
+  - [Problem Matchers](#problem-matchers)
   - [Examples](#examples)
+- [Versioning](#bookmark-versioning)
 - [License](#scroll-license)
 - [Contributions](#1-contributions)
-- [Support this project](#sparkling_heart-support-this-project)
-- [This action uses the following works](#bookmark-this-action-uses-the-following-works)
+- [Support This Project](#sparkling_heart-support-this-project)
+- [Dependencies](#package-dependencies)
 - [Further Reading](#bookmark_tabs-further-reading)
 
-## :tada: PHP Support
-
-|PHP Version|Stability|Release Support|
-|--- |--- |--- |
-|5.6|`Stable`|`End of life`|
-|7.0|`Stable`|`End of life`|
-|7.1|`Stable`|`Security fixes only`|
-|7.2|`Stable`|`Active`|
-|7.3|`Stable`|`Active`|
-|7.4|`Stable`|`Active`|
-
 ## :cloud: OS/Platform Support
 
-|Virtual environment|matrix.operating-system|
+Both `GitHub-hosted` and `self-hosted` runners are suppported by `setup-php` on the following OS/Platforms.
+
+### GitHub-Hosted Runners
+
+|Virtual environment|YAML workflow label|Pre-installed PHP|
+|--- |--- |--- |
+|Ubuntu 16.04|`ubuntu-16.04`|`PHP 5.6` to `PHP 8.0`|
+|Ubuntu 18.04|`ubuntu-latest` or `ubuntu-18.04`|`PHP 7.1` to `PHP 8.0`|
+|Ubuntu 20.04|`ubuntu-20.04`|`PHP 7.4` to `PHP 8.0`|
+|Windows Server 2019|`windows-latest` or `windows-2019`|`PHP 8.0`|
+|macOS Catalina 10.15|`macos-latest` or `macos-10.15`|`PHP 8.0`|
+|macOS Big Sur 11.0|`macos-11.0`|`PHP 8.0`|
+
+### Self-Hosted Runners
+
+|Host OS/Virtual environment|YAML workflow label|
 |--- |--- |
-|Windows Server 2019|`windows-latest` or `windows-2019`|
-|Ubuntu 18.04|`ubuntu-latest` or `ubuntu-18.04`|
-|Ubuntu 16.04|`ubuntu-16.04`|
-|macOS X Catalina 10.15|`macOS-latest` or `macOS-10.15`|
+|Ubuntu 16.04|`self-hosted` or `Linux`|
+|Ubuntu 18.04|`self-hosted` or `Linux`|
+|Ubuntu 20.04|`self-hosted` or `Linux`|
+|Windows 7 and newer|`self-hosted` or `Windows`|
+|Windows Server 2012 R2 and newer|`self-hosted` or `Windows`|
+|macOS Catalina 10.15|`self-hosted` or `macOS`|
+|macOS Big Sur 11.x x86_64/arm64|`self-hosted` or `macOS`|
 
-## :wrench: PHP Extension Support
-- On `ubuntu` by default extensions which are available as a package can be installed. If the extension is not available as a package but it is on `PECL`, it can be installed by specifying `pecl: true`. 
-- On `windows` extensions which have `windows` binary on `PECL` can be installed.
-- On `macOS` extensions which are on `PECL` can be installed.
-- Extensions which are installed along with PHP if specified are enabled.
-- Extensions which cannot be installed gracefully leave an error message in the logs, the action is not interrupted.
+- Refer to the [self-hosted setup](#self-hosted-setup) to use the action on self-hosted runners.
+- If the requested PHP version is pre-installed, `setup-php` switches to it, otherwise it installs the PHP version.
 
-## :signal_strength: Coverage support
+## :tada: PHP Support
+
+On all supported OS/Platforms the following PHP versions are supported as per the runner.
+
+- PHP 5.3 to PHP 8.1 on GitHub-hosted runners.
+- PHP 5.6 to PHP 8.1 on self-hosted runners.
+
+|PHP Version|Stability|Release Support|Runner Support|
+|--- |--- |--- |--- |
+|`5.3`|`Stable`|`End of life`|`GitHub-hosted`|
+|`5.4`|`Stable`|`End of life`|`GitHub-hosted`|
+|`5.5`|`Stable`|`End of life`|`GitHub-hosted`|
+|`5.6`|`Stable`|`End of life`|`GitHub-hosted`, `self-hosted`|
+|`7.0`|`Stable`|`End of life`|`GitHub-hosted`, `self-hosted`|
+|`7.1`|`Stable`|`End of life`|`GitHub-hosted`, `self-hosted`|
+|`7.2`|`Stable`|`End of life`|`GitHub-hosted`, `self-hosted`|
+|`7.3`|`Stable`|`Security fixes only`|`GitHub-hosted`, `self-hosted`|
+|`7.4`|`Stable`|`Active`|`GitHub-hosted`, `self-hosted`|
+|`8.0`|`Stable`|`Active`|`GitHub-hosted`, `self-hosted`|
+|`8.1`|`Nightly`|`In development`|`GitHub-hosted`, `self-hosted`|
+
+**Notes:** 
+- Specifying `8.1` in `php-version` input installs a nightly build of `PHP 8.1.0-dev`. See [nightly build setup](#nightly-build-setup) for more information.
+- To use JIT on `PHP 8.0` and `PHP 8.1` refer to the [JIT configuration](#jit-configuration) section.
+
+## :heavy_plus_sign: PHP Extension Support
+
+PHP extensions can be setup using the `extensions` input. It accepts a `string` in csv-format.
+
+- On `Ubuntu`, extensions which are available as a package or available on `PECL` can be setup.
+
+```yaml
+- name: Setup PHP with PECL extension
+  uses: shivammathur/setup-php@v2
+  with:
+    php-version: '7.4'
+    extensions: imagick, swoole
+```
+
+- On `Windows`, extensions available on `PECL` which have the `DLL` binary can be setup.
+
+- On `macOS`, extensions available on `PECL` can be installed.
+
+- Extensions installed along with PHP if specified are enabled.
+
+- Specific versions of extensions available on `PECL` can be setup by suffixing the extension's name with the version. This is useful for installing old versions of extensions which support end of life PHP versions.
+
+```yaml
+- name: Setup PHP with specific version of PECL extension
+  uses: shivammathur/setup-php@v2
+  with:
+    php-version: '5.4'
+    extensions: swoole-1.9.3
+```
+
+- Pre-release versions extensions available on `PECL` can be setup by suffixing the extension's name with its state i.e `alpha`, `beta`, `devel` or `snapshot`.
+
+```yaml
+- name: Setup PHP with pre-release PECL extension
+  uses: shivammathur/setup-php@v2
+  with:
+    php-version: '7.4'
+    extensions: xdebug-beta
+```
+
+- Shared extensions can be removed by prefixing them with a `:`.
+
+```yaml
+- name: Setup PHP and remove shared extension
+  uses: shivammathur/setup-php@v2
+  with:
+    php-version: '7.4'  
+    extensions: :opcache
+```
+
+- Extension `intl` can be setup with specific `ICU` version for `PHP 5.6` to `PHP 8.0` in `Ubuntu` workflows by suffixing `intl` with the `ICU` version. `ICU 50.2` and newer versions are supported. Refer to [`ICU builds`](https://github.com/shivammathur/icu-intl#icu4c-builds) for the specific versions supported.
+
+```yaml
+- name: Setup PHP with intl
+  uses: shivammathur/setup-php@v2
+  with:
+    php-version: '7.4'
+    extensions: intl-68.2
+```
+
+- Extensions loaded by default after `setup-php` runs can be found on the [wiki](https://github.com/shivammathur/setup-php/wiki).
+
+- These extensions have custom support:
+  - `cubrid`, `pdo_cubrid` and `gearman` on `Ubuntu`.
+  - `geos` on `Ubuntu` and `macOS`.
+  - `blackfire`, `couchbase`, `ioncube`, `oci8`, `pdo_oci`, `phalcon3` and `phalcon4` on all supported OS.
+
+- By default, extensions which cannot be added or removed gracefully leave an error message in the logs, the action is not interrupted. To change this behaviour you can set `fail-fast` flag to `true`. 
+
+```yaml
+- name: Setup PHP with fail-fast
+  uses: shivammathur/setup-php@v2
+  with:
+    php-version: '7.4'
+    extensions: oci8
+  env:
+    fail-fast: true
+```
+
+## :wrench: Tools Support
+
+These tools can be setup globally using the `tools` input. It accepts a string in csv-format.
+
+`behat`, `blackfire`, `blackfire-player`, `codeception`, `composer`, `composer-normalize`, `composer-prefetcher`, `composer-require-checker`, `composer-unused`, `cs2pr`, `deployer`, `flex`, `grpc_php_plugin`, `infection`, `pecl`, `phan`, `phing`, `phinx`, `phive`, `phpcbf`, `phpcpd`, `php-config`, `php-cs-fixer`, `phpcs`, `phpize`, `phpmd`, `phpspec`, `phpstan`, `phpunit`, `prestissimo`, `protoc`, `psalm`, `symfony`, `vapor-cli`
+
+```yaml
+- name: Setup PHP with tools
+  uses: shivammathur/setup-php@v2
+  with:
+    php-version: '7.4'
+    tools: php-cs-fixer, phpunit
+```
+
+- To set up a particular version of a tool, specify it in the form `tool:version`. The latest stable version of `composer` is set up by default. You can set up the required `composer` version by specifying `v1`, `v2`, `snapshot` or `preview` as versions or the exact version in semver format.
+
+```yaml
+- name: Setup PHP with composer v2
+  uses: shivammathur/setup-php@v2
+  with:
+    php-version: '7.4'
+    tools: composer:v2
+```
+
+- Tools `prestissimo` and `composer-prefetcher` will be skipped unless `composer:v1` is also specified in tools input. It is recommended to drop `prestissimo` and use `composer v2`.
+
+- The latest versions of both agent `blackfire-agent` and client `blackfire` are setup when `blackfire` is specified in tools input. Please refer to the [official documentation](https://blackfire.io/docs/integrations/ci/github-actions "Blackfire.io documentation for GitHub Actions") for using `blackfire` with GitHub Actions.
+
+- Version for other tools should be in `semver` format and a valid release of the tool. This is useful for installing tools for older versions of PHP. For example to set up `PHPUnit` on `PHP 7.2`.
+
+```yaml
+- name: Setup PHP with tools
+  uses: shivammathur/setup-php@v2
+  with:
+    php-version: '7.2'
+    tools: phpunit:8.5.8
+```
+
+- By default, tools which cannot be set up gracefully leave an error message in the logs, the action is not interrupted. To change this behaviour you can set `fail-fast` flag to `true`.
+
+```yaml
+- name: Setup PHP with fail-fast
+  uses: shivammathur/setup-php@v2
+  with:
+    php-version: '7.4'
+    tools: deployer
+  env:
+    fail-fast: true
+```
+
+**Notes**
+- Input `tools` is useful to set up tools which you only use in GitHub Actions, thus keeping your `composer.json` tidy.
+- If you do not want to use all your dev-dependencies in GitHub Actions workflow, you can run composer with `--no-dev` and install required tools using `tools` input to speed up your workflow.
+- If you have a tool in your `composer.json`, do not setup it with `tools` input as the two instances of the tool might conflict.
+
+## :signal_strength: Coverage Support
 
 ### Xdebug
 
 Specify `coverage: xdebug` to use `Xdebug`.  
-Runs on all [PHP versions supported](#tada-php-support "List of PHP versions supported on this GitHub Action")    
+Runs on all [PHP versions supported](#tada-php-support "List of PHP versions supported on this GitHub Action").
 
 ```yaml
-uses: shivammathur/setup-php@v1
-with:
-  php-version: '7.4'  
-  coverage: xdebug
+- name: Setup PHP with Xdebug
+  uses: shivammathur/setup-php@v2
+  with:
+    php-version: '7.4'
+    coverage: xdebug
+```
+
+- The latest version of Xdebug compatible with the PHP version is set up by default.
+- If you need Xdebug 2.x on PHP 7.2, 7.3 or 7.4, you can specify `coverage: xdebug2`.
+
+```yaml
+- name: Setup PHP with Xdebug 2.x
+  uses: shivammathur/setup-php@v2
+  with:
+    php-version: '7.4'
+    coverage: xdebug2
 ```
 
 ### PCOV
 
-Specify `coverage: pcov` to use `PCOV`.  
-It is much faster than `Xdebug`.  
-`PCOV` needs `PHP >= 7.1`.  
-If your source code directory is other than `src`, `lib` or, `app`, specify `pcov.directory` using the `ini-values-csv` input.  
-
+Specify `coverage: pcov` to use PCOV and disable Xdebug.  
+Runs on PHP 7.1 and newer PHP versions.
+  
+- In most cases, tests with `PCOV` execute much faster than with `Xdebug`.  
+- If your source code directory is other than `src`, `lib` or, `app`, specify `pcov.directory` using the `ini-values` input.  
 
 ```yaml
-uses: shivammathur/setup-php@v1
-with:
-  php-version: '7.4'
-  ini-values-csv: pcov.directory=api #optional, see above for usage.
-  coverage: pcov
+- name: Setup PHP with PCOV
+  uses: shivammathur/setup-php@v2
+  with:
+    php-version: '7.4'
+    ini-values: pcov.directory=api #optional, see above for usage.
+    coverage: pcov
 ```
 
-### Disable coverage
+- PHPUnit 8.x and above supports PCOV out of the box.  
+- If you are using PHPUnit 5.x, 6.x or 7.x, you need to set up `pcov/clobber` before executing your tests.
 
-Specify `coverage: none` to disable both `Xdebug` and `PCOV`.
+```yaml
+- name: Setup PCOV
+  run: |
+    composer require pcov/clobber
+    vendor/bin/pcov clobber
+```
+
+### Disable Coverage
+
+Specify `coverage: none` to remove both `Xdebug` and `PCOV`.  
 Consider disabling the coverage using this PHP action for these reasons.
 
 - You are not generating coverage reports while testing.
-- It will disable `Xdebug`, which will have a positive impact on PHP performance.
+- It will remove `Xdebug`, which will have a positive impact on PHP performance.
 - You are using `phpdbg` for running your tests.
+- You are profiling your code using `blackfire`.
 
 ```yaml
-uses: shivammathur/setup-php@v1
-with:
-  php-version: '7.4'
-  coverage: none
+- name: Setup PHP with no coverage driver
+  uses: shivammathur/setup-php@v2
+  with:
+    php-version: '7.4'
+    coverage: none
 ```
 
 ## :memo: Usage
 
-Inputs supported by this GitHub Action.
+### Inputs
 
-- php-version `required`
-- extension-csv `optional`
-- ini-values-csv `optional`
-- coverage `optional`
-- pecl `optional`
+> Specify using `with` keyword
 
-See [action.yml](action.yml "Metadata for this GitHub Action") and usage below for more info.
+#### `php-version` (required)
 
-### Basic Usage
+- Specify the PHP version you want to set up.
+- Accepts a `string`. For example `'7.4'`.
+- Accepts `latest` to set up the latest stable PHP version.
+- Accepts the format `d.x`, where `d` is the major version. For example `5.x`, `7.x` and `8.x`.  
+- See [PHP support](#tada-php-support) for supported PHP versions.
+
+#### `extensions` (optional)
+
+- Specify the extensions you want to add or remove.
+- Accepts a `string` in csv-format. For example `mbstring, :opcache`.
+- Non-default extensions prefixed with `:` are removed.
+- See [PHP extension support](#heavy_plus_sign-php-extension-support) for more info.
+
+#### `ini-values` (optional)
+
+- Specify the values you want to add to `php.ini`. 
+- Accepts a `string` in csv-format. For example `post_max_size=256M, max_execution_time=180`.
+- Accepts ini values with commas if wrapped in quotes. For example `xdebug.mode="develop,coverage"`.  
+
+#### `coverage` (optional)
+
+- Specify the code coverage driver you want to set up.
+- Accepts `xdebug`, `pcov` or `none`.
+- See [coverage support](#signal_strength-coverage-support) for more info.
+
+#### `tools` (optional)
+
+- Specify the tools you want to set up.
+- Accepts a `string` in csv-format. For example: `phpunit, phpcs`
+- See [tools Support](#wrench-tools-support) for tools supported.
+
+### Flags
+
+> Specify using `env` keyword
+
+#### `fail-fast` (optional)
+
+- Specify to mark the workflow as failed if an extension or tool fails to set up.
+- This changes the default mode from graceful warnings to fail-fast.
+- By default, it is set to `false`.
+- Accepts `true` and `false`.
+
+#### `phpts` (optional)
+
+- Specify to set up thread-safe version of PHP on windows.
+- Accepts `ts` and `nts`.
+- By default, it is set to `nts`.
+- See [thread safe setup](#thread-safe-setup) for more info.
+
+#### `update` (optional)
+
+- Specify to update PHP on the runner to the latest patch version.
+- Accepts `true` and `false`.
+- By default, it is set to `false`.
+- See [force update setup](#force-update-setup) for more info.
+
+See below for more info.
+
+### Basic Setup
+
+> Setup a particular PHP version.
 
 ```yaml
 steps:
 - name: Checkout
-  uses: actions/checkout@v1
+  uses: actions/checkout@v2
 
 - name: Setup PHP
-  uses: shivammathur/setup-php@v1
+  uses: shivammathur/setup-php@v2
   with:
     php-version: '7.4'
-    extension-csv: mbstring, intl #optional, setup extensions
-    ini-values-csv: post_max_size=256M, short_open_tag=On #optional, setup php.ini configuration
-    coverage: xdebug #optional, setup coverage driver
-    pecl: false #optional, setup PECL
-
-- name: Check PHP Version
-  run: php -v
-
-- name: Check Composer Version
-  run: composer -V
-
-- name: Check PHP Extensions
-  run: php -m
+    extensions: mbstring, intl
+    ini-values: post_max_size=256M, max_execution_time=180
+    coverage: xdebug    
+    tools: php-cs-fixer, phpunit
 ```
 
-### Matrix Testing
+### Matrix Setup
+
+> Setup multiple PHP versions on multiple operating systems.
 
 ```yaml
 jobs:
-  run:    
+  run:
     runs-on: ${{ matrix.operating-system }}
-    strategy:      
+    strategy:
       matrix:
-        operating-system: [ubuntu-latest, windows-latest, macOS-latest]
-        php-versions: ['5.6', '7.0', '7.1', '7.2', '7.3', '7.4']
-    name: PHP ${{ matrix.php-versions }} Test on ${{ matrix.operating-system }}
+        operating-system: ['ubuntu-latest', 'windows-latest', 'macos-latest']
+        php-versions: ['7.3', '7.4']
+        phpunit-versions: ['latest']
+        include:
+        - operating-system: 'ubuntu-latest'
+          php-versions: '7.2'
+          phpunit-versions: '8.5.13'    
     steps:
     - name: Checkout
-      uses: actions/checkout@v1
+      uses: actions/checkout@v2
 
     - name: Setup PHP
-      uses: shivammathur/setup-php@v1
+      uses: shivammathur/setup-php@v2
       with:
         php-version: ${{ matrix.php-versions }}
-        extension-csv: mbstring, intl #optional, setup extensions
-        ini-values-csv: post_max_size=256M, short_open_tag=On #optional, setup php.ini configuration
-        coverage: xdebug #optional, setup coverage driver
-        pecl: false #optional, setup PECL
-
-    - name: Check PHP Version
-      run: php -v
-
-    - name: Check Composer Version
-      run: composer -V
-
-    - name: Check PHP Extensions
-      run: php -m
+        extensions: mbstring, intl
+        ini-values: post_max_size=256M, max_execution_time=180
+        coverage: xdebug        
+        tools: php-cs-fixer, phpunit:${{ matrix.phpunit-versions }}
 ```
 
-### Cache dependencies
+### Nightly Build Setup
 
-You can persist composer's internal cache directory using the [`action/cache`](https://github.com/actions/cache "GitHub Action to cache files") GitHub Action. Dependencies cached are loaded directly instead of downloading them while installation. The files cached are available across check-runs and will reduce the workflow execution time.
+> Setup a nightly build of `PHP 8.1`. 
 
-**Note:** Please do not cache `vendor` directory using `action/cache` as that will have side-effects.
+- This version is currently in development.
+- Some user space extensions might not support this version currently.
 
 ```yaml
-- name: Get Composer Cache Directory
+steps:
+- name: Checkout
+  uses: actions/checkout@v2
+
+- name: Setup nightly PHP
+  uses: shivammathur/setup-php@v2
+  with:
+    php-version: '8.1'
+    extensions: mbstring
+    ini-values: post_max_size=256M, max_execution_time=180
+    coverage: xdebug
+    tools: php-cs-fixer, phpunit
+```
+
+### Thread Safe Setup
+
+> Setup `TS` or `NTS` PHP on `Windows`.
+
+- `NTS` versions are setup by default.
+- On `Ubuntu` and `macOS` only `NTS` versions are supported.
+- On `Windows` both `TS` and `NTS` versions are supported.
+
+```yaml
+jobs:
+  run:
+    runs-on: windows-latest
+    name: Setup PHP TS on Windows
+    steps:
+    - name: Checkout
+      uses: actions/checkout@v2
+
+    - name: Setup PHP
+      uses: shivammathur/setup-php@v2
+      with:
+        php-version: '7.4'
+      env:
+        phpts: ts # specify ts or nts
+```
+
+### Force Update Setup
+
+> Update to the latest patch of PHP versions.
+
+- Pre-installed PHP versions on the GitHub Actions runner are not updated to their latest patch release by default.
+- You can specify the `update` environment variable to `true` to force update to the latest release.
+
+```yaml
+- name: Setup PHP with latest versions
+  uses: shivammathur/setup-php@v2
+  with:
+    php-version: '7.4'
+  env:
+    update: true # specify true or false
+```
+
+### Verbose Setup
+
+> Debug your workflow
+
+To debug any issues, you can use the `verbose` tag instead of `v2`.
+
+```yaml
+- name: Setup PHP with logs
+  uses: shivammathur/setup-php@verbose
+  with:
+    php-version: '7.4'
+```
+
+### Multi-Arch Setup
+
+> Setup PHP on multiple architecture on Ubuntu GitHub Runners.
+
+- `PHP 5.6` to `PHP 7.4` are supported by `setup-php` on multiple architecture on `Ubuntu`.
+- For this, you can use `shivammathur/node` images as containers. These have compatible `Nodejs` and `spc` utility.
+- Using `spc` you can run `setup-php` on both `i386` and `amd64` containers as opposed to [default syntax](#basic-setup), which only supports `amd64`.
+- Currently, for `Arm` based setup, you will need [self-hosted runners](#self-hosted-setup).
+
+```yaml
+jobs:
+  run:
+    runs-on: ubuntu-latest
+    container: shivammathur/node:latest-${{ matrix.arch }}
+    strategy:
+      matrix:
+        arch: ["amd64", "i386"]
+    steps:
+      - name: Install PHP
+        run: |
+          # Update spc (See https://github.com/shivammathur/spc for options)
+          spc -U
+
+          # Install PHP
+          spc --php-version "7.4" \
+              --extensions "mbstring, intl" \
+              --ini-values "post_max_size=256M, max_execution_time=180" \
+              --coverage "xdebug" \
+              --tools "php-cs-fixer, phpunit"
+```
+
+### Self Hosted Setup
+
+> Setup PHP on a self-hosted runner.
+
+- To set up a dockerized self-hosted runner, refer to this [guide](https://github.com/shivammathur/setup-php/wiki/Dockerized-self-hosted-runner-on-Ubuntu) to set up in an `Ubuntu` container and refer to this [guide](https://github.com/shivammathur/setup-php/wiki/Dockerized-self-hosted-runner-on-Windows) to set up in a `Windows` container.
+- To set up the runner directly on the host OS or in a virtual machine, follow this [requirements guide](https://github.com/shivammathur/setup-php/wiki/Requirements-for-self-hosted-runners "Requirements guide for self-hosted runner to run setup-php") before setting up the self-hosted runner.
+- If your workflow uses [services](https://help.github.com/en/actions/reference/workflow-syntax-for-github-actions#jobsjob_idservices "GitHub Actions Services"), then setup the runner on a Linux host or in a Linux virtual machine. GitHub Actions does not support nested virtualization on Linux, so services will not work in a dockerized container.
+
+Specify the environment variable `runner` with the value `self-hosted`. Without this your workflow will fail.
+
+```yaml
+jobs:
+  run:
+    runs-on: self-hosted
+    strategy:
+      matrix:        
+        php-versions: ['5.6', '7.0', '7.1', '7.2', '7.3', '7.4', '8.0']
+    name: PHP ${{ matrix.php-versions }}
+    steps:
+    - name: Checkout
+      uses: actions/checkout@v2
+
+    - name: Setup PHP
+      uses: shivammathur/setup-php@v2
+      with:
+        php-version: ${{ matrix.php-versions }}
+      env:
+        runner: self-hosted # Specify the runner.
+```
+
+**Notes**
+- Do not setup multiple self-hosted runners on a single server instance as parallel workflow will conflict with each other.
+- Do not setup self-hosted runners on the side on your development environment or your production server.
+- Avoid using the same labels for your `self-hosted` runners which are used by `GitHub-hosted` runners.
+
+### Local Testing Setup
+
+> Test your `Ubuntu` workflow locally using [`nektos/act`](https://github.com/nektos/act "Project to test GitHub Actions locally").
+
+```yaml
+jobs:
+  run:
+    runs-on: ubuntu-latest
+    name: PHP 7.4 Test
+    steps:
+    - name: Checkout
+      uses: actions/checkout@v2
+
+    - name: Setup PHP
+      uses: shivammathur/setup-php@v2
+      with:
+        php-version: 7.4
+```
+
+Run the workflow locally with `act` using [`shivammathur/node`](https://github.com/shivammathur/node-docker "Docker image to run setup-php") docker images.
+
+```bash
+# For runs-on: ubuntu-latest
+act -P ubuntu-latest=shivammathur/node:latest
+
+# For runs-on: ubuntu-20.04
+act -P ubuntu-20.04=shivammathur/node:focal
+
+# For runs-on: ubuntu-18.04
+act -P ubuntu-18.04=shivammathur/node:bionic
+
+# For runs-on: ubuntu-16.04
+act -P ubuntu-16.04=shivammathur/node:xenial
+```
+
+### JIT Configuration
+
+> Enable Just-in-time(JIT) on PHP 8.0 and PHP 8.1.
+
+- To enable JIT, enable `opcache` in cli mode by setting `opcache.enable_cli=1`.
+- By default, `opcache.jit=1235` and `opcache.jit_buffer_size=256M` are set which can be changed using `ini-values` input.
+- For detailed information about JIT related directives refer to the [`official PHP documentation`](https://www.php.net/manual/en/opcache.configuration.php#ini.opcache.jit "opcache.jit documentation").
+
+For example to enable JIT in `tracing` mode with buffer size of `64 MB`. 
+
+```yaml
+- name: Setup PHP with JIT in tracing mode
+  uses: shivammathur/setup-php@v2
+  with:
+    php-version: '8.0'
+    ini-values: opcache.enable_cli=1, opcache.jit=tracing, opcache.jit_buffer_size=64M
+```
+
+### Cache Extensions
+
+You can cache PHP extensions using `shivammathur/cache-extensions` and `action/cache` GitHub Actions. Extensions which take very long to set up when cached are available in the next workflow run and are enabled directly. This reduces the workflow execution time.  
+Refer to [`shivammathur/cache-extensions`](https://github.com/shivammathur/cache-extensions "GitHub Action to cache php extensions") for details.
+
+### Cache Composer Dependencies
+
+If your project uses composer, you can persist the composer's internal cache directory. Dependencies cached are loaded directly instead of downloading them while installation. The files cached are available across check-runs and will reduce the workflow execution time.
+
+```yaml
+- name: Get composer cache directory
   id: composer-cache
   run: echo "::set-output name=dir::$(composer config cache-files-dir)"
 
-- name: Cache dependencies  
-  uses: actions/cache@v1
+- name: Cache dependencies
+  uses: actions/cache@v2
   with:
     path: ${{ steps.composer-cache.outputs.dir }}
     key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
     restore-keys: ${{ runner.os }}-composer-
 
-- name: Install Dependencies
+- name: Install dependencies
   run: composer install --prefer-dist
 ```
 
+**Notes**
+- Please do not cache `vendor` directory using `action/cache` as that will have side effects.
+- If you do not commit `composer.lock`, you can use the hash of `composer.json` as the key for your cache.
+```yaml
+key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.json') }}
+```
+
+- If you support a range of `composer` dependencies and use `prefer-lowest` and `prefer-stable` options, you can store them in your matrix and add them to the keys.
+```yaml
+key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}-${{ matrix.prefer }}-
+restore-keys: ${{ runner.os }}-composer-${{ matrix.prefer }}-
+```
+
+### Cache Node.js Dependencies
+
+If your project has node.js dependencies, you can persist NPM or yarn cache directory. The cached files are available across check-runs and will reduce the workflow execution time.
+
+```yaml
+- name: Get node.js cache directory
+  id: node-cache-dir
+  run: echo "::set-output name=dir::$(npm config get cache)" # Use $(yarn cache dir) for yarn
+
+- name: Cache dependencies
+  uses: actions/cache@v2
+  with:
+    path: ${{ steps.node-cache-dir.outputs.dir }}
+    key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }} # Use '**/yarn.lock' for yarn
+    restore-keys: ${{ runner.os }}-node-
+```
+
+**Note:** Please do not cache `node_modules` directory as that will have side effects.
+
+### Composer GitHub OAuth
+
+If you have a number of workflows which setup multiple tools or have many composer dependencies, you might hit the GitHub's rate limit for composer. To avoid that you can add an `OAuth` token to the composer's config by setting `COMPOSER_TOKEN` environment variable. You can use [`GITHUB_TOKEN`](https://help.github.com/en/actions/configuring-and-managing-workflows/authenticating-with-the-github_token "GITHUB_TOKEN documentation") secret for this purpose.
+
+```yaml
+- name: Setup PHP
+  uses: shivammathur/setup-php@v2
+  with:
+    php-version: '7.4'
+  env:
+    COMPOSER_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+```
+
+### Problem Matchers
+
+Problem matchers are `json` configurations which identify errors and warnings in your logs and surface them prominently in the GitHub Actions UI by highlighting them and creating code annotations.
+
+#### PHP
+
+Setup problem matchers for your `PHP` output by adding this step after the `setup-php` step.
+
+```yaml
+- name: Setup problem matchers for PHP
+  run: echo "::add-matcher::${{ runner.tool_cache }}/php.json"
+```
+
+#### PHPUnit
+
+Setup problem matchers for your `PHPUnit` output by adding this step after the `setup-php` step.
+
+```yaml
+- name: Setup problem matchers for PHPUnit
+  run: echo "::add-matcher::${{ runner.tool_cache }}/phpunit.json"
+```
+
+#### PHPStan
+
+PHPStan supports error reporting in GitHub Actions, so it does not require problem matchers.
+
+```yaml
+- name: Setup PHP
+  uses: shivammathur/setup-php@v2
+  with:
+    php-version: '7.4'
+    tools: phpstan
+
+- name: Run PHPStan
+  run: phpstan analyse src
+```
+
+#### Psalm
+
+Psalm supports error reporting in GitHub Actions with an output format `github`.
+
+```yaml
+- name: Setup PHP
+  uses: shivammathur/setup-php@v2
+  with:
+    php-version: '7.4'
+    tools: psalm
+
+- name: Run Psalm
+  run: psalm --output-format=github
+```
+
+#### Tools with checkstyle support
+
+For tools that support `checkstyle` reporting like `phpstan`, `psalm`, `php-cs-fixer` and `phpcs` you can use `cs2pr` to annotate your code.  
+For examples refer to [cs2pr documentation](https://github.com/staabm/annotate-pull-request-from-checkstyle).   
+
+> Here is an example with `phpcs`.
+
+```yaml
+- name: Setup PHP
+  uses: shivammathur/setup-php@v2
+  with:
+    php-version: '7.4'
+    tools: cs2pr, phpcs
+
+- name: Run phpcs
+  run: phpcs -q --report=checkstyle src | cs2pr
+```
+
 ### Examples
 
-Examples for setting up this GitHub Action with different PHP Frameworks/Packages.
+Examples of using `setup-php` with various PHP Frameworks and Packages.
 
 |Framework/Package|Runs on|Workflow|
 |--- |--- |--- |
+|Blackfire|`macOS`, `ubuntu` and `windows`|[blackfire.yml](./examples/blackfire.yml "GitHub Action using Blackfire")|
+|Blackfire Player|`macOS`, `ubuntu` and `windows`|[blackfire-player.yml](./examples/blackfire-player.yml "GitHub Action using Blackfire Player")|
+|CakePHP with `MySQL` and `Redis`|`ubuntu`|[cakephp-mysql.yml](./examples/cakephp-mysql.yml "GitHub Action for CakePHP with MySQL and Redis")|
+|CakePHP with `PostgreSQL` and `Redis`|`ubuntu`|[cakephp-postgres.yml](./examples/cakephp-postgres.yml "GitHub Action for CakePHP with Postgres and Redis")|
+|CakePHP without services|`macOS`, `ubuntu` and `windows`|[cakephp.yml](./examples/cakephp.yml "GitHub Action for CakePHP without services")|
 |CodeIgniter|`macOS`, `ubuntu` and `windows`|[codeigniter.yml](./examples/codeigniter.yml "GitHub Action for CodeIgniter")|
 |Laravel with `MySQL` and `Redis`|`ubuntu`|[laravel-mysql.yml](./examples/laravel-mysql.yml "GitHub Action for Laravel with MySQL and Redis")|
 |Laravel with `PostgreSQL` and `Redis`|`ubuntu`|[laravel-postgres.yml](./examples/laravel-postgres.yml "GitHub Action for Laravel with PostgreSQL and Redis")|
@@ -227,29 +799,81 @@ Examples for setting up this GitHub Action with different PHP Frameworks/Package
 |Yii2 Starter Kit with `PostgreSQL`|`ubuntu`|[yii2-postgres.yml](./examples/yii2-postgres.yml "GitHub Action for Yii2 Starter Kit with PostgreSQL")|
 |Zend Framework|`macOS`, `ubuntu` and `windows`|[zend-framework.yml](./examples/zend-framework.yml "GitHub Action for Zend Framework")|
 
+## :bookmark: Versioning
+
+- Use the `v2` tag as `setup-php` version. It is a rolling tag and is synced with the latest minor and patch releases. With `v2` you automatically get the bug fixes, new features and support for latest PHP releases. For debugging any issues `verbose` tag can be used temporarily. It outputs all the logs and is also synced with the latest releases.
+- Semantic release versions can also be used. It is recommended to [use dependabot](https://docs.github.com/en/github/administering-a-repository/keeping-your-actions-up-to-date-with-github-dependabot "Setup Dependabot with GitHub Actions") with semantic versioning to keep the actions in your workflows up to date.
+- Commit SHA can also be used, but are not recommended. They have to be updated with every release manually, without which you will not get any bug fixes or new features. 
+- It is highly discouraged to use the `master` branch as version, it might break your workflow after major releases as they have breaking changes.
+- If you are using the `v1` tag or a `1.x.y` version, you should [switch to v2](https://github.com/shivammathur/setup-php/wiki/Switch-to-v2 "Guide for switching from setup-php v1 to v2") as `v1` only gets critical bug fixes. Maintenance support for `v1` will be dropped with the last `PHP 8.0` release.
+
 ## :scroll: License
 
-The scripts and documentation in this project are released under the [MIT License](LICENSE "License for shivammathur/setup-php"). This project has multiple [dependencies](https://github.com/shivammathur/setup-php/network/dependencies "Dependencies for this PHP Action") and uses [various works](#bookmark-this-action-uses-the-following-works "Tools used by this action"). Their licenses can be found in their respective repositories.
+- The scripts and documentation in this project are under the [MIT License](LICENSE "License for shivammathur/setup-php"). 
+- This project has multiple [dependencies](#package-dependencies "Dependencies for this PHP Action"). Their licenses can be found in their respective repositories.
+- The logo for `setup-php` is a derivative work of [php.net logo](https://www.php.net/download-logos.php) and is licensed under the [CC BY-SA 4.0 License](https://creativecommons.org/licenses/by-sa/4.0/ "Creative Commons License").
 
 ## :+1: Contributions
 
-Contributions are welcome! See [Contributor's Guide](.github/CONTRIBUTING.md "shivammathur/setup-php contribution guide"). If you face any issues while using this or want to suggest a feature/improvement, create an issue [here](https://github.com/shivammathur/setup-php/issues "Issues reported").
+> Contributions are welcome!
 
-## :sparkling_heart: Support this project
+- See [Contributor's Guide](.github/CONTRIBUTING.md "shivammathur/setup-php contribution guide") before you start.
+- If you face any issues or want to suggest a feature/improvement, start a discussion [here](https://github.com/shivammathur/setup-php/discussions "Setup PHP discussions").
 
-If this action helped you.
+*Join the list of setup-php contributors*
 
-- Please star the project and share it, this helps reach more people.
-- If you blog, write about your experience using this.
-- Support this project on <a href="https://www.patreon.com/shivammathur"><img alt="Patreon" src="https://shivammathur.com/badges/patreon.svg"></a> or using <a href="https://www.paypal.me/shivammathur"><img alt="Paypal" src="https://shivammathur.com/badges/paypal.svg"></a>.
-- If you need any help using this, reach out here <a href="https://www.codementor.io/shivammathur?utm_source=github&utm_medium=button&utm_term=shivammathur&utm_campaign=github" title="Contact Shivam Mathur on Codementor"><img alt="Contact me on Codementor" src="https://cdn.codementor.io/badges/contact_me_github.svg"></a>
+<p align="center">
+  <a href="https://github.com/shivammathur/setup-php/graphs/contributors">
+    <img src="https://opencollective.com/setup-php/contributors.svg?width=1024&button=false" alt="setup-php contributors" width="100%">
+  </a>
+</p>
 
-## :bookmark: This action uses the following works
+## :sparkling_heart: Support This Project
 
-- [powershell-phpmanager](https://github.com/mlocati/powershell-phpmanager "Package to handle PHP on windows")
-- [Homebrew](https://brew.sh/ "MacOS package manager")
-- [ppa:ondrej/php](https://launchpad.net/~ondrej/+archive/ubuntu/php "Pre-compiled ubuntu packages")
-- [exolnet/homebrew-deprecated](https://github.com/eXolnet/homebrew-deprecated "Pre-compiled deprecated PHP for macOS")
+- If setup-php saved your developer time, please consider sponsoring setup-php:
+  - [Open Collective](https://opencollective.com/setup-php "setup-php Open Collective")
+  - [Paypal](https://www.paypal.me/shivammathur "Shivam Mathur PayPal")
+  - [Patreon](https://www.patreon.com/shivammathur "Shivam Mathur Patreon")
+- Please [reach out](mailto:contact@setup-php.com) if you have any questions regarding sponsoring setup-php.
+- Please star the project and share it. If you blog, please share your experience of using this action.
+
+*Huge thanks to the following companies for supporting `setup-php`*
+
+<p>
+  <a href="https://www.jetbrains.com/?from=setup-php">
+    <img src="https://setup-php.com/sponsors/jetbrains.svg" alt="JetBrains" width="106" height="60">
+  </a>
+  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+  <a href="https://blackfire.io/?utm_source=setup-php">
+    <img src="https://setup-php.com/sponsors//blackfire.svg" alt="Blackfire" width="212" height="60">
+  </a>
+  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+  <a href="https://www.macstadium.com/?source=setup-php">
+    <img src="https://setup-php.com/sponsors//macstadium.png" alt="Mac Stadium" width="148" height="60">
+  </a>
+  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+  <a href="https://tidelift.com/subscription/pkg/npm-setup-php">
+    <img src="https://setup-php.com/sponsors//tidelift.png" alt="Tidelift" width="70" height="60">
+  </a>  
+</p>
+
+## :package: Dependencies
+
+- [Node.js dependencies](https://github.com/shivammathur/setup-php/network/dependencies "Node.js dependencies")
+- [aaronparker/VcRedist](https://github.com/aaronparker/VcRedist "VcRedist PowerShell package")
+- [gplessis/dotdeb-php](https://github.com/gplessis/dotdeb-php "Packaging for end of life PHP versions")
+- [mlocati/powershell-phpmanager](https://github.com/mlocati/powershell-phpmanager "Package to handle PHP on windows")
+- [ppa:ondrej/php](https://launchpad.net/~ondrej/+archive/ubuntu/php "Packaging active PHP packages")
+- [shivammathur/cache-extensions](https://github.com/shivammathur/cache-extensions "GitHub action to help with caching PHP extensions")
+- [shivammathur/composer-cache](https://github.com/shivammathur/composer-cache "Cache composer releases")
+- [shivammathur/homebrew-extensions](https://github.com/shivammathur/homebrew-extensions "Tap for PHP extensions on MacOS")
+- [shivammathur/homebrew-php](https://github.com/shivammathur/homebrew-php "Tap for PHP builds on MacOS")
+- [shivammathur/icu-intl](https://github.com/shivammathur/icu-intl "icu4c and php-intl builds")
+- [shivammathur/php-builder](https://github.com/shivammathur/php-builder "Nightly PHP package for Ubuntu")
+- [shivammathur/php-builder-windows](https://github.com/shivammathur/php-builder-windows "Nightly PHP package for Windows")
+- [shivammathur/php-ubuntu](https://github.com/shivammathur/php-ubuntu "Cache stable PHP Packages for Ubuntu")
+- [shivammathur/php5-darwin](https://github.com/shivammathur/php5-darwin "Scripts to setup PHP5 versions on darwin")
+- [shivammathur/php5-ubuntu](https://github.com/shivammathur/php5-ubuntu "Scripts to setup PHP5 versions on ubuntu")
 
 ## :bookmark_tabs: Further Reading
 

__tests__/config.test.ts

@@ -7,14 +7,14 @@ describe('Config tests', () => {
       'win32'
     );
     expect(win32).toContain(
-      'Add-Content C:\\tools\\php\\php.ini "post_max_size=256M\nshort_open_tag=On\ndate.timezone=Asia/Kolkata"'
+      'Add-Content "$php_dir\\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'
+      'openbsd'
     );
-    expect(win32).toContain('Platform fedora is not supported');
+    expect(win32).toContain('Platform openbsd is not supported');
   });
 
   it('checking addINIValuesOnLinux', async () => {
@@ -24,14 +24,14 @@ describe('Config tests', () => {
       true
     );
     expect(linux).toContain(
-      'echo "post_max_size=256M\nshort_open_tag=On\ndate.timezone=Asia/Kolkata"'
+      'echo "post_max_size=256M\nshort_open_tag=On\ndate.timezone=Asia/Kolkata" | sudo tee -a "${pecl_file:-${ini_file[@]}}"'
     );
 
     linux = await config.addINIValues(
       'post_max_size=256M, short_open_tag=On, date.timezone=Asia/Kolkata',
-      'fedora'
+      'openbsd'
     );
-    expect(linux).toContain('Platform fedora is not supported');
+    expect(linux).toContain('Platform openbsd is not supported');
   });
 
   it('checking addINIValuesOnDarwin', async () => {
@@ -40,13 +40,13 @@ describe('Config tests', () => {
       'darwin'
     );
     expect(darwin).toContain(
-      'echo "post_max_size=256M\nshort_open_tag=On\ndate.timezone=Asia/Kolkata"'
+      'echo "post_max_size=256M\nshort_open_tag=On\ndate.timezone=Asia/Kolkata" | sudo tee -a "${pecl_file:-${ini_file[@]}}"'
     );
 
     darwin = await config.addINIValues(
       'post_max_size=256M, short_open_tag=On, date.timezone=Asia/Kolkata',
-      'fedora'
+      'openbsd'
     );
-    expect(darwin).toContain('Platform fedora is not supported');
+    expect(darwin).toContain('Platform openbsd is not supported');
   });
 });

__tests__/coverage.test.ts

@@ -1,18 +1,10 @@
 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'
-    );
+    let win32: string = await coverage.addCoverage('PCOV', '7.4', 'win32');
+    expect(win32).toContain('Add-Extension pcov');
+    expect(win32).toContain('Remove-Extension xdebug');
 
     win32 = await coverage.addCoverage('pcov', '7.0', 'win32');
     expect(win32).toContain('PHP 7.1 or newer is required');
@@ -23,24 +15,44 @@ describe('Config tests', () => {
 
   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');
+    expect(linux).toContain('add_extension pcov');
+    expect(linux).toContain('remove_extension xdebug');
   });
 
   it('checking addCoverage with PCOV on darwin', async () => {
     const darwin: string = await coverage.addCoverage('pcov', '7.4', 'darwin');
-    expect(darwin).toContain('addExtension pcov');
+    expect(darwin).toContain('add_brew_extension pcov');
+    expect(darwin).toContain('remove_extension xdebug');
   });
 
   it('checking addCoverage with Xdebug on windows', async () => {
-    const win32: string = await coverage.addCoverage('xdebug', '7.3', 'win32');
-    expect(win32).toContain('addExtension xdebug');
+    const win32: string = await coverage.addCoverage('xdebug', '7.4', 'win32');
+    expect(win32).toContain('Add-Extension xdebug');
+  });
+
+  it('checking addCoverage with Xdebug3 on windows', async () => {
+    const win32: string = await coverage.addCoverage('xdebug3', '7.4', 'win32');
+    expect(win32).toContain('Add-Extension xdebug');
+  });
+
+  it('checking addCoverage with Xdebug2 on windows', async () => {
+    const win32: string = await coverage.addCoverage('xdebug2', '7.4', 'win32');
+    expect(win32).toContain('Add-Extension xdebug stable 2.9.8');
   });
 
   it('checking addCoverage with Xdebug on linux', async () => {
-    const linux: string = await coverage.addCoverage('xdebug', '7.4', 'linux');
-    expect(linux).toContain('addExtension xdebug');
+    const linux: string = await coverage.addCoverage('xdebug', '8.0', 'linux');
+    expect(linux).toContain('add_extension xdebug');
+  });
+
+  it('checking addCoverage with Xdebug3 on linux', async () => {
+    const linux: string = await coverage.addCoverage('xdebug3', '8.0', 'linux');
+    expect(linux).toContain('add_extension xdebug');
+  });
+
+  it('checking addCoverage with Xdebug2 on linux', async () => {
+    const linux: string = await coverage.addCoverage('xdebug2', '7.4', 'linux');
+    expect(linux).toContain('add_pecl_extension xdebug 2.9.8 zend_extension');
   });
 
   it('checking addCoverage with Xdebug on darwin', async () => {
@@ -49,27 +61,43 @@ describe('Config tests', () => {
       '7.4',
       'darwin'
     );
-    expect(darwin).toContain('addExtension xdebug');
+    expect(darwin).toContain('add_brew_extension xdebug');
+  });
+
+  it('checking addCoverage with Xdebug3 on darwin', async () => {
+    const darwin: string = await coverage.addCoverage(
+      'xdebug3',
+      '7.4',
+      'darwin'
+    );
+    expect(darwin).toContain('add_brew_extension xdebug');
+  });
+
+  it('checking addCoverage with Xdebug2 on darwin', async () => {
+    const darwin: string = await coverage.addCoverage(
+      'xdebug2',
+      '7.4',
+      'darwin'
+    );
+    expect(darwin).toContain('add_brew_extension xdebug2');
   });
 
   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');
+    expect(win32).toContain('Remove-Extension xdebug');
+    expect(win32).toContain('Remove-Extension 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');
+    expect(linux).toContain('remove_extension xdebug');
+    expect(linux).toContain('remove_extension pcov');
   });
 
   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');
+    expect(darwin).toContain('remove_extension xdebug');
+    expect(darwin).toContain('remove_extension pcov');
   });
 
   it('checking no or invalid coverage driver', async () => {

__tests__/extensions.test.ts

@@ -3,85 +3,212 @@ import * as extensions from '../src/extensions';
 describe('Extension tests', () => {
   it('checking addExtensionOnWindows', async () => {
     let win32: string = await extensions.addExtension(
-      'xdebug, pcov, redis',
+      'Xdebug, pcov, sqlite, :intl, phalcon4, ioncube, oci8, pdo_oci, ast-beta, grpc-1.2.3, inotify-1.2.3alpha2, sqlsrv-1.2.3preview1',
       '7.4',
       'win32'
     );
     expect(win32).toContain('Add-Extension xdebug');
     expect(win32).toContain('Add-Extension pcov');
-    expect(win32).toContain('Add-Extension redis beta');
+    expect(win32).toContain('Add-Extension sqlite3');
+    expect(win32).toContain('Remove-Extension intl');
+    expect(win32).toContain('Add-Phalcon phalcon4');
+    expect(win32).toContain('Add-Ioncube');
+    expect(win32).toContain('Add-Oci oci8');
+    expect(win32).toContain('Add-Oci pdo_oci');
+    expect(win32).toContain('Add-Extension ast beta');
+    expect(win32).toContain('Add-Extension grpc stable 1.2.3');
+    expect(win32).toContain('Add-Extension inotify alpha 1.2.3');
+    expect(win32).toContain('Add-Extension sqlsrv devel 1.2.3');
+
+    win32 = await extensions.addExtension('pcov', '5.6', 'win32');
+    expect(win32).toContain(
+      'Add-Log "$cross" "pcov" "pcov is not supported on PHP 5.6"'
+    );
+
+    win32 = await extensions.addExtension('xdebug2', '7.2', 'win32');
+    expect(win32).toContain('Add-Extension xdebug stable 2.9.8');
+
+    win32 = await extensions.addExtension('mysql', '7.4', 'win32');
+    expect(win32).toContain('Add-Extension mysqli');
+    expect(win32).toContain('Add-Extension mysqlnd');
+
+    win32 = await extensions.addExtension('mysql', '8.0', 'win32');
+    expect(win32).toContain('Add-Extension mysqli');
+    expect(win32).toContain('Add-Extension mysqlnd');
+
+    win32 = await extensions.addExtension('mysql', '5.5', 'win32');
+    expect(win32).toContain('Add-Extension mysql');
+    expect(win32).toContain('Add-Extension mysqli');
+    expect(win32).toContain('Add-Extension mysqlnd');
 
     win32 = await extensions.addExtension(
-      'does_not_exist',
+      'phalcon3, does_not_exist',
       '7.2',
       'win32',
       true
     );
+    expect(win32).toContain('Add-Phalcon phalcon3');
     expect(win32).toContain('Add-Extension does_not_exist');
 
-    win32 = await extensions.addExtension('xdebug', '7.2', 'fedora');
-    expect(win32).toContain('Platform fedora is not supported');
+    win32 = await extensions.addExtension('xdebug', '7.2', 'openbsd');
+    expect(win32).toContain('Platform openbsd is not supported');
+
+    win32 = await extensions.addExtension('blackfire', '7.3', 'win32');
+    expect(win32).toContain('Add-Blackfire blackfire');
+
+    win32 = await extensions.addExtension('blackfire-1.31.0', '7.3', 'win32');
+    expect(win32).toContain('Add-Blackfire blackfire-1.31.0');
   });
 
   it('checking addExtensionOnLinux', async () => {
     let linux: string = await extensions.addExtension(
-      'xdebug, pcov, redis',
+      'Xdebug, pcov, sqlite, :intl, ast, ast-beta, pdo_mysql, pdo-odbc, xdebug-alpha, grpc-1.2.3',
       '7.4',
       'linux'
     );
+    expect(linux).toContain('add_extension xdebug');
+    expect(linux).toContain('add_extension sqlite3');
+    expect(linux).toContain('remove_extension intl');
+    expect(linux).toContain('add_unstable_extension ast beta extension');
+    expect(linux).toContain('add_pdo_extension mysql');
+    expect(linux).toContain('add_pdo_extension odbc');
+    expect(linux).toContain('add_pecl_extension grpc 1.2.3 extension');
     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'
+      'add_unstable_extension xdebug alpha zend_extension'
     );
 
-    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');
+    linux = await extensions.addExtension('pcov', '5.6', 'linux');
+    expect(linux).toContain(
+      'add_log "$cross" "pcov" "pcov is not supported on PHP 5.6"'
+    );
+
+    linux = await extensions.addExtension('gearman', '5.6', 'linux');
+    expect(linux).toContain('add_gearman');
+    linux = await extensions.addExtension('gearman', '7.4', 'linux');
+    expect(linux).toContain('add_gearman');
+
+    linux = await extensions.addExtension('couchbase', '5.6', 'linux');
+    expect(linux).toContain('add_couchbase');
+    linux = await extensions.addExtension('couchbase', '7.4', 'linux');
+    expect(linux).toContain('add_couchbase');
+
+    linux = await extensions.addExtension('pdo_cubrid', '7.0', 'linux');
+    expect(linux).toContain('add_cubrid pdo_cubrid');
+    linux = await extensions.addExtension('cubrid', '7.4', 'linux');
+    expect(linux).toContain('add_cubrid cubrid');
+
+    linux = await extensions.addExtension('xdebug2', '7.2', 'linux');
+    expect(linux).toContain('add_pecl_extension xdebug 2.9.8 zend_extension');
+
+    linux = await extensions.addExtension('xdebug', '7.2', 'openbsd');
+    expect(linux).toContain('Platform openbsd is not supported');
 
     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');
+    expect(linux).toContain('add_phalcon phalcon3');
+    expect(linux).toContain('add_phalcon phalcon4');
 
-    linux = await extensions.addExtension('phalcon4', '7.4', 'linux');
-    expect(linux).toContain('phalcon.sh 4.0.x 7.4');
+    linux = await extensions.addExtension('ioncube', '7.3', 'linux');
+    expect(linux).toContain('add_ioncube');
 
-    linux = await extensions.addExtension('xdebug', '7.2', 'fedora');
-    expect(linux).toContain('Platform fedora is not supported');
+    linux = await extensions.addExtension('geos', '7.3', 'linux');
+    expect(linux).toContain('add_geos');
+
+    linux = await extensions.addExtension('oci8, pdo_oci', '7.3', 'linux');
+    expect(linux).toContain('add_oci oci8');
+    expect(linux).toContain('add_oci pdo_oci');
+
+    linux = await extensions.addExtension('blackfire', '7.3', 'linux');
+    expect(linux).toContain('add_blackfire blackfire');
+
+    linux = await extensions.addExtension('blackfire-1.31.0', '7.3', 'linux');
+    expect(linux).toContain('add_blackfire blackfire-1.31.0');
+
+    linux = await extensions.addExtension('intl-65.1', '5.6', 'linux');
+    expect(linux).toContain('add_intl intl-65.1');
+
+    linux = await extensions.addExtension('intl-67.1', '7.3', 'linux');
+    expect(linux).toContain('add_intl intl-67.1');
+
+    linux = await extensions.addExtension('intl-68.2', '8.0', 'linux');
+    expect(linux).toContain('add_intl intl-68.2');
   });
 
   it('checking addExtensionOnDarwin', async () => {
     let darwin: string = await extensions.addExtension(
-      'xdebug, pcov',
+      'amqp, Xdebug, pcov, grpc, igbinary, imagick, imap, protobuf, swoole, sqlite, oci8, pdo_oci, :intl, ast-beta, grpc-1.2.3',
       '7.2',
       'darwin'
     );
-    expect(darwin).toContain('sudo pecl install xdebug');
-    expect(darwin).toContain('sudo pecl install pcov');
+    expect(darwin).toContain('add_brew_extension amqp extension');
+    expect(darwin).toContain('add_brew_extension xdebug zend_extension');
+    expect(darwin).toContain('add_brew_extension pcov extension');
+    expect(darwin).toContain('add_brew_extension grpc extension');
+    expect(darwin).toContain('add_brew_extension igbinary extension');
+    expect(darwin).toContain('add_brew_extension imagick extension');
+    expect(darwin).toContain('add_brew_extension imap extension');
+    expect(darwin).toContain('add_brew_extension protobuf extension');
+    expect(darwin).toContain('add_brew_extension swoole extension');
+    expect(darwin).toContain('add_extension sqlite3');
+    expect(darwin).toContain('remove_extension intl');
+    expect(darwin).toContain('add_unstable_extension ast beta extension');
+    expect(darwin).toContain('add_pecl_extension grpc 1.2.3 extension');
+
+    darwin = await extensions.addExtension('phalcon3', '7.0', 'darwin');
+    expect(darwin).toContain('add_phalcon phalcon3');
+
+    darwin = await extensions.addExtension('phalcon4', '7.3', 'darwin');
+    expect(darwin).toContain('add_phalcon phalcon4');
+
+    darwin = await extensions.addExtension('couchbase', '5.6', 'darwin');
+    expect(darwin).toContain('add_couchbase');
+
+    darwin = await extensions.addExtension('couchbase', '7.3', 'darwin');
+    expect(darwin).toContain('add_couchbase');
+
+    darwin = await extensions.addExtension('ioncube', '7.3', 'darwin');
+    expect(darwin).toContain('add_ioncube');
+
+    darwin = await extensions.addExtension('geos', '7.3', 'darwin');
+    expect(darwin).toContain('add_geos');
+
+    darwin = await extensions.addExtension('oci8, pdo_oci', '7.3', 'darwin');
+    expect(darwin).toContain('add_oci oci8');
+    expect(darwin).toContain('add_oci pdo_oci');
 
     darwin = await extensions.addExtension('pcov', '5.6', 'darwin');
-    expect(darwin).toContain('sudo pecl install pcov');
+    expect(darwin).toContain(
+      'add_log "$cross" "pcov" "pcov is not supported on PHP 5.6"'
+    );
 
     darwin = await extensions.addExtension('pcov', '7.2', 'darwin');
-    expect(darwin).toContain('sudo pecl install pcov');
+    expect(darwin).toContain('add_brew_extension pcov');
 
     darwin = await extensions.addExtension('xdebug', '5.6', 'darwin');
-    expect(darwin).toContain('sudo pecl install xdebug-2.5.5');
+    expect(darwin).toContain('add_brew_extension xdebug');
+
+    darwin = await extensions.addExtension('xdebug', '7.0', 'darwin');
+    expect(darwin).toContain('add_brew_extension xdebug');
 
     darwin = await extensions.addExtension('xdebug', '7.2', 'darwin');
-    expect(darwin).toContain('sudo pecl install xdebug');
+    expect(darwin).toContain('add_brew_extension xdebug');
+
+    darwin = await extensions.addExtension('xdebug2', '7.2', 'darwin');
+    expect(darwin).toContain('add_brew_extension xdebug2');
 
     darwin = await extensions.addExtension('redis', '5.6', 'darwin');
-    expect(darwin).toContain('sudo pecl install redis-2.2.8');
+    expect(darwin).toContain('add_extension redis-2.2.8');
 
     darwin = await extensions.addExtension('redis', '7.2', 'darwin');
-    expect(darwin).toContain('sudo pecl install redis');
+    expect(darwin).toContain('add_extension redis');
+
+    darwin = await extensions.addExtension('imagick', '5.5', 'darwin');
+    expect(darwin).toContain('add_extension imagick');
+
+    darwin = await extensions.addExtension('blackfire', '7.3', 'darwin');
+    expect(darwin).toContain('add_blackfire blackfire');
+
+    darwin = await extensions.addExtension('blackfire-1.31.0', '7.3', 'darwin');
+    expect(darwin).toContain('add_blackfire blackfire-1.31.0');
 
     darwin = await extensions.addExtension(
       'does_not_exist',
@@ -91,7 +218,7 @@ describe('Extension tests', () => {
     );
     expect(darwin).toContain('add_extension does_not_exist');
 
-    darwin = await extensions.addExtension('xdebug', '7.2', 'fedora');
-    expect(darwin).toContain('Platform fedora is not supported');
+    darwin = await extensions.addExtension('xdebug', '7.2', 'openbsd');
+    expect(darwin).toContain('Platform openbsd is not supported');
   });
 });

__tests__/install.test.ts

@@ -1,29 +1,38 @@
 import * as install from '../src/install';
+import * as utils from '../src/utils';
 
 /**
  * Mock install.ts
  */
 jest.mock('../src/install', () => ({
-  build: jest.fn().mockImplementation(
+  getScript: 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'] || '';
+      const extension_csv: string = process.env['extensions'] || '';
+      const ini_values_csv: string = process.env['ini-values'] || '';
       const coverage_driver: string = process.env['coverage'] || '';
+      let tools_csv: string = process.env['tools'] || '';
+      const pecl: string = process.env['pecl'] || '';
+      if (pecl == 'true') {
+        tools_csv = 'pecl, ' + tools_csv;
+      }
 
       let script = 'initial script ' + filename + version + os_version;
+      if (tools_csv) {
+        script += 'add_tool';
+      }
       if (extension_csv) {
         script += 'install extensions';
       }
-      if (ini_values_csv) {
-        script += 'edit php.ini';
-      }
       if (coverage_driver) {
         script += 'set coverage driver';
       }
+      if (ini_values_csv) {
+        script += 'edit php.ini';
+      }
 
       return script;
     }
@@ -31,29 +40,18 @@ jest.mock('../src/install', () => ({
   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;
+      const version: string = await utils.parseVersion(
+        await utils.getInput('php-version', true)
+      );
+      const tool = await utils.scriptTool(os_version);
+      const filename = os_version + (await utils.scriptExtension(os_version));
+      return [
+        await install.getScript(filename, version, os_version),
+        tool,
+        filename,
+        version,
+        __dirname
+      ].join(' ');
     }
   )
 }));
@@ -66,81 +64,112 @@ jest.mock('../src/install', () => ({
  * @param extension_csv
  * @param ini_values_csv
  * @param coverage_driver
+ * @param tools
  */
 function setEnv(
-  version: string,
+  version: string | number,
   os: string,
   extension_csv: string,
   ini_values_csv: string,
   coverage_driver: string,
-  pecl: string
+  tools: string
 ): void {
-  process.env['php-version'] = version;
+  process.env['php-version'] = version.toString();
   process.env['RUNNER_OS'] = os;
-  process.env['extension-csv'] = extension_csv;
-  process.env['ini-values-csv'] = ini_values_csv;
+  process.env['extensions'] = extension_csv;
+  process.env['ini-values'] = ini_values_csv;
   process.env['coverage'] = coverage_driver;
-  process.env['pecl'] = pecl;
+  process.env['tools'] = tools;
 }
 
 describe('Install', () => {
   it('Test install on windows', async () => {
-    setEnv('7.3', 'win32', '', '', '', '');
-    // @ts-ignore
-    let script: string = await install.run();
+    setEnv('7.0', 'win32', '', '', '', '');
+
+    let script: string = '' + (await install.run());
     expect(script).toContain('initial script');
-    expect(script).toContain('pwsh script.ps1 -version 7.3 -dir ' + __dirname);
+    expect(script).toContain('pwsh win32.ps1 7.0 ' + __dirname);
+
+    setEnv('7.3', 'win32', '', '', '', '');
+
+    script = '' + (await install.run());
+    expect(script).toContain('initial script');
+    expect(script).toContain('pwsh win32.ps1 7.3 ' + __dirname);
 
     setEnv('7.3', 'win32', 'a, b', 'a=b', 'x', '');
-    // @ts-ignore
-    script = await install.run();
+
+    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);
+    expect(script).toContain('pwsh win32.ps1 7.3 ' + __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();
+    let script: string = '' + (await install.run());
+    expect(script).toContain('initial script');
+    expect(script).toContain('bash linux.sh 7.3 ');
+
+    setEnv('latest', 'linux', '', '', '', '');
+
+    script = '' + (await install.run());
+    expect(script).toContain('initial script');
+    expect(script).toContain('bash linux.sh 8.0 ');
+
+    setEnv('7.3', 'linux', 'a, b', 'a=b', 'x', 'phpunit');
+
+    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');
+    expect(script).toContain('bash linux.sh 7.3');
+    expect(script).toContain('add_tool');
   });
 
   it('Test install on darwin', async () => {
     setEnv('7.3', 'darwin', '', '', '', '');
-    // @ts-ignore
-    let script: string = await install.run();
+
+    let script: string = '' + (await install.run());
     expect(script).toContain('initial script');
-    expect(script).toContain('sh script.sh 7.3 ' + __dirname);
+    expect(script).toContain('bash darwin.sh 7.3 ' + __dirname);
 
     setEnv('7.3', 'darwin', 'a, b', 'a=b', 'x', '');
-    // @ts-ignore
-    script = await install.run();
+
+    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);
+    expect(script).toContain('bash darwin.sh 7.3 ' + __dirname);
+  });
+
+  it('Test malformed version inputs', async () => {
+    setEnv('7.4.1', 'darwin', '', '', '', '');
+
+    let script: string = '' + '' + (await install.run());
+    expect(script).toContain('initial script');
+    expect(script).toContain('bash darwin.sh 7.4 ' + __dirname);
+
+    setEnv(8.0, 'darwin', '', '', '', '');
+
+    script = '' + (await install.run());
+    expect(script).toContain('initial script');
+    expect(script).toContain('bash darwin.sh 8.0 ' + __dirname);
+
+    setEnv(8, 'darwin', '', '', '', '');
+
+    script = '' + (await install.run());
+    expect(script).toContain('initial script');
+    expect(script).toContain('bash darwin.sh 8.0 ' + __dirname);
+
+    setEnv(8.1, 'darwin', '', '', '', '');
+
+    script = '' + (await install.run());
+    expect(script).toContain('initial script');
+    expect(script).toContain('bash darwin.sh 8.1 ' + __dirname);
   });
 });

__tests__/tools.test.ts

@@ -0,0 +1,684 @@
+import * as tools from '../src/tools';
+
+describe('Tools tests', () => {
+  it('checking parseToolVersion', async () => {
+    expect(await tools.getToolVersion('latest')).toBe('latest');
+    expect(await tools.getToolVersion('1.2.3')).toBe('1.2.3');
+    expect(await tools.getToolVersion('^1.2.3')).toBe('1.2.3');
+    expect(await tools.getToolVersion('>=1.2.3')).toBe('1.2.3');
+    expect(await tools.getToolVersion('>1.2.3')).toBe('1.2.3');
+    expect(await tools.getToolVersion('1.2.3-ALPHA')).toBe('1.2.3-ALPHA');
+    expect(await tools.getToolVersion('1.2.3-alpha')).toBe('1.2.3-alpha');
+    expect(await tools.getToolVersion('1.2.3-beta')).toBe('1.2.3-beta');
+    expect(await tools.getToolVersion('1.2.3-rc')).toBe('1.2.3-rc');
+    expect(await tools.getToolVersion('1.2.3-dev')).toBe('1.2.3-dev');
+    expect(await tools.getToolVersion('1.2.3-alpha1')).toBe('1.2.3-alpha1');
+    expect(await tools.getToolVersion('1.2.3-alpha.1')).toBe('1.2.3-alpha.1');
+  });
+
+  it('checking parseToolVersion', async () => {
+    expect(await tools.parseTool('phpunit')).toStrictEqual({
+      name: 'phpunit',
+      version: 'latest'
+    });
+    expect(await tools.parseTool('phpunit:1.2.3')).toStrictEqual({
+      name: 'phpunit',
+      version: '1.2.3'
+    });
+    expect(await tools.parseTool('phpunit:^1.2.3')).toStrictEqual({
+      name: 'phpunit',
+      version: '1.2.3'
+    });
+    expect(await tools.parseTool('phpunit:>=1.2.3')).toStrictEqual({
+      name: 'phpunit',
+      version: '1.2.3'
+    });
+    expect(await tools.parseTool('phpunit:>1.2.3')).toStrictEqual({
+      name: 'phpunit',
+      version: '1.2.3'
+    });
+    expect(await tools.parseTool('phpunit:1.2.3-ALPHA')).toStrictEqual({
+      name: 'phpunit',
+      version: '1.2.3-ALPHA'
+    });
+    expect(await tools.parseTool('phpunit:1.2.3-alpha')).toStrictEqual({
+      name: 'phpunit',
+      version: '1.2.3-alpha'
+    });
+    expect(await tools.parseTool('phpunit:1.2.3-beta')).toStrictEqual({
+      name: 'phpunit',
+      version: '1.2.3-beta'
+    });
+    expect(await tools.parseTool('phpunit:1.2.3-rc')).toStrictEqual({
+      name: 'phpunit',
+      version: '1.2.3-rc'
+    });
+    expect(await tools.parseTool('phpunit:1.2.3-dev')).toStrictEqual({
+      name: 'phpunit',
+      version: '1.2.3-dev'
+    });
+    expect(await tools.parseTool('phpunit:1.2.3-alpha1')).toStrictEqual({
+      name: 'phpunit',
+      version: '1.2.3-alpha1'
+    });
+    expect(await tools.parseTool('phpunit:1.2.3-alpha.1')).toStrictEqual({
+      name: 'phpunit',
+      version: '1.2.3-alpha.1'
+    });
+  });
+
+  it('checking getUri', async () => {
+    expect(
+      await tools.getUri('tool', '.phar', 'latest', 'releases', '', 'download')
+    ).toBe('releases/latest/download/tool.phar');
+    expect(
+      await tools.getUri('tool', '.phar', '1.2.3', 'releases', '', 'download')
+    ).toBe('releases/download/1.2.3/tool.phar');
+    expect(
+      await tools.getUri('tool', '.phar', '1.2.3', 'releases', 'v', 'download')
+    ).toBe('releases/download/v1.2.3/tool.phar');
+  });
+
+  it('checking getCodeceptionUriBuilder', async () => {
+    expect(await tools.getCodeceptionUriBuilder('3.2.1', 'php56')).toBe(
+      'releases/3.2.1/php56/codecept.phar'
+    );
+    expect(await tools.getCodeceptionUriBuilder('3.2.1', 'php54')).toBe(
+      'releases/3.2.1/php54/codecept.phar'
+    );
+    expect(await tools.getCodeceptionUriBuilder('3.2.1', '')).toBe(
+      'releases/3.2.1/codecept.phar'
+    );
+  });
+
+  it('checking getCodeceptionUri', async () => {
+    expect(await tools.getCodeceptionUri('latest', '5.6')).toBe(
+      'php56/codecept.phar'
+    );
+    expect(await tools.getCodeceptionUri('latest', '7.0')).toBe(
+      'php56/codecept.phar'
+    );
+    expect(await tools.getCodeceptionUri('latest', '7.1')).toBe(
+      'php56/codecept.phar'
+    );
+    expect(await tools.getCodeceptionUri('latest', '7.2')).toBe(
+      'codecept.phar'
+    );
+    expect(await tools.getCodeceptionUri('latest', '7.3')).toBe(
+      'codecept.phar'
+    );
+    expect(await tools.getCodeceptionUri('latest', '7.4')).toBe(
+      'codecept.phar'
+    );
+    expect(await tools.getCodeceptionUri('4.0.0', '7.4')).toBe(
+      'releases/4.0.0/codecept.phar'
+    );
+    expect(await tools.getCodeceptionUri('4.0.0', '5.6')).toBe(
+      'releases/4.0.0/php56/codecept.phar'
+    );
+    expect(await tools.getCodeceptionUri('4.0.0', '7.1')).toBe(
+      'releases/4.0.0/php56/codecept.phar'
+    );
+    expect(await tools.getCodeceptionUri('3.1.0', '7.4')).toBe(
+      'releases/3.1.0/codecept.phar'
+    );
+    expect(await tools.getCodeceptionUri('3.1.0', '5.6')).toBe(
+      'releases/3.1.0/php54/codecept.phar'
+    );
+    expect(await tools.getCodeceptionUri('2.5.4', '7.4')).toBe(
+      'releases/2.5.4/codecept.phar'
+    );
+    expect(await tools.getCodeceptionUri('2.5.4', '5.6')).toBe(
+      'releases/2.5.4/php54/codecept.phar'
+    );
+    expect(await tools.getCodeceptionUri('2.3.4', '7.4')).toBe(
+      'releases/2.3.4/codecept.phar'
+    );
+    expect(await tools.getCodeceptionUri('2.3.4', '5.4')).toBe(
+      'releases/2.3.4/php54/codecept.phar'
+    );
+    expect(await tools.getCodeceptionUri('2.2.4', '5.6')).toBe(
+      'releases/2.2.4/codecept.phar'
+    );
+    expect(await tools.getCodeceptionUri('2.2.4', '7.4')).toBe(
+      'releases/2.2.4/codecept.phar'
+    );
+    expect(await tools.getCodeceptionUri('2.2.4', '5.4')).toBe(
+      'releases/2.2.4/php54/codecept.phar'
+    );
+    expect(await tools.getCodeceptionUri('2.1.7', '5.6')).toBe(
+      'releases/2.1.7/codecept.phar'
+    );
+    expect(await tools.getCodeceptionUri('2.1.7', '5.4')).toBe(
+      'releases/2.1.7/php54/codecept.phar'
+    );
+    expect(await tools.getCodeceptionUri('2.1.5', '5.4')).toBe(
+      'releases/2.1.5/codecept.phar'
+    );
+    expect(await tools.getCodeceptionUri('2.1.5', '7.4')).toBe(
+      'releases/2.1.5/codecept.phar'
+    );
+    expect(await tools.getCodeceptionUri('1.6.9', '7.4')).toBe(
+      'releases/1.6.9/codecept.phar'
+    );
+    expect(await tools.getCodeceptionUri('1.5.0', '7.4')).toBe(
+      'releases/1.5.0/codecept.phar'
+    );
+  });
+
+  it('checking addPhive', async () => {
+    let script: string = await tools.addPhive('1.2.3', '7.4', 'linux');
+    expect(script).toContain(
+      'add_tool https://github.com/phar-io/phive/releases/download/1.2.3/phive-1.2.3.phar phive'
+    );
+
+    script = await tools.addPhive('latest', '5.5', 'win32');
+    expect(script).toContain('Phive is not supported on PHP 5.5');
+
+    script = await tools.addPhive('latest', '5.6', 'win32');
+    expect(script).toContain(
+      'Add-Tool https://github.com/phar-io/phive/releases/download/0.12.1/phive-0.12.1.phar phive'
+    );
+
+    script = await tools.addPhive('latest', '7.1', 'win32');
+    expect(script).toContain(
+      'Add-Tool https://github.com/phar-io/phive/releases/download/0.13.5/phive-0.13.5.phar phive'
+    );
+  });
+
+  it('checking getPharUri', async () => {
+    expect(await tools.getPharUrl('domain', 'tool', '', 'latest')).toBe(
+      'domain/tool.phar'
+    );
+    expect(await tools.getPharUrl('domain', 'tool', 'v', '1.2.3')).toBe(
+      'domain/tool-v1.2.3.phar'
+    );
+  });
+
+  it('checking getBlackfirePlayerUrl', async () => {
+    expect(await tools.getBlackfirePlayerUrl('latest', '7.4')).toBe(
+      'https://get.blackfire.io/blackfire-player.phar'
+    );
+    expect(await tools.getBlackfirePlayerUrl('latest', '5.5')).toBe(
+      'https://get.blackfire.io/blackfire-player-v1.9.3.phar'
+    );
+    expect(await tools.getBlackfirePlayerUrl('latest', '7.0')).toBe(
+      'https://get.blackfire.io/blackfire-player-v1.9.3.phar'
+    );
+    expect(await tools.getBlackfirePlayerUrl('1.2.3', '7.0')).toBe(
+      'https://get.blackfire.io/blackfire-player-v1.2.3.phar'
+    );
+  });
+
+  it('checking getDeployerUri', async () => {
+    expect(await tools.getDeployerUrl('latest')).toBe(
+      'https://deployer.org/deployer.phar'
+    );
+    expect(await tools.getDeployerUrl('1.2.3')).toBe(
+      'https://deployer.org/releases/v1.2.3/deployer.phar'
+    );
+  });
+
+  it('checking addComposer', async () => {
+    expect(await tools.addComposer(['a', 'b'])).toStrictEqual([
+      'composer',
+      'a',
+      'b'
+    ]);
+    expect(await tools.addComposer(['a', 'b', 'composer'])).toStrictEqual([
+      'composer',
+      'a',
+      'b'
+    ]);
+    expect(await tools.addComposer(['a', 'b', 'composer:1.2'])).toStrictEqual([
+      'composer',
+      'a',
+      'b'
+    ]);
+    expect(
+      await tools.addComposer(['a', 'b', 'composer:1.2.3'])
+    ).toStrictEqual(['composer:1.2.3', 'a', 'b']);
+    expect(
+      await tools.addComposer(['a', 'b', 'composer:v1.2.3'])
+    ).toStrictEqual(['composer:1.2.3', 'a', 'b']);
+    expect(
+      await tools.addComposer(['a', 'b', 'composer:snapshot'])
+    ).toStrictEqual(['composer:snapshot', 'a', 'b']);
+    expect(
+      await tools.addComposer(['a', 'b', 'composer:preview'])
+    ).toStrictEqual(['composer:preview', 'a', 'b']);
+    expect(
+      await tools.addComposer(['a', 'b', 'c', 'composer:1'])
+    ).toStrictEqual(['composer:1', 'a', 'b', 'c']);
+    expect(
+      await tools.addComposer(['a', 'b', 'c', 'composer:2'])
+    ).toStrictEqual(['composer:2', 'a', 'b', 'c']);
+    expect(
+      await tools.addComposer(['a', 'b', 'c', 'composer:v1'])
+    ).toStrictEqual(['composer:1', 'a', 'b', 'c']);
+    expect(
+      await tools.addComposer(['a', 'b', 'c', 'composer:v2'])
+    ).toStrictEqual(['composer:2', 'a', 'b', 'c']);
+  });
+
+  it('checking getComposerUrl', async () => {
+    expect(await tools.getComposerUrl('latest')).toContain(
+      'https://getcomposer.org/composer-stable.phar'
+    );
+    expect(await tools.getComposerUrl('stable')).toContain(
+      'https://getcomposer.org/composer-stable.phar'
+    );
+    expect(await tools.getComposerUrl('snapshot')).toContain(
+      'https://getcomposer.org/composer.phar'
+    );
+    expect(await tools.getComposerUrl('preview')).toContain(
+      'https://getcomposer.org/composer-preview.phar'
+    );
+    expect(await tools.getComposerUrl('1')).toContain(
+      'https://getcomposer.org/composer-1.phar'
+    );
+    expect(await tools.getComposerUrl('2')).toContain(
+      'https://getcomposer.org/composer-2.phar'
+    );
+    expect(await tools.getComposerUrl('1.7.2')).toContain(
+      'https://github.com/composer/composer/releases/download/1.7.2/composer.phar'
+    );
+    expect(await tools.getComposerUrl('1.7.2')).toContain(
+      'https://getcomposer.org/composer-1.7.2.phar'
+    );
+    expect(await tools.getComposerUrl('2.0.0-RC2')).toContain(
+      'https://github.com/composer/composer/releases/download/2.0.0-RC2/composer.phar'
+    );
+    expect(await tools.getComposerUrl('2.0.0-RC2')).toContain(
+      'https://getcomposer.org/composer-2.0.0-RC2.phar'
+    );
+    expect(await tools.getComposerUrl('wrong')).toContain(
+      'https://getcomposer.org/composer-stable.phar'
+    );
+  });
+
+  it('checking getSymfonyUri', async () => {
+    expect(await tools.getSymfonyUri('latest', 'linux')).toContain(
+      'releases/latest/download/symfony_linux_amd64'
+    );
+    expect(await tools.getSymfonyUri('1.2.3', 'linux')).toContain(
+      'releases/download/v1.2.3/symfony_linux_amd64'
+    );
+    expect(await tools.getSymfonyUri('latest', 'darwin')).toContain(
+      'releases/latest/download/symfony_darwin_amd64'
+    );
+    expect(await tools.getSymfonyUri('1.2.3', 'darwin')).toContain(
+      'releases/download/v1.2.3/symfony_darwin_amd64'
+    );
+    expect(await tools.getSymfonyUri('latest', 'win32')).toContain(
+      'releases/latest/download/symfony_windows_amd64'
+    );
+    expect(await tools.getSymfonyUri('1.2.3', 'win32')).toContain(
+      'releases/download/v1.2.3/symfony_windows_amd64'
+    );
+    expect(await tools.getSymfonyUri('1.2.3', 'openbsd')).toContain(
+      'Platform openbsd is not supported'
+    );
+  });
+
+  it('checking getCleanedToolsList', async () => {
+    const tools_list: string[] = await tools.getCleanedToolsList(
+      'tool, composer:1.2, behat/behat, icanhazstring/composer-unused, laravel/vapor-cli, robmorgan/phinx, phpspec/phpspec, symfony/flex'
+    );
+    expect(tools_list).toStrictEqual([
+      'composer',
+      'tool',
+      'behat',
+      'composer-unused',
+      'vapor-cli',
+      'phinx',
+      'phpspec',
+      'flex'
+    ]);
+  });
+
+  it('checking getWpCliUri', async () => {
+    expect(await tools.getWpCliUrl('latest')).toBe(
+      'wp-cli/builds/blob/gh-pages/phar/wp-cli.phar?raw=true'
+    );
+    expect(await tools.getWpCliUrl('2.4.0')).toBe(
+      'wp-cli/wp-cli/releases/download/v2.4.0/wp-cli-2.4.0.phar'
+    );
+  });
+
+  it('checking addArchive', async () => {
+    let script: string = await tools.addArchive(
+      'tool',
+      'https://tool.com/tool.phar',
+      'linux',
+      '-v'
+    );
+    expect(script).toContain('add_tool https://tool.com/tool.phar tool');
+    script = await tools.addArchive(
+      'tool',
+      'https://tool.com/tool.phar',
+      'darwin',
+      '-v'
+    );
+    expect(script).toContain('add_tool https://tool.com/tool.phar tool');
+    script = await tools.addArchive(
+      'tool',
+      'https://tool.com/tool.phar',
+      'win32',
+      '-v'
+    );
+    expect(script).toContain('Add-Tool https://tool.com/tool.phar tool');
+
+    script = await tools.addArchive(
+      'tool',
+      'https://tool.com/tool.phar',
+      'openbsd',
+      '-v'
+    );
+    expect(script).toContain('Platform openbsd is not supported');
+  });
+
+  it('checking addDevTools', async () => {
+    let script: string = await tools.addDevTools('phpize', 'linux');
+    expect(script).toContain('add_devtools phpize');
+
+    script = await tools.addDevTools('php-config', 'linux');
+    expect(script).toContain('add_devtools php-config');
+
+    script = await tools.addDevTools('phpize', 'darwin');
+    expect(script).toContain('add_devtools phpize');
+
+    script = await tools.addDevTools('php-config', 'darwin');
+    expect(script).toContain('add_devtools php-config');
+
+    script = await tools.addDevTools('phpize', 'win32');
+    expect(script).toContain(
+      'Add-Log "$tick" "phpize" "phpize is not a windows tool"'
+    );
+
+    script = await tools.addDevTools('php-config', 'win32');
+    expect(script).toContain(
+      'Add-Log "$tick" "php-config" "php-config is not a windows tool"'
+    );
+
+    script = await tools.addDevTools('tool', 'openbsd');
+    expect(script).toContain('Platform openbsd is not supported');
+  });
+
+  it('checking addPackage', async () => {
+    let script: string = await tools.addPackage(
+      'tool',
+      'tool:1.2.3',
+      'user/',
+      'linux'
+    );
+    expect(script).toContain('add_composertool tool tool:1.2.3 user/');
+
+    script = await tools.addPackage('tool', 'tool:1.2.3', 'user/', 'darwin');
+    expect(script).toContain('add_composertool tool tool:1.2.3 user/');
+
+    script = await tools.addPackage('tool', 'tool:1.2.3', 'user/', 'win32');
+    expect(script).toContain('Add-Composertool tool tool:1.2.3 user/');
+
+    script = await tools.addPackage('tool', 'tool:1.2.3', 'user/', 'openbsd');
+    expect(script).toContain('Platform openbsd is not supported');
+  });
+
+  it('checking addTools on linux', async () => {
+    const script: string = await tools.addTools(
+      'blackfire, blackfire-player, cs2pr, flex, grpc_php_plugin, php-cs-fixer, phplint, phpstan, phpunit, pecl, phing, phinx, phinx:1.2.3, phive, php-config, phpize, protoc, symfony, wp-cli',
+      '7.4',
+      'linux'
+    );
+    expect(script).toContain('add_blackfire');
+    expect(script).toContain(
+      'add_tool https://get.blackfire.io/blackfire-player.phar blackfire-player "-V"'
+    );
+    expect(script).toContain(
+      'add_tool https://github.com/shivammathur/composer-cache/releases/latest/download/composer-stable.phar,https://getcomposer.org/composer-stable.phar composer'
+    );
+    expect(script).toContain(
+      'add_tool https://github.com/staabm/annotate-pull-request-from-checkstyle/releases/latest/download/cs2pr cs2pr "-V"'
+    );
+    expect(script).toContain(
+      'add_tool https://github.com/FriendsOfPHP/PHP-CS-Fixer/releases/latest/download/php-cs-fixer.phar php-cs-fixer "-V"'
+    );
+    expect(script).toContain(
+      'add_tool https://github.com/phpstan/phpstan/releases/latest/download/phpstan.phar phpstan "-V"'
+    );
+    expect(script).toContain(
+      'add_tool https://www.phing.info/get/phing-latest.phar phing "-v"'
+    );
+    expect(script).toContain(
+      'add_tool https://phar.io/releases/phive.phar phive status'
+    );
+    expect(script).toContain(
+      'add_tool https://phar.phpunit.de/phpunit.phar phpunit "--version"'
+    );
+    expect(script).toContain(
+      'add_tool https://github.com/symfony/cli/releases/latest/download/symfony_linux_amd64 symfony version'
+    );
+    expect(script).toContain(
+      'add_tool https://github.com/wp-cli/builds/blob/gh-pages/phar/wp-cli.phar?raw=true wp-cli "--version"'
+    );
+    expect(script).toContain('add_protoc latest');
+    expect(script).toContain('add_grpc_php_plugin latest');
+    expect(script).toContain('add_pecl');
+    expect(script).toContain('add_composertool flex flex symfony/');
+    expect(script).toContain('add_composertool phinx phinx robmorgan/');
+    expect(script).toContain('add_composertool phplint phplint overtrue/');
+    expect(script).toContain('add_composertool phinx phinx:1.2.3 robmorgan/');
+    expect(script).toContain('add_devtools php-config');
+    expect(script).toContain('add_devtools phpize');
+  });
+  it('checking addTools on darwin', async () => {
+    const listOfTools = [
+      'behat',
+      'blackfire',
+      'blackfire-player',
+      'composer-normalize',
+      'composer-require-checker',
+      'composer-unused',
+      'cs2pr:1.2.3',
+      'flex',
+      'grpc_php_plugin:1.2.3',
+      'infection',
+      'phan',
+      'phan:2.7.2',
+      'phing:1.2.3',
+      'phinx',
+      'phive:1.2.3',
+      'php-config',
+      'phpcbf',
+      'phpcpd',
+      'phpcs',
+      'phpize',
+      'phpmd',
+      'phpspec',
+      'protoc:v1.2.3',
+      'psalm',
+      'symfony',
+      'symfony:1.2.3',
+      'vapor-cli',
+      'wp-cli'
+    ];
+
+    const script: string = await tools.addTools(
+      listOfTools.join(', '),
+      '7.4',
+      'darwin'
+    );
+
+    expect(script).toContain('add_blackfire');
+    expect(script).toContain(
+      'add_tool https://get.blackfire.io/blackfire-player.phar blackfire-player "-V"'
+    );
+    expect(script).toContain(
+      'add_tool https://github.com/shivammathur/composer-cache/releases/latest/download/composer-stable.phar,https://getcomposer.org/composer-stable.phar composer'
+    );
+    expect(script).toContain(
+      'add_tool https://github.com/ergebnis/composer-normalize/releases/latest/download/composer-normalize.phar composer-normalize "-V"'
+    );
+    expect(script).toContain(
+      'add_tool https://github.com/maglnet/ComposerRequireChecker/releases/latest/download/composer-require-checker.phar composer-require-checker "-V"'
+    );
+    expect(script).toContain(
+      'add_tool https://github.com/staabm/annotate-pull-request-from-checkstyle/releases/download/1.2.3/cs2pr cs2pr "-V"'
+    );
+    expect(script).toContain(
+      'add_tool https://github.com/infection/infection/releases/latest/download/infection.phar infection "-V"'
+    );
+    expect(script).toContain(
+      'add_tool https://github.com/phan/phan/releases/latest/download/phan.phar phan "-v"'
+    );
+    expect(script).toContain(
+      'add_tool https://www.phing.info/get/phing-1.2.3.phar phing "-v"'
+    );
+    expect(script).toContain(
+      'add_tool https://github.com/squizlabs/PHP_CodeSniffer/releases/latest/download/phpcs.phar phpcs "--version"'
+    );
+    expect(script).toContain(
+      'add_tool https://github.com/squizlabs/PHP_CodeSniffer/releases/latest/download/phpcbf.phar phpcbf "--version"'
+    );
+    expect(script).toContain(
+      'add_tool https://phar.phpunit.de/phpcpd.phar phpcpd "--version"'
+    );
+    expect(script).toContain(
+      'add_tool https://github.com/phpmd/phpmd/releases/latest/download/phpmd.phar phpmd "--version"'
+    );
+    expect(script).toContain(
+      'https://github.com/vimeo/psalm/releases/latest/download/psalm.phar psalm "-v"'
+    );
+    expect(script).toContain('add_grpc_php_plugin 1.2.3');
+    expect(script).toContain('add_protoc 1.2.3');
+    expect(script).toContain('add_composertool behat behat behat/');
+    expect(script).toContain('add_composertool phpspec phpspec phpspec/');
+    expect(script).toContain('add_composertool vapor-cli vapor-cli laravel/');
+    expect(script).toContain('add_composertool flex flex symfony/');
+    expect(script).toContain('add_composertool phinx phinx robmorgan/');
+    expect(script).toContain(
+      'add_tool https://github.com/phan/phan/releases/download/2.7.2/phan.phar phan "-v"'
+    );
+    expect(script).toContain(
+      'add_tool https://github.com/phar-io/phive/releases/download/1.2.3/phive-1.2.3.phar phive'
+    );
+    expect(script).toContain(
+      'add_composertool composer-unused composer-unused icanhazstring/'
+    );
+    expect(script).toContain(
+      'add_tool https://github.com/symfony/cli/releases/latest/download/symfony_darwin_amd64 symfony version'
+    );
+    expect(script).toContain(
+      'add_tool https://github.com/symfony/cli/releases/download/v1.2.3/symfony_darwin_amd64 symfony version'
+    );
+    expect(script).toContain(
+      'add_tool https://github.com/wp-cli/builds/blob/gh-pages/phar/wp-cli.phar?raw=true wp-cli "--version"'
+    );
+    expect(script).toContain('add_devtools phpize');
+    expect(script).toContain('add_devtools php-config');
+  });
+  it('checking addTools on windows', async () => {
+    const listOfTools = [
+      'blackfire',
+      'blackfire-player:1.8.1',
+      'codeception',
+      'cs2pr',
+      'deployer',
+      'does_not_exist',
+      'flex',
+      'phinx',
+      'phive:0.13.2',
+      'php-config',
+      'phpize',
+      'phpmd',
+      'symfony',
+      'wp-cli'
+    ];
+
+    const script: string = await tools.addTools(
+      listOfTools.join(', '),
+      '7.4',
+      'win32'
+    );
+
+    expect(script).toContain('Add-Blackfire');
+    expect(script).toContain(
+      'Add-Tool https://get.blackfire.io/blackfire-player-v1.8.1.phar blackfire-player "-V"'
+    );
+    expect(script).toContain(
+      'Add-Tool https://github.com/shivammathur/composer-cache/releases/latest/download/composer-stable.phar,https://getcomposer.org/composer-stable.phar composer'
+    );
+    expect(script).toContain(
+      'Add-Tool https://github.com/staabm/annotate-pull-request-from-checkstyle/releases/latest/download/cs2pr cs2pr "-V"'
+    );
+    expect(script).toContain('Add-Composertool flex flex symfony/');
+    expect(script).toContain(
+      'Add-Tool https://deployer.org/deployer.phar deployer "-V"'
+    );
+    expect(script).toContain(
+      'Add-Tool https://github.com/phpmd/phpmd/releases/latest/download/phpmd.phar phpmd "--version"'
+    );
+    expect(script).toContain('Add-Composertool phinx phinx robmorgan/');
+    expect(script).toContain(
+      'Add-Tool https://github.com/phar-io/phive/releases/download/0.13.2/phive-0.13.2.phar phive status'
+    );
+    expect(script).toContain(
+      'Add-Tool https://github.com/symfony/cli/releases/latest/download/symfony_windows_amd64.exe symfony version'
+    );
+    expect(script).toContain(
+      'Add-Tool https://github.com/wp-cli/builds/blob/gh-pages/phar/wp-cli.phar?raw=true wp-cli "--version"'
+    );
+    expect(script).toContain('phpize is not a windows tool');
+    expect(script).toContain('php-config is not a windows tool');
+    expect(script).toContain('Tool does_not_exist is not supported');
+  });
+  it('checking addTools with composer tool using user/tool as input', async () => {
+    const listOfTools = [
+      'composer:v1',
+      'hirak/prestissimo',
+      'narrowspark/automatic-composer-prefetcher',
+      'robmorgan/phinx'
+    ];
+
+    const script: string = await tools.addTools(
+      listOfTools.join(', '),
+      '7.4',
+      'win32'
+    );
+
+    expect(script).toContain(
+      'Add-Tool https://github.com/shivammathur/composer-cache/releases/latest/download/composer-1.phar,https://getcomposer.org/composer-1.phar composer'
+    );
+    expect(script).toContain('Add-Composertool prestissimo prestissimo hirak/');
+    expect(script).toContain('Add-Composertool phinx phinx robmorgan/');
+    expect(script).toContain(
+      'Add-Composertool composer-prefetcher composer-prefetcher narrowspark/automatic-'
+    );
+  });
+  it('checking composer setup', async () => {
+    const listOfTools = ['composer', 'composer:v1'];
+
+    let script: string = await tools.addTools(
+      listOfTools.join(', '),
+      '7.4',
+      'linux'
+    );
+
+    expect(script).toContain(
+      'add_tool https://github.com/shivammathur/composer-cache/releases/latest/download/composer-1.phar,https://getcomposer.org/composer-1.phar composer'
+    );
+
+    script = await tools.addTools('composer:preview', '7.4', 'linux');
+    expect(script).toContain(
+      'add_tool https://github.com/shivammathur/composer-cache/releases/latest/download/composer-preview.phar,https://getcomposer.org/composer-preview.phar composer preview'
+    );
+    script = await tools.addTools(
+      'composer:v1, composer:preview, composer:snapshot',
+      '7.4',
+      'linux'
+    );
+    expect(script).toContain(
+      'add_tool https://github.com/shivammathur/composer-cache/releases/latest/download/composer-snapshot.phar,https://getcomposer.org/composer.phar composer snapshot'
+    );
+  });
+});

__tests__/utils.test.ts

@@ -8,6 +8,12 @@ jest.mock('@actions/core', () => ({
   })
 }));
 
+jest.spyOn(utils, 'fetch').mockImplementation(
+  async (url): Promise<string> => {
+    return `{ "latest": "8.0", "5.x": "5.6", "url": "${url}" }`;
+  }
+);
+
 async function cleanup(path: string): Promise<void> {
   fs.unlink(path, error => {
     if (error) {
@@ -17,38 +23,45 @@ async function cleanup(path: string): Promise<void> {
 }
 
 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('');
+    expect(await utils.readEnv('test')).toBe('setup-php');
+    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';
+    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('');
+    expect(async () => {
+      await utils.getInput('DoesNotExist', true);
+    }).rejects.toThrow('Input required and not supplied: DoesNotExist');
+  });
+
+  it('checking fetch', async () => {
+    expect(await utils.fetch('test_url')).toBe(
+      '{ "latest": "8.0", "5.x": "5.6", "url": "test_url" }'
+    );
+  });
+
+  it('checking parseVersion', async () => {
+    expect(await utils.parseVersion('latest')).toBe('8.0');
+    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('4.x')).toBe(undefined);
   });
 
   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');
   });
 
@@ -72,12 +85,12 @@ describe('Utils tests', () => {
       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);
+    expect(await utils.readScript('darwin.sh')).toBe(darwin);
+    expect(await utils.readScript('darwin.sh')).toBe(darwin);
+    expect(await utils.readScript('linux.sh')).toBe(linux);
+    expect(await utils.readScript('linux.sh')).toBe(linux);
+    expect(await utils.readScript('win32.ps1')).toBe(win32);
+    expect(await utils.readScript('win32.ps1')).toBe(win32);
   });
 
   it('checking writeScripts', async () => {
@@ -85,9 +98,12 @@ describe('Utils tests', () => {
     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 fs.readFile(
+      script_path,
+      function (error: Error | null, data: Buffer) {
+        expect(testString).toBe(data.toString());
+      }
+    );
     await cleanup(script_path);
   });
 
@@ -104,13 +120,27 @@ describe('Utils tests', () => {
   });
 
   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('')).toEqual([]);
+    expect(await utils.CSVArray(' ')).toEqual([]);
   });
 
   it('checking log', async () => {
@@ -143,8 +173,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 +187,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 +197,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 +205,58 @@ 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('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');
+  });
 });

action.yml

@@ -1,24 +1,25 @@
 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'
+    default: '8.0'
     required: true
-  extension-csv:
+  extensions:
     description: 'Setup PHP extensions.'
     required: false
-  ini-values-csv: 
+  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
 runs:
   using: 'node12'

examples/bedrock.yml

@@ -11,20 +11,22 @@ jobs:
         php-versions: ['7.1', '7.2', '7.3', '7.4']
     steps:
       - name: Checkout
-        uses: actions/checkout@v1
+        uses: actions/checkout@v2
       - name: Setup PHP, with composer and extensions
-        uses: shivammathur/setup-php@v1 #https://github.com/shivammathur/setup-php
+        uses: shivammathur/setup-php@v2 #https://github.com/shivammathur/setup-php
         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
+      - uses: actions/cache@v2
         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

examples/blackfire-player.yml

@@ -0,0 +1,31 @@
+# GitHub Action for Blackfire Player
+name: Play a Blackfire Scenario
+on: [push, pull_request]
+jobs:
+  blackfire-player:
+    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: ['7.2', '7.3', '7.4']
+        # blackfire-player supports PHP >= 5.5
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+      - name: Setup PHP, with composer and extensions
+        uses: shivammathur/setup-php@v2 #https://github.com/shivammathur/setup-php
+        with:
+          php-version: ${{ matrix.php-versions }}
+          extensions: blackfire
+          tools: blackfire, blackfire-player #Setup Blackfire client, agent and player
+          coverage: none
+      - name: Play the scenario
+        run: blackfire-player run scenario.bkf # Refer to https://blackfire.io/docs/player/index#usage

examples/blackfire.yml

@@ -0,0 +1,31 @@
+# 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: ['7.2', '7.3', '7.4']
+        # Blackfire supports PHP >= 5.3 on ubuntu and macos and PHP >= 5.4 on windows
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+      - name: Setup PHP, with composer and extensions
+        uses: shivammathur/setup-php@v2 #https://github.com/shivammathur/setup-php
+        with:
+          php-version: ${{ matrix.php-versions }}
+          extensions: blackfire
+          tools: blackfire #Setup Blackfire client and agent
+          coverage: none
+      - name: Profile
+        run: blackfire run php my-script.php # Refer to https://blackfire.io/docs/cookbooks/profiling-cli

examples/cakephp-mysql.yml

@@ -0,0 +1,114 @@
+# 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: ['7.2', '7.3', '7.4']
+    runs-on: ubuntu-latest
+    services:
+      mysql:
+        image: mysql:5.7
+        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@v2
+      - 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, pdo_mysql
+          coverage: pcov
+      - name: Start mysql service
+        run: sudo /etc/init.d/mysql start
+      - 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@v2
+        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'] }}
+          DB_DSN: "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_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION\""
+
+  coding-standard:
+    name: Coding Standard
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: '7.3'
+          extensions: mbstring, intl
+      - 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@v2
+        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@v2
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: '7.3'
+          extensions: mbstring, intl
+          tools: phpstan
+      - 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@v2
+        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: Static Analysis using PHPStan
+        run: phpstan analyse --no-progress src/

examples/cakephp-postgres.yml

@@ -0,0 +1,112 @@
+# 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:
+      matrix:
+        php-versions: ['7.2', '7.3', '7.4']
+    runs-on: ubuntu-latest
+    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
+      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@v2
+      - 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, pdo_pgsql
+          coverage: pcov
+      - 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@v2
+        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'] }}
+          DB_DSN: postgres://postgres@127.0.0.1:${{ job.services.postgres.ports['5432'] }}/postgres
+
+  coding-standard:
+    name: Coding Standard
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: '7.3'
+          extensions: mbstring, intl
+      - 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@v2
+        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@v2
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: '7.3'
+          extensions: mbstring, intl
+          tools: phpstan
+      - 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@v2
+        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: Static Analysis using PHPStan
+        run: phpstan analyse --no-progress src/

examples/cakephp.yml

@@ -0,0 +1,92 @@
+# 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: ['7.2', '7.3', '7.4']
+    runs-on: ${{ matrix.operating-system }}
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2 #https://github.com/shivammathur/setup-php
+        with:
+          php-version: ${{ matrix.php-versions }}
+          extensions: mbstring, intl, pdo_sqlite, pdo_mysql
+          coverage: pcov #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@v2
+        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@v2
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: '7.3'
+          extensions: mbstring, intl
+      - 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@v2
+        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@v2
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: '7.3'
+          extensions: mbstring, intl
+          tools: phpstan
+      - 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@v2
+        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: Static Analysis using PHPStan
+        run: phpstan analyse --no-progress src/

examples/codeigniter.yml

@@ -5,28 +5,30 @@ 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: ['7.2', '7.3', '7.4']
     runs-on: ${{ matrix.operating-system }}
     steps:
       - name: Checkout
-        uses: actions/checkout@v1
+        uses: actions/checkout@v2
       - name: Setup PHP, with composer and extensions
-        uses: shivammathur/setup-php@v1 #https://github.com/shivammathur/setup-php
+        uses: shivammathur/setup-php@v2 #https://github.com/shivammathur/setup-php
         with:
           php-version: ${{ matrix.php-versions }}
-          extension-csv: mbstring, intl, curl, dom
+          extensions: mbstring, intl, curl, dom
           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
+        uses: actions/cache@v2
         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

examples/laravel-mysql.yml

@@ -21,7 +21,7 @@ jobs:
           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
@@ -34,24 +34,28 @@ jobs:
         php-versions: ['7.2', '7.3', '7.4']
     steps:
       - name: Checkout
-        uses: actions/checkout@v1
+        uses: actions/checkout@v2
       - name: Setup PHP, with composer and extensions
-        uses: shivammathur/setup-php@v1 #https://github.com/shivammathur/setup-php
+        uses: shivammathur/setup-php@v2 #https://github.com/shivammathur/setup-php
         with:
           php-version: ${{ matrix.php-versions }}
-          extension-csv: mbstring, dom, fileinfo, mysql
+          extensions: mbstring, dom, fileinfo, mysql
           coverage: xdebug #optional
+      - name: Start mysql service
+        run: sudo /etc/init.d/mysql start
       - 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
+        uses: actions/cache@v2
         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');"
@@ -62,7 +66,9 @@ jobs:
         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

@@ -36,24 +36,26 @@ jobs:
         php-versions: ['7.2', '7.3', '7.4']
     steps:
       - name: Checkout
-        uses: actions/checkout@v1
+        uses: actions/checkout@v2
       - name: Setup PHP, with composer and extensions
-        uses: shivammathur/setup-php@v1 #https://github.com/shivammathur/setup-php
+        uses: shivammathur/setup-php@v2 #https://github.com/shivammathur/setup-php
         with:
           php-version: ${{ matrix.php-versions }}
-          extension-csv: mbstring, dom, fileinfo, pgsql
+          extensions: mbstring, dom, fileinfo, 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
+        uses: actions/cache@v2
         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');"
@@ -64,7 +66,9 @@ jobs:
         run: php artisan migrate -v
         env:
           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,28 +8,30 @@ 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: ['7.2', '7.3', '7.4']
     steps:
       - name: Checkout
-        uses: actions/checkout@v1
+        uses: actions/checkout@v2
       - name: Setup PHP, with composer and extensions
-        uses: shivammathur/setup-php@v1 #https://github.com/shivammathur/setup-php
+        uses: shivammathur/setup-php@v2 #https://github.com/shivammathur/setup-php
         with:
           php-version: ${{ matrix.php-versions }}
-          extension-csv: mbstring, dom, fileinfo
+          extensions: mbstring, dom, fileinfo
           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
+        uses: actions/cache@v2
         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');"

examples/lumen-mysql.yml

@@ -21,7 +21,7 @@ jobs:
           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
@@ -31,28 +31,32 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        php-versions: ['7.2', '7.3']
+        php-versions: ['7.2', '7.3', '7.4']
     steps:
       - name: Checkout
-        uses: actions/checkout@v1
+        uses: actions/checkout@v2
       - name: Setup PHP, with composer and extensions
-        uses: shivammathur/setup-php@v1 #https://github.com/shivammathur/setup-php
+        uses: shivammathur/setup-php@v2 #https://github.com/shivammathur/setup-php
         with:
           php-version: ${{ matrix.php-versions }}
-          extension-csv: mbstring, dom, fileinfo, mysql
+          extensions: mbstring, dom, fileinfo, mysql
           coverage: xdebug #optional
+      - name: Start mysql service
+        run: sudo /etc/init.d/mysql start
       - 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
+        uses: actions/cache@v2
         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');"
@@ -62,7 +66,9 @@ jobs:
         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/lumen-postgres.yml

@@ -33,28 +33,30 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        php-versions: ['7.2', '7.3']
+        php-versions: ['7.2', '7.3', '7.4']
     steps:
       - name: Checkout
-        uses: actions/checkout@v1
+        uses: actions/checkout@v2
       - name: Setup PHP, with composer and extensions
-        uses: shivammathur/setup-php@v1 #https://github.com/shivammathur/setup-php
+        uses: shivammathur/setup-php@v2 #https://github.com/shivammathur/setup-php
         with:
           php-version: ${{ matrix.php-versions }}
-          extension-csv: mbstring, dom, fileinfo, pgsql
+          extensions: mbstring, dom, fileinfo, 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
+        uses: actions/cache@v2
         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');"
@@ -64,7 +66,9 @@ jobs:
         run: php artisan migrate -v
         env:
           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] }}
+          REDIS_PORT: ${{ job.services.redis.ports['6379'] }}

examples/lumen.yml

@@ -8,28 +8,30 @@ 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: ['7.2', '7.3', '7.4']
     steps:
       - name: Checkout
-        uses: actions/checkout@v1
+        uses: actions/checkout@v2
       - name: Setup PHP, with composer and extensions
-        uses: shivammathur/setup-php@v1 #https://github.com/shivammathur/setup-php
+        uses: shivammathur/setup-php@v2 #https://github.com/shivammathur/setup-php
         with:
           php-version: ${{ matrix.php-versions }}
-          extension-csv: mbstring, dom, fileinfo, mysql
+          extensions: mbstring, dom, fileinfo, 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
+        uses: actions/cache@v2
         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

examples/phalcon-mysql.yml

@@ -24,32 +24,38 @@ jobs:
           MYSQL_ROOT_PASSWORD: password
           MYSQL_DATABASE: phalcon
         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.2', '7.3', '7.4']
+      # For phalcon 3.x, use
+      # php-versions: ['7.0', '7.1', '7.2', '7.3']
     steps:
       - name: Checkout
-        uses: actions/checkout@v1
+        uses: actions/checkout@v2
       - name: Setup PHP, with composer and extensions
-        uses: shivammathur/setup-php@v1 #https://github.com/shivammathur/setup-php
+        uses: shivammathur/setup-php@v2 #https://github.com/shivammathur/setup-php
         with:
           php-version: ${{ matrix.php-versions }}
-          extension-csv: mbstring, dom, zip, phalcon4, mysql #use phalcon3 for the phalcon 3.x.
+          extensions: mbstring, dom, zip, phalcon4, mysql #use phalcon3 for the phalcon 3.x.
           coverage: xdebug #optional
+      - name: Start mysql service
+        run: sudo /etc/init.d/mysql start
       - 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
+        uses: actions/cache@v2
         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

examples/phalcon-postgres.yml

@@ -31,26 +31,30 @@ jobs:
       fail-fast: false
       matrix:
         php-versions: ['7.2', '7.3', '7.4']
+      # For phalcon 3.x, use
+      # php-versions: ['7.0', '7.1', '7.2', '7.3']
     steps:
       - name: Checkout
-        uses: actions/checkout@v1
+        uses: actions/checkout@v2
       - name: Setup PHP, with composer and extensions
-        uses: shivammathur/setup-php@v1 #https://github.com/shivammathur/setup-php
+        uses: shivammathur/setup-php@v2 #https://github.com/shivammathur/setup-php
         with:
           php-version: ${{ matrix.php-versions }}
-          extension-csv: mbstring, dom, zip, phalcon4, pgsql #use phalcon3 for the phalcon 3.x
+          extensions: mbstring, dom, zip, phalcon4, pgsql #use phalcon3 for the phalcon 3.x
           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
+        uses: actions/cache@v2
         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

examples/sage.yml

@@ -12,22 +12,22 @@ jobs:
         node-versions: ['8', '10']
     steps:
       - name: Checkout
-        uses: actions/checkout@v1
+        uses: actions/checkout@v2
       - name: Setup Node.js
         uses: actions/setup-node@v1
         with:
           node-version: ${{ matrix.node-versions }}
       - name: Setup PHP, with composer and extensions
-        uses: shivammathur/setup-php@v1 #https://github.com/shivammathur/setup-php
+        uses: shivammathur/setup-php@v2 #https://github.com/shivammathur/setup-php
         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
+      - uses: actions/cache@v2
         with:
           path: ${{ steps.yarn-cache.outputs.dir }}
           key: ${{ runner.os }}-yarn-${{ hashFiles('**/yarn.lock') }}
@@ -36,15 +36,17 @@ jobs:
         id: composer-cache
         run: echo "::set-output name=dir::$(composer config cache-files-dir)"
       - name: Cache composer dependencies
-        uses: actions/cache@v1
+        uses: actions/cache@v2
         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
       - name: Install Composer dependencies
-        run: composer install -o --prefer-dist --no-interaction
+        run: composer install --no-progress --prefer-dist --optimize-autoloader
       - name: Yarn test and build
         run: |
           yarn run test

examples/slim-framework.yml

@@ -5,28 +5,30 @@ 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: ['7.2', '7.3', '7.4']
     runs-on: ${{ matrix.operating-system }}
     steps:
       - name: Checkout
-        uses: actions/checkout@v1
+        uses: actions/checkout@v2
       - name: Setup PHP, with composer and extensions
-        uses: shivammathur/setup-php@v1 #https://github.com/shivammathur/setup-php
+        uses: shivammathur/setup-php@v2 #https://github.com/shivammathur/setup-php
         with:
           php-version: ${{ matrix.php-versions }}
-          extension-csv: mbstring, simplexml, dom
+          extensions: mbstring, simplexml, dom
           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
+        uses: actions/cache@v2
         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

examples/symfony-mysql.yml

@@ -13,41 +13,44 @@ jobs:
           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: ['7.3', '7.4']
     steps:
       - name: Checkout
-        uses: actions/checkout@v1
+        uses: actions/checkout@v2
       - name: Setup PHP, with composer and extensions
-        uses: shivammathur/setup-php@v1 #https://github.com/shivammathur/setup-php
+        uses: shivammathur/setup-php@v2 #https://github.com/shivammathur/setup-php
         with:
           php-version: ${{ matrix.php-versions }}
-          extension-csv: mbstring, xml, ctype, iconv, mysql
+          extensions: mbstring, xml, ctype, iconv, intl, pdo_sqlite, mysql
           coverage: xdebug #optional
+      - name: Start mysql service
+        run: sudo /etc/init.d/mysql start
       - 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
+        uses: actions/cache@v2
         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 require --dev symfony/orm-pack symfony/phpunit-bridge
+          composer install --no-progress --prefer-dist --optimize-autoloader
+          php bin/phpunit install
       - 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"
         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
+        run: php bin/phpunit --coverage-text

examples/symfony-postgres.yml

@@ -18,36 +18,37 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        php-versions: ['7.3']
+        php-versions: ['7.3', '7.4']
     steps:
       - name: Checkout
-        uses: actions/checkout@v1
+        uses: actions/checkout@v2
       - name: Setup PHP, with composer and extensions
-        uses: shivammathur/setup-php@v1 #https://github.com/shivammathur/setup-php
+        uses: shivammathur/setup-php@v2 #https://github.com/shivammathur/setup-php
         with:
           php-version: ${{ matrix.php-versions }}
-          extension-csv: mbstring, xml, ctype, iconv, pgsql
+          extensions: mbstring, xml, ctype, iconv, intl, pdo_sqlite, 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
+        uses: actions/cache@v2
         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 require --dev symfony/orm-pack symfony/phpunit-bridge
+          composer install --no-progress --prefer-dist --optimize-autoloader
+          php bin/phpunit install
       - 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"
         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
+        run: php bin/phpunit --coverage-text

examples/symfony.yml

@@ -8,31 +8,32 @@ 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: ['7.3', '7.4']
     steps:
       - name: Checkout
-        uses: actions/checkout@v1
+        uses: actions/checkout@v2
       - name: Setup PHP, with composer and extensions
-        uses: shivammathur/setup-php@v1 #https://github.com/shivammathur/setup-php
+        uses: shivammathur/setup-php@v2 #https://github.com/shivammathur/setup-php
         with:
           php-version: ${{ matrix.php-versions }}
-          extension-csv: mbstring, xml, ctype, iconv
+          extensions: mbstring, xml, ctype, iconv, intl, pdo_sqlite
           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
+        uses: actions/cache@v2
         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
+          composer require --dev symfony/phpunit-bridge
+          composer install --no-progress --prefer-dist --optimize-autoloader
+          php bin/phpunit install
       - name: Run Tests
-        run: |
-          composer require phpunit
-          php bin/phpunit --coverage-text
+        run: php bin/phpunit --coverage-text

examples/yii2-mysql.yml

@@ -19,7 +19,7 @@ jobs:
           MYSQL_ROOT_PASSWORD: yii
           MYSQL_DATABASE: yii
         ports:
-          - 3306
+          - 3306/tcp
         options: --health-cmd="mysqladmin ping" --health-interval=10s --health-timeout=5s --health-retries=3
     strategy:
       fail-fast: false
@@ -27,28 +27,32 @@ jobs:
         php-versions: ['7.2', '7.3', '7.4']
     steps:
       - name: Checkout
-        uses: actions/checkout@v1
+        uses: actions/checkout@v2
       - 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
+        uses: shivammathur/setup-php@v2 #https://github.com/shivammathur/setup-php
         with:
           php-version: ${{ matrix.php-versions }}
-          extension-csv: mbstring, intl, gd, imagick, zip, dom, mysql
+          extensions: mbstring, intl, gd, imagick, zip, dom, mysql
           coverage: xdebug #optional
+      - name: Start mysql service
+        run: sudo /etc/init.d/mysql start
       - 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
+        uses: actions/cache@v2
         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.dist', '.env');"

examples/yii2-postgres.yml

@@ -27,28 +27,30 @@ jobs:
         php-versions: ['7.2', '7.3', '7.4']
     steps:
       - name: Checkout
-        uses: actions/checkout@v1
+        uses: actions/checkout@v2
       - 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
+        uses: shivammathur/setup-php@v2 #https://github.com/shivammathur/setup-php
         with:
           php-version: ${{ matrix.php-versions }}
-          extension-csv: mbstring, intl, gd, imagick, zip, dom, pgsql
+          extensions: 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
+        uses: actions/cache@v2
         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.dist', '.env');"

examples/zend-framework.yml

@@ -5,30 +5,32 @@ 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: ['7.2', '7.3', '7.4']
     runs-on: ${{ matrix.operating-system }}
     steps:
       - name: Checkout
-        uses: actions/checkout@v1
+        uses: actions/checkout@v2
       - name: Setup PHP, with composer and extensions
-        uses: shivammathur/setup-php@v1 #https://github.com/shivammathur/setup-php
+        uses: shivammathur/setup-php@v2 #https://github.com/shivammathur/setup-php
         with:
           php-version: ${{ matrix.php-versions }}
-          extension-csv: mbstring, bcmath, curl, intl
+          extensions: 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
+        uses: actions/cache@v2
         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
+          composer install --no-progress --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,12 +1,12 @@
 {
   "name": "setup-php",
-  "version": "1.5.7",
+  "version": "2.9.0",
   "private": false,
   "description": "Setup PHP for use with GitHub Actions",
   "main": "dist/index.js",
   "scripts": {
     "build": "tsc",
-    "lint": "eslint **/*.ts --cache",
+    "lint": "eslint **/*.ts --cache --fix",
     "format": "prettier --write **/*.ts && git add .",
     "format-check": "prettier --check **/*.ts",
     "release": "ncc build src/install.ts -o dist && git add -f dist/",
@@ -24,32 +24,33 @@
   "author": "shivammathur",
   "license": "MIT",
   "dependencies": {
-    "@actions/core": "^1.2.0",
-    "@actions/exec": "^1.0.1",
+    "@actions/core": "^1.2.6",
+    "@actions/exec": "^1.0.4",
+    "@actions/io": "^1.0.2",
     "fs": "0.0.1-security"
   },
   "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"
+    "@types/jest": "^26.0.19",
+    "@types/node": "^14.14.14",
+    "@typescript-eslint/eslint-plugin": "^4.10.0",
+    "@typescript-eslint/parser": "^4.10.0",
+    "@zeit/ncc": "^0.22.3",
+    "eslint": "^7.16.0",
+    "eslint-config-prettier": "^7.1.0",
+    "eslint-plugin-import": "^2.22.1",
+    "eslint-plugin-jest": "^24.1.3",
+    "eslint-plugin-prettier": "^3.3.0",
+    "husky": "^4.3.6",
+    "jest": "^26.6.3",
+    "jest-circus": "^26.6.3",
+    "prettier": "^2.2.1",
+    "ts-jest": "^26.4.4",
+    "typescript": "^4.1.3"
   },
   "husky": {
     "skipCI": true,
     "hooks": {
-      "pre-commit": "npm run build && npm run format && npm run release"
+      "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.join('\n') +
+    '" | sudo tee -a "${pecl_file:-${ini_file[@]}}" >/dev/null 2>&1' +
+    script
+  );
 }
 
 /**
@@ -25,17 +30,14 @@ 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') +
-    '"' +
-    script
+    'Add-Content "$php_dir\\php.ini" "' + ini_values.join('\n') + '"' + script
   );
 }
 
@@ -44,6 +46,7 @@ export async function addINIValuesWindows(
  *
  * @param ini_values_csv
  * @param os_version
+ * @param no_step
  */
 export async function addINIValues(
   ini_values_csv: string,

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/php-versions.json

@@ -0,0 +1,6 @@
+{
+  "latest": "8.0",
+  "5.x": "5.6",
+  "7.x": "7.4",
+  "8.x": "8.0"
+}

src/configs/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/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/coverage.ts

@@ -5,24 +5,27 @@ import * as config from './config';
 /**
  * Function to setup Xdebug
  *
+ * @param extension
  * @param version
  * @param os_version
+ * @param pipe
  */
 export async function addCoverageXdebug(
+  extension: string,
   version: string,
-  os_version: string
+  os_version: string,
+  pipe: 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
-    ))
+  const xdebug =
+    (await extensions.addExtension(extension, version, os_version, true)) +
+    pipe;
+  const log = await utils.addLog(
+    '$tick',
+    extension,
+    'Xdebug enabled as coverage driver',
+    os_version
   );
+  return xdebug + '\n' + log;
 }
 
 /**
@@ -30,17 +33,19 @@ export async function addCoverageXdebug(
  *
  * @param version
  * @param os_version
+ * @param pipe
  */
 export async function addCoveragePCOV(
   version: string,
-  os_version: string
+  os_version: 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)) +
+        pipe +
         '\n';
       script +=
         (await config.addINIValues('pcov.enabled=1', os_version, true)) + '\n';
@@ -48,20 +53,11 @@ export async function addCoveragePCOV(
       // 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';
+          script += 'remove_extension xdebug' + pipe + '\n';
           break;
         case 'win32':
-          script +=
-            'if(php -m | findstr -i xdebug) { Disable-PhpExtension xdebug C:\\tools\\php }\n';
+          script += 'Remove-Extension xdebug' + pipe + '\n';
           break;
       }
 
@@ -74,8 +70,8 @@ export async function addCoveragePCOV(
       );
       // version is not supported
       break;
-    case '5.6':
-    case '7.0':
+
+    case /5\.[3-6]|7\.0/.test(version):
       script += await utils.addLog(
         '$cross',
         'pcov',
@@ -93,38 +89,23 @@ export async function addCoveragePCOV(
  *
  * @param version
  * @param os_version
+ * @param pipe
  */
 export async function disableCoverage(
   version: string,
-  os_version: string
+  os_version: 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';
+      script += 'remove_extension xdebug' + pipe + '\n';
+      script += 'remove_extension pcov' + pipe + '\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';
+      script += 'Remove-Extension xdebug' + pipe + '\n';
+      script += 'Remove-Extension pcov' + pipe + '\n';
       break;
   }
   script += await utils.addLog(
@@ -149,16 +130,24 @@ export async function addCoverage(
   version: string,
   os_version: string
 ): Promise<string> {
-  coverage_driver.toLowerCase();
+  coverage_driver = coverage_driver.toLowerCase();
   const script: string =
     '\n' + (await utils.stepLog('Setup Coverage', os_version));
+  const pipe: string = await utils.suppressOutput(os_version);
   switch (coverage_driver) {
     case 'pcov':
-      return script + (await addCoveragePCOV(version, os_version));
+      return script + (await addCoveragePCOV(version, os_version, pipe));
     case 'xdebug':
-      return script + (await addCoverageXdebug(version, os_version));
+    case 'xdebug3':
+      return (
+        script + (await addCoverageXdebug('xdebug', version, os_version, pipe))
+      );
+    case 'xdebug2':
+      return (
+        script + (await addCoverageXdebug('xdebug2', version, os_version, pipe))
+      );
     case 'none':
-      return script + (await disableCoverage(version, os_version));
+      return script + (await disableCoverage(version, os_version, pipe));
     default:
       return '';
   }

src/extensions.ts

@@ -1,4 +1,3 @@
-import * as path from 'path';
 import * as utils from './utils';
 
 /**
@@ -12,31 +11,87 @@ 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';
+  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 += '\nremove_extension ' + ext_name.slice(1);
+        return;
+      // match 5.3blackfire...8.0blackfire
+      // match 5.3blackfire-(semver)...8.0blackfire-(semver)
+      // match pdo_oci and oci8
+      // match 5.3ioncube...7.4ioncube, 5.3geos...7.4geos
+      // match 7.0phalcon3...7.3phalcon3 and 7.2phalcon4...7.4phalcon4
+      // match 5.6couchbase...7.4couchbase
+      case /^(5\.[3-6]|7\.[0-4]|8\.0)blackfire(-\d+\.\d+\.\d+)?$/.test(
+        version_extension
+      ):
+      case /^pdo_oci$|^oci8$/.test(extension):
+      case /^(5\.[3-6]|7\.[0-4])(ioncube|geos)$/.test(version_extension):
+      case /^7\.[0-3]phalcon3$|^7\.[2-4]phalcon4$/.test(version_extension):
+      case /^5\.6couchbase$|^7\.[0-4]couchbase$/.test(version_extension):
+        add_script += await utils.customPackage(
+          ext_name,
+          'ext',
+          extension,
+          'darwin'
+        );
+        return;
+      // match pre-release versions. For example - xdebug-beta
+      case /.*-(stable|beta|alpha|devel|snapshot|rc|preview)/.test(
+        version_extension
+      ):
+        add_script += await utils.joins(
+          '\nadd_unstable_extension',
+          ext_name,
+          ext_version,
+          ext_prefix
+        );
+        return;
+      // match semver
+      case /.*-\d+\.\d+\.\d+.*/.test(version_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 5.6 to 8.9 for amqp, grpc, igbinary, imagick, imap, protobuf, swoole and xdebug
+      // match 7.1 to 8.9 for pcov
+      case /(5\.6|7\.[0-4]|8\.[0-9])(amqp|grpc|igbinary|imagick|imap|protobuf|swoole|xdebug)/.test(
+        version_extension
+      ):
+      case /(7\.[1-4]|8\.[0-9])pcov/.test(version_extension):
+        add_script += await utils.joins(
+          '\nadd_brew_extension',
+          ext_name,
+          ext_prefix
+        );
+        return;
+      // match 5.6redis
+      case /5\.6redis/.test(version_extension):
+        extension = 'redis-2.2.8';
         break;
-      case '5.6redis':
-        install_command = 'sudo pecl install redis-2.2.8 >/dev/null 2>&1';
+      // 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 +105,96 @@ 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 += '\nRemove-Extension ' + ext_name.slice(1);
+        break;
+      // match 5.3blackfire...8.0blackfire
+      // match 5.3blackfire-(semver)...8.0blackfire-(semver)
+      // match pdo_oci and oci8
+      // match 5.3ioncube...7.4ioncube
+      // match 7.0phalcon3...7.3phalcon3 and 7.2phalcon4...7.4phalcon4
+      case /^(5\.[3-6]|7\.[0-4]|8\.0)blackfire(-\d+\.\d+\.\d+)?$/.test(
+        version_extension
+      ):
+      case /^pdo_oci$|^oci8$/.test(extension):
+      case /^5\.[3-6]ioncube$|^7\.[0-4]ioncube$/.test(version_extension):
+      case /^7\.[0-3]phalcon3$|^7\.[2-4]phalcon4$/.test(version_extension):
+        add_script += await utils.customPackage(
+          ext_name,
+          'ext',
+          extension,
+          'win32'
+        );
+        return;
+      // match pre-release versions. For example - xdebug-beta
+      case /.*-(stable|beta|alpha|devel|snapshot)/.test(version_extension):
+        add_script += await utils.joins(
+          '\nAdd-Extension',
+          ext_name,
+          ext_version.replace('stable', '')
+        );
+        break;
+      // match semver without state
+      case /.*-\d+\.\d+\.\d+$/.test(version_extension):
+        add_script += await utils.joins(
+          '\nAdd-Extension',
+          ext_name,
+          'stable',
+          ext_version
+        );
+        break;
+      // match semver with state
+      case /.*-(\d+\.\d+\.\d)([a-zA-Z+]+)\d*/.test(version_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 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.3mysql..5.6mysql
+      // match 5.3mysqli..5.6mysqli
+      // match 5.3mysqlnd..5.6mysqlnd
+      case /^5\.\d(mysql|mysqli|mysqlnd)$/.test(version_extension):
+        add_script +=
+          '\nAdd-Extension mysql\nAdd-Extension mysqli\nAdd-Extension mysqlnd';
+        break;
+      // match 7.0mysql..8.9mysql
+      // match 7.0mysqli..8.9mysqli
+      // match 7.0mysqlnd..8.9mysqlnd
+      case /[7-8]\.\d(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 +208,90 @@ 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 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';
+  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 += '\nremove_extension ' + ext_name.slice(1);
+        return;
+      // match 5.3blackfire...8.0blackfire
+      // match 5.3blackfire-(semver)...8.0blackfire-(semver)
+      // match 5.3pdo_cubrid...7.2php_cubrid, 5.3cubrid...7.4cubrid
+      // match pdo_oci and oci8
+      // match 5.3ioncube...7.4ioncube, 5.3geos...7.4geos
+      // match 7.0phalcon3...7.3phalcon3 and 7.2phalcon4...7.4phalcon4
+      // match 5.6gearman...7.4gearman, 5.6couchbase...7.4couchbase
+      case /^(5\.[3-6]|7\.[0-4]|8\.0)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 /^pdo_oci$|^oci8$/.test(extension):
+      case /^(5\.6|7\.[0-4]|8\.0)intl-[\d]+\.[\d]+$/.test(version_extension):
+      case /^(5\.[3-6]|7\.[0-4])(ioncube|geos)$/.test(version_extension):
+      case /^7\.[0-3]phalcon3$|^7\.[2-4]phalcon4$/.test(version_extension):
+      case /^((5\.6)|(7\.[0-4]))(gearman|couchbase)$/.test(version_extension):
+        add_script += await utils.customPackage(
+          ext_name,
+          'ext',
+          extension,
+          'linux'
+        );
+        return;
+      // match pre-release versions. For example - xdebug-beta
+      case /.*-(stable|beta|alpha|devel|snapshot|rc|preview)/.test(
+        version_extension
+      ):
+        add_script += await utils.joins(
+          '\nadd_unstable_extension',
+          ext_name,
+          ext_version,
+          ext_prefix
+        );
+        return;
+      // match semver versions
+      case /.*-\d+\.\d+\.\d+.*/.test(version_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(version_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;
 }
 
 /**
@@ -134,7 +300,7 @@ export async function addExtensionLinux(
  * @param extension_csv
  * @param version
  * @param os_version
- * @param log_prefix
+ * @param no_step
  */
 export async function addExtension(
   extension_csv: string,
@@ -142,16 +308,15 @@ export async function addExtension(
   os_version: string,
   no_step = false
 ): Promise<string> {
+  const log: string = await utils.stepLog('Setup Extensions', os_version);
   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_version));
       break;
     case false:
     default:
-      script += await utils.stepLog('Setup Extensions', os_version);
+      script += log;
       break;
   }
 

src/install.ts

@@ -3,6 +3,7 @@ import * as core from '@actions/core';
 import * as config from './config';
 import * as coverage from './coverage';
 import * as extensions from './extensions';
+import * as tools from './tools';
 import * as utils from './utils';
 
 /**
@@ -12,26 +13,35 @@ import * as utils from './utils';
  * @param version
  * @param os_version
  */
-export async function build(
+export async function getScript(
   filename: string,
   version: string,
   os_version: string
 ): Promise<string> {
+  const name = 'setup-php';
+  const url = 'https://setup-php.com/support';
   // taking inputs
-  const extension_csv: string = await utils.getInput('extension-csv', false);
-  const ini_values_csv: string = await utils.getInput('ini-values-csv', false);
+  process.env['fail_fast'] = await utils.getInput('fail-fast', false);
+  const extension_csv: string = await utils.getInput('extensions', false);
+  const ini_values_csv: string = await utils.getInput('ini-values', false);
   const coverage_driver: string = await utils.getInput('coverage', false);
+  const tools_csv: string = await utils.getInput('tools', false);
+
+  let script: string = await utils.readScript(filename);
+  script += await tools.addTools(tools_csv, version, os_version);
 
-  let script: string = await utils.readScript(filename, version, os_version);
   if (extension_csv) {
     script += await extensions.addExtension(extension_csv, version, os_version);
   }
-  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);
   }
+  if (ini_values_csv) {
+    script += await config.addINIValues(ini_values_csv, os_version);
+  }
+
+  script += '\n' + (await utils.stepLog('Support this project', os_version));
+  script += '\n' + (await utils.addLog('$tick', name, url, os_version));
 
   return await utils.writeScript(filename, script);
 }
@@ -41,27 +51,17 @@ export async function build(
  */
 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;
+    const version: string = await utils.parseVersion(
+      await utils.getInput('php-version', true)
+    );
+    if (version) {
+      const os_version: string = process.platform;
+      const tool = await utils.scriptTool(os_version);
+      const script = os_version + (await utils.scriptExtension(os_version));
+      const location = await getScript(script, version, os_version);
+      await exec(await utils.joins(tool, location, version, __dirname));
+    } else {
+      core.setFailed('Unable to get the PHP version');
     }
   } catch (error) {
     core.setFailed(error.message);

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
-}

src/scripts/common.sh

@@ -0,0 +1,269 @@
+# Variables
+export tick="✓"
+export cross="✗"
+export curl_opts=(-sL)
+export old_versions="5.[3-5]"
+export jit_versions="8.[0-9]"
+export nightly_versions="8.[1-9]"
+export xdebug3_versions="7.[2-4]|8.[0-9]"
+export tool_path_dir="/usr/local/bin"
+export composer_bin="$HOME/.composer/vendor/bin"
+export composer_json="$HOME/.composer/composer.json"
+export latest="releases/latest/download"
+export github="https://github.com/shivammathur"
+export bintray="https://dl.bintray/shivammathur"
+
+# Function to log start of a operation.
+step_log() {
+  message=$1
+  printf "\n\033[90;1m==> \033[0m\033[37;1m%s\033[0m\n" "$message"
+}
+
+# Function to log result of a operation.
+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"
+    [ "$fail_fast" = "true" ] && exit 1;
+  fi
+}
+
+# Function to log result of installing extension.
+add_extension_log() {
+  extension=$1
+  status=$2
+  extension_name=$(echo "$extension" | cut -d '-' -f 1)
+  (
+    check_extension "$extension_name" && add_log "$tick" "$extension_name" "$status"
+  ) || add_log "$cross" "$extension_name" "Could not install $extension on PHP ${semver:?}"
+}
+
+# Function to read env inputs.
+read_env() {
+  [[ -z "${update}" ]] && update='false' && UPDATE='false' || update="${update}"
+  [ "$update" = false ] && [[ -n ${UPDATE} ]] && update="${UPDATE}"
+  [[ -z "${runner}" ]] && runner='github' && RUNNER='github' || runner="${runner}"
+  [ "$runner" = false ] && [[ -n ${RUNNER} ]] && runner="${RUNNER}"
+  [[ -z "${fail_fast}" ]] && fail_fast='false' || fail_fast="${fail_fast}"
+}
+
+# Function to download a file using cURL.
+# mode: -s pipe to stdout, -v save file and return status code
+# execute: -e save file as executable
+get() {
+  mode=$1
+  execute=$2
+  file_path=$3
+  shift 3
+  links=("$@")
+  if [ "$mode" = "-s" ]; then
+    sudo curl "${curl_opts[@]}" "${links[0]}"
+  else
+    for link in "${links[@]}"; do
+      status_code=$(sudo curl -w "%{http_code}" -o "$file_path" "${curl_opts[@]}" "$link")
+      [ "$status_code" = "200" ] && break
+    done
+    [ "$execute" = "-e" ] && sudo chmod a+x "$file_path"
+    [ "$mode" = "-v" ] && echo "$status_code"
+  fi
+}
+
+# Function to download and run scripts from GitHub releases with bintray fallback.
+run_script() {
+  repo=$1
+  shift
+  args=("$@")
+  get -q -e /tmp/install.sh "$bintray/php/$repo.sh" "$github/$repo/$latest/install.sh"
+  bash /tmp/install.sh "${args[@]}"
+}
+
+# Function to install required packages on self-hosted runners.
+self_hosted_setup() {
+  if [ "$runner" = "self-hosted" ]; then
+    if [[ "${version:?}" =~ $old_versions ]]; then
+      add_log "$cross" "PHP" "PHP $version is not supported on self-hosted runner"
+      exit 1
+    else
+      self_hosted_helper >/dev/null 2>&1
+    fi
+  fi
+}
+
+# Function to test if extension is loaded.
+check_extension() {
+  extension=$1
+  if [ "$extension" != "mysql" ]; then
+    php -m | grep -i -q -w "$extension"
+  else
+    php -m | grep -i -q "$extension"
+  fi
+}
+
+# Function to enable existing extensions.
+enable_extension() {
+  modules_dir="/var/lib/php/modules/$version"
+  [ -d "$modules_dir" ] && sudo find "$modules_dir" -path "*disabled*$1" -delete
+  if ! check_extension "$1" && [ -e "${ext_dir:?}/$1.so" ]; then
+    echo "$2=${ext_dir:?}/$1.so" | sudo tee -a "${pecl_file:-${ini_file[@]}}" >/dev/null
+  fi
+}
+
+# Function to configure PHP
+configure_php() {
+  (
+    echo -e "date.timezone=UTC\nmemory_limit=-1"
+    [[ "$version" =~ $jit_versions ]] && echo -e "opcache.enable=1\nopcache.jit_buffer_size=256M\nopcache.jit=1235"
+    [[ "$version" =~ $xdebug3_versions ]] && echo -e "xdebug.mode=coverage"
+  ) | sudo tee -a "${pecl_file:-${ini_file[@]}}" >/dev/null
+}
+
+# Function to configure PECL.
+configure_pecl() {
+  if ! [ -e /tmp/pecl_config ]; then
+    if ! command -v pecl >/dev/null || ! command -v pear >/dev/null; then
+      add_pecl >/dev/null 2>&1
+    fi
+    for script in pear pecl; do
+      sudo "$script" config-set php_ini "${pecl_file:-${ini_file[@]}}"
+      sudo "$script" channel-update "$script".php.net
+    done
+    echo '' | sudo tee /tmp/pecl_config >/dev/null 2>&1
+  fi
+}
+
+# Function to get the PECL version of an extension.
+get_pecl_version() {
+  extension=$1
+  stability="$(echo "$2" | grep -m 1 -Eio "(stable|alpha|beta|rc|snapshot|preview)")"
+  pecl_rest='https://pecl.php.net/rest/r/'
+  response=$(get -s -n "" "$pecl_rest$extension"/allreleases.xml)
+  pecl_version=$(echo "$response" | grep -m 1 -Eio "([0-9]+\.[0-9]+\.[0-9]+${stability}[0-9]+)")
+  if [ ! "$pecl_version" ]; then
+    pecl_version=$(echo "$response" | grep -m 1 -Eo "([0-9]+\.[0-9]+\.[0-9]+)")
+  fi
+  echo "$pecl_version"
+}
+
+# Function to install PECL extensions and accept default options
+pecl_install() {
+  local extension=$1
+  configure_pecl >/dev/null 2>&1
+  yes '' 2>/dev/null | sudo pecl install -f "$extension" >/dev/null 2>&1
+}
+
+# Function to setup pre-release extensions using PECL.
+add_unstable_extension() {
+  extension=$1
+  stability=$2
+  prefix=$3
+  pecl_version=$(get_pecl_version "$extension" "$stability")
+  add_pecl_extension "$extension" "$pecl_version" "$prefix"
+}
+
+# Function to extract tool version.
+get_tool_version() {
+  tool=$1
+  param=$2
+  version_regex="[0-9]+((\.{1}[0-9]+)+)(\.{0})(-[a-zA-Z0-9]+){0,1}"
+  if [ "$tool" = "composer" ]; then
+    if [ "$param" != "snapshot" ]; then
+      composer_version="$(grep -Ea "const\sVERSION" "$tool_path_dir/composer" | grep -Eo "$version_regex")"
+    else
+      composer_version="$(grep -Ea "const\sBRANCH_ALIAS_VERSION" "$tool_path_dir/composer" | grep -Eo "$version_regex")+$(grep -Ea "const\sVERSION" "$tool_path_dir/composer" | grep -Eo "[a-zA-z0-9]+" | tail -n 1)"
+    fi
+    echo "$composer_version" | sudo tee /tmp/composer_version
+  else
+    $tool "$param" 2>/dev/null | sed -Ee "s/[Cc]omposer(.)?$version_regex//g" | grep -Eo "$version_regex" | head -n 1
+  fi
+}
+
+# Function to configure composer
+configure_composer() {
+  tool_path=$1
+  sudo ln -sf "$tool_path" "$tool_path.phar"
+  php -r "try {\$p=new Phar('$tool_path.phar', 0);exit(0);} catch(Exception \$e) {exit(1);}"
+  if [ $? -eq 1 ]; then
+    add_log "$cross" "composer" "Could not download composer"
+    exit 1
+  fi
+  composer -q config -g process-timeout 0
+  echo "$composer_bin" >> "$GITHUB_PATH"
+  if [ -n "$COMPOSER_TOKEN" ]; then
+    composer -q config -g github-oauth.github.com "$COMPOSER_TOKEN"
+  fi
+}
+
+# Function to setup a remote tool.
+add_tool() {
+  url=$1
+  tool=$2
+  ver_param=$3
+  tool_path="$tool_path_dir/$tool"
+  if ! [[ "$PATH" =~ $tool_path_dir ]] ; then
+    export PATH=$PATH:"$tool_path_dir"
+    echo "export PATH=\$PATH:$tool_path_dir" | sudo tee -a "$GITHUB_ENV" >/dev/null
+  fi
+  if [ ! -e "$tool_path" ]; then
+    rm -rf "$tool_path"
+  fi
+  IFS="," read -r -a url <<< "$url"
+  status_code=$(get -v -e "$tool_path" "${url[@]}")
+  if [ "$status_code" != "200" ] && [[ "${url[0]}" =~ .*github.com.*releases.*latest.* ]]; then
+    url[0]="${url[0]//releases\/latest\/download/releases/download/$(get -s -n "" "$(echo "${url[0]}" | cut -d '/' -f '1-5')/releases" | grep -Eo -m 1 "([0-9]+\.[0-9]+\.[0-9]+)/$(echo "${url[0]}" | sed -e "s/.*\///")" | cut -d '/' -f 1)}"
+    status_code=$(get -v -e "$tool_path" "${url[0]}")
+  fi
+  if [ "$status_code" = "200" ]; then
+    if [ "$tool" = "composer" ]; then
+      configure_composer "$tool_path"
+    elif [ "$tool" = "cs2pr" ]; then
+      sudo sed -i 's/\r$//; s/exit(9)/exit(0)/' "$tool_path" 2>/dev/null ||
+      sudo sed -i '' 's/\r$//; s/exit(9)/exit(0)/' "$tool_path"
+    elif [ "$tool" = "phan" ]; then
+      add_extension fileinfo extension >/dev/null 2>&1
+      add_extension ast extension >/dev/null 2>&1
+    elif [ "$tool" = "phive" ]; then
+      add_extension curl extension >/dev/null 2>&1
+      add_extension mbstring extension >/dev/null 2>&1
+      add_extension xml extension >/dev/null 2>&1
+    elif [ "$tool" = "wp-cli" ]; then
+      sudo cp -p "$tool_path" "$tool_path_dir"/wp
+    fi
+    tool_version=$(get_tool_version "$tool" "$ver_param")
+    add_log "$tick" "$tool" "Added $tool $tool_version"
+  else
+    add_log "$cross" "$tool" "Could not setup $tool"
+  fi
+}
+
+# Function to setup a tool using composer.
+add_composertool() {
+  tool=$1
+  release=$2
+  prefix=$3
+  if [[ "$tool" =~ prestissimo|composer-prefetcher ]]; then
+    composer_version=$(cat /tmp/composer_version)
+    if [ "$(echo "$composer_version" | cut -d'.' -f 1)" != "1" ]; then
+      echo "::warning:: Skipping $tool, as it does not support Composer $composer_version. Specify composer:v1 in tools to use $tool"
+      add_log "$cross" "$tool" "Skipped"
+      return
+    fi
+  fi
+  (
+    composer global require "$prefix$release" >/dev/null 2>&1 &&
+    json=$(grep "$prefix$tool" "$composer_json") &&
+    tool_version=$(get_tool_version 'echo' "$json") &&
+    add_log "$tick" "$tool" "Added $tool $tool_version"
+  ) || add_log "$cross" "$tool" "Could not setup $tool"
+  if [ -e "$composer_bin/composer" ]; then
+    sudo cp -p "$tool_path_dir/composer" "$composer_bin"
+  fi
+}
+
+# Function to get PHP version in semver format.
+php_semver() {
+  php"$version" -v | grep -Eo -m 1 "[0-9]+\.[0-9]+\.[0-9]+" | head -n 1
+}

src/scripts/darwin.sh

@@ -1,56 +1,185 @@
-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"
+# Function to setup environment for self-hosted runners.
+self_hosted_helper() {
+  if ! command -v brew >/dev/null; then
+    step_log "Setup Brew"
+    get -q -e "/tmp/install.sh" "https://raw.githubusercontent.com/Homebrew/install/master/install.sh" && /tmp/install.sh >/dev/null 2>&1
+    add_log "${tick:?}" "Brew" "Installed Homebrew"
   fi
 }
 
-step_log "Setup PHP and Composer"
-version=$1
-export HOMEBREW_NO_INSTALL_CLEANUP=TRUE
-brew tap shivammathur/homebrew-php >/dev/null 2>&1
-brew install shivammathur/php/php@"$1" composer >/dev/null 2>&1
-brew link --force --overwrite php@"$1" >/dev/null 2>&1
-ini_file=$(php -d "date.timezone=UTC" --ini | grep "Loaded Configuration" | sed -e "s|.*:s*||" | sed "s/ //g")
-echo "date.timezone=UTC" >> "$ini_file"
-ext_dir=$(php -i | grep "extension_dir => /usr" | sed -e "s|.*=> s*||")
-sudo chmod 777 "$ini_file"
-mkdir -p "$(pecl config-get ext_dir)"
-composer global require hirak/prestissimo >/dev/null 2>&1
-add_log "$tick" "PHP" "Installed PHP $(php -v | head -n 1 | cut -c 5-10)"
-add_log "$tick" "Composer" "Installed"
-
-add_extension() {
+# Function to remove extensions.
+remove_extension() {
   extension=$1
-  install_command=$2
+  if check_extension "$extension"; then
+    sudo sed -Ei '' "/=(.*\/)?\"?$extension(.so)?$/d" "${ini_file:?}"
+    sudo rm -rf "${scan_dir:?}"/*"$extension"* "${ext_dir:?}"/"$extension".so >/dev/null 2>&1
+    (! check_extension "$extension" && add_log "${tick:?}" ":$extension" "Removed") ||
+      add_log "${cross:?}" ":$extension" "Could not remove $extension on PHP ${semver:?}"
+  else
+    add_log "${tick:?}" ":$extension" "Could not find $extension on PHP $semver"
+  fi
+}
+
+# Function to install a specific version of PECL extension.
+add_pecl_extension() {
+  extension=$1
+  pecl_version=$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"
+  enable_extension "$extension" "$prefix"
+  if [[ $pecl_version =~ .*(alpha|beta|rc|snapshot|preview).* ]]; then
+    pecl_version=$(get_pecl_version "$extension" "$pecl_version")
+  fi
+  ext_version=$(php -r "echo phpversion('$extension');")
+  if [ "$ext_version" = "$pecl_version" ]; then
+    add_log "${tick:?}" "$extension" "Enabled"
+  else
+    remove_extension "$extension" >/dev/null 2>&1
+    pecl_install "$extension-$pecl_version"
+    add_extension_log "$extension-$pecl_version" "Installed and enabled"
+  fi
+}
+
+# Function to fetch a brew tap
+fetch_brew_tap() {
+  tap=$1
+  tap_user=$(dirname "$tap")
+  tap_name=$(basename "$tap")
+  mkdir -p "$tap_dir/$tap_user"
+  get -s -n "" "https://github.com/$tap/archive/master.tar.gz" | sudo tar -xzf - -C "$tap_dir/$tap_user"
+  if [ -d "$tap_dir/$tap_user/$tap_name-master" ]; then
+    sudo mv "$tap_dir/$tap_user/$tap_name-master" "$tap_dir/$tap_user/$tap_name"
+  fi
+}
+
+# Function to add a brew tap.
+add_brew_tap() {
+  tap=$1
+  if ! [ -d "$tap_dir/$tap" ]; then
+    if [ "${runner:?}" = "self-hosted" ]; then
+      brew tap --shallow "$tap" >/dev/null 2>&1
     else
-      if ! php -m | grep -i -q "$extension"; then
-        add_log "$cross" "$extension" "Could not find $extension for PHP$version on PECL"
+      fetch_brew_tap "$tap" >/dev/null 2>&1
+      if ! [ -d "$tap_dir/$tap" ]; then
+        brew tap --shallow "$tap" >/dev/null 2>&1
       fi
     fi
   fi
-}
+}
+
+# Function to install a php extension from shivammathur/extensions tap.
+add_brew_extension() {
+  formula=$1
+  prefix=$2
+  extension=${formula//[0-9]/}
+  enable_extension "$extension" "$prefix"
+  if check_extension "$extension"; then
+    add_log "${tick:?}" "$extension" "Enabled"
+  else
+    add_brew_tap shivammathur/homebrew-php
+    add_brew_tap shivammathur/homebrew-extensions
+    sudo mv "$tap_dir"/shivammathur/homebrew-extensions/.github/deps/"$extension"/* "$tap_dir/homebrew/homebrew-core/Formula/" 2>/dev/null || true
+    brew install "$formula@$version" >/dev/null 2>&1
+    sudo cp "$brew_prefix/opt/$formula@$version/$extension.so" "$ext_dir"
+    add_extension_log "$extension" "Installed and enabled"
+  fi
+}
+
+# Function to setup extensions
+add_extension() {
+  extension=$1
+  prefix=$2
+  enable_extension "$extension" "$prefix"
+  if check_extension "$extension"; then
+    add_log "${tick:?}" "$extension" "Enabled"
+  else
+    [[ "$version" =~ 5.[4-5] ]] && [ "$extension" = "imagick" ] && brew install pkg-config imagemagick >/dev/null 2>&1
+    pecl_install "$extension" >/dev/null 2>&1 &&
+      if [[ "$version" =~ ${old_versions:?} ]]; then echo "$prefix=$ext_dir/$extension.so" >>"$ini_file"; fi
+    add_extension_log "$extension" "Installed and enabled"
+  fi
+}
+
+# Function to handle request to add phpize and php-config.
+add_devtools() {
+  tool=$1
+  add_log "${tick:?}" "$tool" "Added $tool $semver"
+}
+
+# Function to handle request to add PECL.
+add_pecl() {
+  pecl_version=$(get_tool_version "pecl" "version")
+  add_log "${tick:?}" "PECL" "Found PECL $pecl_version"
+}
+
+# Function to update dependencies.
+update_dependencies() {
+  if [[ "$version" =~ ${nightly_versions:?} ]] && [ "${runner:?}" != "self-hosted" ] && [ "${ImageOS:-}" != "" ] && [ "${ImageVersion:-}" != "" ]; then
+    while read -r formula; do
+      get -q -n "$tap_dir/homebrew/homebrew-core/Formula/$formula.rb" "https://raw.githubusercontent.com/Homebrew/homebrew-core/master/Formula/$formula.rb" &
+      to_wait+=($!)
+    done <"$tap_dir/shivammathur/homebrew-php/.github/deps/${ImageOS:?}_${ImageVersion:?}"
+    wait "${to_wait[@]}"
+  fi
+  # Remove once commit with bottle syntax breaking change is in images
+  git -C "$brew_repo" pull origin master
+}
+
+# Function to setup PHP 5.6 and newer using Homebrew.
+add_php() {
+  action=$1
+  add_brew_tap shivammathur/homebrew-php
+  update_dependencies
+  if ! [[ "$(find "$(brew --cellar)"/php/ -maxdepth 1 -name "$version*" | wc -l 2>/dev/null)" -eq 0 ]] && [ "$action" != "upgrade" ]; then
+    brew unlink shivammathur/php/php@"$version"
+  else
+    brew upgrade "shivammathur/php/php@$version" 2>/dev/null || brew install "shivammathur/php/php@$version"
+  fi
+  brew link --force --overwrite shivammathur/php/php@"$version"
+}
+
+# Function to Setup PHP
+setup_php() {
+  step_log "Setup PHP"
+  existing_version=$(php-config --version 2>/dev/null | cut -c 1-3)
+  if [[ "$version" =~ ${old_versions:?} ]]; then
+    run_script "php5-darwin" "${version/./}" >/dev/null 2>&1
+    status="Installed"
+  elif [ "$existing_version" != "$version" ]; then
+    add_php "install" >/dev/null 2>&1
+    status="Installed"
+  elif [ "$existing_version" = "$version" ] && [ "${update:?}" = "true" ]; then
+    add_php "upgrade" >/dev/null 2>&1
+    status="Updated to"
+  else
+    status="Found"
+  fi
+  ini_file=$(php -d "date.timezone=UTC" --ini | grep "Loaded Configuration" | sed -e "s|.*:s*||" | sed "s/ //g")
+  sudo chmod 777 "$ini_file" "${tool_path_dir:?}"
+  configure_php
+  ext_dir=$(php -i | grep -Ei "extension_dir => /" | sed -e "s|.*=> s*||")
+  scan_dir=$(php --ini | grep additional | sed -e "s|.*: s*||")
+  sudo mkdir -m 777 -p "$ext_dir" "$HOME/.composer"
+  semver=$(php -v | head -n 1 | cut -f 2 -d ' ')
+  if [ "${semver%.*}" != "$version" ]; then
+    add_log "$cross" "PHP" "Could not setup PHP $version"
+    exit 1
+  fi
+  sudo cp "$dist"/../src/configs/*.json "$RUNNER_TOOL_CACHE/"
+  add_log "$tick" "PHP" "$status PHP $semver"
+}
+
+# Variables
+version=$1
+dist=$2
+brew_prefix="$(brew --prefix)"
+brew_repo="$(brew --repository)"
+tap_dir="$brew_repo"/Library/Taps
+export HOMEBREW_CHANGE_ARCH_TO_ARM=1
+export HOMEBREW_NO_INSTALL_CLEANUP=1
+export HOMEBREW_NO_AUTO_UPDATE=1
+
+# shellcheck source=.
+. "${dist}"/../src/scripts/common.sh
+read_env
+self_hosted_setup
+setup_php

src/scripts/ext/blackfire.ps1

@@ -0,0 +1,28 @@
+# Function to install blackfire extension.
+Function Add-Blackfire() {
+  Param (
+    [Parameter(Position = 0, Mandatory = $true)]
+    [ValidateNotNull()]
+    [string]
+    $extension
+  )
+  try {
+    $no_dot_version = $version.replace('.', '')
+    $extension_version = $extension.split('-')[1]
+    if ($extension_version -notmatch "\S") {
+        $extension_version = (Invoke-RestMethod https://blackfire.io/api/v1/releases).probe.php
+    }
+    if (Test-Path $ext_dir\blackfire.dll) {
+        Enable-PhpExtension -Extension blackfire -Path $php_dir
+        $status="Enabled"
+    } else {
+        $nts = if (!$installed.ThreadSafe) { "_nts" } else { "" }
+        Invoke-WebRequest -Uri "https://packages.blackfire.io/binaries/blackfire-php/${extension_version}/blackfire-php-windows_${arch}-php-${no_dot_version}${nts}.dll" -OutFile $ext_dir\blackfire.dll > $null 2>&1
+        Enable-PhpExtension -Extension blackfire -Path $php_dir
+        $status="Installed and enabled"
+    }
+    Add-Log $tick $extension $status
+  } catch {
+    Add-Log $cross $extension "Could not install $extension on PHP $($installed.FullVersion)"
+  }
+}

src/scripts/ext/blackfire.sh

@@ -0,0 +1,17 @@
+# Function to install blackfire extension.
+add_blackfire() {
+  extension=$1
+  version=${version:?}
+  no_dot_version=${version/./}
+  platform=$(uname -s | tr '[:upper:]' '[:lower:]')
+  extension_version=$(echo "$extension" | cut -d '-' -f 2)
+  blackfire_ini_file="${pecl_file:-${ini_file[@]}}"
+  if [ ! -e "${ext_dir:?}/blackfire.so" ]; then
+    if [ "$extension_version" = "blackfire" ]; then
+      extension_version=$(get -s -n "" https://blackfire.io/api/v1/releases | grep -Eo 'php":"([0-9]+.[0-9]+.[0-9]+)' | cut -d '"' -f 3)
+    fi
+    get -q -n "${ext_dir:?}/blackfire.so" https://packages.blackfire.io/binaries/blackfire-php/"$extension_version"/blackfire-php-"$platform"_amd64-php-"$no_dot_version".so >/dev/null 2>&1
+  fi
+  echo "extension=blackfire.so" | sudo tee -a "$blackfire_ini_file" >/dev/null 2>&1
+  add_extension_log "$extension-$extension_version" "Installed and enabled"
+}

src/scripts/ext/couchbase.sh

@@ -0,0 +1,42 @@
+# Function to install libraries required by couchbase
+add_couchbase_libs() {
+  if [ "$(uname -s)" = "Linux" ]; then
+    if [[ ${version:?} =~ 5.6|7.[0-1] ]]; then
+      trunk="http://packages.couchbase.com/ubuntu"
+      list="deb $trunk ${DISTRIB_CODENAME:?} ${DISTRIB_CODENAME:?}/main"
+    else
+      trunk="http://packages.couchbase.com/clients/c/repos/deb"
+      list="deb $trunk/ubuntu${DISTRIB_RELEASE/./} ${DISTRIB_CODENAME:?} ${DISTRIB_CODENAME:?}/main"
+    fi
+    add_pecl
+    get -s -n "" "$trunk/couchbase.key" | sudo apt-key add
+    echo "$list" | sudo tee /etc/apt/sources.list.d/couchbase.list
+    sudo apt-get update
+    ${apt_install:?} libcouchbase-dev
+  else
+    if [[ ${version:?} =~ 5.6|7.[0-1] ]]; then
+      brew install libcouchbase@2
+      brew link --overwrite --force libcouchbase@2
+    else
+      brew install libcouchbase
+    fi
+  fi
+}
+
+# Function to add couchbase.
+add_couchbase() {
+  add_couchbase_libs >/dev/null 2>&1
+  enable_extension "couchbase" "extension"
+  if check_extension "couchbase"; then
+    add_log "${tick:?}" "couchbase" "Enabled"
+  else
+    if [[ ${version:?} =~ 5.6|7.[0-1] ]]; then
+      pecl_install couchbase-2.6.2 >/dev/null 2>&1
+    elif [[ ${version:?} =~ 7.2 ]]; then
+      pecl_install couchbase-3.0.4 >/dev/null 2>&1
+    else
+      pecl_install couchbase >/dev/null 2>&1
+    fi
+    add_extension_log "couchbase" "Installed and enabled"
+  fi
+}

src/scripts/ext/cubrid.sh

@@ -0,0 +1,52 @@
+# Function to log license details.
+add_license_log() {
+  printf "::group::\033[34;1m%s \033[0m\033[90;1m%s \033[0m\n" "$ext" "Click to read the $ext related license information"
+  printf "Cubrid CCI package is required for %s extension.\n" "$ext"
+  printf "The extension %s and Cubrid CCI are provided under the license linked below.\n" "$ext"
+  printf "Refer to: \033[35;1m%s \033[0m\n" "https://github.com/CUBRID/cubrid-cci/blob/develop/COPYING"
+  echo "::endgroup::"
+}
+
+# Function to set cubrid repo for the extension.
+set_cubrid_repo() {
+  case "${ext:?}" in
+    "cubrid") cubrid_repo="cubrid-php";;
+    "pdo_cubrid") cubrid_repo="cubrid-pdo";;
+  esac
+}
+
+# Function to set cubrid branch for a PHP version.
+set_cubrid_branch() {
+  case "${version:?}" in
+    5.[3-6]) cubrid_branch="RB-9.3.0";;
+    *) cubrid_branch="develop";;
+  esac
+}
+
+add_cubrid_helper() {
+  ext=$1
+  enable_extension "$ext" extension
+  if ! check_extension "$ext"; then
+    status='Installed and enabled'
+    set_cubrid_repo
+    set_cubrid_branch
+    (
+      git clone -b "$cubrid_branch" --recursive "https://github.com/CUBRID/$cubrid_repo" "/tmp/$cubrid_repo"
+      cd "/tmp/$cubrid_repo" || exit
+      ! [[ "$version" =~ ${old_versions:?} ]] && add_devtools
+      phpize && ./configure --with-php-config="$(command -v php-config)" --with-"${ext/_/-}"=shared
+      make -j"$(nproc)"
+      sudo make install
+    )
+    echo "extension=$ext.so" | sudo tee "${scan_dir:?}/$ext.ini"
+  fi
+}
+
+# Function to add cubrid and pdo_cubrid.
+add_cubrid() {
+  ext=$1
+  status='Enabled'
+  add_cubrid_helper "$ext" >/dev/null 2>&1
+  add_extension_log "$ext" "$status"
+  check_extension "$ext" && add_license_log
+}

src/scripts/ext/gearman.sh

@@ -0,0 +1,23 @@
+# Helper function to add gearman extension.
+add_gearman_helper() {
+  sudo "${debconf_fix:?}" add-apt-repository ppa:ondrej/pkg-gearman -y
+  if [ -e "${ext_dir:?}/gearman.so" ] && [ "$DISTRIB_RELEASE" != "16.04" ]; then
+    ${apt_install:?} libgearman-dev
+    echo "extension=gearman.so" | sudo tee -a "${scan_dir:?}/20-gearman.ini" >/dev/null 2>&1
+  else
+    status="Installed and enabled"
+    if [ "$DISTRIB_RELEASE" = "16.04" ]; then
+      sudo "${debconf_fix:?}" apt-get update -y
+      ${apt_install:?} php"${version:?}"-gearman
+    else
+      ${apt_install:?} libgearman-dev php"${version:?}"-gearman
+    fi
+  fi
+}
+
+# Function to add gearman extension.
+add_gearman() {
+  status="Enabled"
+  add_gearman_helper >/dev/null 2>&1
+  add_extension_log "gearman" "$status"
+}

src/scripts/ext/geos.sh

@@ -0,0 +1,51 @@
+# Helper function install geos library and headers
+add_geos_libs() {
+  if [ "$(uname -s)" = "Darwin" ]; then
+    brew install geos
+  else
+    sudo apt-get install libgeos-dev
+    if [ "${runner:?}" = "self-hosted" ]; then
+      ${apt_install:?} --no-upgrade --no-install-recommends autoconf automake gcc g++
+    fi
+  fi
+}
+
+# Patch geos for PHP 7
+patch_geos() {
+  if [ "$(php -r "echo PHP_VERSION_ID;")" -ge 70000 ]; then
+    sed -i~ -e "s/, ce->name/, ZSTR_VAL(ce->name)/; s/ulong /zend_ulong /" /tmp/php-geos-"$geos_tag"/geos.c
+  fi
+}
+
+# Get geos source
+get_geos() {
+  curl -o /tmp/geos.tar.gz -sL https://github.com/libgeos/php-geos/archive/"$geos_tag".tar.gz
+  tar -xzf /tmp/geos.tar.gz -C /tmp
+  patch_geos
+}
+
+# Helper function to compile and install geos
+add_geos_helper() {
+  get_geos
+  (
+    cd /tmp/php-geos-"$geos_tag" || exit
+    phpize
+    ./configure --enable-geos --with-geos-config="$(command -v geos-config)"
+    sudo make -j"$(nproc)"
+    sudo make install
+    enable_extension geos extension
+  )
+}
+
+# Function to add geos
+add_geos() {
+  geos_tag='1.0.0'
+  add_geos_libs >/dev/null 2>&1
+  enable_extension "geos" "extension"
+  if check_extension "geos"; then
+    add_log "${tick:?}" "geos" "Enabled"
+  else
+    add_geos_helper >/dev/null 2>&1
+    add_extension_log "geos" "Installed and enabled"
+  fi
+}

src/scripts/ext/intl.sh

@@ -0,0 +1,23 @@
+# Function to install ICU
+install_icu() {
+  icu=$1
+  if [ "$(php -i | grep "ICU version =>" | sed -e "s|.*=> s*||")" != "$icu" ]; then
+    get -q -n /tmp/icu.tar.zst "https://dl.bintray.com/shivammathur/icu4c/icu4c-$icu.tar.zst"
+    sudo tar -I zstd -xf /tmp/icu.tar.zst -C /usr/local
+    sudo cp -r /usr/local/icu/lib/* /usr/lib/x86_64-linux-gnu/
+  fi
+}
+
+# Function to add ext-intl with the given version of ICU
+add_intl() {
+  icu=$(echo "$1" | cut -d'-' -f 2)
+  supported_version=$(get -s -n "" https://api.bintray.com/packages/shivammathur/icu4c/icu4c | grep -Po "$icu" | head -n 1)
+  if [ "$icu" != "$supported_version" ]; then
+    add_log "${cross:?}" "intl" "ICU $icu is not supported"
+  else
+    install_icu "$icu" >/dev/null 2>&1
+    get -q -n "${ext_dir:?}/intl.so" "https://dl.bintray.com/shivammathur/icu4c/php${version:?}-intl-$icu.so"
+    enable_extension intl extension
+    add_extension_log intl "Installed and enabled with ICU $icu"
+  fi
+}

src/scripts/ext/ioncube.ps1

@@ -0,0 +1,32 @@
+# Function to log result of a operation.
+Function Add-LicenseLog() {
+  printf "::group::\033[34;1m%s \033[0m\033[90;1m%s \033[0m\n" "ioncube" "Click to read the ioncube loader license information"
+  Get-Content $ext_dir\ioncube\LICENSE.txt
+  Write-Output "::endgroup::"
+}
+
+# Function to add ioncube extension.
+Function Add-Ioncube() {
+  try {
+    if (-not(Test-Path $ext_dir\php_ioncube.dll)) {
+      $status = 'Installed and enabled'
+      $arch_part = $arch
+      if ($arch -eq 'x64') {
+        $arch_part = 'x86-64'
+      }
+      $vc = $installed.VCVersion
+      $ts_part = ""
+      if (-not($installed.ThreadSafe)) {
+        $ts_part = "_nonts"
+      }
+      Invoke-WebRequest -Uri "https://downloads.ioncube.com/loader_downloads/ioncube_loaders_win$ts_part`_vc$vc`_$arch_part.zip" -OutFile $ext_dir\ioncube.zip
+      Expand-Archive -Path $ext_dir\ioncube.zip -DestinationPath $ext_dir -Force
+      Copy-Item $ext_dir\ioncube\ioncube_loader_win_$version.dll $ext_dir\php_ioncube.dll
+    }
+    "zend_extension=$ext_dir\php_ioncube.dll`r`n" + (Get-Content $php_dir\php.ini -Raw) | Set-Content $php_dir\php.ini
+    Add-Log $tick "ioncube" $status
+    Add-LicenseLog
+  } catch {
+    Add-Log $cross "ioncube" "Could not install ioncube on PHP $($installed.FullVersion)"
+  }
+}

src/scripts/ext/ioncube.sh

@@ -0,0 +1,19 @@
+# Function to log result of a operation.
+add_license_log() {
+  printf "::group::\033[34;1m%s \033[0m\033[90;1m%s \033[0m\n" "ioncube" "Click to read the ioncube loader license information"
+  cat /tmp/ioncube/LICENSE.txt
+  echo "::endgroup::"
+}
+
+# Function to install ioncube.
+add_ioncube() {
+  if [ ! -e "${ext_dir:?}/ioncube.so" ]; then
+    status='Installed and enabled'
+    os_name='lin' && [ "$(uname -s)" = "Darwin" ] && os_name='mac'
+    get -s -n "" https://downloads.ioncube.com/loader_downloads/ioncube_loaders_"$os_name"_x86-64.tar.gz | tar -xzf - -C /tmp
+    sudo mv /tmp/ioncube/ioncube_loader_"$os_name"_"${version:?}".so "$ext_dir/ioncube.so"
+  fi
+  echo "zend_extension=$ext_dir/ioncube.so" | sudo tee "${scan_dir:?}/00-ioncube.ini" >/dev/null 2>&1
+  add_extension_log "ioncube" "$status"
+  check_extension "ioncube" && add_license_log
+}

src/scripts/ext/oci.ps1

@@ -0,0 +1,58 @@
+# Function to log license information.
+Function Add-LicenseLog() {
+    printf "::group::\033[34;1m%s \033[0m\033[90;1m%s \033[0m\n" $extension "Click to read the $extension related license information"
+    printf "Oracle Instant Client package is required for %s extension.\n" $extension
+    printf "It is provided under the Oracle Technology Network Development and Distribution License.\n"
+    printf "Refer to: \033[35;1m%s \033[0m\n" "https://www.oracle.com/downloads/licenses/instant-client-lic.html"
+    Write-Output "::endgroup::"
+}
+
+# Function to get instantclinet.
+Function Add-InstantClient() {
+  if (-not(Test-Path $php_dir\oci.dll)) {
+    $suffix = 'windows'
+    if ($arch -eq 'x86') {
+      $suffix = 'nt'
+    }
+    Invoke-WebRequest -Uri https://download.oracle.com/otn_software/nt/instantclient/instantclient-basiclite-$suffix.zip -OutFile $php_dir\instantclient.zip
+    Expand-Archive -Path $php_dir\instantclient.zip -DestinationPath $php_dir -Force
+    Copy-Item $php_dir\instantclient*\* $php_dir
+  }
+}
+
+# Function to install oci8 and pdo_oci.
+Function Add-Oci() {
+  Param (
+    [Parameter(Position = 0, Mandatory = $true)]
+    [ValidateNotNull()]
+    [ValidateSet('oci8', 'pdo_oci')]
+    [string]
+    $extension
+  )
+  try {
+    $status = 'Enabled'
+    Add-InstantClient
+    if ($extension -eq "pdo_oci") {
+      Enable-PhpExtension pdo_oci -Path $php_dir
+    } else {
+      if(-not(Test-Path $ext_dir\php_oci8.dll)) {
+        $status = 'Installed and enabled'
+        $ociVersion = '2.2.0'
+        if ($version -eq '7.0') {
+          $ociVersion = '2.1.8'
+        } elseif ($version -lt '7.0') {
+          $ociVersion = '2.0.12'
+        }
+        $ociUrl = Get-PeclArchiveUrl oci8 $ociVersion $installed
+        Invoke-WebRequest -Uri $ociUrl -OutFile $php_dir\oci8.zip
+        Expand-Archive -Path $php_dir\oci8.zip -DestinationPath $ext_dir -Force
+
+      }
+      Add-Content -Value "`r`nextension=php_oci8.dll" -Path $php_dir\php.ini
+    }
+    Add-Log $tick $extension $status
+    Add-LicenseLog
+  } catch {
+    Add-Log $cross $extension "Could not install $extension on PHP $( $installed.FullVersion )"
+  }
+}

src/scripts/ext/oci.sh

@@ -0,0 +1,125 @@
+# Function to log result of a operation.
+add_license_log() {
+  printf "::group::\033[34;1m%s \033[0m\033[90;1m%s \033[0m\n" "$ext" "Click to read the $ext related license information"
+  printf "Oracle Instant Client package is required for %s extension.\n" "$ext"
+  printf "It is provided under the Oracle Technology Network Development and Distribution License.\n"
+  printf "Refer to: \033[35;1m%s \033[0m\n" "https://www.oracle.com/downloads/licenses/instant-client-lic.html"
+  echo "::endgroup::"
+}
+
+# Function to get the tag for a php version.
+get_tag() {
+  tag='master'
+  if ! [[ ${version:?} =~ $nightly_versions ]]; then
+    tag="php-$(php -v | head -n 1 | cut -f 2 -d ' ' | cut -f 1 -d '-')"
+  elif [ "${version:?}" = '8.0' ]; then
+    tag="PHP-8.0"
+  fi
+  echo "$tag"
+}
+
+# Function to install instantclient and SDK.
+add_client() {
+  sudo mkdir -p -m 777 "$oracle_home"
+  if [ ! -e "$oracle_client" ]; then
+    for package in basiclite sdk; do
+      if [ "$os" = 'Linux' ]; then
+        libs='/usr/lib/'
+        os_name='linux'
+        arch='linuxx64'
+        lib_ext='so'
+      elif [ "$os" = 'Darwin' ]; then
+        libs='/usr/local/lib/'
+        os_name='mac'
+        arch='macos'
+        lib_ext='dylib'
+      fi
+      get -q -n "/opt/oracle/$package.zip" "https://download.oracle.com/otn_software/$os_name/instantclient/instantclient-$package-$arch.zip"
+      unzip "/opt/oracle/$package.zip" -d "$oracle_home"
+    done
+    sudo ln -sf /opt/oracle/instantclient*/*.$lib_ext* $libs
+    sudo ln -sf /opt/oracle/instantclient* "$oracle_client"
+  fi
+}
+
+# Function to get PHP source.
+get_php() {
+  [ ! -d "/opt/oracle/php-src-$tag" ] && get -s -n "" "https://github.com/php/php-src/archive/$tag.tar.gz" | tar xzf - -C "$oracle_home/"
+}
+
+# Function to get phpize location on darwin.
+get_phpize() {
+  if [[ "$version" =~ 5.[3-5] ]]; then
+    echo '/opt/local/bin/phpize'
+  else
+    echo "/usr/local/bin/$(readlink /usr/local/bin/phpize)"
+  fi
+}
+
+# Function to patch phpize to link to php headers on darwin.
+patch_phpize() {
+  if [ "$os" = "Darwin" ]; then
+    sudo cp "$phpize_orig" "$phpize_orig.bck"
+    sudo sed -i '' 's~includedir=.*~includedir="$(xcrun --show-sdk-path)/usr/include/php"~g' "$phpize_orig"
+  fi
+}
+
+# Function to restore phpize.
+restore_phpize() {
+  if [ "$os" = "Darwin" ]; then
+    sudo mv "$phpize_orig.bck" "$phpize_orig" || true
+  fi
+}
+
+# Function to patch pdo_oci.
+patch_pdo_oci_config() {
+  get -q -n config.m4 https://raw.githubusercontent.com/php/php-src/PHP-8.0/ext/pdo_oci/config.m4
+  if [[ ${version:?} =~ 5.[3-6] ]]; then
+    sudo sed -i '' "/PHP_CHECK_PDO_INCLUDES/d" config.m4 2>/dev/null || sudo sed -i "/PHP_CHECK_PDO_INCLUDES/d" config.m4
+  fi
+}
+
+# Function to install the dependencies.
+add_dependencies() {
+  if [ "$os" = 'Linux' ]; then
+    if [ "${runner:?}" = "self-hosted" ]; then
+      ${apt_install:?} --no-upgrade --no-install-recommends libaio-dev
+    fi
+    ! [[ ${version:?} =~ $nightly_versions ]] && add_devtools phpize
+  fi
+}
+
+# Function to install oci8 and pdo_oci.
+add_oci_helper() {
+  if ! [ -e "${ext_dir:?}/$ext.so" ]; then
+    status='Installed and enabled'
+    phpize_orig=$(get_phpize)
+    tag=$(get_tag)
+    get_php
+    patch_phpize
+    (
+      cd "/opt/oracle/php-src-$tag/ext/$ext" || exit 1
+      [ "$ext" = "pdo_oci" ] && patch_pdo_oci_config
+      sudo phpize && ./configure --with-php-config="$(command -v php-config)" --with-"${ext/_/-}"=instantclient,"$oracle_client"
+      sudo make -j"$(nproc)"
+      sudo cp ./modules/* "$ext_dir/"
+    )
+    restore_phpize
+  fi
+  echo "extension=$ext.so" | sudo tee "${scan_dir:?}/99-$ext.ini"
+}
+
+# Function to add oci extension oci8 and pdo_oci.
+add_oci() {
+  ext=$1
+  status='Enabled'
+  oracle_home='/opt/oracle'
+  oracle_client=$oracle_home/instantclient
+  os=$(uname -s)
+  nightly_versions='8.[0-1]'
+  add_client >/dev/null 2>&1
+  add_dependencies >/dev/null 2>&1
+  add_oci_helper >/dev/null 2>&1
+  add_extension_log "$ext" "$status"
+  check_extension "$ext" && add_license_log
+}

src/scripts/ext/phalcon.ps1

@@ -0,0 +1,55 @@
+# Function to install phalcon
+Function Add-PhalconHelper() {
+  if ($extension_version -eq '4') {
+    Install-Phpextension phalcon -MinimumStability stable -Path $php_dir
+  } else {
+    $domain = 'https://github.com'
+    $nts = if (!$installed.ThreadSafe) { "_nts" } else { "" }
+    $match = Invoke-WebRequest -Uri $domain/phalcon/cphalcon/releases | Select-String -Pattern "href=`"(.*phalcon_x64_.*_php${version}_${extension_version}.*[0-9]${nts}.zip)`""
+    $zip_file = $match.Matches[0].Groups[1].Value
+    Invoke-WebRequest -Uri $domain/$zip_file -OutFile $ENV:RUNNER_TOOL_CACHE\phalcon.zip > $null 2>&1
+    Expand-Archive -Path $ENV:RUNNER_TOOL_CACHE\phalcon.zip -DestinationPath $ENV:RUNNER_TOOL_CACHE\phalcon -Force > $null 2>&1
+    Copy-Item -Path "$ENV:RUNNER_TOOL_CACHE\phalcon\php_phalcon.dll" -Destination "$ext_dir\php_phalcon.dll"
+    Enable-PhpExtension -Extension phalcon -Path $php_dir
+  }
+}
+
+Function Add-Phalcon() {
+  Param (
+    [Parameter(Position = 0, Mandatory = $true)]
+    [ValidateNotNull()]
+    [ValidateSet('phalcon3', 'phalcon4')]
+    [string]
+    $extension
+  )
+  try {
+    $status = 'Enabled'
+    $extension_version = $extension.substring($extension.Length - 1)
+
+    if($extension_version -eq '4') {
+      if (Test-Path $ext_dir\php_psr.dll) {
+        Enable-PhpExtension -Extension psr -Path $php_dir
+      } else {
+        Install-Phpextension psr -MinimumStability stable -Path $php_dir
+      }
+    }
+
+    if(Test-Path $ext_dir\php_phalcon.dll) {
+      $phalcon = Get-PhpExtension $ext_dir\php_phalcon.dll
+      if($phalcon.Version[0] -eq $extension_version) {
+        Enable-PhpExtension -Extension phalcon -Path $php_dir
+      } else {
+        $status = 'Installed and enabled'
+        Remove-Item $ext_dir\php_phalcon.dll
+        Add-PhalconHelper
+      }
+    } else {
+      $status = 'Installed and enabled'
+      Add-PhalconHelper
+    }
+    Add-Log $tick $extension $status
+  } catch [Exception] {
+    Write-Output $_.Exception|format-list -force
+    Add-Log $cross $extension "Could not install $extension on PHP $($installed.FullVersion)"
+  }
+}

src/scripts/ext/phalcon.sh

@@ -0,0 +1,68 @@
+# Helper function to add phalcon.
+add_phalcon_helper() {
+  status='Installed and enabled'
+  if [ "$os_name" = "Linux" ]; then
+    update_lists
+    if [ "$extension" = "phalcon4" ]; then
+      ${apt_install:?} "php${version:?}-psr" "php${version:?}-$extension"
+    else
+      ${apt_install:?} "php${version:?}-$extension"
+    fi
+  else
+    sed -i '' '/extension.*psr/d' "${ini_file:?}"
+    brew tap shivammathur/homebrew-phalcon
+    brew install phalcon@"${version:?}"_"$extension_major_version"
+    sudo cp /usr/local/opt/psr@"${version:?}"/psr.so "${ext_dir:?}"
+    sudo cp /usr/local/opt/phalcon@"${version:?}"_"$extension_major_version"/phalcon.so "${ext_dir:?}"
+  fi
+}
+
+# Function to add phalcon3.
+add_phalcon3() {
+  if [ -e "${ext_dir:?}/phalcon.so" ]; then
+    phalcon_version=$(php -d="extension=phalcon.so" -r "echo phpversion('phalcon');" | cut -d'.' -f 1)
+    if [ "$phalcon_version" != "$extension_major_version" ]; then
+      add_phalcon_helper
+    else
+      echo "extension=phalcon.so" | sudo tee -a "$phalcon_ini_file"
+    fi
+  else
+    add_phalcon_helper
+  fi
+}
+
+# Function to add phalcon4.
+add_phalcon4() {
+  if [ -e "${ext_dir:?}/psr.so" ] && ! php -m | grep -i -q -w psr; then
+    echo "extension=psr.so" | sudo tee -a "${ini_file:?}"
+  fi
+  if [ -e "$ext_dir/phalcon.so" ]; then
+    if php -m | grep -i -q -w psr; then
+      phalcon_version=$(php -d="extension=phalcon" -r "echo phpversion('phalcon');" | cut -d'.' -f 1)
+      if [ "$phalcon_version" != "$extension_major_version" ]; then
+        add_phalcon_helper
+      else
+        echo "extension=phalcon.so" | sudo tee -a "$phalcon_ini_file"
+      fi
+    else
+      add_phalcon_helper
+    fi
+  else
+    add_phalcon_helper
+  fi
+}
+
+# Function to add phalcon.
+add_phalcon() {
+  extension=$1
+  status='Enabled'
+  os_name=$(uname -s)
+  phalcon_ini_file="${pecl_file:-${ini_file[@]}}"
+  extension_major_version=${extension: -1}
+  if [ "$extension_major_version" = "4" ]; then
+    add_phalcon4 >/dev/null 2>&1
+  elif [ "$extension_major_version" = "3" ]; then
+    add_phalcon3 >/dev/null 2>&1
+  fi
+  add_extension_log "phalcon" "$status"
+}

src/scripts/linux.sh

@@ -1,93 +1,310 @@
-tick="✓"
-cross="✗"
-
-step_log() {
-  message=$1
-  printf "\n\033[90;1m==> \033[0m\033[37;1m%s\033[0m\n" "$message"
+# Function to setup environment for self-hosted runners.
+self_hosted_helper() {
+  if ! command -v apt-fast >/dev/null; then
+    sudo ln -sf /usr/bin/apt-get /usr/bin/apt-fast
+  fi
+  install_packages curl make software-properties-common unzip autoconf automake gcc g++
+  add_ppa
 }
 
-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"
+# Function to backup and cleanup package lists.
+cleanup_lists() {
+  if [ ! -e /etc/apt/sources.list.d.save ]; then
+    sudo mv /etc/apt/sources.list.d /etc/apt/sources.list.d.save
+    sudo mkdir /etc/apt/sources.list.d
+    sudo mv /etc/apt/sources.list.d.save/*ondrej*.list /etc/apt/sources.list.d/
+    sudo mv /etc/apt/sources.list.d.save/*dotdeb*.list /etc/apt/sources.list.d/ 2>/dev/null || true
+    trap "sudo mv /etc/apt/sources.list.d.save/*.list /etc/apt/sources.list.d/ 2>/dev/null" exit
   fi
 }
-existing_version=$(php-config --version | cut -c 1-3)
-version=$1
-step_log "Setup PHP and Composer"
-sudo mkdir -p /var/run
-sudo mkdir -p /run/php
-find /etc/apt/sources.list.d -type f -name 'ondrej-ubuntu-php*.list' -exec sudo DEBIAN_FRONTEND=noninteractive apt-fast update -o Dir::Etc::sourcelist="{}" ';' >/dev/null 2>&1
-if [ "$existing_version" != "$1" ]; then
-	if [ ! -e "/usr/bin/php$1" ]; then
-		if [ "$1" != "7.4" ]; then
-		  sudo DEBIAN_FRONTEND=noninteractive apt-fast install -y php"$1" curl php"$1"-curl >/dev/null 2>&1
-		else
-		  sudo DEBIAN_FRONTEND=noninteractive apt-fast install -y php"$1" php"$1"-phpdbg php"$1"-xml curl php"$1"-curl >/dev/null 2>&1
-		fi
-		status="installed"
-	else
-	  status="switched"
-	fi
 
-	for tool in php phar phar.phar php-cgi php-config phpize phpdbg; do
-		if [ -e "/usr/bin/$tool$1" ]; then
-			sudo update-alternatives --set $tool /usr/bin/"$tool$1" >/dev/null 2>&1
-		fi
-	done
-	if [ "$status" != "switched" ]; then
-	  status="Installed PHP $(php -v | head -n 1 | cut -c 5-10)"
-	else
-	  status="Switched to PHP $(php -v | head -n 1 | cut -c 5-10)"
-	fi
-else
-  status="PHP $(php -v | head -n 1 | cut -c 5-10) Found"
-fi
+# Function to add ppa:ondrej/php.
+add_ppa() {
+  if ! apt-cache policy | grep -q ondrej/php; then
+    cleanup_lists
+    LC_ALL=C.UTF-8 sudo apt-add-repository ppa:ondrej/php -y
+    if [ "$DISTRIB_RELEASE" = "16.04" ]; then
+      sudo "$debconf_fix" apt-get update
+    fi
+  fi
+}
 
-ini_file=$(php --ini | grep "Loaded Configuration" | sed -e "s|.*:s*||" | sed "s/ //g")
-ext_dir=$(php -i | grep "extension_dir => /usr" | sed -e "s|.*=> s*||")
-sudo chmod 777 "$ini_file"
-add_log "$tick" "PHP" "$status"
-if [ "$2" = "true" ]; then
-  sudo DEBIAN_FRONTEND=noninteractive apt-fast install -y php"$1"-dev php"$1"-xml >/dev/null 2>&1
-  sudo update-alternatives --set php-config /usr/bin/php-config"$1" >/dev/null 2>&1
-  sudo update-alternatives --set phpize /usr/bin/phpize"$1" >/dev/null 2>&1
-  wget https://github.com/pear/pearweb_phars/raw/master/install-pear-nozlib.phar >/dev/null 2>&1
-  sudo php install-pear-nozlib.phar >/dev/null 2>&1
-  sudo pear config-set php_ini "$ini_file" >/dev/null 2>&1
-  add_log "$tick" "PECL" "Installed"
-fi
+# Function to update the package lists.
+update_lists() {
+  if [ ! -e /tmp/setup_php ]; then
+    [ "$DISTRIB_RELEASE" = "20.04" ] && add_ppa >/dev/null 2>&1
+    cleanup_lists
+    sudo "$debconf_fix" apt-get update >/dev/null 2>&1
+    echo '' | sudo tee /tmp/setup_php >/dev/null 2>&1
+  fi
+}
 
-if [ ! -e "/usr/bin/composer" ]; then
-	curl -s -L https://getcomposer.org/installer > composer-setup.php
-	if [ "$(curl -s https://composer.github.io/installer.sig)" != "$(php -r "echo hash_file('sha384', 'composer-setup.php');")" ]; then
-		>&2 echo 'ERROR: Invalid installer signature'		
-	else
-		export COMPOSER_ALLOW_SUPERUSER=1
-		sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer
-	fi
-	rm composer-setup.php	
-fi
-composer global require hirak/prestissimo >/dev/null 2>&1
-add_log "$tick" "Composer" "Installed"
+# Function to install a package
+install_packages() {
+  packages=("$@")
+  $apt_install "${packages[@]}" >/dev/null 2>&1 || update_lists && $apt_install "${packages[@]}" >/dev/null 2>&1
+}
 
-add_extension()
-{
+# Function to disable an extension.
+disable_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
-      (
-        eval "$install_command" && \
-        add_log "$tick" "$extension" "Installed and enabled"
-      ) || add_log "$cross" "$extension" "Could not install $extension on php$version"
+  sudo sed -Ei "/=(.*\/)?\"?$extension(.so)?$/d" "${ini_file[@]}"
+  sudo sed -Ei "/=(.*\/)?\"?$extension(.so)?$/d" "$pecl_file"
+  sudo find "$ini_dir"/.. -name "*$extension.ini" -delete >/dev/null 2>&1 || true
+}
+
+# Function to delete an extension.
+delete_extension() {
+  extension=$1
+  disable_extension "$extension"
+  sudo rm -rf "$ext_dir"/"$extension".so >/dev/null 2>&1
+  sudo sed -i "/Package: php$version-$extension/,/^$/d" /var/lib/dpkg/status
+}
+
+# Function to disable and delete extensions.
+remove_extension() {
+  extension=$1
+  if check_extension "$extension"; then
+    if [[ ! "$version" =~ ${old_versions:?} ]] && [ -e /etc/php/"$version"/mods-available/"$extension".ini ]; then
+      sudo phpdismod -v "$version" "$extension" >/dev/null 2>&1
+    fi
+    delete_extension "$extension"
+    (! check_extension "$extension" && add_log "${tick:?}" ":$extension" "Removed") ||
+      add_log "${cross:?}" ":$extension" "Could not remove $extension on PHP ${semver:?}"
+  else
+    delete_extension "$extension"
+    add_log "${tick:?}" ":$extension" "Could not find $extension on PHP $semver"
   fi
-}
+}
+
+# Function to add PDO extension.
+add_pdo_extension() {
+  pdo_ext="pdo_$1"
+  if check_extension "$pdo_ext"; then
+    add_log "${tick:?}" "$pdo_ext" "Enabled"
+  else
+    ext=$1
+    ext_name=$1
+    disable_extension pdo
+    echo "extension=pdo.so" | sudo tee "${ini_file[@]/php.ini/conf.d/10-pdo.ini}" >/dev/null 2>&1
+    if [ "$ext" = "mysql" ]; then
+      enable_extension "mysqlnd" "extension"
+      ext_name='mysqli'
+    elif [ "$ext" = "dblib" ]; then
+      ext_name="sybase"
+    elif [ "$ext" = "firebird" ]; then
+      install_packages libfbclient2 >/dev/null 2>&1
+      enable_extension "pdo_firebird" "extension"
+      ext_name="interbase"
+    elif [ "$ext" = "sqlite" ]; then
+      ext="sqlite3"
+      ext_name="sqlite3"
+    fi
+    add_extension "$ext_name" "extension" >/dev/null 2>&1
+    add_extension "$pdo_ext" "extension" >/dev/null 2>&1
+    add_extension_log "$pdo_ext" "Enabled"
+  fi
+}
+
+# Function to add extensions.
+add_extension() {
+  extension=$1
+  prefix=$2
+  enable_extension "$extension" "$prefix"
+  if check_extension "$extension"; then
+    add_log "${tick:?}" "$extension" "Enabled"
+  else
+    if [[ "$version" =~ 5.[4-5] ]]; then
+      install_packages "php5-$extension=$release_version"
+    elif [[ "$version" =~ ${nightly_versions:?} ]]; then
+      pecl_install "$extension"
+    else
+      install_packages "php$version-$extension" || pecl_install "$extension"
+    fi
+    add_extension_log "$extension" "Installed and enabled"
+  fi
+  sudo chmod 777 "${ini_file[@]}"
+}
+
+# Function to install a PECL version.
+add_pecl_extension() {
+  extension=$1
+  pecl_version=$2
+  prefix=$3
+  if [[ $pecl_version =~ .*(alpha|beta|rc|snapshot|preview).* ]]; then
+    pecl_version=$(get_pecl_version "$extension" "$pecl_version")
+  fi
+  enable_extension "$extension" "$prefix"
+  ext_version=$(php -r "echo phpversion('$extension');")
+  if [ "$ext_version" = "$pecl_version" ]; then
+    add_log "${tick:?}" "$extension" "Enabled"
+  else
+    delete_extension "$extension"
+    pecl_install "$extension-$pecl_version"
+    add_extension_log "$extension-$pecl_version" "Installed and enabled"
+  fi
+}
+
+# Function to install extension from source
+add_extension_from_source() {
+  extension=$1
+  repo=$2
+  release=$3
+  args=$4
+  prefix=$5
+  (
+    add_devtools phpize
+    delete_extension "$extension"
+    get -q -n "/tmp/$extension.tar.gz" "https://github.com/$repo/archive/$release.tar.gz"
+    tar xf /tmp/"$extension".tar.gz -C /tmp
+    cd /tmp/"$extension-$release" || exit 1
+    phpize && ./configure "$args" && make -j"$(nproc)" && sudo make install
+    enable_extension "$extension" "$prefix"
+  ) >/dev/null 2>&1
+  add_extension_log "$extension-$release" "Installed and enabled"
+}
+
+# Function to setup phpize and php-config.
+add_devtools() {
+  tool=$1
+  if ! command -v "$tool$version" >/dev/null; then
+    install_packages "php$version-dev" "php$version-xml"
+  fi
+  sudo update-alternatives --set php-config /usr/bin/php-config"$version" >/dev/null 2>&1
+  sudo update-alternatives --set phpize /usr/bin/phpize"$version" >/dev/null 2>&1
+  configure_pecl >/dev/null 2>&1
+  add_log "${tick:?}" "$tool" "Added $tool $semver"
+}
+
+# Function to setup the nightly build from shivammathur/php-builder
+setup_nightly() {
+  run_script "php-builder" "$runner" "$version"
+}
+
+# Function to setup PHP 5.3, PHP 5.4 and PHP 5.5.
+setup_old_versions() {
+  run_script "php5-ubuntu" "$version"
+  release_version=$(php -v | head -n 1 | cut -d' ' -f 2)
+}
+
+# Function to add PECL.
+add_pecl() {
+  add_devtools phpize >/dev/null 2>&1
+  if ! command -v pecl >/dev/null; then
+    install_packages php-pear
+  fi
+  configure_pecl >/dev/null 2>&1
+  pecl_version=$(get_tool_version "pecl" "version")
+  add_log "${tick:?}" "PECL" "Added PECL $pecl_version"
+}
+
+# Function to switch versions of PHP binaries.
+switch_version() {
+  for tool in pear pecl php phar phar.phar php-cgi php-config phpize phpdbg; do
+    if [ -e "/usr/bin/$tool$version" ]; then
+      sudo update-alternatives --set $tool /usr/bin/"$tool$version" &
+      to_wait+=($!)
+    fi
+  done
+  wait "${to_wait[@]}"
+}
+
+# Function to install packaged PHP
+add_packaged_php() {
+  if [ "$runner" = "self-hosted" ] || [ "${use_package_cache:-true}" = "false" ]; then
+    update_lists
+    IFS=' ' read -r -a packages <<<"$(echo "cli curl mbstring xml intl" | sed "s/[^ ]*/php$version-&/g")"
+    $apt_install "${packages[@]}"
+  else
+    run_script "php-ubuntu" "$version"
+  fi
+}
+
+# Function to update PHP.
+update_php() {
+  initial_version=$(php_semver)
+  use_package_cache="false" add_packaged_php
+  updated_version=$(php_semver)
+  if [ "$updated_version" != "$initial_version" ]; then
+    status="Updated to"
+  else
+    status="Switched to"
+  fi
+}
+
+# Function to install PHP.
+add_php() {
+  if [[ "$version" =~ ${nightly_versions:?} ]]; then
+    setup_nightly
+  elif [[ "$version" =~ ${old_versions:?} ]]; then
+    setup_old_versions
+  else
+    add_packaged_php
+  fi
+  status="Installed"
+}
+
+# Function to ini file for pear and link it to each SAPI.
+link_pecl_file() {
+  echo '' | sudo tee "$pecl_file" >/dev/null 2>&1
+  for file in "${ini_file[@]}"; do
+    sapi_scan_dir="$(realpath -m "$(dirname "$file")")/conf.d"
+    [ "$sapi_scan_dir" != "$scan_dir" ] && ! [ -h "$sapi_scan_dir" ] && sudo ln -sf "$pecl_file" "$sapi_scan_dir/99-pecl.ini"
+  done
+}
+
+# Function to Setup PHP
+setup_php() {
+  step_log "Setup PHP"
+  sudo mkdir -m 777 -p /var/run /run/php
+  if [ "$(php-config --version 2>/dev/null | cut -c 1-3)" != "$version" ]; then
+    if [ ! -e "/usr/bin/php$version" ]; then
+      add_php >/dev/null 2>&1
+    else
+      if [ "${update:?}" = "true" ]; then
+        update_php >/dev/null 2>&1
+      else
+        status="Switched to"
+      fi
+    fi
+    if ! [[ "$version" =~ ${old_versions:?}|${nightly_versions:?} ]]; then
+      switch_version >/dev/null 2>&1
+    fi
+  else
+    if [ "$update" = "true" ]; then
+      update_php >/dev/null 2>&1
+    else
+      status="Found"
+    fi
+  fi
+  if ! command -v php"$version" >/dev/null; then
+    add_log "$cross" "PHP" "Could not setup PHP $version"
+    exit 1
+  fi
+  semver=$(php_semver)
+  ext_dir=$(php -i | grep "extension_dir => /" | sed -e "s|.*=> s*||")
+  scan_dir=$(php --ini | grep additional | sed -e "s|.*: s*||")
+  ini_dir=$(php --ini | grep "(php.ini)" | sed -e "s|.*: s*||")
+  pecl_file="$scan_dir"/99-pecl.ini
+  mapfile -t ini_file < <(sudo find "$ini_dir/.." -name "php.ini" -exec readlink -m {} +)
+  link_pecl_file
+  configure_php
+  sudo rm -rf /usr/local/bin/phpunit >/dev/null 2>&1
+  sudo chmod 777 "${ini_file[@]}" "$pecl_file" "${tool_path_dir:?}"
+  sudo cp "$dist"/../src/configs/*.json "$RUNNER_TOOL_CACHE/"
+  add_log "${tick:?}" "PHP" "$status PHP $semver"
+}
+
+# Variables
+version=$1
+dist=$2
+debconf_fix="DEBIAN_FRONTEND=noninteractive"
+apt_install="sudo $debconf_fix apt-fast install -y"
+apt_remove="sudo $debconf_fix apt-fast remove -y"
+
+# shellcheck source=.
+. "${dist}"/../src/scripts/common.sh
+. /etc/lsb-release
+read_env
+self_hosted_setup
+setup_php

src/scripts/pcov.sh

@@ -1,5 +0,0 @@
-cd ~ && git clone --depth=1 https://github.com/krakjoe/pcov.git
-cd pcov && phpize
-./configure --enable-pcov
-make
-sudo make install

src/scripts/phalcon.sh

@@ -1,26 +0,0 @@
-ini_file=$(php --ini | grep "Loaded Configuration" | sed -e "s|.*:s*||" | sed "s/ //g")
-if [ ! "$(apt-cache search php"$2"-psr)" ]; then
-  sudo DEBIAN_FRONTEND=noninteractive add-apt-repository ppa:ondrej/php -y >/dev/null 2>&1
-fi
-sudo DEBIAN_FRONTEND=noninteractive apt-fast install -y php"$2"-dev php"$2"-psr
-for tool in php-config phpize; do
-  if [ -e "/usr/bin/$tool$2" ]; then
-    sudo update-alternatives --set $tool /usr/bin/"$tool$2"
-  fi
-done
-
-if [ ! "$(apt-cache search php"$2"-psr)" ]; then
-  cd ~ && git clone --depth=1 https://github.com/jbboehr/php-psr.git
-  cd php-psr && sudo /usr/bin/phpize"$2"
-  ./configure --with-php-config=/usr/bin/php-config"$2"
-  make -j2 && sudo make -j2 install
-  echo "extension=psr.so" >> "$ini_file"
-fi
-
-if [ "$1" = "master" ]; then
-  sudo DEBIAN_FRONTEND=noninteractive apt-fast install -y php"$2"-phalcon
-else
-  cd ~ && git clone --depth=1 -v https://github.com/phalcon/cphalcon.git -b "$1"
-  cd cphalcon/build && sudo ./install --phpize /usr/bin/phpize"$2" --php-config /usr/bin/php-config"$2"
-  echo "extension=phalcon.so" >> "$ini_file"
-fi

src/scripts/tools/blackfire.ps1

@@ -0,0 +1,21 @@
+# Function to add blackfire and blackfire-agent.
+Function Add-Blackfire() {
+  $arch_name ='amd64'
+  if(-not([Environment]::Is64BitOperatingSystem) -or $version -lt '7.0') {
+    $arch_name = '386'
+  }
+  $agent_version = (Invoke-RestMethod https://blackfire.io/api/v1/releases).agent
+  $url = "https://packages.blackfire.io/binaries/blackfire-agent/${agent_version}/blackfire-agent-windows_${arch_name}.zip"
+  Invoke-WebRequest -Uri $url -OutFile $bin_dir\blackfire.zip >$null 2>&1
+  Expand-Archive -Path $bin_dir\blackfire.zip -DestinationPath $bin_dir -Force >$null 2>&1
+  Add-ToProfile $current_profile 'blackfire' "New-Alias blackfire $bin_dir\blackfire.exe"
+  Add-ToProfile $current_profile 'blackfire-agent' "New-Alias blackfire-agent $bin_dir\blackfire-agent.exe"
+  if ((Test-Path env:BLACKFIRE_SERVER_ID) -and (Test-Path env:BLACKFIRE_SERVER_TOKEN)) {
+    blackfire-agent --register --server-id=$env:BLACKFIRE_SERVER_ID --server-token=$env:BLACKFIRE_SERVER_TOKEN >$null 2>&1
+  }
+  if ((Test-Path env:BLACKFIRE_CLIENT_ID) -and (Test-Path env:BLACKFIRE_CLIENT_TOKEN)) {
+    blackfire config --client-id=$env:BLACKFIRE_CLIENT_ID --client-token=$env:BLACKFIRE_CLIENT_TOKEN --ca-cert=$php_dir\ssl\cacert.pem >$null 2>&1
+  }
+  Add-Log $tick "blackfire" "Added blackfire $agent_version"
+  Add-Log $tick "blackfire-agent" "Added blackfire-agent $agent_version"
+}

src/scripts/tools/blackfire.sh

@@ -0,0 +1,35 @@
+add_blackfire_linux() {
+  sudo mkdir -p /var/run/blackfire
+  get -s -n "" https://packages.blackfire.io/gpg.key | sudo apt-key add -
+  echo "deb http://packages.blackfire.io/debian any main" | sudo tee /etc/apt/sources.list.d/blackfire.list
+  sudo "${debconf_fix:?}" apt-get update
+  ${apt_install:?} blackfire-agent
+}
+
+add_blackfire_darwin() {
+  sudo mkdir -p /usr/local/var/run
+  brew tap --shallow blackfireio/homebrew-blackfire
+  brew install blackfire-agent
+}
+
+blackfire_config() {
+  if [[ -n $BLACKFIRE_SERVER_ID ]] && [[ -n $BLACKFIRE_SERVER_TOKEN ]]; then
+    sudo blackfire-agent --register --server-id="$BLACKFIRE_SERVER_ID" --server-token="$BLACKFIRE_SERVER_TOKEN"
+    [ "$os" = "Linux" ] && sudo /etc/init.d/blackfire-agent restart
+    [ "$os" = "Darwin" ] && brew services start blackfire-agent
+  fi
+  if [[ -n $BLACKFIRE_CLIENT_ID ]] && [[ -n $BLACKFIRE_CLIENT_TOKEN ]]; then
+    blackfire config --client-id="$BLACKFIRE_CLIENT_ID" --client-token="$BLACKFIRE_CLIENT_TOKEN"
+  fi
+}
+
+# Function to add blackfire and blackfire-agent.
+add_blackfire() {
+  os="$(uname -s)"
+  [ "$os" = "Linux" ] && add_blackfire_linux >/dev/null 2>&1
+  [ "$os" = "Darwin" ] && add_blackfire_darwin >/dev/null 2>&1
+  blackfire_config >/dev/null 2>&1
+  tool_version=$(get_tool_version "blackfire" "version")
+  add_log "${tick:?}" "blackfire" "Added blackfire $tool_version"
+  add_log "${tick:?}" "blackfire-agent" "Added blackfire-agent $tool_version"
+}

src/scripts/tools/grpc_php_plugin.ps1

@@ -0,0 +1,21 @@
+Function Add-Msys2() {
+  $msys_location = 'C:\msys64'
+  if (-not(Test-Path $msys_location)) {
+    choco install msys2 -y >$null 2>&1
+    $msys_location = 'C:\tools\msys64'
+  }
+  return $msys_location
+}
+
+Function Add-Grpc_php_plugin() {
+  $msys_location = Add-Msys2
+  $logs = . $msys_location\usr\bin\bash -l -c "pacman -S --noconfirm mingw-w64-x86_64-grpc" >$null 2>&1
+  $grpc_version = Get-ToolVersion 'Write-Output' "$logs"
+  Write-Output "$msys_location\mingw64\bin" | Out-File -FilePath $env:GITHUB_PATH -Encoding utf8
+  Write-Output "::set-output name=grpc_php_plugin_path::$msys_location\mingw64\bin\grpc_php_plugin.exe"
+  Add-ToProfile $current_profile 'grpc_php_plugin' "New-Alias grpc_php_plugin $msys_location\mingw64\bin\grpc_php_plugin.exe"
+  Add-Log $tick "grpc_php_plugin" "Added grpc_php_plugin $grpc_version"
+  printf "::group::\033[34;1m%s \033[0m\033[90;1m%s \033[0m\n" "grpc_php_plugin" "Click to read the grpc_php_plugin related license information"
+  Write-Output (Invoke-WebRequest https://raw.githubusercontent.com/grpc/grpc/master/LICENSE).Content
+  Write-Output "::endgroup::"
+}

src/scripts/tools/grpc_php_plugin.sh

@@ -0,0 +1,62 @@
+add_bazel() {
+  if ! command -v bazel; then
+    if [ "$(uname -s)" = "Linux" ]; then
+      ${apt_install:?} curl gnupg
+      get -s -n "" https://bazel.build/bazel-release.pub.gpg | sudo apt-key add -
+      echo "deb [arch=amd64] https://storage.googleapis.com/bazel-apt stable jdk1.8" | sudo tee /etc/apt/sources.list.d/bazel.list
+      sudo "${debconf_fix:?}" apt-get update -y
+      ${apt_install:?} bazel
+    else
+      brew install bazel
+    fi
+  fi
+}
+
+get_grpc_tag() {
+  if [ "$grpc_tag" = "latest" ]; then
+    grpc_tag=$(get -s -n "" https://github.com/grpc/grpc/releases/latest | grep -Eo -m 1 "v[0-9]+\.[0-9]+\.[0-9]+" | head -n 1)
+  else
+    if [[ ${grpc_tag:0:1} != "v" ]] ; then grpc_tag="v$grpc_tag"; fi
+    status_code=$(get -v -n /tmp/grpc.tmp "https://github.com/grpc/grpc/releases/tag/$grpc_tag")
+    if [ "$status_code" != "200" ]; then
+      grpc_tag=$(get -s -n "" https://github.com/grpc/grpc/releases/latest | grep -Eo -m 1 "v[0-9]+\.[0-9]+\.[0-9]+" | head -n 1)
+    fi
+  fi
+}
+
+add_grpc_php_plugin_macos() {
+  brew install grpc
+  brew link --force --overwrite grpc >/dev/null 2>&1
+  grpc_tag="v$(brew info grpc | grep "grpc:" | grep -Eo "[0-9]+\.[0-9]+\.[0-9]+")"
+  license_path="$(brew --prefix grpc)/LICENSE"
+}
+
+add_grpc_php_plugin_linux() {
+  get_grpc_tag
+  get -s -n "" "https://github.com/grpc/grpc/archive/$grpc_tag.tar.gz" | tar -xz -C /tmp
+  cd "/tmp/grpc-${grpc_tag:1}" || exit
+  add_bazel
+  if [ "$DISTRIB_RELEASE" = "16.04" ]; then
+    CC="$(command -v gcc)" CXX="$(command -v g++)" ./tools/bazel build src/compiler:grpc_php_plugin
+  else
+    ./tools/bazel build src/compiler:grpc_php_plugin
+  fi
+  sudo mv ./bazel-bin/src/compiler/grpc_php_plugin /usr/local/bin/grpc_php_plugin
+  sudo chmod a+x /usr/local/bin/grpc_php_plugin
+  license_path="/tmp/grpc-${grpc_tag:1}/LICENSE"
+}
+
+add_grpc_php_plugin() {
+  grpc_tag=$1
+  license_path=""
+  if [ "$(uname -s)" = "Darwin" ]; then
+    add_grpc_php_plugin_macos >/dev/null 2>&1
+  else
+    add_grpc_php_plugin_linux >/dev/null 2>&1
+  fi
+  echo "::set-output name=grpc_php_plugin_path::$(command -v grpc_php_plugin)"
+  add_log "${tick:?}" "grpc_php_plugin" "Added grpc_php_plugin ${grpc_tag:1}"
+  printf "::group::\033[34;1m%s \033[0m\033[90;1m%s \033[0m\n" "grpc_php_plugin" "Click to read the grpc_php_plugin related license information"
+  cat "$license_path"
+  echo "::endgroup::"
+}

src/scripts/tools/protoc.ps1

@@ -0,0 +1,38 @@
+Function Get-ProtobufTag() {
+  if("$protobuf_tag" -eq "latest") {
+    $protobuf_tag = (Invoke-RestMethod https://api.github.com/repos/protocolbuffers/protobuf/tags).Name | Where-Object { $_ -match "v\d+.\d+.\d+$" } | Select-Object -First 1
+  } else {
+    try {
+      [net.httpWebRequest] $request = [net.webRequest]::create("https://github.com/protocolbuffers/protobuf/releases/tag/v$protobuf_tag")
+      $req.Method = "HEAD"
+      [net.httpWebResponse] $response = $request.getResponse()
+      $response.Close()
+      $protobuf_tag = "v$protobuf_tag"
+    } catch {
+      $protobuf_tag = (Invoke-RestMethod https://api.github.com/repos/protocolbuffers/protobuf/tags).Name | Where-Object { $_ -match "v\d+.\d+.\d+$" } | Select-Object -First 1
+    }
+  }
+  return $protobuf_tag
+}
+
+Function Add-Protoc() {
+  param(
+    [Parameter(Mandatory = $true, Position = 0, HelpMessage = 'The PHP version to be installed')]
+    [ValidatePattern('^latest$|^(v?)\d+\.\d+\.\d+$')]
+    [string] $protobuf_tag
+  )
+  $protobuf_tag = Get-ProtobufTag
+  $arch_num = '64'
+  if(-not([Environment]::Is64BitOperatingSystem)) {
+    $arch_num = '32'
+  }
+  $url = "https://github.com/protocolbuffers/protobuf/releases/download/$protobuf_tag/protoc-$($protobuf_tag -replace 'v', '')-win$arch_num.zip"
+  Invoke-WebRequest -Uri $url -OutFile $bin_dir\protoc.zip >$null 2>&1
+  Expand-Archive -Path $bin_dir\protoc.zip -DestinationPath $bin_dir\protoc -Force >$null 2>&1
+  Move-Item -Path $bin_dir\protoc\bin\protoc.exe -Destination $bin_dir\protoc.exe
+  Add-ToProfile $current_profile 'protoc' "New-Alias protoc $bin_dir\protoc.exe"
+  Add-Log $tick "protoc" "Added protoc $($protobuf_tag -replace 'v', '')"
+  printf "::group::\033[34;1m%s \033[0m\033[90;1m%s \033[0m\n" "protoc" "Click to read the protoc related license information"
+  Write-Output (Invoke-WebRequest https://raw.githubusercontent.com/protocolbuffers/protobuf/master/LICENSE).Content
+  Write-Output "::endgroup::"
+}

src/scripts/tools/protoc.sh

@@ -0,0 +1,28 @@
+get_protobuf_tag() {
+  if [ "$protobuf_tag" = "latest" ]; then
+    protobuf_tag=$(get -s -n "" https://github.com/protocolbuffers/protobuf/releases/latest 2<&1 | grep -m 1 -Eo "(v[0-9]+\.[0-9]+\.[0-9]+)" | head -n 1)
+  else
+    status_code=$(get -v -n /tmp/protobuf.tmp "https://github.com/protocolbuffers/protobuf/releases/tag/v$protobuf_tag")
+    if [ "$status_code" = "200" ]; then
+      protobuf_tag="v$protobuf_tag"
+    else
+      protobuf_tag=$(get -s -n "" https://github.com/protocolbuffers/protobuf/releases/latest 2<&1 | grep -m 1 -Eo "(v[0-9]+\.[0-9]+\.[0-9]+)" | head -n 1)
+    fi
+  fi
+}
+
+add_protoc() {
+  protobuf_tag=$1
+  get_protobuf_tag
+  (
+    platform='linux'
+    [ "$(uname -s)" = "Darwin" ] && platform='osx'
+    get -q -n /tmp/protobuf.zip "https://github.com/protocolbuffers/protobuf/releases/download/$protobuf_tag/protoc-${protobuf_tag:1}-$platform-x86_64.zip"
+    sudo unzip /tmp/protobuf.zip -d /usr/local/
+    sudo chmod 777 /usr/local/bin/protoc -R /usr/local/include/google
+  ) >/dev/null 2>&1
+  add_log "${tick:?}" "protoc" "Added protoc ${protobuf_tag:1}"
+  printf "::group::\033[34;1m%s \033[0m\033[90;1m%s \033[0m\n" "protoc" "Click to read the protoc related license information"
+  curl "${curl_opts[@]:?}" https://raw.githubusercontent.com/protocolbuffers/protobuf/master/LICENSE
+  echo "::endgroup::"
+}

src/scripts/win32.ps1

@@ -1,58 +1,119 @@
 param (
-  [Parameter(Mandatory = $true)][string]$version = "7.3",
-  [Parameter(Mandatory = $true)][string]$dir
+  [Parameter(Position = 0, Mandatory = $true)]
+  [ValidateNotNull()]
+  [ValidateLength(1, [int]::MaxValue)]
+  [string]
+  $version = '7.4',
+  [Parameter(Position = 1, Mandatory = $true)]
+  [ValidateNotNull()]
+  [ValidateLength(1, [int]::MaxValue)]
+  [string]
+  $dist
 )
 
-$tick = ([char]8730)
-$cross = ([char]10007)
-$php_dir = 'C:\tools\php'
-
+# Function to log start of a operation.
 Function Step-Log($message) {
   printf "\n\033[90;1m==> \033[0m\033[37;1m%s \033[0m\n" $message
 }
 
+# Function to log result of a operation.
 Function Add-Log($mark, $subject, $message) {
-  $code = if ($mark -eq $cross) { "31" } else { "32" }
-  printf "\033[%s;1m%s \033[0m\033[34;1m%s \033[0m\033[90;1m%s \033[0m\n" $code $mark $subject $message
-}
-
-Step-Log "Setup PhpManager"
-Install-Module -Name PhpManager -Force -Scope CurrentUser
-Add-Log $tick "PhpManager" "Installed"
-
-$installed = $null
-if (Test-Path -LiteralPath $php_dir -PathType Container) {
-  try {
-    $installed = Get-Php -Path $php_dir
-  }
-  catch {
+  if ($mark -eq $tick) {
+    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
+    if($env:fail_fast -eq 'true') {
+      exit 1;
+    }
   }
 }
-Step-Log "Setup PHP and Composer"
-if ($null -eq $installed -or -not("$($installed.Version).".StartsWith(($version -replace '^(\d+(\.\d+)*).*', '$1.')))) {
-  if ($version -lt '7.0') {
-    Install-Module -Name VcRedist -Force
+
+# Function to add a line to a powershell profile safely.
+Function Add-ToProfile {
+  param(
+    [Parameter(Position = 0, Mandatory = $true)]
+    [ValidateNotNull()]
+    [ValidateLength(1, [int]::MaxValue)]
+    [string]
+    $input_profile,
+    [Parameter(Position = 1, Mandatory = $true)]
+    [ValidateNotNull()]
+    [ValidateLength(1, [int]::MaxValue)]
+    [string]
+    $search,
+    [Parameter(Position = 2, Mandatory = $true)]
+    [ValidateNotNull()]
+    [ValidateLength(1, [int]::MaxValue)]
+    [string]
+    $value
+  )
+  if($null -eq (Get-Content $input_profile | findstr $search)) {
+    Add-Content -Path $input_profile -Value $value
   }
-
-  Install-Php -Version $version -Architecture x86 -ThreadSafe $true -InstallVC -Path $php_dir -TimeZone UTC -InitialPhpIni Production -Force >$null 2>&1
-  $installed = Get-Php -Path $php_dir
-  $status = "Installed PHP $($installed.FullVersion)"
-}
-else {
-  $status = "PHP $($installed.FullVersion) Found"
 }
 
-Set-PhpIniKey -Key 'date.timezone' -Value 'UTC' -Path $php_dir
-Enable-PhpExtension -Extension openssl, curl -Path $php_dir
-Update-PhpCAInfo -Path $php_dir -Source CurrentUser
-if ([Version]$installed.Version -ge '7.4') {
-  Copy-Item "$dir\..\src\ext\php_pcov.dll" -Destination "$($installed.ExtensionsPath)\php_pcov.dll"
+# Function to fetch PATH from the registry.
+Function Get-PathFromRegistry {
+  $env:Path = [System.Environment]::GetEnvironmentVariable("Path","User") + ";" +
+          [System.Environment]::GetEnvironmentVariable("Path","Machine")
+  Add-ToProfile $current_profile 'Get-PathFromRegistry' 'Function Get-PathFromRegistry { $env:Path = [System.Environment]::GetEnvironmentVariable("Path", "User") + ";" + [System.Environment]::GetEnvironmentVariable("Path", "Machine") }; Get-PathFromRegistry'
 }
-Add-Log $tick "PHP" $status
 
-Install-Composer -Scope System -Path $php_dir -PhpPath $php_dir
-Add-Log $tick "Composer" "Installed"
+# Function to add a location to PATH.
+Function Add-Path {
+  param(
+    [string]$PathItem
+  )
+  $newPath = (Get-ItemProperty -Path 'hkcu:\Environment' -Name PATH).Path.replace("$PathItem;", '')
+  $newPath = $PathItem + ';' + $newPath
+  Set-ItemProperty -Path 'hkcu:\Environment' -Name Path -Value $newPath
+  Get-PathFromRegistry
+}
 
+# Function to make sure printf is in PATH.
+Function Add-Printf {
+  if (-not(Test-Path "C:\Program Files\Git\usr\bin\printf.exe")) {
+    if(Test-Path "C:\msys64\usr\bin\printf.exe") {
+      New-Item -Path $bin_dir\printf.exe -ItemType SymbolicLink -Value C:\msys64\usr\bin\printf.exe
+    } else {
+      Invoke-WebRequest -Uri "$github/shivammathur/printf/releases/latest/download/printf-x64.zip" -OutFile "$bin_dir\printf.zip"
+      Expand-Archive -Path $bin_dir\printf.zip -DestinationPath $bin_dir -Force
+    }
+  } else {
+    New-Item -Path $bin_dir\printf.exe -ItemType SymbolicLink -Value "C:\Program Files\Git\usr\bin\printf.exe"
+  }
+}
+
+# Function to get a clean Powershell profile.
+Function Get-CleanPSProfile {
+  if(-not(Test-Path -LiteralPath $profile)) {
+    New-Item -Path $profile -ItemType "file" -Force
+  }
+  Set-Content $current_profile -Value ''
+  Add-ToProfile $profile $current_profile.replace('\', '\\') ". $current_profile"
+}
+
+# Function to install a powershell package from GitHub.
+Function Install-PSPackage() {
+  param(
+    [Parameter(Position = 0, Mandatory = $true)]
+    $package,
+    [Parameter(Position = 1, Mandatory = $true)]
+    $psm1_path,
+    [Parameter(Position = 2, Mandatory = $true)]
+    $url
+  )
+  $module_path = "$bin_dir\$psm1_path.psm1"
+  if(-not (Test-Path $module_path -PathType Leaf)) {
+    $zip_file = "$bin_dir\$package.zip"
+    Invoke-WebRequest -Uri $url -OutFile $zip_file
+    Expand-Archive -Path $zip_file -DestinationPath $bin_dir -Force
+  }
+  Import-Module $module_path
+  Add-ToProfile $current_profile "$package-search" "Import-Module $module_path"
+}
+
+# Function to add PHP extensions.
 Function Add-Extension {
   Param (
     [Parameter(Position = 0, Mandatory = $true)]
@@ -64,7 +125,12 @@ Function Add-Extension {
     [ValidateNotNull()]
     [ValidateSet('stable', 'beta', 'alpha', 'devel', 'snapshot')]
     [string]
-    $mininum_stability = 'stable'
+    $stability = 'stable',
+    [Parameter(Position = 2, Mandatory = $false)]
+    [ValidateNotNull()]
+    [ValidatePattern('^\d+(\.\d+){0,2}$')]
+    [string]
+    $extension_version = ''
   )
   try {
     $extension_info = Get-PhpExtension -Path $php_dir | Where-Object { $_.Name -eq $extension -or $_.Handle -eq $extension }
@@ -83,11 +149,288 @@ Function Add-Extension {
       }
     }
     else {
-      Install-PhpExtension -Extension $extension -MinimumStability $mininum_stability -Path $php_dir
+      if($extension_version -ne '') {
+        Install-PhpExtension -Extension $extension -Version $extension_version -MinimumStability $stability -MaximumStability $stability -Path $php_dir
+      } else {
+        Install-PhpExtension -Extension $extension -MinimumStability $stability -MaximumStability $stability -Path $php_dir
+      }
+
       Add-Log $tick $extension "Installed and enabled"
     }
   }
   catch {
-    Add-Log $cross $extension "Could not enable"
+    Add-Log $cross $extension "Could not install $extension on PHP $($installed.FullVersion)"
   }
 }
+
+# Function to remove PHP extensions.
+Function Remove-Extension() {
+  Param (
+    [Parameter(Position = 0, Mandatory = $true)]
+    [ValidateNotNull()]
+    [ValidateLength(1, [int]::MaxValue)]
+    [string]
+    $extension
+  )
+  if(php -m | findstr -i $extension) {
+    try {
+      Disable-PhpExtension $extension $php_dir
+      if (Test-Path $ext_dir\php_$extension.dll) {
+        Remove-Item $ext_dir\php_$extension.dll
+      }
+      Add-Log $tick ":$extension" "Removed"
+    } catch {
+      Add-Log $cross ":$extension" "Could not remove $extension on PHP $($installed.FullVersion)"
+    }
+  } else {
+    Add-Log $tick ":$extension" "Could not find $extension on PHP $($installed.FullVersion)"
+  }
+}
+
+Function Edit-ComposerConfig() {
+  Param(
+    [Parameter(Position = 0, Mandatory = $true)]
+    [ValidateNotNull()]
+    [ValidateLength(1, [int]::MaxValue)]
+    [string]
+    $tool_path
+  )
+  Copy-Item $tool_path -Destination "$tool_path.phar"
+  php -r "try {`$p=new Phar('$tool_path.phar', 0);exit(0);} catch(Exception `$e) {exit(1);}"
+  if ($? -eq $False) {
+    Add-Log "$cross" "composer" "Could not download composer"
+    exit 1;
+  }
+  composer -q config -g process-timeout 0
+  Write-Output $composer_bin | Out-File -FilePath $env:GITHUB_PATH -Encoding utf8
+  if (Test-Path env:COMPOSER_TOKEN) {
+    composer -q config -g github-oauth.github.com $env:COMPOSER_TOKEN
+  }
+}
+
+# Function to extract tool version.
+Function Get-ToolVersion() {
+  Param (
+      [Parameter(Position = 0, Mandatory = $true)]
+      $tool,
+      [Parameter(Position = 1, Mandatory = $true)]
+      $param
+  )
+  $version_regex = "[0-9]+((\.{1}[0-9]+)+)(\.{0})(-[a-z0-9]+){0,1}"
+  if($tool -eq 'composer') {
+    if ($param -eq 'snapshot') {
+      $composer_version = (Select-String -Pattern "const\sBRANCH_ALIAS_VERSION" -Path $bin_dir\composer -Raw | Select-String -Pattern $version_regex | ForEach-Object { $_.matches.Value }) + '+' + (Select-String -Pattern "const\sVERSION" -Path $bin_dir\composer -Raw | Select-String -Pattern "[a-zA-Z0-9]+" -AllMatches | ForEach-Object { $_.matches[2].Value })
+    } else {
+      $composer_version = Select-String -Pattern "const\sVERSION" -Path $bin_dir\composer -Raw | Select-String -Pattern $version_regex | ForEach-Object { $_.matches.Value }
+    }
+    Set-Variable -Name 'composer_version' -Value $composer_version -Scope Global
+    return "$composer_version"
+  }
+  return . $tool $param 2> $null | ForEach-Object { $_ -replace "composer $version_regex", '' } | Select-String -Pattern $version_regex | Select-Object -First 1 | ForEach-Object { $_.matches.Value }
+}
+
+# Function to add tools.
+Function Add-Tool() {
+  Param (
+    [Parameter(Position = 0, Mandatory = $true)]
+    [ValidateNotNull()]
+    $url,
+    [Parameter(Position = 1, Mandatory = $true)]
+    [ValidateNotNull()]
+    $tool,
+    [Parameter(Position = 2, Mandatory = $true)]
+    [ValidateNotNull()]
+    $ver_param
+  )
+  if (Test-Path $bin_dir\$tool) {
+    Remove-Item $bin_dir\$tool
+  }
+  if($url.Count -gt 1) { $url = $url[0] }
+  if ($tool -eq "symfony") {
+    Invoke-WebRequest -Uri $url -OutFile $bin_dir\$tool.exe
+    Add-ToProfile $current_profile $tool "New-Alias $tool $bin_dir\$tool.exe" >$null 2>&1
+  } else {
+    try {
+      Invoke-WebRequest -Uri $url -OutFile $bin_dir\$tool
+    } catch {
+      if($url -match '.*github.com.*releases.*latest.*') {
+        try {
+          $url = $url.replace("releases/latest/download", "releases/download/" + ([regex]::match((Invoke-WebRequest -Uri ($url.split('/release')[0] + "/releases")).Content, "([0-9]+\.[0-9]+\.[0-9]+)/" + ($url.Substring($url.LastIndexOf("/") + 1))).Groups[0].Value).split('/')[0])
+          Invoke-WebRequest -Uri $url -OutFile $bin_dir\$tool
+        } catch { }
+      }
+    }
+  }
+  if (((Get-ChildItem -Path $bin_dir/* | Where-Object Name -Match "^$tool(.exe|.phar)*$").Count -gt 0)) {
+    $bat_content = @()
+    $bat_content += "@ECHO off"
+    $bat_content += "setlocal DISABLEDELAYEDEXPANSION"
+    $bat_content += "SET BIN_TARGET=%~dp0/" + $tool
+    $bat_content += "php %BIN_TARGET% %*"
+    Set-Content -Path $bin_dir\$tool.bat -Value $bat_content
+    Add-ToProfile $current_profile $tool "New-Alias $tool $bin_dir\$tool.bat" >$null 2>&1
+    if($tool -eq "phan") {
+      Add-Extension fileinfo >$null 2>&1
+      Add-Extension ast >$null 2>&1
+    } elseif($tool -eq "phive") {
+      Add-Extension xml >$null 2>&1
+    } elseif($tool -eq "cs2pr") {
+      (Get-Content $bin_dir/cs2pr).replace('exit(9)', 'exit(0)') | Set-Content $bin_dir/cs2pr
+    } elseif($tool -eq "composer") {
+      Edit-ComposerConfig $bin_dir\$tool
+    } elseif($tool -eq "wp-cli") {
+      Copy-Item $bin_dir\wp-cli.bat -Destination $bin_dir\wp.bat
+    }
+    $tool_version = Get-ToolVersion $tool $ver_param
+    Add-Log $tick $tool "Added $tool $tool_version"
+  } else {
+    Add-Log $cross $tool "Could not add $tool"
+  }
+}
+
+# Function to setup a tool using composer.
+Function Add-Composertool() {
+  Param (
+    [Parameter(Position = 0, Mandatory = $true)]
+    [ValidateNotNull()]
+    [ValidateLength(1, [int]::MaxValue)]
+    [string]
+    $tool,
+    [Parameter(Position = 1, Mandatory = $true)]
+    [ValidateNotNull()]
+    [ValidateLength(1, [int]::MaxValue)]
+    [string]
+    $release,
+    [Parameter(Position = 2, Mandatory = $true)]
+    [ValidateNotNull()]
+    [ValidateLength(1, [int]::MaxValue)]
+    [string]
+    $prefix
+  )
+  if($tool -match "prestissimo|composer-prefetcher" -and $composer_version.split('.')[0] -ne "1") {
+    Write-Output "::warning:: Skipping $tool, as it does not support Composer $composer_version. Specify composer:v1 in tools to use $tool"
+    Add-Log $cross $tool "Skipped"
+    Return
+  }
+  composer global require $prefix$release 2>&1 | out-null
+  $json = findstr $prefix$tool $env:APPDATA\Composer\composer.json
+  if(Test-Path $composer_bin\composer) {
+    Copy-Item -Path "$bin_dir\composer" -Destination "$composer_bin\composer" -Force
+  }
+  if($json) {
+    $tool_version = Get-ToolVersion "Write-Output" "$json"
+    Add-Log $tick $tool "Added $tool $tool_version"
+  } else {
+    Add-Log $cross $tool "Could not setup $tool"
+  }
+}
+
+# Function to handle request to add PECL.
+Function Add-Pecl() {
+  Add-Log $tick "PECL" "Use extensions input to setup PECL extensions on windows"
+}
+
+# Variables
+$tick = ([char]8730)
+$cross = ([char]10007)
+$php_dir = 'C:\tools\php'
+$ext_dir = "$php_dir\ext"
+$bin_dir = $php_dir
+$bintray = 'https://dl.bintray.com/shivammathur/php'
+$github = 'https://github.com'
+$composer_bin = "$env:APPDATA\Composer\vendor\bin"
+$current_profile = "$env:TEMP\setup-php.ps1"
+$ProgressPreference = 'SilentlyContinue'
+$nightly_version = '8.[0-9]'
+$cert_source='CurrentUser'
+$enable_extensions = ('openssl', 'curl', 'mbstring')
+
+$arch = 'x64'
+if(-not([Environment]::Is64BitOperatingSystem) -or $version -lt '7.0') {
+  $arch = 'x86'
+}
+
+$ts = $env:PHPTS -eq 'ts'
+if($env:PHPTS -ne 'ts') {
+  $env:PHPTS = 'nts'
+}
+if($env:RUNNER -eq 'self-hosted') {
+  $bin_dir = 'C:\tools\bin'
+  $php_dir = "$php_dir$version"
+  $ext_dir = "$php_dir\ext"
+  $cert_source='Curl'
+  Get-CleanPSProfile >$null 2>&1
+  New-Item $bin_dir -Type Directory 2>&1 | Out-Null
+  Add-Path -PathItem $bin_dir
+  if($version -lt 5.6) {
+    Add-Log $cross "PHP" "PHP $version is not supported on self-hosted runner"
+    Start-Sleep 1
+    exit 1
+  }
+  if ((Get-InstalledModule).Name -notcontains 'VcRedist') {
+    Install-Module -Name VcRedist -Force
+  }
+  New-Item $php_dir -Type Directory 2>&1 | Out-Null
+  Add-Path -PathItem $php_dir
+  setx PHPROOT $php_dir >$null 2>&1
+} else {
+  $current_profile = "$PSHOME\Profile.ps1"
+  if(-not(Test-Path -LiteralPath $current_profile)) {
+    New-Item -Path $current_profile -ItemType "file" -Force >$null 2>&1
+  }
+}
+
+Add-Printf >$null 2>&1
+Step-Log "Setup PhpManager"
+Install-PSPackage PhpManager PhpManager\PhpManager "$github/mlocati/powershell-phpmanager/releases/latest/download/PhpManager.zip" >$null 2>&1
+Add-Log $tick "PhpManager" "Installed"
+
+Step-Log "Setup PHP"
+$installed = $null
+if (Test-Path -LiteralPath $php_dir -PathType Container) {
+  try {
+    $installed = Get-Php -Path $php_dir
+  } catch { }
+}
+$status = "Installed"
+if ($null -eq $installed -or -not("$($installed.Version).".StartsWith(($version -replace '^(\d+(\.\d+)*).*', '$1.'))) -or $ts -ne $installed.ThreadSafe) {
+  if ($version -lt '7.0' -and (Get-InstalledModule).Name -notcontains 'VcRedist') {
+    Install-PSPackage VcRedist VcRedist-main\VcRedist\VcRedist "$github/aaronparker/VcRedist/archive/main.zip" >$null 2>&1
+  }
+  try {
+    if ($version -match $nightly_version) {
+      Invoke-WebRequest -Uri $bintray/Get-PhpNightly.ps1 -OutFile $php_dir\Get-PhpNightly.ps1 > $null 2>&1
+      & $php_dir\Get-PhpNightly.ps1 -Architecture $arch -ThreadSafe $ts -Path $php_dir -Version $version > $null 2>&1
+    } else {
+      Install-Php -Version $version -Architecture $arch -ThreadSafe $ts -InstallVC -Path $php_dir -TimeZone UTC -InitialPhpIni Production -Force > $null 2>&1
+    }
+  } catch { }
+} else {
+  if($env:update -eq 'true') {
+    Update-Php $php_dir >$null 2>&1
+    $status = "Updated to"
+  } else {
+    $status = "Found"
+  }
+}
+
+$installed = Get-Php -Path $php_dir
+if($installed.MajorMinorVersion -ne $version) {
+  Add-Log $cross "PHP" "Could not setup PHP $version"
+  exit 1
+}
+('date.timezone=UTC', 'memory_limit=-1', 'xdebug.mode=coverage') | ForEach-Object { $p=$_.split('='); Set-PhpIniKey -Key $p[0] -Value $p[1] -Path $php_dir }
+if($version -lt "5.5") {
+  ('libeay32.dll', 'ssleay32.dll') | ForEach-Object { Invoke-WebRequest -Uri $bintray/$_ -OutFile $php_dir\$_ >$null 2>&1 }
+} else {
+  $enable_extensions += ('opcache')
+}
+# Patch till there is a pcov DLL for PHP 8.0 on pecl
+if ($version -eq '8.0') {
+  Invoke-WebRequest -Uri "https://github.com/shivammathur/php-extensions-windows/releases/latest/download/php$version`_$env:PHPTS`_$arch`_pcov.dll" -OutFile $php_dir"\ext\php`_pcov.dll"
+}
+Enable-PhpExtension -Extension $enable_extensions -Path $php_dir
+Update-PhpCAInfo -Path $php_dir -Source $cert_source
+Copy-Item -Path $dist\..\src\configs\*.json -Destination $env:RUNNER_TOOL_CACHE
+New-Item -ItemType Directory -Path $composer_bin -Force 2>&1 | Out-Null
+Add-Log $tick "PHP" "$status PHP $($installed.FullVersion)"

src/scripts/xdebug.sh

@@ -1,3 +0,0 @@
-cd ~ && git clone --depth=1 https://github.com/xdebug/xdebug.git
-cd xdebug || echo "Failed to clone Xdebug"
-sudo ./rebuild.sh

src/scripts/xdebug_darwin.sh

@@ -1,6 +0,0 @@
-cd ~ && git clone --depth=1 https://github.com/xdebug/xdebug.git
-cd xdebug || echo "Failed to clone Xdebug"
-sudo phpize
-sudo ./configure
-sudo make
-sudo cp modules/xdebug.so "$(php -i | grep "extension_dir => /opt" | sed -e "s|.*=> s*||")"

src/tools.ts

@@ -0,0 +1,623 @@
+import * as utils from './utils';
+
+/**
+ * Function to get tool version
+ *
+ * @param version
+ */
+export async function getToolVersion(version: string): Promise<string> {
+  // semver_regex - https://semver.org/
+  const semver_regex = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$/;
+  const composer_regex = /^stable$|^preview$|^snapshot$|^v?[1|2]$/;
+  version = version.replace(/[><=^]*/, '');
+  switch (true) {
+    case version.charAt(0) == 'v':
+      return version.replace('v', '');
+    case composer_regex.test(version):
+    case semver_regex.test(version):
+      return version;
+    default:
+      return 'latest';
+  }
+}
+
+/**
+ * Function to parse tool:version
+ *
+ * @param release
+ */
+export async function parseTool(
+  release: string
+): Promise<{name: string; version: string}> {
+  const parts: string[] = release.split(':');
+  const tool: string = parts[0];
+  const version: string | undefined = parts[1];
+  switch (version) {
+    case undefined:
+      return {
+        name: tool,
+        version: 'latest'
+      };
+    default:
+      return {
+        name: tool,
+        version: await getToolVersion(parts[1])
+      };
+  }
+}
+
+/**
+ * Function to get the url of tool with the given version
+ *
+ * @param tool
+ * @param extension
+ * @param version
+ * @param prefix
+ * @param version_prefix
+ * @param verb
+ */
+export async function getUri(
+  tool: string,
+  extension: string,
+  version: string,
+  prefix: string,
+  version_prefix: string,
+  verb: string
+): Promise<string> {
+  switch (version) {
+    case 'latest':
+      return [prefix, version, verb, tool + extension]
+        .filter(Boolean)
+        .join('/');
+    default:
+      return [prefix, verb, version_prefix + version, tool + extension]
+        .filter(Boolean)
+        .join('/');
+  }
+}
+
+/**
+ * Helper function to get the codeception url
+ *
+ * @param version
+ * @param suffix
+ */
+export async function getCodeceptionUriBuilder(
+  version: string,
+  suffix: string
+): Promise<string> {
+  return ['releases', version, suffix, 'codecept.phar']
+    .filter(Boolean)
+    .join('/');
+}
+
+/**
+ * Function to get the codeception url
+ *
+ * @param version
+ * @param php_version
+ */
+export async function getCodeceptionUri(
+  version: string,
+  php_version: string
+): Promise<string> {
+  const codecept: string = await getCodeceptionUriBuilder(version, '');
+  const codecept54: string = await getCodeceptionUriBuilder(version, 'php54');
+  const codecept56: string = await getCodeceptionUriBuilder(version, 'php56');
+  // Refer to https://codeception.com/builds
+  switch (true) {
+    case /latest/.test(version):
+      switch (true) {
+        case /5\.6|7\.[0|1]/.test(php_version):
+          return 'php56/codecept.phar';
+        case /7\.[2-4]/.test(php_version):
+        default:
+          return 'codecept.phar';
+      }
+    case /(^[4-9]|\d{2,})\..*/.test(version):
+      switch (true) {
+        case /5\.6|7\.[0|1]/.test(php_version):
+          return codecept56;
+        case /7\.[2-4]/.test(php_version):
+        default:
+          return codecept;
+      }
+    case /(^2\.[4-5]\.\d+|^3\.[0-1]\.\d+).*/.test(version):
+      switch (true) {
+        case /5\.6/.test(php_version):
+          return codecept54;
+        case /7\.[0-4]/.test(php_version):
+        default:
+          return codecept;
+      }
+    case /^2\.3\.\d+.*/.test(version):
+      switch (true) {
+        case /5\.[4-6]/.test(php_version):
+          return codecept54;
+        case /^7\.[0-4]$/.test(php_version):
+        default:
+          return codecept;
+      }
+    case /(^2\.(1\.([6-9]|\d{2,}))|^2\.2\.\d+).*/.test(version):
+      switch (true) {
+        case /5\.[4-5]/.test(php_version):
+          return codecept54;
+        case /5.6|7\.[0-4]/.test(php_version):
+        default:
+          return codecept;
+      }
+    case /(^2\.(1\.[0-5]|0\.\d+)|^1\.[6-8]\.\d+).*/.test(version):
+      return codecept;
+    default:
+      return codecept;
+  }
+}
+
+/**
+ * Helper function to get script to setup phive
+ *
+ * @param version
+ * @param php_version
+ * @param os_version
+ */
+export async function addPhive(
+  version: string,
+  php_version: string,
+  os_version: string
+): Promise<string> {
+  switch (true) {
+    case /5\.[3-5]/.test(php_version):
+      return await utils.addLog(
+        '$cross',
+        'phive',
+        'Phive is not supported on PHP ' + php_version,
+        os_version
+      );
+    case /5\.6|7\.0/.test(php_version):
+      version = version.replace('latest', '0.12.1');
+      break;
+    case /7\.1/.test(php_version):
+      version = version.replace('latest', '0.13.5');
+      break;
+  }
+  switch (version) {
+    case 'latest':
+      return (
+        (await utils.getCommand(os_version, 'tool')) +
+        'https://phar.io/releases/phive.phar phive status'
+      );
+    default:
+      return (
+        (await utils.getCommand(os_version, 'tool')) +
+        'https://github.com/phar-io/phive/releases/download/' +
+        version +
+        '/phive-' +
+        version +
+        '.phar phive status'
+      );
+  }
+}
+
+/**
+ * Function to get the phar url in domain/tool-version.phar format
+ *
+ * @param domain
+ * @param tool
+ * @param prefix
+ * @param version
+ */
+export async function getPharUrl(
+  domain: string,
+  tool: string,
+  prefix: string,
+  version: string
+): Promise<string> {
+  switch (version) {
+    case 'latest':
+      return domain + '/' + tool + '.phar';
+    default:
+      return domain + '/' + tool + '-' + prefix + version + '.phar';
+  }
+}
+
+/**
+ * Function to get blackfire player url for a PHP version.
+ *
+ * @param version
+ * @param php_version
+ */
+export async function getBlackfirePlayerUrl(
+  version: string,
+  php_version: string
+): Promise<string> {
+  switch (true) {
+    case /5\.[5-6]|7\.0/.test(php_version) && version == 'latest':
+      version = '1.9.3';
+      break;
+    default:
+      break;
+  }
+  return await getPharUrl(
+    'https://get.blackfire.io',
+    'blackfire-player',
+    'v',
+    version
+  );
+}
+
+/**
+ * Function to get the Deployer url
+ *
+ * @param version
+ */
+export async function getDeployerUrl(version: string): Promise<string> {
+  const deployer = 'https://deployer.org';
+  switch (version) {
+    case 'latest':
+      return deployer + '/deployer.phar';
+    default:
+      return deployer + '/releases/v' + version + '/deployer.phar';
+  }
+}
+
+/**
+ * Function to get the Deployer url
+ *
+ * @param version
+ * @param os_version
+ */
+export async function getSymfonyUri(
+  version: string,
+  os_version: string
+): Promise<string> {
+  let filename = '';
+  switch (os_version) {
+    case 'linux':
+    case 'darwin':
+      filename = 'symfony_' + os_version + '_amd64';
+      break;
+    case 'win32':
+      filename = 'symfony_windows_amd64.exe';
+      break;
+    default:
+      return await utils.log(
+        'Platform ' + os_version + ' is not supported',
+        os_version,
+        'error'
+      );
+  }
+  switch (version) {
+    case 'latest':
+      return 'releases/latest/download/' + filename;
+    default:
+      return 'releases/download/v' + version + '/' + filename;
+  }
+}
+
+/**
+ * Function to get the WP-CLI url
+ *
+ * @param version
+ */
+export async function getWpCliUrl(version: string): Promise<string> {
+  switch (version) {
+    case 'latest':
+      return 'wp-cli/builds/blob/gh-pages/phar/wp-cli.phar?raw=true';
+    default:
+      return await getUri(
+        'wp-cli',
+        '-' + version + '.phar',
+        version,
+        'wp-cli/wp-cli/releases',
+        'v',
+        'download'
+      );
+  }
+}
+
+/**
+ * Function to add/move composer in the tools list
+ *
+ * @param tools_list
+ */
+export async function addComposer(tools_list: string[]): Promise<string[]> {
+  const regex_any = /^composer($|:.*)/;
+  const regex_valid = /^composer:?($|preview$|snapshot$|v?[1-2]$|v?\d+\.\d+\.\d+[\w-]*$)/;
+  const matches: string[] = tools_list.filter(tool => regex_valid.test(tool));
+  let composer = 'composer';
+  tools_list = tools_list.filter(tool => !regex_any.test(tool));
+  switch (true) {
+    case matches[0] == undefined:
+      break;
+    default:
+      composer = matches[matches.length - 1].replace(/v(\d\S*)/, '$1');
+      break;
+  }
+  tools_list.unshift(composer);
+  return tools_list;
+}
+
+/**
+ * Function to get composer URL for a given version
+ *
+ * @param version
+ */
+export async function getComposerUrl(version: string): Promise<string> {
+  let cache_url = `https://github.com/shivammathur/composer-cache/releases/latest/download/composer-${version.replace(
+    'latest',
+    'stable'
+  )}.phar`;
+  switch (true) {
+    case /^snapshot$/.test(version):
+      return `${cache_url},https://getcomposer.org/composer.phar`;
+    case /^preview$|^[1-2]$/.test(version):
+      return `${cache_url},https://getcomposer.org/composer-${version}.phar`;
+    case /^\d+\.\d+\.\d+[\w-]*$/.test(version):
+      cache_url = `https://github.com/composer/composer/releases/download/${version}/composer.phar`;
+      return `${cache_url},https://getcomposer.org/composer-${version}.phar`;
+    default:
+      return `${cache_url},https://getcomposer.org/composer-stable.phar`;
+  }
+}
+
+/**
+ * Function to get Tools list after cleanup
+ *
+ * @param tools_csv
+ */
+export async function getCleanedToolsList(
+  tools_csv: string
+): Promise<string[]> {
+  let tools_list: string[] = await utils.CSVArray(tools_csv);
+  tools_list = await addComposer(tools_list);
+  tools_list = tools_list
+    .map(function (extension: string) {
+      return extension
+        .trim()
+        .replace(
+          /-agent|behat\/|hirak\/|icanhazstring\/|laravel\/|narrowspark\/automatic-|overtrue\/|phpspec\/|robmorgan\/|symfony\//,
+          ''
+        );
+    })
+    .filter(Boolean);
+  return [...new Set(tools_list)];
+}
+
+/**
+ * Helper function to get script to setup a tool using a phar url
+ *
+ * @param tool
+ * @param url
+ * @param os_version
+ * @param ver_param
+ */
+export async function addArchive(
+  tool: string,
+  url: string,
+  os_version: string,
+  ver_param: string
+): Promise<string> {
+  return (
+    (await utils.getCommand(os_version, 'tool')) +
+    (await utils.joins(url, tool, ver_param))
+  );
+}
+
+/**
+ * Function to get the script to setup php-config and phpize
+ *
+ * @param tool
+ * @param os_version
+ */
+export async function addDevTools(
+  tool: string,
+  os_version: string
+): Promise<string> {
+  switch (os_version) {
+    case 'linux':
+    case 'darwin':
+      return 'add_devtools ' + tool;
+    case 'win32':
+      return await utils.addLog(
+        '$tick',
+        tool,
+        tool + ' is not a windows tool',
+        'win32'
+      );
+    default:
+      return await utils.log(
+        'Platform ' + os_version + ' is not supported',
+        os_version,
+        'error'
+      );
+  }
+}
+
+/**
+ * Helper function to get script to setup a tool using composer
+ *
+ * @param tool
+ * @param release
+ * @param prefix
+ * @param os_version
+ */
+export async function addPackage(
+  tool: string,
+  release: string,
+  prefix: string,
+  os_version: string
+): Promise<string> {
+  const tool_command = await utils.getCommand(os_version, 'composertool');
+  return tool_command + tool + ' ' + release + ' ' + prefix;
+}
+
+/**
+ * Setup tools
+ *
+ * @param tools_csv
+ * @param php_version
+ * @param os_version
+ */
+export async function addTools(
+  tools_csv: string,
+  php_version: string,
+  os_version: string
+): Promise<string> {
+  let script = '\n' + (await utils.stepLog('Setup Tools', os_version));
+  const tools_list: Array<string> = await getCleanedToolsList(tools_csv);
+  await utils.asyncForEach(tools_list, async function (release: string) {
+    const tool_data: {name: string; version: string} = await parseTool(release);
+    const tool: string = tool_data.name;
+    const version: string = tool_data.version;
+    const github = 'https://github.com/';
+    let uri: string = await getUri(
+      tool,
+      '.phar',
+      version,
+      'releases',
+      '',
+      'download'
+    );
+    script += '\n';
+    let url = '';
+    switch (tool) {
+      case 'blackfire':
+      case 'grpc_php_plugin':
+      case 'protoc':
+        script += await utils.customPackage(tool, 'tools', version, os_version);
+        break;
+      case 'behat':
+      case 'phpspec':
+        script += await addPackage(tool, release, tool + '/', os_version);
+        break;
+      case 'blackfire-player':
+        url = await getBlackfirePlayerUrl(version, php_version);
+        script += await addArchive(tool, url, os_version, '"-V"');
+        break;
+      case 'codeception':
+        url =
+          'https://codeception.com/' +
+          (await getCodeceptionUri(version, php_version));
+        script += await addArchive(tool, url, os_version, '"-V"');
+        break;
+      case 'composer':
+        url = await getComposerUrl(version);
+        script += await addArchive('composer', url, os_version, version);
+        break;
+      case 'composer-normalize':
+        uri = await getUri(tool, '.phar', version, 'releases', '', 'download');
+        url = github + 'ergebnis/composer-normalize/' + uri;
+        script += await addArchive(tool, url, os_version, '"-V"');
+        break;
+      case 'composer-prefetcher':
+        script += await addPackage(
+          tool,
+          release,
+          'narrowspark/automatic-',
+          os_version
+        );
+        break;
+      case 'composer-require-checker':
+        uri = await getUri(tool, '.phar', version, 'releases', '', 'download');
+        url = github + 'maglnet/ComposerRequireChecker/' + uri;
+        script += await addArchive(tool, url, os_version, '"-V"');
+        break;
+      case 'composer-unused':
+        script += await addPackage(tool, release, 'icanhazstring/', os_version);
+        break;
+      case 'cs2pr':
+        uri = await getUri(tool, '', version, 'releases', '', 'download');
+        url = github + 'staabm/annotate-pull-request-from-checkstyle/' + uri;
+        script += await addArchive(tool, url, os_version, '"-V"');
+        break;
+      case 'deployer':
+        url = await getDeployerUrl(version);
+        script += await addArchive(tool, url, os_version, '"-V"');
+        break;
+      case 'flex':
+        script += await addPackage(tool, release, 'symfony/', os_version);
+        break;
+      case 'infection':
+        url = github + 'infection/infection/' + uri;
+        script += await addArchive(tool, url, os_version, '"-V"');
+        break;
+      case 'pecl':
+        script += await utils.getCommand(os_version, 'pecl');
+        break;
+      case 'phan':
+        url = github + 'phan/phan/' + uri;
+        script += await addArchive(tool, url, os_version, '"-v"');
+        break;
+      case 'phing':
+        url = 'https://www.phing.info/get/phing-' + version + '.phar';
+        script += await addArchive(tool, url, os_version, '"-v"');
+        break;
+      case 'phinx':
+        script += await addPackage(tool, release, 'robmorgan/', os_version);
+        break;
+      case 'phive':
+        script += await addPhive(version, php_version, os_version);
+        break;
+      case 'php-config':
+      case 'phpize':
+        script += await addDevTools(tool, os_version);
+        break;
+      case 'php-cs-fixer':
+        uri = await getUri(tool, '.phar', version, 'releases', 'v', 'download');
+        url = github + 'FriendsOfPHP/PHP-CS-Fixer/' + uri;
+        script += await addArchive(tool, url, os_version, '"-V"');
+        break;
+      case 'phpcbf':
+      case 'phpcs':
+        url = github + 'squizlabs/PHP_CodeSniffer/' + uri;
+        script += await addArchive(tool, url, os_version, '"--version"');
+        break;
+      case 'phpcpd':
+      case 'phpunit':
+        url = await getPharUrl('https://phar.phpunit.de', tool, '', version);
+        script += await addArchive(tool, url, os_version, '"--version"');
+        break;
+      case 'phplint':
+        script += await addPackage(tool, release, 'overtrue/', os_version);
+        break;
+      case 'phpmd':
+        url = github + 'phpmd/phpmd/' + uri;
+        script += await addArchive(tool, url, os_version, '"--version"');
+        break;
+      case 'phpstan':
+        url = github + 'phpstan/phpstan/' + uri;
+        script += await addArchive(tool, url, os_version, '"-V"');
+        break;
+      case 'prestissimo':
+        script += await addPackage(tool, release, 'hirak/', os_version);
+        break;
+      case 'psalm':
+        url = github + 'vimeo/psalm/' + uri;
+        script += await addArchive(tool, url, os_version, '"-v"');
+        break;
+      case 'symfony':
+      case 'symfony-cli':
+        uri = await getSymfonyUri(version, os_version);
+        url = github + 'symfony/cli/' + uri;
+        script += await addArchive('symfony', url, os_version, 'version');
+        break;
+      case 'vapor-cli':
+        script += await addPackage(tool, release, 'laravel/', os_version);
+        break;
+      case 'wp-cli':
+        url = github + (await getWpCliUrl(version));
+        script += await addArchive(tool, url, os_version, '"--version"');
+        break;
+      default:
+        script += await utils.addLog(
+          '$cross',
+          tool,
+          'Tool ' + tool + ' is not supported',
+          os_version
+        );
+        break;
+    }
+  });
+
+  return script;
+}

src/utils.ts

@@ -1,7 +1,24 @@
+import {IncomingMessage} from 'http';
 import * as fs from 'fs';
+import * as https from 'https';
 import * as path from 'path';
 import * as core from '@actions/core';
 
+/**
+ * Function to read environment variable and return a string value.
+ *
+ * @param property
+ */
+export async function readEnv(property: string): Promise<string> {
+  const value = process.env[property];
+  switch (value) {
+    case undefined:
+      return '';
+    default:
+      return value;
+  }
+}
+
 /**
  * Function to get inputs from both with and env annotations.
  *
@@ -12,31 +29,56 @@ export async function getInput(
   name: string,
   mandatory: boolean
 ): Promise<string> {
-  const input = process.env[name];
-  switch (input) {
-    case '':
-    case undefined:
-      return core.getInput(name, {required: mandatory});
-    default:
+  const input = core.getInput(name);
+  const env_input = await readEnv(name);
+  switch (true) {
+    case input != '':
       return input;
+    case input == '' && env_input != '':
+      return env_input;
+    case input == '' && env_input == '' && mandatory:
+      throw new Error(`Input required and not supplied: ${name}`);
+    default:
+      return '';
   }
 }
 
 /**
- * Function to read the PHP version.
+ * Function to fetch an URL
+ *
+ * @param url
  */
-export async function getVersion(): Promise<string> {
-  const version: string = await getInput('php-version', true);
-  switch (version) {
-    case '8.0':
-    case '8.0-dev':
-    case '7.4':
-    case '7.4snapshot':
-    case '7.4nightly':
-    case 'nightly':
-      return '7.4';
+export async function fetch(url: string): Promise<string> {
+  const fetch_promise: Promise<string> = new Promise(resolve => {
+    const req = https.get(url, (res: IncomingMessage) => {
+      res.setEncoding('utf8');
+      let body = '';
+      res.on('data', chunk => (body += chunk));
+      res.on('end', () => resolve(body));
+    });
+    req.end();
+  });
+  return await fetch_promise;
+}
+
+/**
+ * Function to parse PHP version.
+ *
+ * @param version
+ */
+export async function parseVersion(version: string): Promise<string> {
+  const manifest =
+    'https://raw.githubusercontent.com/shivammathur/setup-php/develop/src/configs/php-versions.json';
+  switch (true) {
+    case /latest|\d.x/.test(version):
+      return JSON.parse(await fetch(manifest))[version];
     default:
-      return version;
+      switch (true) {
+        case version.length > 1:
+          return version.slice(0, 3);
+        default:
+          return version + '.0';
+      }
   }
 }
 
@@ -83,7 +125,6 @@ export async function color(type: string): Promise<string> {
  * @param message
  * @param os_version
  * @param log_type
- * @param prefix
  */
 export async function log(
   message: string,
@@ -139,6 +180,7 @@ export async function stepLog(
  * @param mark
  * @param subject
  * @param message
+ * @param os_version
  */
 export async function addLog(
   mark: string,
@@ -165,14 +207,8 @@ export async function addLog(
  * Read the scripts
  *
  * @param filename
- * @param version
- * @param os_version
  */
-export async function readScript(
-  filename: string,
-  version: string,
-  os_version: string
-): Promise<string> {
+export async function readScript(filename: string): Promise<string> {
   return fs.readFileSync(
     path.join(__dirname, '../src/scripts/' + filename),
     'utf8'
@@ -183,7 +219,6 @@ export async function readScript(
  * Write final script which runs
  *
  * @param filename
- * @param version
  * @param script
  */
 export async function writeScript(
@@ -209,30 +244,39 @@ export async function extensionArray(
     case ' ':
       return [];
     default:
-      return extension_csv.split(',').map(function(extension: string) {
-        return extension
-          .trim()
-          .replace('php-', '')
-          .replace('php_', '');
-      });
+      return extension_csv
+        .split(',')
+        .map(function (extension: string) {
+          return extension
+            .trim()
+            .toLowerCase()
+            .replace(/^php[-_]/, '');
+        })
+        .filter(Boolean);
   }
 }
 
 /**
- * Function to break ini values csv into an array
+ * Function to break csv into an array
  *
- * @param ini_values_csv
+ * @param values_csv
  * @constructor
  */
-export async function INIArray(ini_values_csv: string): Promise<Array<string>> {
-  switch (ini_values_csv) {
+export async function CSVArray(values_csv: string): Promise<Array<string>> {
+  switch (values_csv) {
     case '':
     case ' ':
       return [];
     default:
-      return ini_values_csv.split(',').map(function(ini_value: string) {
-        return ini_value.trim();
-      });
+      return values_csv
+        .split(/,(?=(?:(?:[^"']*["']){2})*[^"']*$)/)
+        .map(function (value) {
+          return value
+            .trim()
+            .replace(/^["']|["']$|(?<==)["']/g, '')
+            .replace(/=(((?!E_).)*[?{}|&~![()^]+((?!E_).)+)/, "='$1'");
+        })
+        .filter(Boolean);
   }
 }
 
@@ -242,14 +286,11 @@ export async function INIArray(ini_values_csv: string): Promise<Array<string>> {
  * @param extension
  */
 export async function getExtensionPrefix(extension: string): Promise<string> {
-  const zend: Array<string> = ['xdebug', 'opcache', 'ioncube', 'eaccelerator'];
-  switch (zend.indexOf(extension)) {
-    case 0:
-    case 1:
-      return 'zend_extension';
-    case -1:
+  switch (true) {
     default:
       return 'extension';
+    case /xdebug([2-3])?$|opcache|ioncube|eaccelerator/.test(extension):
+      return 'zend_extension';
   }
 }
 
@@ -273,3 +314,127 @@ export async function suppressOutput(os_version: string): Promise<string> {
       );
   }
 }
+
+/**
+ * Function to get script to log unsupported extensions.
+ *
+ * @param extension
+ * @param version
+ * @param os_version
+ */
+export async function getUnsupportedLog(
+  extension: string,
+  version: string,
+  os_version: string
+): Promise<string> {
+  return (
+    '\n' +
+    (await addLog(
+      '$cross',
+      extension,
+      [extension, 'is not supported on PHP', version].join(' '),
+      os_version
+    )) +
+    '\n'
+  );
+}
+
+/**
+ * Function to get command to setup tools
+ *
+ * @param os_version
+ * @param suffix
+ */
+export async function getCommand(
+  os_version: string,
+  suffix: string
+): Promise<string> {
+  switch (os_version) {
+    case 'linux':
+    case 'darwin':
+      return 'add_' + suffix + ' ';
+    case 'win32':
+      return 'Add-' + suffix.charAt(0).toUpperCase() + suffix.slice(1) + ' ';
+    default:
+      return await log(
+        'Platform ' + os_version + ' is not supported',
+        os_version,
+        'error'
+      );
+  }
+}
+
+/**
+ * Function to join strings with space
+ *
+ * @param str
+ */
+export async function joins(...str: string[]): Promise<string> {
+  return [...str].join(' ');
+}
+
+/**
+ * Function to get script extensions
+ *
+ * @param os_version
+ */
+export async function scriptExtension(os_version: string): Promise<string> {
+  switch (os_version) {
+    case 'win32':
+      return '.ps1';
+    case 'linux':
+    case 'darwin':
+      return '.sh';
+    default:
+      return await log(
+        'Platform ' + os_version + ' is not supported',
+        os_version,
+        'error'
+      );
+  }
+}
+
+/**
+ * Function to get script tool
+ *
+ * @param os_version
+ */
+export async function scriptTool(os_version: string): Promise<string> {
+  switch (os_version) {
+    case 'win32':
+      return 'pwsh';
+    case 'linux':
+    case 'darwin':
+      return 'bash';
+    default:
+      return await log(
+        'Platform ' + os_version + ' is not supported',
+        os_version,
+        'error'
+      );
+  }
+}
+
+/**
+ * Function to get script to add tools with custom support.
+ *
+ * @param pkg
+ * @param type
+ * @param version
+ * @param os_version
+ */
+export async function customPackage(
+  pkg: string,
+  type: string,
+  version: string,
+  os_version: string
+): Promise<string> {
+  const pkg_name: string = pkg.replace(/\d+|pdo[_-]/, '');
+  const script_extension: string = await scriptExtension(os_version);
+  const script: string = path.join(
+    __dirname,
+    '../src/scripts/' + type + '/' + pkg_name + script_extension
+  );
+  const command: string = await getCommand(os_version, pkg_name);
+  return '\n. ' + script + '\n' + command + version;
+}

tsconfig.json

@@ -2,7 +2,7 @@
   "compilerOptions": {
     /* Basic Options */
     // "incremental": true,                   /* Enable incremental compilation */
-    "target": "es6",                          /* Specify ECMAScript target version: 'ES3' (default), 'ES5', 'ES2015', 'ES2016', 'ES2017', 'ES2018', 'ES2019' or 'ESNEXT'. */
+    "target": "ES2019",                       /* Specify ECMAScript target version: 'ES3' (default), 'ES5', 'ES2015', 'ES2016', 'ES2017', 'ES2018', 'ES2019' or 'ESNEXT'. */
     "module": "commonjs",                     /* Specify module code generation: 'none', 'commonjs', 'amd', 'system', 'umd', 'es2015', or 'ESNext'. */
     // "allowJs": true,                       /* Allow javascript files to be compiled. */
     // "checkJs": true,                       /* Report errors in .js files. */