2016-07-19 13:05:02 +02:00
PHP Censor
2017-01-04 13:22:20 +01:00
==========
2013-05-10 15:59:22 +02:00
2017-01-03 19:22:58 +01:00
PHP Censor is a fork of PHPCI (And B8Framework) and is a free and open source (BSD-2-Clause license) continuous
2016-07-19 13:05:02 +02:00
integration tool specifically designed for PHP. We've built it with simplicity in mind, so whilst it doesn't
do *everything* Jenkins can do, it is a breeze to set up and use.
2013-05-10 15:59:22 +02:00
2016-07-19 13:05:02 +02:00
What it does
2017-01-04 13:22:20 +01:00
------------
2013-05-17 17:39:44 +02:00
2013-07-25 13:36:46 +02:00
* Clones your project from Github, Bitbucket or a local path
2013-05-10 15:59:22 +02:00
* Allows you to set up and tear down test databases.
* Installs your project's Composer dependencies.
2016-07-19 13:05:02 +02:00
* Runs through any combination of the [supported plugins ](docs/README.md )).
2013-05-10 15:59:22 +02:00
* You can mark directories for the plugins to ignore.
* You can mark certain plugins as being allowed to fail (but still run.)
2016-07-19 13:05:02 +02:00
What it doesn't do (yet)
2017-01-04 13:22:20 +01:00
------------------------
2016-07-19 13:05:02 +02:00
2016-04-27 15:13:42 +02:00
* Virtualised testing.
* Multiple PHP-version tests.
2013-05-10 15:59:22 +02:00
2017-01-04 10:23:06 +01:00
Screenshots
2017-01-04 13:22:20 +01:00
-----------
2017-01-04 10:23:06 +01:00
[](docs/screenshots/dashboard.png)
[](docs/screenshots/project.png)
[](docs/screenshots/build-log.png)
[](docs/screenshots/build-errors.png)
[](docs/screenshots/build-information.png)
2016-08-11 16:32:42 +02:00
Tests
2017-01-04 13:22:20 +01:00
-----
2016-08-11 16:32:42 +02:00
```bash
cd /path/to/php-censor
./vendor/bin/phpunit
```
For Phar plugin tests set 'phar.readonly' setting to Off (0) in `php.ini` config. Otherwise tests will be skipped.
2017-01-04 09:16:20 +01:00
For database B8Framework tests create empty 'b8_test' MySQL database on 'localhost' with user/password: `root/root` . Otherwise database tests will be skipped.
2016-08-11 16:32:42 +02:00
2017-01-03 19:22:58 +01:00
Migrations
2017-01-04 13:22:20 +01:00
----------
2017-01-03 19:22:58 +01:00
Run to apply latest migrations:
```bash
cd /path/to/php-censor
./bin/console php-censor-migrations:migrate
```
Run to create new migration:
```bash
cd /path/to/php-censor
./bin/console php-censor-migrations:create NewMigrationName
```
Documentation
2017-01-04 13:22:20 +01:00
-------------
2017-01-03 19:22:58 +01:00
[PHP Censor documentation ](docs/README.md )
2016-07-19 13:05:02 +02:00
License
2017-01-04 13:22:20 +01:00
-------
2013-05-10 15:59:22 +02:00
2017-01-03 19:22:58 +01:00
PHP Censor is open source software licensed under the BSD-2-Clause license.
