QueryPHP

Appearance

类型 ​

Testing Is Documentation

tests/Support/TypeTest.php

QueryPHP 提供了增加 PHP 自身类型的辅助方法。

Uses

php
<?php

use Leevel\Kernel\Utils\Api;
use Leevel\Support\Type;

判断是否为字符串 ​

php
public function testTypeString(): void
{
    self::assertTrue(Type::type('foo', 'string'));
    self::assertFalse(Type::type(1, 'string'));
}

判断是否为整型 ​

php
public function testTypeInt(): void
{
    self::assertTrue(Type::type(1, 'int'));
    self::assertTrue(Type::type(3, 'integer'));
    self::assertFalse(Type::type(true, 'int'));
}

判断是否为浮点数 ​

php
public function testTypeFloat(): void
{
    self::assertTrue(Type::type(1.1, 'float'));
    self::assertTrue(Type::type(3.14, 'double'));
    self::assertFalse(Type::type(true, 'double'));
}

判断是否为布尔值 ​

php
public function testTypeBool(): void
{
    self::assertTrue(Type::type(true, 'bool'));
    self::assertTrue(Type::type(false, 'bool'));
    self::assertFalse(Type::type(4, 'bool'));
}

判断是否为数字 ​

php
public function testTypeNumeric(): void
{
    self::assertTrue(Type::type(1.2, 'numeric'));
    self::assertTrue(Type::type(2, 'numeric'));
    self::assertTrue(Type::type('2.5', 'numeric'));
    self::assertFalse(Type::type(false, 'numeric'));
}

判断是否为标量 ​

php
public function testTypeScalar(): void
{
    self::assertTrue(Type::type(1, 'scalar'));
    self::assertTrue(Type::type('hello world', 'scalar'));
    self::assertTrue(Type::type(0, 'scalar'));
    self::assertTrue(Type::type(false, 'scalar'));
    self::assertTrue(Type::type(1.1, 'scalar'));
    self::assertTrue(Type::type(false, 'scalar'));
    self::assertFalse(Type::type([], 'scalar'));
    self::assertFalse(Type::type(null, 'scalar'));
}

判断是否为资源 ​

php
public function testTypeResource(): void
{
    $testFile = __DIR__.'/test.txt';
    file_put_contents($testFile, 'foo');
    $resource = fopen($testFile, 'r');
    self::assertTrue(Type::type($resource, 'resource'));
    self::assertFalse(Type::type(4, 'resource'));
    fclose($resource);
    unlink($testFile);
}

判断是否为闭包 ​

php
public function testTypeClosure(): void
{
    self::assertTrue(Type::type(static function (): void {}, 'Closure'));
    self::assertFalse(Type::type(true, 'Closure'));
}

判断是否为数组 ​

格式支持

  • 支持 PHP 内置或者自定义的 is_array,is_int,is_custom 等函数
  • 数组支持 array:int,string 格式，值类型
  • 数组支持 array:int:string,string:array 格式，键类型:值类型
  • 数组支持 array:string:array:string:array:string:int 无限层级格式，键类型:值类型:键类型:值类型...(值类型|键类型:值类型)
php
public function testTypeArray(): void
{
    self::assertTrue(Type::type([], 'array'));
    self::assertTrue(Type::type([1, 2], 'array:int'));
    self::assertFalse(Type::type([1, 2], 'array:'));
    self::assertTrue(Type::type([1, 2], 'array:int:int'));
    self::assertTrue(Type::type(['foo' => 1, 'bar' => 2], 'array:string:int'));
    self::assertTrue(Type::type(['foo' => [], 'bar' => []], 'array:string:array'));
    self::assertTrue(Type::type(['foo' => [1, 2, 3], 'bar' => [4, 5, 6]], 'array:string:array:int'));
    self::assertFalse(Type::type(['foo' => [1, 2, 3], 'bar' => [4, 5, 6]], 'array:string:array:string'));
    self::assertTrue(Type::type(['foo' => ['hello' => 1], 'bar' => ['hello' => 4]], 'array:string:array:string:int'));
    self::assertTrue(Type::type(['foo' => ['hello' => ['foo' => 2]], 'bar' => ['hello' => ['foo' => 2]]], 'array:string:array:string:array:string:int'));
}

判断是否为对象 ​

php
public function testTypeObject(): void
{
    self::assertTrue(Type::type(new \stdClass(), 'object'));
    self::assertFalse(Type::type(null, 'object'));
}

判断是否为 NULL ​

php
public function testTypeNull(): void
{
    self::assertTrue(Type::type(null, 'null'));
    self::assertFalse(Type::type(1, 'null'));
}

判断是否为回调 ​

\Tests\Support\Callback1 定义

php
namespace Tests\Support;

class Callback1
{
    public function test(): void {}

    public static function test2(): void {}
}
php
public function testTypeCallback(): void
{
    self::assertTrue(Type::type(static function (): void {}, 'callable'));
    self::assertTrue(Type::type('md5', 'callable'));
    self::assertTrue(Type::type([new Callback1(), 'test'], 'callable'));
    self::assertTrue(Type::type([Callback1::class, 'test2'], 'callable'));
    self::assertFalse(Type::type(1, 'callable'));
}

判断是否为对象实例 ​

\Tests\Support\Callback2 定义

php
namespace Tests\Support;

class Callback2 implements IInterface {}

\Tests\Support\IInterface 定义

php
namespace Tests\Support;

interface IInterface {}
php
public function testTypeInstance(): void
{
    self::assertTrue(Type::type(new \stdClass(), \stdClass::class));
    self::assertTrue(Type::type(new Callback1(), Callback1::class));
    self::assertTrue(Type::type(new Callback2(), IInterface::class));
    self::assertFalse(Type::type(1, 'callback'));
}

判断是否为指定的几种类型 ​

php
public function testTypeThese(): void
{
    self::assertTrue(Type::these('foo', ['string']));
    self::assertTrue(Type::these(1, ['string', 'int']));
}

判断是否为数组元素类型 ​

格式支持

  • 数组支持 int,string 格式，值类型
  • 数组支持 int:string,string:array 格式，键类型:值类型
  • 数组支持 string:array:string:array:string:int 无限层级格式，键类型:值类型:键类型:值类型...(值类型|键类型:值类型)
php
public function testTypeStrictArray(): void
{
    self::assertTrue(Type::arr(['foo'], ['string']));
    self::assertFalse(Type::arr([1, 2], ['string']));
    self::assertTrue(Type::arr(['bar', 'foo'], ['string']));
    self::assertTrue(Type::arr(['bar', 2], ['string', 'int']));
    self::assertTrue(Type::arr(['hello' => 'bar', 2], ['string:string', 'int']));
    self::assertTrue(Type::arr(['hello' => 'bar', 'foo' => 'bar'], ['string:string']));
    self::assertFalse(Type::arr(['hello' => 'bar', 2], ['string:string']));
    self::assertFalse(Type::arr(['foo' => [1, 2, 3], 'bar' => [4, 5, 6]], ['string:array:string']));
    self::assertTrue(Type::arr(['foo' => ['hello' => 1], 'bar' => ['hello' => 4]], ['string:array:string:int']));
    self::assertTrue(Type::arr(['foo' => ['hello' => ['foo' => 2]], 'bar' => ['hello' => ['foo' => 2]]], ['string:array:string:array:string:int']));
}

MIT Licensed | Copyright © 2010-present Xiangmin Liu