breezechms/apache-php

Breeze ChMS

Breeze ChMS 是世界上最简单的基于Web的教会管理软件，适用于中小型教会。

开发环境设置

MacOSx

先决条件

1. 安装 Homebrew

   bash
   $ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
   

2. 安装 docker、docker-machine、docker-compose 和 virtualbox

   bash
   $ brew cask install virtualbox
   $ brew install docker docker-machine docker-compose
   

   如果因权限问题导致错误，请进入"系统偏好设置" > "安全性与隐私" > "通用"，在底部寻找允许操作的提示。

   （图片：Oracle权限设置界面，宽度300px）

3. 安装 https://github.com/codekitchen/dinghy#install

   bash
   $ brew tap codekitchen/dinghy
   $ brew install dinghy
   

4. 创建 virtualbox 虚拟机：

   bash
   $ dinghy create --memory=1024 --cpus=2 --provider virtualbox
   

   虚拟机启动后，会获得添加Docker相关环境变量的说明，以便Docker客户端能连接到虚拟机内的Docker服务器。可将这些变量添加到.bashrc（或等效文件）中，也可通过运行以下命令更新：

   bash
   $ eval $(dinghy env)
   

获取代码并启动服务器

1. 使用git克隆仓库

   bash
   $ git clone git@github.com:BreezeChMS/breeze.git breeze
   $ cd breeze
   

2. 生成自签名SSL证书

   bash
   $ docker/generate_certs.sh
   

3. 构建docker容器

   bash
   $ docker-compose build
   $ docker-compose run --rm web composer install -n
   

4. 启动docker容器

   bash
   $ docker-compose up
   

5. 访问Breeze

   • 打开 [***]
   • 需要接受可能出现的HTTPS警告，服务器使用浏览器会提示的自签名证书。
   • 若出现ERR_CERT_INVALID错误，可能需要安装本地证书：https://github.com/BreezeChMS/zephyr/wiki/Installing-Local-Certificate

6. 连接MySQL服务器

   • 打开 [***]
   • 使用用户名root和密码root登录

7. 生成PDF需在服务器上安装wkhtmltopdf

   bash
   # 以分离模式运行docker，以便在同一终端窗口登录
   $ docker-compose up -d
   
   # 访问docker命令行
   $ docker exec -it breeze_web_1 bash
   
   # 运行以下命令安装wkhtmltopdf
   $ apt-get update
   $ apt-get install xvfb libfontconfig build-essential xorg wget libssl-dev
   $ WKHTML2PDF_VERSION='0.12.4'
   $ wget "https://github.com/wkhtmltopdf/wkhtmltopdf/releases/download/${WKHTML2PDF_VERSION}/wkhtmltox-${WKHTML2PDF_VERSION}_linux-generic-amd64.tar.xz"
   $ tar -xJf "wkhtmltox-${WKHTML2PDF_VERSION}_linux-generic-amd64.tar.xz"
   $ cd wkhtmltox
   $ cp -r * /usr/
   

   tar步骤中可能出现权限错误，属正常现象。

   （图片：获取代码并启动服务器的截图）

测试（使用Docker）

运行所有测试

bash
docker-compose run --rm web vendor/bin/codecept run --steps

运行单元测试或验收测试

bash
docker-compose run --rm web vendor/bin/codecept run unit

bash
docker-compose run --rm web vendor/bin/codecept run acceptance

测试（本地，不使用Docker）

安装依赖

1. 安装 Homebrew

   bash
   $ ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
   

2. 安装PHP 5.6（MacOSx默认安装最新版本PHP，当前为PHP 7）

   bash
   $ brew install php@5.6
   $ cat export PATH="$(brew --prefix)/opt/php@5.6/bin:$PATH" >> ~/.bashrc
   $ source ~/.bashrc
   

   在较新机器上，Homebrew可能提示没有php56的可用公式，此时可尝试：

   bash
   $ brew tap exolnet/homebrew-deprecated
   $ brew install php@5.6
   

   使用以下命令让系统使用此版本：

   bash
   $ brew link php@5.6 --force
   

   打开新终端窗口，运行：

   bash
   $ php --version
   

   应显示5.6版本。若PHP提示"Unable to load dynamic library"，可将/usr/local/etc/php/5.6/conf.d重命名为conf.d.disabled。

3. 安装 composer

   bash
   $ brew install composer
   

4. 安装 Selenium WebDriver 和 ChromeDriver

   bash
   $ brew install selenium-server-standalone
   $ brew cask install chromedriver
   

5. 安装 Codeception

   bash
   $ brew install codeception
   

6. 使用composer安装更多依赖

   bash
   $ composer install
   

运行验收测试或单元测试

1. 在新终端中运行selenium-server：

   bash
   $ selenium-server
   

2. 在另一个终端中运行验收测试

   bash
   $ vendor/bin/codecept run acceptance --steps
   

3. 运行单元测试

   bash
   $ vendor/bin/codecept run unit
   

验收测试

创建验收测试

1. 生成验收测试

   bash
   $ vendor/bin/codecept generate:cest acceptance First
   

2. 编写第一个测试

php
<?php
class FirstCest
{
    public function frontpageWorks(AcceptanceTester $I)
    {
        $I->amOnPage('/');
        $I->see('Home');
    }
}

3. 运行测试

   bash
   $ codecept run --steps ./acceptance/FirstCest.php
   

要了解Codeception及可编写的各类测试，请参阅 Codeception 入门指南。