README

PHP 开发者工具

安装

使用以下命令通过 composer 安装此包：

$ composer require --dev avto-dev/dev-tools "^2.0"

需要安装 composer （如何安装 composer）。

您需要修复包的主要版本。

使用方法

此包允许您轻松地将辅助工具集成到应用程序中，从而更有效地进行开发。它们可以分为以下几组：

Laravel 辅助服务

对于 Laravel 应用程序，您可以连接以下服务提供者：

应用程序单元测试

在 PHPUnit 框架的上下文中

Bootstrap

Bootstrap 是一个在所有测试开始前只执行一次的文件。其主要任务是准备环境 - 创建临时文件目录（删除之前的），准备数据库模式等。

您可以在 PHPUnit 的配置中指定自己的 bootstrap 文件路径（./phpunit.xml）

<?xml version="1.0" encoding="UTF-8"?>
<phpunit bootstrap="./tests/bootstrap.php">
    <!-- configuration -->
</phpunit>

对于 Laravel 应用程序

编写递归创建目录、连接数据库的代码可能会让您感到很繁琐。为了简化这个任务，您可以为您的类创建一个 bootsrapper，它能够在创建自己的实例时按顺序执行所有以 boot* 开头的方法。此外，$this->app 已经保存了您应用程序的实例（只需连接必要的 trait 即可）。请看以下示例：

<?php

class MyBootstrap extends \AvtoDev\DevTools\Tests\Bootstrap\AbstractLaravelTestsBootstrapper
{
    use AvtoDev\DevTools\Tests\PHPUnit\Traits\CreatesApplicationTrait;

    public function bootPrepareDatabase()
    {
        $this->app->make(Illuminate\Contracts\Console\Kernel::class)->call('migrate:refresh');
    }
}

您始终在启动测试前拥有“新鲜”的数据库模式。

其他应用程序

更简单的实现

<?php

class MyBootstrap extends \AvtoDev\DevTools\Tests\Bootstrap\AbstractTestsBootstrapper
{
    public function bootMakeSome()
    {
        // Put your code here
    }

    public function bootMakeSomethingElse()
    {
        // Put your code here
    }
}

在两种情况下，都不要忘记创建 ./tests/bootstrap.php 文件，在其中写入 <?php new MyBootstrap();，并在 PHPUnit 的配置中指定 <phpunit bootstrap="./tests/bootstrap.php">。

抽象单元测试类

为了更方便地测试您的应用程序，您可以使用本包提供的抽象单元测试类（有适用于 Laravel 应用程序的版本，也有不依赖 Laravel 的版本）。

它们的独特之处在于包含额外的 assert 方法，这些方法可以让您编写更简洁、更富有表现力的测试。此功能通过特性启用，因此您可以在需要时创建自己的抽象类（不是从提供的类继承而来）并包含所需的功能集。

推荐使用抽象类的原因在于其功能将随着时间的推移而扩展，您可以通过执行单个命令 composer update avto-dev/dev-tools 来获取它们的新功能。

对于Laravel应用程序

从 AvtoDev\DevTools\Tests\PHPUnit\AbstractLaravelTestCase 继承您的测试类。

其他应用程序

从 AvtoDev\DevTools\Tests\PHPUnit\AbstractTestCase 继承您的测试类。

PHPUnit特性

以下是一个汇总表，列出了特性和它们提供的功能。所有特性都位于 AvtoDev\DevTools\Tests\PHPUnit\Traits

测试

对于包测试，我们使用 phpunit 框架和 docker-ce + docker-compose 作为开发环境。因此，在克隆存储库后，只需在终端中写入

$ make build
$ make latest # or 'make lowest'
$ make test

变更日志

变更日志可以在 此处找到。

支持

如果您发现任何包错误，请在当前存储库中 创建一个问题。

许可证

这是一个开源软件，根据 MIT许可证 许可。