and let’s assume the following content of Bar.php:
// Bar.phpnamespaceOtherDir;useSomeDir\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.phpnamespaceOtherDir;useSomeDir\FooasSomeDirFoo;// There is no conflict anymore.
Loading history...
13
use Throwable;
14
15
interface Mixin
16
{
17
/**
18
* @psalm-pure
19
* @psalm-assert null|string $value
20
*
21
* @param mixed $value
22
* @param string $message
23
*
24
* @throws InvalidArgumentException
25
*/
26
public static function nullOrString($value, $message = '');
27
28
/**
29
* @psalm-pure
30
* @psalm-assert iterable<string> $value
31
*
32
* @param mixed $value
33
* @param string $message
34
*
35
* @throws InvalidArgumentException
36
*/
37
public static function allString($value, $message = '');
38
39
/**
40
* @psalm-pure
41
* @psalm-assert null|non-empty-string $value
42
*
43
* @param mixed $value
44
* @param string $message
45
*
46
* @throws InvalidArgumentException
47
*/
48
public static function nullOrStringNotEmpty($value, $message = '');
49
50
/**
51
* @psalm-pure
52
* @psalm-assert iterable<non-empty-string> $value
53
*
54
* @param mixed $value
55
* @param string $message
56
*
57
* @throws InvalidArgumentException
58
*/
59
public static function allStringNotEmpty($value, $message = '');
60
61
/**
62
* @psalm-pure
63
* @psalm-assert null|int $value
64
*
65
* @param mixed $value
66
* @param string $message
67
*
68
* @throws InvalidArgumentException
69
*/
70
public static function nullOrInteger($value, $message = '');
71
72
/**
73
* @psalm-pure
74
* @psalm-assert iterable<int> $value
75
*
76
* @param mixed $value
77
* @param string $message
78
*
79
* @throws InvalidArgumentException
80
*/
81
public static function allInteger($value, $message = '');
82
83
/**
84
* @psalm-pure
85
* @psalm-assert null|numeric $value
86
*
87
* @param mixed $value
88
* @param string $message
89
*
90
* @throws InvalidArgumentException
91
*/
92
public static function nullOrIntegerish($value, $message = '');
93
94
/**
95
* @psalm-pure
96
* @psalm-assert iterable<numeric> $value
97
*
98
* @param mixed $value
99
* @param string $message
100
*
101
* @throws InvalidArgumentException
102
*/
103
public static function allIntegerish($value, $message = '');
104
105
/**
106
* @psalm-pure
107
* @psalm-assert null|float $value
108
*
109
* @param mixed $value
110
* @param string $message
111
*
112
* @throws InvalidArgumentException
113
*/
114
public static function nullOrFloat($value, $message = '');
115
116
/**
117
* @psalm-pure
118
* @psalm-assert iterable<float> $value
119
*
120
* @param mixed $value
121
* @param string $message
122
*
123
* @throws InvalidArgumentException
124
*/
125
public static function allFloat($value, $message = '');
126
127
/**
128
* @psalm-pure
129
* @psalm-assert null|numeric $value
130
*
131
* @param mixed $value
132
* @param string $message
133
*
134
* @throws InvalidArgumentException
135
*/
136
public static function nullOrNumeric($value, $message = '');
137
138
/**
139
* @psalm-pure
140
* @psalm-assert iterable<numeric> $value
141
*
142
* @param mixed $value
143
* @param string $message
144
*
145
* @throws InvalidArgumentException
146
*/
147
public static function allNumeric($value, $message = '');
148
149
/**
150
* @psalm-pure
151
* @psalm-assert null|int $value
152
*
153
* @param mixed $value
154
* @param string $message
155
*
156
* @throws InvalidArgumentException
157
*/
158
public static function nullOrNatural($value, $message = '');
159
160
/**
161
* @psalm-pure
162
* @psalm-assert iterable<int> $value
163
*
164
* @param mixed $value
165
* @param string $message
166
*
167
* @throws InvalidArgumentException
168
*/
169
public static function allNatural($value, $message = '');
170
171
/**
172
* @psalm-pure
173
* @psalm-assert null|bool $value
174
*
175
* @param mixed $value
176
* @param string $message
177
*
178
* @throws InvalidArgumentException
179
*/
180
public static function nullOrBoolean($value, $message = '');
181
182
/**
183
* @psalm-pure
184
* @psalm-assert iterable<bool> $value
185
*
186
* @param mixed $value
187
* @param string $message
188
*
189
* @throws InvalidArgumentException
190
*/
191
public static function allBoolean($value, $message = '');
192
193
/**
194
* @psalm-pure
195
* @psalm-assert null|scalar $value
196
*
197
* @param mixed $value
198
* @param string $message
199
*
200
* @throws InvalidArgumentException
201
*/
202
public static function nullOrScalar($value, $message = '');
203
204
/**
205
* @psalm-pure
206
* @psalm-assert iterable<scalar> $value
207
*
208
* @param mixed $value
209
* @param string $message
210
*
211
* @throws InvalidArgumentException
212
*/
213
public static function allScalar($value, $message = '');
214
215
/**
216
* @psalm-pure
217
* @psalm-assert null|object $value
218
*
219
* @param mixed $value
220
* @param string $message
221
*
222
* @throws InvalidArgumentException
223
*/
224
public static function nullOrObject($value, $message = '');
225
226
/**
227
* @psalm-pure
228
* @psalm-assert iterable<object> $value
229
*
230
* @param mixed $value
231
* @param string $message
232
*
233
* @throws InvalidArgumentException
234
*/
235
public static function allObject($value, $message = '');
236
237
/**
238
* @psalm-pure
239
* @psalm-assert null|resource $value
240
*
241
* @param mixed $value
242
* @param string|null $type type of resource this should be. @see https://www.php.net/manual/en/function.get-resource-type.php
243
* @param string $message
244
*
245
* @throws InvalidArgumentException
246
*/
247
public static function nullOrResource($value, $type = null, $message = '');
248
249
/**
250
* @psalm-pure
251
* @psalm-assert iterable<resource> $value
252
*
253
* @param mixed $value
254
* @param string|null $type type of resource this should be. @see https://www.php.net/manual/en/function.get-resource-type.php
255
* @param string $message
256
*
257
* @throws InvalidArgumentException
258
*/
259
public static function allResource($value, $type = null, $message = '');
260
261
/**
262
* @psalm-pure
263
* @psalm-assert null|callable $value
264
*
265
* @param mixed $value
266
* @param string $message
267
*
268
* @throws InvalidArgumentException
269
*/
270
public static function nullOrIsCallable($value, $message = '');
271
272
/**
273
* @psalm-pure
274
* @psalm-assert iterable<callable> $value
275
*
276
* @param mixed $value
277
* @param string $message
278
*
279
* @throws InvalidArgumentException
280
*/
281
public static function allIsCallable($value, $message = '');
282
283
/**
284
* @psalm-pure
285
* @psalm-assert null|array $value
286
*
287
* @param mixed $value
288
* @param string $message
289
*
290
* @throws InvalidArgumentException
291
*/
292
public static function nullOrIsArray($value, $message = '');
293
294
/**
295
* @psalm-pure
296
* @psalm-assert iterable<array> $value
297
*
298
* @param mixed $value
299
* @param string $message
300
*
301
* @throws InvalidArgumentException
302
*/
303
public static function allIsArray($value, $message = '');
304
305
/**
306
* @psalm-pure
307
* @psalm-assert null|iterable $value
308
*
309
* @deprecated use "isIterable" or "isInstanceOf" instead
310
*
311
* @param mixed $value
312
* @param string $message
313
*
314
* @throws InvalidArgumentException
315
*/
316
public static function nullOrIsTraversable($value, $message = '');
317
318
/**
319
* @psalm-pure
320
* @psalm-assert iterable<iterable> $value
321
*
322
* @deprecated use "isIterable" or "isInstanceOf" instead
323
*
324
* @param mixed $value
325
* @param string $message
326
*
327
* @throws InvalidArgumentException
328
*/
329
public static function allIsTraversable($value, $message = '');
330
331
/**
332
* @psalm-pure
333
* @psalm-assert null|array|ArrayAccess $value
334
*
335
* @param mixed $value
336
* @param string $message
337
*
338
* @throws InvalidArgumentException
339
*/
340
public static function nullOrIsArrayAccessible($value, $message = '');
webmozart /
assert
Ivan Kurnosov
Let’s assume that you have a directory layout like this:
. |-- OtherDir | |-- Bar.php | `-- Foo.php `-- SomeDir `-- Foo.phpand let’s assume the following content of
Bar.php:If both files
OtherDir/Foo.phpandSomeDir/Foo.phpare 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.phpHowever, as
OtherDir/Foo.phpdoes not necessarily have to be loaded and the error is only triggered if it is loaded beforeOtherDir/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: