mirror of https://github.com/shivammathur/setup-php.git synced 2024-11-22 11:51:07 +07:00

GitHub action to set up PHP with extensions, php.ini configuration, coverage drivers, and various tools.

code-coverage composer continuous-integration github-actions php php-extensions static-analysis tools

Go to file

Shivam Mathur e97e822eff Cleanup 7.4.sh and bump version to 1.3.7		2019-10-03 20:45:58 +05:30
__tests__	Fix xdebug and pcov on PHP7.4 and restructre code	2019-10-03 11:44:17 +05:30
.github	Fix scripts and action workflow	2019-09-25 17:04:10 +05:30
example	adding laravel with mysql example	2019-10-03 13:43:34 +03:00
lib	Fix xdebug and pcov on PHP7.4 and restructre code	2019-10-03 11:44:17 +05:30
node_modules	Add coverage support, improve logs and fix bugs	2019-09-26 20:24:24 +05:30
src	Cleanup 7.4.sh and bump version to 1.3.7	2019-10-03 20:45:58 +05:30
.gitignore	Improve code quality and write tests	2019-09-20 21:54:46 +05:30
.prettierrc.json	init	2019-09-06 05:17:43 +05:30
action.yml	Add coverage support, improve logs and fix bugs	2019-09-26 20:24:24 +05:30
jest.config.js	Improve code quality and write tests	2019-09-20 21:54:46 +05:30
LICENSE	Add README and LICENSE	2019-09-06 05:51:19 +05:30
package-lock.json	Cleanup 7.4.sh and bump version to 1.3.7	2019-10-03 20:45:58 +05:30
package.json	Cleanup 7.4.sh and bump version to 1.3.7	2019-10-03 20:45:58 +05:30
README.md	adding laravel with mysql example	2019-10-03 13:43:34 +03:00
tsconfig.json	init	2019-09-06 05:17:43 +05:30

README.md

Setup PHP in GitHub Actions

Setup PHP with required extensions, php.ini configuration and composer in 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 section to see how to use this.

🎉 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	`Beta`/`RC`	`Active`

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

☁️ OS/Platform 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.

📶 Coverage support

Specify coverage: xdebug to use Xdebug.
- Runs on all PHP versions supported

uses: shivammathur/setup-php@master
with:
  php-version: 7.3  
  coverage: xdebug

Specify coverage: pcov to use PCOV. PCOV is way faster than Xdebug
- For pcov.directory to be other than src, lib or, app, specify it using the ini-values-csv input.
- PCOV needs PHPUnit >= 8.0 and PHP >= 7.1, PHPUnit needs PHP >= 7.2. So use PHP >= 7.2 with PCOV

uses: shivammathur/setup-php@master
with:
  php-version: 7.3
  ini-values-csv: 'pcov.directory=api' #optional, see above for usage.
  coverage: pcov

📝 Usage

Inputs supported by this GitHub Action.

php-version
extension-csv (optional)
ini-values-csv (optional)
coverage (optional)

See action.yml for more info

Basic Usage

steps:
- name: Checkout
  uses: actions/checkout@master
- name: Installing PHP
  uses: shivammathur/setup-php@master
  with:
    php-version: 7.3
    extension-csv: mbstring, xdebug #optional
    ini-values-csv: "post_max_size=256M, short_open_tag=On" #optional
    coverage: xdebug #optional
- 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/checkout@master
    - name: Install PHP
      uses: shivammathur/setup-php@master
      with:
        php-version: ${{ matrix.php-versions }}
        extension-csv: mbstring, xdebug #optional
        ini-values-csv: "post_max_size=256M, short_open_tag=On" #optional
        coverage: xdebug #optional
    - name: Check PHP Version
      run: php -v
    - name: Check Composer Version
      run: composer -V
    - name: Check PHP Extensions
      run: php -m

Examples

Laravel

📜 License

The scripts and documentation in this project are released under the MIT License. This project has multiple dependencies and their licenses can be found in their respective repositories.