extra assertions against arrays

extra-assertions.php

<?php

namespace Tests;

use Illuminate\Support\Str;
use PHPUnit\Framework\TestCase as BaseTestCase;

class TestCase extends BaseTestCase
{
    /**
     * Assert that any of the values in the array contains something.
     *
     * @param string|int $needle
     * @param array      $haystack
     * @param string     $msg
     *
     * @return void
     */
    public static function assertArrayContains($needle, array $haystack, string $msg = '')
    {
        if ($msg === '') {
            $msg = "Expected any value in the array to contain '$needle'.";
        }

        foreach ($haystack as $value) {
            if (Str::contains($value, $needle)) {
                return;
            }
        }

        self::fail($msg);
    }

    /**
     * Assert that none of the values in the array contain something.
     *
     * @param string|int $needle
     * @param array      $haystack
     * @param string     $msg
     *
     * @return void
     */
    public static function assertArrayNotContains($needle, array $haystack, string $msg = '')
    {
        if ($msg === '') {
            $msg = "Expected none of the values in the array to contain '$needle'.";
        }

        foreach ($haystack as $value) {
            if (Str::contains($value, $needle)) {
                self::fail($msg);
            }
        }
    }
}