README

PHP Censor 是一个开源、自托管、用于 PHP 项目的持续集成服务器（PHPCI 分支）。官方 Twitter @php_censor。

PHP Censor 版本

更多 截图。

• 系统要求
• 功能
• 变更日志
• 路线图
• 安装
• 更新
• 配置项目
• 迁移
• 代码风格
• 测试
• 文档
• 许可

系统要求

• 类 Unix 操作系统（不支持 Windows）；

• PHP 7.4+（带 OpenSSL 支持，并启用函数：exec()，shell_exec() 和 proc_open()）；

• Web 服务器（Nginx 或 Apache2）；

• 数据库（MySQL/MariaDB 或 PostgreSQL）；

• Beanstalkd 队列；

功能

• 从 GitHub，Bitbucket（Git/Hg），GitLab，Git，Hg（Mercurial），SVN（Subversion）或本地目录中克隆项目；

• 为 PostgreSQL，MySQL 或 SQLite 设置和拆卸数据库测试；

• 安装 Composer 依赖项；

• 运行 PHPUnit、Atoum、Behat、Codeception 和 PHPSpec 的测试；

• 通过 Lint、PHPParallelLint、Pdepend、PHPCodeSniffer、PHPCpd、PHPCsFixer、PHPDocblockChecker、PHPLoc、PHPMessDetector、PHPTalLint 和 TechnicalDebt 检查代码；

• 运行其他支持的插件，包括 Campfire、CleanBuild、CopyBuild、Deployer、Env、Git、Grunt、Gulp、PackageBuild、Phar、Phing、Shell 和 Wipe 的任何组合；

• 向电子邮件、XMPP、Slack、IRC、Flowdock、HipChat和Telegram发送通知；

• 使用您的LDAP服务器进行身份验证；

更新日志

版本更新日志.

路线图

请参阅里程碑。

安装

请参阅文档中的安装部分；

更新

请参阅文档中的更新部分；

配置项目

有几种方法可以设置项目

• 添加无任何项目配置的项目（运行“零配置”插件，包括：Composer、TechnicalDebt、PHPLoc、PHPCpd、PHPCodeSniffer、PHPMessDetector、PHPDocblockChecker、PHPParallelLint、PHPUnit和Codeception）；

• 类似于Travis CI，要在您的项目中支持PHP Censor，您只需将.php-censor.yml文件添加到存储库的根目录中；

• 在PHP Censor项目页面中添加项目配置（并将取消文件配置从项目存储库中删除）；

项目配置应如下所示

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

有关文档中配置项目的更多详细信息。

迁移

运行以应用最新的迁移

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

运行以创建新的迁移

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

代码风格

cd /path/to/php-censor

./vendor/bin/php-cs-fixer fix --allow-risky=yes

测试

cd /path/to/php-censor

./vendor/bin/phpunit --configuration ./phpunit.xml.dist --coverage-html ./tests/runtime/coverage -vvv --colors=always

对于Phar插件测试，在php.ini配置中将'phar.readonly'设置设置为关闭（0）。否则，测试将跳过。

对于数据库测试，在'localhost'上创建一个空的'test_db'数据库，MySQL的用户/密码为root/<empty>，PostgreSQL的用户/密码为postgres/<empty>（您可以在phpunit.xml[.dist]配置常量中更改默认测试用户、密码和数据库名称）。如果连接失败，测试将跳过。

文档

完整的PHP Censor文档.

许可

PHP Censor是开源软件，许可证为BSD-2-Clause许可证。