ngmy/stand-ci

A continuous integration tool designed for Laravel 5 application

Stand CI

, _(*1)

Stand CI is a continuous integration tool designed for Laravel 5 application. It can easily be integrated into your Laravel 5 application., _(*2)

Integrated Tools

Stand CI has integrated the following tools:, _(*3)

• PHPUnit - A unit testing framework, _(*4)

• PhpMetrics - A tool to generate reports about such as complexity, maintenability, instability of code, _(*5)

• PHPMD - A tool to detect potential problems in code, _(*6)

• PHPCPD - A tool to detect duplicate code, _(*7)

• PHP_CodeSniffer - A tool to detect coding standard violations, _(*8)

• phpDocumentor - A tool to generate documentation of code, _(*9)

Requirements

Stand CI has the following requirements:, _(*10)

• PHP 5.4+, _(*11)

• Laravel 5.0+, _(*12)

Installation

Add the package to your composer.json and run composer update:, _(*13)

{
    "require-dev": {
        "ngmy/stand-ci": "dev-master"
    }
}

Add the following to the list of service providers in config/app.php:, _(*14)

'Ngmy\StandCi\StandCiServiceProvider',

Run the following command:, _(*15)

$ php artisan stand-ci:install

Usage

via Web Browser

You can access the Stand CI dashborard via your web browser directly, by typing in the following URL:, _(*16)

http://your.laravel.site.domain/stand-ci/builds

After you open the dashboard, you can start the build, by click the "Build" button., _(*17)

via Command Line

Build

You can start the build, by running the following command:, _(*18)

$ sudo -u your_web_server_user -H php artisan stand-ci:build

Housekeeping

You can discard old builds, by running the following command:, _(*19)

$ sudo -u your_web_server_user -H php artisan stand-ci:housekeep

This will discard older than the most recent 20 builds., _(*20)

You can also specify the maximum number of builds to keep, by using the --max-builds option:, _(*21)

$ sudo -u your_web_server_user -H php artisan stand-ci:housekeep --max-builds=5

Note: You must be running these commands as your web server user. Otherwise, you will not be able to housekeep using the browser., _(*22)

via Crontab

Example: The following will build at one minute past midnight each day:, _(*23)

01 00 * * * sudo -u your_web_server_user -H php /path/to/your/laravel/project/artisan stand-ci:build; sudo -u your_web_server_user -H php /path/to/your/laravel/project/artisan stand-ci:housekeep

Other Features

Build Notification

If you wish to be notified when the build fails, set the sender and receiver, and the pretend option to false, in your config/packages/ngmy/stand-ci/ngmy-stand-ci-notification.php configuration file., _(*24)