Issues (19)

src/TypedMapInterface.php (1 issue)

Labels
Severity
1
<?php declare(strict_types=1);
2
/**
3
 * This file is part of the daikon-cqrs/data-structure project.
4
 *
5
 * For the full copyright and license information, please view the LICENSE
6
 * file that was distributed with this source code.
7
 */
8
9
namespace Daikon\DataStructure;
10
11
use Countable;
12
use Ds\Map;
0 ignored issues
show
This use statement conflicts with another class in this namespace, Daikon\DataStructure\Map. 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...
13
use IteratorAggregate;
14
15
interface TypedMapInterface extends IteratorAggregate, Countable
16
{
17
    public function keys(): array;
18
19
    public function empty(): self;
20
21
    public function has(string $key): bool;
22
23
    /** @param null|object $default */
24
    public function get(string $key, $default = null): ?object;
25
26
    public function with(string $key, object $object): self;
27
28
    public function without(string $key): self;
29
30
    /** @return string|bool */
31
    public function find(object $object);
32
33
    public function first(): object;
34
35
    public function last(): object;
36
37
    public function isEmpty(): bool;
38
39
    /** @psalm-suppress MissingParamType */
40
    public function merge($map): self;
41
42
    /** @psalm-suppress MissingParamType */
43
    public function intersect($map): self;
44
45
    /** @psalm-suppress MissingParamType */
46
    public function diff($map): self;
47
48
    public function filter(callable $predicate): self;
49
50
    /** @return string|bool */
51
    public function search(callable $predicate);
52
53
    public function map(callable $predicate): self;
54
55
    /**
56
     * @param mixed $initial
57
     * @return mixed
58
     */
59
    public function reduce(callable $predicate, $initial = null);
60
61
    public function getValidTypes(): array;
62
63
    public function unwrap(): array;
64
65
    public function getIterator(): Map;
66
67
    public function __get(string $key): ?object;
68
}
69