README

Kahlan 是一个功能齐全的单元测试和BDD测试框架，类似于 RSpec/JSpec，它使用 describe-it 语法，并将测试在 PHP 中推进了一步。

Kahlan 允许您像在 Ruby 或 JavaScript 中一样直接模拟或猴子补丁您的代码，无需任何 PECL 扩展。

视频

• Warren Seymour 在 Unified Diff (2015) 上的演讲
• Grafikart 法语演讲 (2016, Kahlan 2.X)

IRC

chat.freenode.net (服务器) #kahlan (频道)

文档

查看完整的文档这里

要求

• PHP 7.1+
• Composer
• phpdbg 或 Xdebug（仅用于代码覆盖率分析）

主要功能

• RSpec/JSpec 语法
• 代码覆盖率指标（需要 xdebug 或 phpdbg）
• 便捷的模拟系统（不再需要 mockery 或 prophecy）
• 直接在类方法上设置模拟（即允许动态模拟）
• 能够对代码进行猴子补丁（即允许动态替换核心函数/类）
• 检查您的类/实例上调用过的方法
• 内置报告器（终端或通过 istanbul 或 lcov）进行 HTML 报告）
• 内置导出器（Coveralls，Code Climate，Scrutinizer，Clover）
• 可扩展、可自定义的工作流程

语法

<?php

describe("Example", function() {

    it("makes an expectation", function() {

         expect(true)->toBe(true);

    });

    it("expects methods to be called", function() {

        $user = new User();
        expect($user)->toReceive('save')->with(['validates' => false]);
        $user->save(['validates' => false]);

    });

    it("stubs a function", function() {

        allow('time')->toBeCalled()->andReturn(123);
        $user = new User();
        expect($user->save())->toBe(true)
        expect($user->created)->toBe(123);

    });

    it("stubs a class", function() {

        allow('PDO')->toReceive('prepare', 'fetchAll')->andReturn([['name' => 'bob']]);
        $user = new User();
        expect($user->all())->toBe([['name' => 'bob']]);

    });

});

屏幕截图

默认报告示例

详细报告示例

特定范围代码覆盖率示例

安装

通过 Composer

$ composer require --dev kahlan/kahlan

注意：Kahlan 使用了语义化版本控制，并维护一个变更日志来帮助您轻松理解发生了什么。

通过 Git 克隆

git clone git://github.com/kahlan/kahlan.git
cd kahlan
composer install
bin/kahlan              # to run specs or,
bin/kahlan --coverage=4 # to run specs with coverage info for namespaces, classes & methods (require xdebug)