application php-censor

erp-mgroen/php-censor

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

, _(*1)

, _(*2)

PHP Censor is a open source self-hosted continuous integration server for PHP projects (PHPCI fork)., _(*3)

, _(*4)

More screenshots., _(*5)

• System requirements
• Features
• Installing
• Installing via Docker
• Updating
• Configuring project
• Migrations
• Tests
• Documentation
• License

System requirements

• Unix-like OS (Windows isn't supported);, _(*6)

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

• Web-server (Nginx or Apache2);, _(*8)

• Database (MySQL/MariaDB or PostgreSQL);, _(*9)

• Beanstalkd queue (Optional);, _(*10)

Features

• Clone project from Github, Bitbucket, Gitlab, Git, Mercurial, SVN or from local directory;, _(*11)

• Set up and tear down database tests for PostgreSQL, MySQL or SQLite;, _(*12)

• Install Composer dependencies;, _(*13)

• Run tests for PHPUnit, Atoum, Behat, Codeception and PHPSpec;, _(*14)

• Check code via Lint, PHPParallelLint, Pdepend, PHPCodeSniffer, PHPCpd, PHPCsFixer, PHPDocblockChecker, PHPLoc, PHPMessDetect, PHPTalLint and TechnicalDept;, _(*15)

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

• Send notifications on Email, XMPP, Slack, IRC, Flowdock, HipChat and Telegram;, _(*17)

• Use your LDAP-server for authentication;, _(*18)

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 php-censor/php-censor php-censor.local --keep-vcs

Or download latest archive from Github, unzip it and run composer install., _(*19)

• Create empty database for application (Mysql/MariaDB or Postgres);, _(*20)

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

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'

• Add a virtual host to your web server, pointing to the public directory within your new PHP Censor directory. You'll need to set up rewrite rules to point all non-existent requests to PHP Censor;, _(*22)

• Set up the PHP Censor Worker (Need configured Queue) or a cron-job to run PHP Censor builds;, _(*23)

Installing via Docker

If you want to install PHP Censor as Docker container, you can use php-censor/docker-php-censor project., _(*24)

Updating

• Go to your PHP Censor directory (to /var/www/php-censor.local for example):, _(*25)

  cd /var/www/php-censor.local
  

• Pull the latest code from repository by Git (If you want latest master branch):, _(*26)

  git checkout master
  git pull -r
  

  Or pull latest version:, _(*27)

  git fetch
  git checkout <version>
  

• Update the Composer dependencies: composer install, _(*28)

• Update the database scheme:, _(*29)

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

• Restart Supervisord workers (If you use workers and Supervisord):, _(*30)

  sudo supervisorctl status
  sudo supervisorctl restart <worker:worker_00>
  ...
  sudo supervisorctl restart <worker:worker_nn>
  

  Or restart Systemd workers (If you use workers and Systemd):, _(*31)

  sudo systemctl restart <worker@1.service>
  ...
  sudo systemctl restart <worker@n.service>
  

Configuring project

There are several ways to set up the project:, _(*32)

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

• 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;, _(*34)

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

The project config should look something like this:, _(*36)

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., _(*37)

Migrations

Run to apply latest migrations:, _(*38)

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

Run to create new migration:, _(*39)

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., _(*40)

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., _(*41)

Documentation

Full PHP Censor documentation., _(*42)

License

PHP Censor is open source software licensed under the BSD-2-Clause license., _(*43)