Passed
Pull Request — main (#22)
by Andrey
30:44 queued 13:09
created

Is::contract()   A

Complexity

Conditions 3
Paths 3

Size

Total Lines 9
Code Lines 4

Duplication

Lines 0
Ratio 0 %

Importance

Changes 1
Bugs 0 Features 0
Metric Value
cc 3
eloc 4
c 1
b 0
f 0
nc 3
nop 1
dl 0
loc 9
rs 10
1
<?php
2
3
namespace Helldar\Support\Helpers;
4
5
use Exception;
6
use Helldar\Support\Facades\Helpers\Instance;
0 ignored issues
show
Bug introduced by
This use statement conflicts with another class in this namespace, Helldar\Support\Helpers\Instance. Consider defining an alias.

Let?s assume that you have a directory layout like this:

.
|-- OtherDir
|   |-- Bar.php
|   `-- Foo.php
`-- SomeDir
    `-- Foo.php

and let?s assume the following content of Bar.php:

// Bar.php
namespace OtherDir;

use SomeDir\Foo; // This now conflicts the class OtherDir\Foo

If both files OtherDir/Foo.php and SomeDir/Foo.php are loaded in the same runtime, you will see a PHP error such as the following:

PHP Fatal error:  Cannot use SomeDir\Foo as Foo because the name is already in use in OtherDir/Foo.php

However, as OtherDir/Foo.php does not necessarily have to be loaded and the error is only triggered if it is loaded before OtherDir/Bar.php, this problem might go unnoticed for a while. In order to prevent this error from surfacing, you must import the namespace with a different alias:

// Bar.php
namespace OtherDir;

use SomeDir\Foo as SomeDirFoo; // There is no conflict anymore.
Loading history...
7
use Helldar\Support\Facades\Helpers\Reflection;
0 ignored issues
show
Bug introduced by
This use statement conflicts with another class in this namespace, Helldar\Support\Helpers\Reflection. Consider defining an alias.

Let?s assume that you have a directory layout like this:

.
|-- OtherDir
|   |-- Bar.php
|   `-- Foo.php
`-- SomeDir
    `-- Foo.php

and let?s assume the following content of Bar.php:

// Bar.php
namespace OtherDir;

use SomeDir\Foo; // This now conflicts the class OtherDir\Foo

If both files OtherDir/Foo.php and SomeDir/Foo.php are loaded in the same runtime, you will see a PHP error such as the following:

PHP Fatal error:  Cannot use SomeDir\Foo as Foo because the name is already in use in OtherDir/Foo.php

However, as OtherDir/Foo.php does not necessarily have to be loaded and the error is only triggered if it is loaded before OtherDir/Bar.php, this problem might go unnoticed for a while. In order to prevent this error from surfacing, you must import the namespace with a different alias:

// Bar.php
namespace OtherDir;

use SomeDir\Foo as SomeDirFoo; // There is no conflict anymore.
Loading history...
8
use ReflectionClass;
9
use Throwable;
10
11
final class Is
12
{
13
    /**
14
     * Finds whether a variable is an object.
15
     *
16
     * @param  mixed  $value
17
     *
18
     * @return bool
19
     */
20
    public function object($value): bool
21
    {
22
        return is_object($value);
23
    }
24
25
    /**
26
     * Find whether the type of a variable is string.
27
     *
28
     * @param  mixed  $value
29
     *
30
     * @return bool
31
     */
32
    public function string($value): bool
33
    {
34
        return is_string($value);
35
    }
36
37
    /**
38
     * Find whether the type of a variable is interface.
39
     *
40
     * @param  mixed  $value
41
     *
42
     * @return bool
43
     */
44
    public function contract($value): bool
45
    {
46
        if (is_string($value)) {
47
            $class = Instance::classname($value);
48
49
            return ! empty($class) && interface_exists($class);
50
        }
51
52
        return Reflection::resolve($value)->isInterface();
53
    }
54
55
    /**
56
     * Find whether the type of a variable is exception.
57
     *
58
     * @param  mixed  $value
59
     *
60
     * @return bool
61
     */
62
    public function error($value): bool
63
    {
64
        return Instance::of($value, [Exception::class, Throwable::class]);
65
    }
66
67
    /**
68
     * Find whether the type of a variable is ReflectionClass.
69
     *
70
     * @param  mixed  $value
71
     *
72
     * @return bool
73
     */
74
    public function reflectionClass($value): bool
75
    {
76
        return $value instanceof ReflectionClass;
77
    }
78
}
79