https://github.com/phingofficial/phing-github-action
Run your Phing Build in your Github Actions.
https://github.com/phingofficial/phing-github-action
ant build build-tool github-actions phing php
Last synced: about 1 year ago
JSON representation
Run your Phing Build in your Github Actions.
- Host: GitHub
- URL: https://github.com/phingofficial/phing-github-action
- Owner: phingofficial
- License: mit
- Created: 2020-10-03T14:46:13.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2020-10-10T21:52:32.000Z (over 5 years ago)
- Last Synced: 2025-04-15T22:03:58.019Z (about 1 year ago)
- Topics: ant, build, build-tool, github-actions, phing, php
- Language: Shell
- Homepage: https://www.phing.info
- Size: 18.6 KB
- Stars: 4
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 
Phing GitHub Action
Run your Phing Build in your GitHub Actions.
> **PH**ing **I**s **N**ot **G**NU make; it's a PHP project build system or build tool based on Apache Ant. You can do anything with it that you could do with a traditional build system like GNU make, and its use of simple XML build files and extensible PHP "task" classes make it an easy-to-use and highly flexible build framework.
## Configuration
Create your GiTHub Workflow config in `.github/workflows/build.yml` or similar to run your **phing** `build.xml`
```yaml
name: CI
on: [push]
jobs:
build-test:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- name: Phing Build
uses: phingofficial/phing-github-action@main
```
### General parameters
| parameter | description | default |
|---|---|---|
| buildfile | location of the build file | `build.xml` |
| targets | targets to run as space separated list | n/a |
| user-properties | user properties as space separated list [a=b c=d] | n/a |
| version | phing version to use | 2.16.3 |
#### To execute a build with `custom/path/to/build.xml` as a phing build file use:
```yaml
name: CI
on: [push]
jobs:
build-test:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- name: Phing Build
uses: phingofficial/phing-github-action@main
with:
buildfile: custom/path/to/build.xml
```
#### Run targets:
```yaml
name: CI
on: [push]
jobs:
build-test:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- name: Phing Build
uses: phingofficial/phing-github-action@main
with:
targets: build deploy
```
#### Invoke with user properties:
```yaml
name: CI
on: [push]
jobs:
build-test:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- name: Phing Build
uses: phingofficial/phing-github-action@main
with:
user-properties: foo=bar my=self you=too
```
### Control output:
| parameter | description |
|---|---|
| quiet | be extra quiet |
| silent | print nothing but task outputs and build failures |
| verbose | be extra verbose |
| debug | print debugging information |
| emacs | produce logging information without adornments |
| longtargets | show target descriptions during build |
**It does not matter which value was set to activate the options.
So `verbose: false` will also enable verbose logging.**
```yaml
name: CI
on: [push]
jobs:
build-test:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- name: Phing Build
uses: phingofficial/phing-github-action@main
with:
verbose: true
debug: true
```
### Versions
By default, the action will use `phing 2.16.3`.
To change that behavior use the action with the `version` parameter.
```yaml
name: CI
on: [push]
jobs:
build-test:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- name: Phing Build
uses: phingofficial/phing-github-action@main
with:
version: 3.0.0-alpha4
```
## Phing in Action
[Example "Phing Build" Project](https://github.com/phingofficial/phing-github-action-example/runs/1203313448?check_suite_focus=true#step:4:9)