shivammathur/setup-php

GitHub action to install PHP with required extensions and composer

Setup PHP in GitHub Actions

GitHub Actions status LICENSE

GitHub Action to install PHP with required extensions and composer. 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 section to see how to use this.

PHP Versions Support

  • 5.6
  • 7.0
  • 7.1
  • 7.2
  • 7.3
  • 7.4 7.4.0beta4 on ubuntu, and 7.4.0RC1 on windows and macOS

Note: PHP 7.4 is currently in development, do not use in production.

OS Support

|Virtual environment|matrix.operating-system| |--- |--- | |Windows Server 2019|windows-latest or windows-2019| |Windows Server 2016 R2|windows-2016| |Ubuntu 18.04|ubuntu-latest or ubuntu-18.04| |Ubuntu 16.04|ubuntu-16.04| |macOS X Mojave 10.14|macOS-latest or macOS-10.14|

PHP Extension Support

  • On ubuntu extensions which have the package in apt are installed.
  • On windows and macOS PECL extensions are 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 interruped.

Usage

See action.yml for inputs this action supports.

Basic

steps:
- name: Checkout
  uses: actions/[email protected]
- name: Installing PHP
  uses: shivammathur/[email protected]
  with:
    php-version: 7.3
    extension-csv: mbstring, xdebug
- name: Check PHP Version
  run: php -v
- name: Check Composer Version
  run: composer -V
- name: Check PHP Extensions
  run: php -m

Matrix Testing

jobs:
  run:    
    runs-on: ${{ matrix.operating-system }}
    strategy:
      max-parallel: 15
      matrix:
        operating-system: [ubuntu-latest, windows-latest, macOS-latest]
        php-versions: ['5.6', '7.0', '7.1', '7.2', '7.3']
    name: PHP ${{ matrix.php-versions }} Test on ${{ matrix.operating-system }}
    steps:
    - name: Checkout
      uses: actions/[email protected]
    - name: Install PHP
      uses: shivammathur/[email protected]
      with:
        php-version: ${{ matrix.php-versions }}
        extension-csv: mbstring, xdebug
    - name: Check PHP Version
      run: php -v
    - name: Check Composer Version
      run: composer -V
    - name: Check PHP Extensions
      run: php -m           

License

The scripts and documentation in this project are released under the MIT License

Contributions

Contributions are welcome! See Contributor's Guide

This action uses the following works

Further Reading

Repo Not Found