# ivuorinen/actions/php-tests

## PHP Tests

### Description

Run PHPUnit tests on the repository

### Inputs

| name       | description                            | required | default                     |
|------------|----------------------------------------|----------|-----------------------------|
| `token`    | <p>GitHub token for authentication</p> | `false`  | `""`                        |
| `username` | <p>GitHub username for commits</p>     | `false`  | `github-actions`            |
| `email`    | <p>GitHub email for commits</p>        | `false`  | `github-actions@github.com` |

### Outputs

| name            | description                                            |
|-----------------|--------------------------------------------------------|
| `test_status`   | <p>Test execution status (success/failure/skipped)</p> |
| `tests_run`     | <p>Number of tests executed</p>                        |
| `tests_passed`  | <p>Number of tests passed</p>                          |
| `coverage_path` | <p>Path to coverage report</p>                         |

### Runs

This action is a `composite` action.

### Usage

```yaml
- uses: ivuorinen/actions/php-tests@main
  with:
    token:
    # GitHub token for authentication
    #
    # Required: false
    # Default: ""

    username:
    # GitHub username for commits
    #
    # Required: false
    # Default: github-actions

    email:
    # GitHub email for commits
    #
    # Required: false
    # Default: github-actions@github.com
```