No Description

Dmitry Khomutov bc17b23758 UI fix 6 months ago
app a2fbd9b775 Code style fixes 6 months ago
bin a2fbd9b775 Code style fixes 6 months ago
docs e560d7c266 Added Deployer (deployer.org) plugin by @ket4yii to the plugin list 6 months ago
public bc17b23758 UI fix 6 months ago
runtime 8d7087554f Added directory /runtime/status_cache. Issue #19 7 months ago
src 550d019e17 Fixed language select on user/edit page 6 months ago
tests 075be27691 Fixed HttpClientTest test 6 months ago
.gitignore cad14a7377 Remove pluginconfig + added application parameter 'php-censor.build.remove_builds' for control artifacts 8 months ago
.php-censor.yml 9f0580e802 Improved TravisCI build settings 7 months ago
.travis.yml 9f0580e802 Improved TravisCI build settings 7 months ago
CHANGELOG.md 8d82e41666 Updated CHANGELOG.md (Added v0.11.0) 6 months ago
LICENSE.md 60267cc315 Small updates 8 months ago
README.md 23aa5d7cc7 Improved README and Docs 6 months ago
bootstrap.php a2fbd9b775 Code style fixes 6 months ago
composer.json acfa89071c Removed useless daterangepicker and datepicker (+ Updated dependencies). Issue #37 6 months ago
composer.lock acfa89071c Removed useless daterangepicker and datepicker (+ Updated dependencies). Issue #37 6 months ago
phpunit.mysql.xml 9f0580e802 Improved TravisCI build settings 7 months ago
phpunit.pgsql.xml 9f0580e802 Improved TravisCI build settings 7 months ago

README.md

PHPCensor TravisCI Latest Version Total downloads License SensioLabs Insight

PHP Censor

PHP Censor is a open source self-hosted continuous integration server for PHP projects (Fork of PHPCI).

Dashboard

More screenshots.

System requirements

  • Unix-like OS (Windows isn't supported);

  • PHP 5.6+ (with OpenSSL support and enabled functions: exec(), shell_exec() and proc_open());

  • Web-server (Nginx or Apache2);

  • Database (MySQL/MariaDB or PostgreSQL);

  • Beanstalkd queue (Optional);

Features

  • Clone project from Github, Bitbucket, Gitlab, Git, Mercurial, SVN or from local directory;

  • Set up and tear down database tests for PostgreSQL, MySQL or SQLite;

  • Install Composer dependencies;

  • Run tests for PHPUnit, Atoum, Behat, Codeception and PHPSpec;

  • Check code via Lint, PHPParallelLint, Pdepend, PHPCodeSniffer, PHPCpd, PHPCsFixer, PHPDocblockChecker, PHPLoc, PHPMessDetect, PHPTalLint and TechnicalDept;

  • Run through any combination of the other supported plugins, including Campfire, CleanBuild, CopyBuild, Deployer, Env, Git, Grunt, Gulp, PackageBuild, Phar, Phing, Shell and Wipe;

  • Send notifications on Email, XMPP, Slack, IRC, Flowdock, HipChat and Telegram;

  • Use your LDAP-server for authentication;

Installing

  • Go to the directory in which you want to install PHP Censor, for example: /var/www:
cd /var/www
  • Create project by Composer:
composer create-project corpsee/php-censor php-censor.local --keep-vcs

Or download latest archive from Github, unzip it and run composer install.

  • Create empty database for application (Mysql/MariaDB or Postgres);

  • Install Beanstalkd Queue (Optional, if you are going to use queue with Worker):

aptitude install beanstalkd # For deb-based
  • Install PHP Censor itself:
cd ./php-censor.local

# Interactive installation
./bin/console php-censor:install

# Non-interactive installation
./bin/console php-censor:install --url='http://php-censor.local' --db-type=pgsql --db-host=localhost --db-name=php-censor --db-user=php-censor --db-password=php-censor --db-port=null --admin-name=admin --admin-password=admin --admin-email='admin@php-censor.local' --queue-use=1 --queue-host=localhost --queue-name=php-censor

# Non-interactive installation with prepared config.yml file
./bin/console php-censor:install --config-from-file=yes --admin-name=admin --admin-password=admin --admin-email='admin@php-censor.local'

Installing via Docker

If you want to install PHP Censor as Docker container, you can use ket4yii/docker-php-censor project.

Updating

  • Go to your PHP Censor directory (to /var/www/php-censor.local for example):
cd /var/www/php-censor.local
  • Pull the latest code by Git:
git pull -r
  • Update the Composer dependencies: composer install

  • Update the PHP Censor database scheme:

./bin/console php-censor-migrations:migrate

Configuring project

There are several ways to set up the project:

  • Add project without any project config (Runs "zero-config" plugins, including: Composer, TechnicalDept, PHPLoc, PHPCpd, PHPCodeSniffer, PHPMessDetect, PHPDocblockChecker, PHPParallelLint, PHPUnit and Codeception);

  • Similar to Travis CI, to support PHP Censor in your project, you simply need to add a .php-censor.yml (phpci.yml/.phpci.yml for backward compatibility with PHPCI) file to the root of your repository;

  • Add project config in PHP Censor project page (And it will cancel file config from project repository);

The project config should look something like this:

setup:
  composer:
    action: "install"
test:
  php_unit:
    config: "phpunit.xml"
  php_mess_detector:
    allow_failures: true
  php_code_sniffer:
    standard: "PSR2"
  php_cpd:
    allow_failures: true
complete:
  email:
    default_mailto_address: admin@php-censor.local

More details about configuring project.

Migrations

Run to apply latest migrations:

cd /path/to/php-censor
./bin/console php-censor-migrations:migrate

Run to create new migration:

cd /path/to/php-censor
./bin/console php-censor-migrations:create NewMigrationName

Tests

cd /path/to/php-censor

# For testing on MySQL DB
./vendor/bin/phpunit --configuration ./phpunit.mysql.xml

# For testing on PostgreSQL
./vendor/bin/phpunit --configuration ./phpunit.pgsql.xml

For Phar plugin tests set 'phar.readonly' setting to Off (0) in php.ini config. Otherwise tests will be skipped.

For database B8Framework tests create empty 'b8_test' database on 'localhost' with user/password: root/<empty>' for MySQL and with user/password: postgres/<empty>' for PostgreSQL (You can change default test user, password and database name in phpunit.mysql|pgsql.xml config). If connection failed tests will be skipped.

Documentation

Full PHP Censor documentation.

License

PHP Censor is open source software licensed under the BSD-2-Clause license.