Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/techpivot/phalcon-ci-installer
Composer integration for PHP applications to install the Phalcon framework as an extension in the PHP runtime for various hosted CI services including TravisCI, CircleCI, ScrutinizerCI, Shippable and Codeship.
https://github.com/techpivot/phalcon-ci-installer
ci circleci codeship phalcon php scrutinizer shippable travisci
Last synced: 26 days ago
JSON representation
Composer integration for PHP applications to install the Phalcon framework as an extension in the PHP runtime for various hosted CI services including TravisCI, CircleCI, ScrutinizerCI, Shippable and Codeship.
- Host: GitHub
- URL: https://github.com/techpivot/phalcon-ci-installer
- Owner: techpivot
- License: mit
- Created: 2015-10-16T00:57:24.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2020-08-12T23:17:46.000Z (over 4 years ago)
- Last Synced: 2024-11-08T08:25:19.346Z (about 2 months ago)
- Topics: ci, circleci, codeship, phalcon, php, scrutinizer, shippable, travisci
- Language: Shell
- Homepage: https://www.techpivot.net
- Size: 47.9 KB
- Stars: 26
- Watchers: 6
- Forks: 8
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Phalcon CI Installer
[](https://circleci.com/gh/techpivot/phalcon-ci-installer)
[](https://travis-ci.org/techpivot/phalcon-ci-installer)
[](https://scrutinizer-ci.com/g/techpivot/phalcon-ci-installer/)
[](https://codeship.com/projects/109153)
[](https://app.shippable.com/projects/56204d941895ca44741e1583)
[](https://packagist.org/packages/techpivot/phalcon-ci-installer)
[](https://packagist.org/packages/techpivot/phalcon-ci-installer)
[](https://raw.githubusercontent.com/techpivot/phalcon-ci-installer/master/LICENSE)
Composer integration for PHP applications to install the [Phalcon](https://phalconphp.com) framework as an extension in the PHP runtime for various hosted CI services including CircleCI, Travis CI, Scrutinizer, Codeship, and Shippable.
## Features
* Phalcon extension loaded in PHP runtime
* Native cache support to prevent rebuilding Phalcon from source
* Auto-detection of latest tagged Phalcon version
* Install specific Phalcon versions, tags and releases _(Since 1.0.2)_
* Supports PHP7 and Phalcon 3.0.x _(Since 1.0.4)_
## Version Compatibility
The following table outlines general compability of Phalcon inside various CI environments.
| PHP CI Version | Phalcon Version(s) | CI Environment |
|:---------------|:-------------------|:---------------|
| 5.3 | ✖ (Not supported) | - |
| 5.4 | ✖ (Not supported) | - |
| 5.5 | ✔ `master`, `2.0.x`, `3.0.x` | ✔ CircleCI, Travis CI, Scrutinizer, Codeship, Shippable |
| 5.6 | ✔ `master`, `2.0.x`, `3.0.x` | ✔ CircleCI, Travis CI, Scrutinizer, Codeship, Shippable |
| 7.0 | ✔ `3.0.x` | ✔ CircleCI, Travis CI, Scrutinizer, Codeship, Shippable |
## Installation
1. Add the `techpivot/phalcon-ci-installer` repository into the **require-dev** section of your `composer.json` as follows:
```json
"require-dev": {
"techpivot/phalcon-ci-installer": "~1.0"
}
```
1. Update your CI script to execute the **vendor/bin/install-phalcon.sh** installer in the
relevant section. See the examples below for various CI providers.
## Options
The installer takes one optional argument that can be used to specify a specific branch or tag.
Examples:
```bash
# Install latest version from default branch
vendor/bin/install-phalcon.sh
# Install latest revision from branch "3.0.x"
vendor/bin/install-phalcon.sh 3.0.x
# Install specific release tag "phalcon-v2.0.9"
vendor/bin/install-phalcon.sh phalcon-v2.0.9
```
> **Note:** The Phalcon CI installer is designed to cache the resulting binaries that correspond to the Phalcon/PHP version.
Specifing a release or tagged version will result in the best performance as subsequent builds (depending on CI
container/settings) will be cached. Building from a branch (including the default master option) will result in a
Phalcon rebuild every time the installer detects a new version that is not yet cached.
## CI Environments
### CircleCI
**`circle.yml`**
```yml
machine:
php:
version: 5.6.14
dependencies:
cache_directories:
- vendor
- ~/cphalcon
post:
- vendor/bin/install-phalcon.sh phalcon-v2.0.13
test:
override:
- vendor/bin/phpunit
```
> **Note:** In order to cache data for faster builds, ensure the `cache_directories` directives are specified as outlined above.
> **Note:** Ensure that the `vendor/bin/circleci-install-phalcon.sh` is executed in the **post** phase, which will allow for the inclusion of the `techpivot/phalcon-ci-installer` repository during the composer installation at inference or override phase.
> **Reference:** CircleCI PHP Versions – [Ubuntu 14.04](https://circleci.com/docs/build-image-trusty/#php) • [Ubuntu 12.04](https://circleci.com/docs/build-image-precise/#php)
### Travis CI
**`.travis.yml`**
```yml
language: php
php:
- 5.5
- 5.6
- 7.0
cache:
directories:
- vendor
- ~/.composer/cache
- ~/cphalcon
before_install:
- composer install --prefer-source --no-interaction
- vendor/bin/install-phalcon.sh 3.0.x
script:
- vendor/bin/phpunit
notifications:
email: false
```
> **Note:** Multiple PHP versions can be specified and each one will be cached independently; however, the phalcon target ref (branch or tag) will be applied for all builds
> **Reference:** [TravisCI PHP Versions](https://docs.travis-ci.com/user/languages/php#Choosing-PHP-versions-to-test-against)
### Scrutinizer
**`.scrutinizer.yml`**
```yml
build:
environment:
php:
version: 7.0.8
cache:
directories:
- ~/cphalcon
dependencies:
override:
- composer install --prefer-source --no-interaction
after:
- vendor/bin/install-phalcon.sh 3.0.x
```
> **Note:** No need to include the `vendor/` cache directory as this is cached automatically.
> **Reference:** [ScrutinizerCI PHP Versions](https://scrutinizer-ci.com/docs/configuration/build#php)
### Codeship
Sample **Setup Commands**
```bash
phpenv local 5.6
php --version
composer install --prefer-source --no-interaction
vendor/bin/install-phalcon.sh
```
> **Reference:** [Codeship CI PHP Versions](https://codeship.com/documentation/languages/php/#versions)
### Shippable
**`shippable.yml`**
```yml
language: php
php:
- 7.0
build:
cache: true
cache_dir_list:
- $SHIPPABLE_BUILD_DIR/vendor
- ~/cphalcon
ci:
- composer install --prefer-source --no-interaction
- bin/install-phalcon.sh 3.0.x
```
> **Reference:** [Shippable PHP Versions](http://docs.shippable.com/ci_languages/#php)