Add PHPCI Support to Your Projects¶
Similar to Travis CI, to support PHPCI in your project, you simply need to add a
phpci.yml file to the root of your repository. The file should look something like this:
build_settings: clone_depth: 1 # depth of 1 is a shallow clone, remove this line to clone entire repo ignore: - "vendor" - "tests" mysql: host: "localhost" user: "root" pass: "" setup: mysql: - "DROP DATABASE IF EXISTS test;" - "CREATE DATABASE test;" - "GRANT ALL PRIVILEGES ON test.* TO [email protected]'localhost' IDENTIFIED BY 'test';" composer: action: "install" test: php_unit: config: - "PHPUnit-all.xml" - "PHPUnit-ubuntu-fix.xml" directory: - "tests/" run_from: "phpunit/" coverage: "tests/logs/coverage" php_mess_detector: allow_failures: true php_code_sniffer: standard: "PSR2" php_cpd: allow_failures: true grunt: task: "build" complete: mysql: host: "localhost" user: "root" pass: "" - "DROP DATABASE IF EXISTS test;"
As mentioned earlier, PHPCI is powered by plugins, there are several phases in which plugins can be run:
setup- This phase is designed to initialize the build procedure.
test- The tests that should be run during the build. Plugins run during this phase will contribute to the success or failure of the build.
complete- Always called when the
testphase completes, regardless of success or failure. Note that is you do any mysql stuff here, you will need to add the mysql credentials to this section as well, as it runs in a separate instance.
success- Called upon success of the
failure- Called upon failure of the
fixed- Called upon success of the
testphase if the previous build of the branch was a failure.
broken- Called upon failure of the
testphase if the previous build of the branch was a success.
ignore section is merely an array of paths that should be ignored in all tests (where possible.)