Download the PHP package chr0n1x/php-coveralls without Composer
On this page you can find all versions of the php package chr0n1x/php-coveralls. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package php-coveralls
php-coveralls
PHP client library for Coveralls.
API doc
API doc is generated by ApiGen
Prerequisites
- PHP 5.3 or later
- On GitHub
- Building on Travis CI, CircleCI, Jenkins or Codeship
- Testing by PHPUnit or other testing framework that can generate clover style coverage report
Installation
To install php-coveralls with Composer, just add the following to your composer.json file:
Then, you can install the new dependencies by running Composer’s update command from the directory where your composer.json
file is located:
You can see this library on Packagist.
Composer installs autoloader at ./vendor/autoloader.php
. If you use php-coveralls in your php script, add:
If you use Symfony2, autoloader has to be detected automatically.
Or you can use git clone command:
Configuration
Currently support clover style coverage report. php-coveralls collect coverage information from clover.xml
.
PHPUnit
Make sure that phpunit.xml.dist
is configured to generate "coverage-clover" type log named clover.xml
like the following configuration:
You can also use --coverage-clover
CLI option.
phpcov
Above settings are good for almost projects If your test suite is executed once a build and is not devided into several parts. But if your test suite is configured as parallel task or generates multiple coverage reports through a build, you can use either coverage_clover
configuration in .coveralls.yml
(see below coverage clover configuration section) to specify multiple clover.xml
or phpcov
for processing coverages reports.
composer.json
phpcov
is not ready for Packagist yet but you can install it via PEAR channel:
phpunit configuration
Make sure that phpunit.xml.dist
is configured to generate "coverage-php" type log:
You can also use --coverage-php
CLI option.
phpcov configuration
And then, execute phpcov.php
to merge coverage.cov
logs.
clover.xml
php-coveralls collects count
attribute in a line
tag from clover.xml
if its type
attribute equals to stmt
. When type
attribute equals to method
, php-coveralls excludes its count
attribute from coverage collection because abstract method in an abstract class is never counted though subclasses implement that method which is executed in test cases.
Travis CI
Add php vendor/bin/coveralls
to your .travis.yml
at after_script
.
CircleCI
Add pecl install xdebug
to your circle.yml
at dependencies
section since currently Xdebug extension is not pre-installed. composer
and phpunit
are pre-installed but you can install them manually in this dependencies section. The following sample uses default ones.
Add php vendor/bin/coveralls
to the "Test commands" textarea on Web UI (Edit settings > Tests > Test commands textarea).
Please note that COVERALLS_REPO_TOKEN
should be set in the same line before coveralls command execution. You can not export this variable before coveralls command execution in other command since each command runs in its own shell and does not share environment variables (see reference on CircleCI).
Codeship
You can configure CI process for Coveralls by adding the following commands to the textarea on Web UI (Project settings > Test tab).
In the "Modify your Setup Commands" section:
In the "Modify your Test Commands" section:
Next, open Project settings > Environment tab, you can set COVERALLS_REPO_TOKEN
environment variable.
In the "Configure your environment variables" section:
From local environment
If you would like to call Coveralls API from your local environment, you can set COVERALLS_RUN_LOCALLY
envrionment variable. This configuration requires repo_token
to specify which project on Coveralls your project maps to. This can be done by configuring .coveralls.yml
or COVERALLS_REPO_TOKEN
environment variable.
php-coveralls set the following properties to json_file
which is sent to Coveralls API (same behaviour as the Ruby library will do except for the service name).
- service_name: php-coveralls
- service_event_type: manual
CLI options
You can get help information for coveralls
with the --help (-h)
option.
--config (-c)
: Used to specify the path to.coveralls.yml
. Default is.coveralls.yml
--verbose (-v)
: Used to show logs.--dry-run
: Used not to send json_file to Coveralls Jobs API.--exclude-no-stmt
: Used to exclude source files that have no executable statements.
.coveralls.yml
php-coveralls can use optional .coveralls.yml
file to configure options. This configuration file is usually at the root level of your repository, but you can specify other path by --config (or -c)
CLI option. Following options are the same as Ruby library (see reference on coveralls.io).
repo_token
: Used to specify which project on Coveralls your project maps to. This is only needed for repos not using CI and should be kept secretservice_name
: Allows you to specify where Coveralls should look to find additional information about your builds. This can be any string, but usingtravis-ci
ortravis-pro
will allow Coveralls to fetch branch data, comment on pull requests, and more.
Following options can be used for php-coveralls.
src_dir
: Used to specify where the root level of your source files directory is. Default issrc
.coverage_clover
: Used to specify the path toclover.xml
. Default isbuild/logs/clover.xml
json_path
: Used to specify where to outputjson_file
that will be uploaded to Coveralls API. Default isbuild/logs/coveralls-upload.json
.
coverage clover configuration
You can specify multiple clover.xml
logs at coverage_clover
. This is useful for a project that has more than two test suites if all of the test results should be merged into one json_file
.
Change log
See changelog
Wiki
All versions of php-coveralls with dependencies
ext-json Version *
ext-simplexml Version *
symfony/yaml Version >=2.0
symfony/console Version >=2.0
symfony/config Version >=2.0
symfony/stopwatch Version >=2.2
guzzle/guzzle Version >=2.7
psr/log Version 1.0.0