PHPUnit:验证该数组是否具有给定值的键

时间:2009-09-28 14:19:31

标签: php phpunit

鉴于以下课程:

<?php
class Example {
    private $Other;

    public function __construct ($Other)
    {
        $this->Other = $Other;
    }

    public function query ()
    {   
        $params = array(
            'key1' => 'Value 1'
            , 'key2' => 'Value 2'
        );

        $this->Other->post($params);
    }
}

这个测试用例:

<?php
require_once 'Example.php';
require_once 'PHPUnit/Framework.php';

class ExampleTest extends PHPUnit_Framework_TestCase {

    public function test_query_key1_value ()
    {   
        $Mock = $this->getMock('Other', array('post'));

        $Mock->expects($this->once())
              ->method('post')
              ->with(YOUR_IDEA_HERE);

        $Example = new Example($Mock);
        $Example->query();
    }

如何验证$params(哪个是数组)并传递给$Other->post()包含一个名为'key1'的键,其值为'Value 1'?

我不想验证所有的数组 - 这只是一个示例代码,在实际代码中,传递的数组有更多的值,我想在那里只验证一个键/值对。

我可以使用$this->arrayHasKey('keyname')来验证密钥是否存在。

还有$this->contains('Value 1'),可用于验证数组是否具有此值。

我甚至可以将这两者与$this->logicalAnd结合起来。但这当然不会产生预期的结果。

到目前为止,我一直在使用returnCallback,捕获整个$ params然后对其进行断言,但也许还有另一种方法可以做我想要的事情?

5 个答案:

答案 0 :(得分:40)

$this->arrayHasKey('keyname');方法存在,但其名称为assertArrayHasKey

// In your PHPUnit test method
$hi = array(
    'fr' => 'Bonjour',
    'en' => 'Hello'
);

$this->assertArrayHasKey('en', $hi);    // Succeeds
$this->assertArrayHasKey('de', $hi);    // Fails

答案 1 :(得分:15)

代替创建可重用的约束类,我能够使用PHPUnit中的现有回调约束来声明数组键的值。在我的用例中,我需要检查模拟方法的第二个参数中的数组值(MongoCollection::ensureIndex(),如果有人好奇的话)。这就是我想出的:

$mockedObject->expects($this->once())
    ->method('mockedMethod')
    ->with($this->anything(), $this->callback(function($o) {
        return isset($o['timeout']) && $o['timeout'] === 10000;
    }));

callback constraint期望在其构造函数中使用callable,并在评估期间简单地调用它。断言根据callable返回true还是false返回或失败。

对于一个大项目,我当然建议创建一个可重用的约束(如上面的解决方案)或请求将PR #312合并到PHPUnit中,但是这样做了一次性的技巧需要。很容易看出回调约束如何对更复杂的断言有用。

答案 2 :(得分:8)

我最终创建了自己的约束类,基于属性一

<?php
class Test_Constraint_ArrayHas extends PHPUnit_Framework_Constraint
{
    protected $arrayKey;

    protected $constraint;

    protected $value;

    /**
     * @param PHPUnit_Framework_Constraint $constraint
     * @param string                       $arrayKey
     */
    public function __construct(PHPUnit_Framework_Constraint $constraint, $arrayKey)
    {
        $this->constraint  = $constraint;
        $this->arrayKey    = $arrayKey;
    }


    /**
     * Evaluates the constraint for parameter $other. Returns TRUE if the
     * constraint is met, FALSE otherwise.
     *
     * @param mixed $other Value or object to evaluate.
     * @return bool
     */
    public function evaluate($other)
    {
        if (!array_key_exists($this->arrayKey, $other)) {
            return false;
        }

        $this->value = $other[$this->arrayKey];

        return $this->constraint->evaluate($other[$this->arrayKey]);
    }

    /**
     * @param   mixed   $other The value passed to evaluate() which failed the
     *                         constraint check.
     * @param   string  $description A string with extra description of what was
     *                               going on while the evaluation failed.
     * @param   boolean $not Flag to indicate negation.
     * @throws  PHPUnit_Framework_ExpectationFailedException
     */
    public function fail($other, $description, $not = FALSE)
    {
        parent::fail($other[$this->arrayKey], $description, $not);
    }


    /**
     * Returns a string representation of the constraint.
     *
     * @return string
     */
    public function toString ()
    {
        return 'the value of key "' . $this->arrayKey . '"(' . $this->value . ') ' .  $this->constraint->toString();
    }


    /**
     * Counts the number of constraint elements.
     *
     * @return integer
     */
    public function count ()
    {
        return count($this->constraint) + 1;
    }


    protected function customFailureDescription ($other, $description, $not)
    {
        return sprintf('Failed asserting that %s.', $this->toString());
    }

可以像这样使用:

 ... ->with(new Test_Constraint_ArrayHas($this->equalTo($value), $key));

答案 3 :(得分:3)

如果您希望对参数进行一些复杂的测试,并且还有有用的消息和比较,总是可以选择在回调中放置断言。

e.g。

$clientMock->expects($this->once())->method('post')->with($this->callback(function($input) {
    $this->assertNotEmpty($input['txn_id']);
    unset($input['txn_id']);
    $this->assertEquals($input, array(
        //...
    ));
    return true;
}));

请注意,回调返回true。否则,它总会失败。

答案 4 :(得分:-4)

对不起,我不是说英语的人。

我认为您可以使用array_key_exists函数测试数组中是否存在键,并且您可以使用array_search测试该值是否存在

例如:

function checkKeyAndValueExists($key,$value,$arr){
    return array_key_exists($key, $arr) && array_search($value,$arr)!==false;
}

使用!==因为如果存在,array_search将返回该值的键,它可能为0.