README

需求

此项目模板最低要求您的Web服务器支持PHP 7.1.0。

安装

通过Composer安装

如果您没有Composer，您可以按照getcomposer.org上的说明进行安装。

然后，您可以使用以下命令安装此项目模板

composer create-project --prefer-dist thefx/yii2-app-basic .

准备应用程序

安装应用程序后，您必须执行以下步骤以初始化已安装的应用程序。您只需要做一次。

1. 打开控制台终端，执行init命令并选择dev作为环境。

   /path/to/php-bin/php /path/to/yii-application/init
   

   如果您用脚本自动化，可以以非交互模式执行init。

   /path/to/php-bin/php /path/to/yii-application/init --env=Development --overwrite=All --delete=All
   

2. 使用真实数据编辑文件config/db-local.php，例如

   return [
       'class' => 'yii\db\Connection',
       'dsn' => 'mysql:host=localhost;dbname=yii2basic',
       'username' => 'root',
       'password' => '1234',
       'charset' => 'utf8',
   ];

3. 打开控制台终端，使用命令/path/to/php-bin/php /path/to/yii-application/yii migrate应用迁移。

应用迁移

php yii migrate --migrationPath=@thefx/user/migrations
php yii migrate --migrationPath=@thefx/pages/migrations
php yii migrate --migrationPath=@thefx/blocks/migrations

然后，您可以通过以下URL访问应用程序

https:///web/

使用Docker安装

更新供应商包

docker-compose run --rm php composer update --prefer-dist

运行安装触发器（创建cookie验证代码）

docker-compose run --rm php composer install    

启动容器

docker-compose up -d

然后，您可以通过以下URL访问应用程序

http://127.0.0.1:8000

可以通过运行以下命令执行测试

docker-compose run --rm php vendor/bin/codecept run

注意

• 最低要求的Docker引擎版本为17.04（开发）（请参阅卷挂载性能调整）
• 默认配置使用您的家目录中的宿主卷.docker-composer作为Composer缓存

测试

测试位于tests目录中。它们是用Codeception PHP测试框架开发的。默认情况下有3个测试套件

• 单元
• 功能
• 接受

可以通过运行以下命令执行测试

vendor/bin/codecept run

上面的命令将执行单元和功能测试。单元测试用于测试系统组件，而功能测试用于测试用户交互。接受测试默认禁用，因为它们需要额外的设置，因为它们在真实浏览器中执行测试。

代码覆盖率支持

默认情况下，在codeception.yml配置文件中禁用了代码覆盖率，您应该取消注释所需的行以收集代码覆盖率。您可以使用以下命令运行测试并收集覆盖率

#collect coverage for all tests
vendor/bin/codecept run --coverage --coverage-html --coverage-xml

#collect coverage only for unit tests
vendor/bin/codecept run unit --coverage --coverage-html --coverage-xml

#collect coverage for unit and functional tests
vendor/bin/codecept run functional,unit --coverage --coverage-html --coverage-xml

您可以在tests/_output目录下查看代码覆盖率输出。