| Server IP : 66.29.137.217 / Your IP : 3.128.205.62 Web Server : LiteSpeed System : Linux premium294.web-hosting.com 4.18.0-513.11.1.lve.el8.x86_64 #1 SMP Thu Jan 18 16:21:02 UTC 2024 x86_64 User : gltevjme ( 1095) PHP Version : 7.0.33 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : ON | Sudo : OFF | Pkexec : OFF Directory : /home/gltevjme/cbt.bofirm.com/vendor/spatie/data-transfer-object/src/ |
Upload File : |
<?php
declare(strict_types=1);
namespace Spatie\DataTransferObject;
use RecursiveArrayIterator;
use RecursiveIteratorIterator;
class DocblockFieldValidator extends FieldValidator
{
public const DOCBLOCK_REGEX = <<<REGEXP
/
@var ( # Starting with `@var `, we'll capture the definition the follows
(?: # Not explicitly capturing this group,
# which contains repeated sets of type definitions
(?: # Not explicitly capturing this group
[\w?|\\\\<>,\s] # Matches type definitions like `int|string|\My\Object|array<int, string>`
)+ # These definitions can be repeated
(?: # Not explicitly capturing this group
\[] # Matches array definitions like `int[]`
)? # Array definitions are optional though
)+ # Repeated sets of type definitions
) # The whole definition after `@var ` is captured in one group
/x
REGEXP;
public function __construct(string $definition, bool $hasDefaultValue = false)
{
preg_match(
DocblockFieldValidator::DOCBLOCK_REGEX,
$definition,
$matches
);
$definition = trim($matches[1] ?? '');
$this->hasTypeDeclaration = $definition !== '';
$this->hasDefaultValue = $hasDefaultValue;
$this->isNullable = $this->resolveNullable($definition);
$this->isMixed = $this->resolveIsMixed($definition);
$this->isMixedArray = $this->resolveIsMixedArray($definition);
$this->allowedTypes = $this->resolveAllowedTypes($definition);
$this->allowedArrayTypes = $this->resolveAllowedArrayTypes($definition);
$this->allowedArrayKeyTypes = $this->resolveAllowedArrayKeyTypes($definition);
}
private function resolveNullable(string $definition): bool
{
if (! $definition) {
return true;
}
if (Str::contains($definition, ['mixed', 'null', '?'])) {
return true;
}
return false;
}
private function resolveIsMixed(string $definition): bool
{
return Str::contains($definition, ['mixed']);
}
private function resolveIsMixedArray(string $definition): bool
{
$types = $this->normaliseTypes(...explode('|', $definition));
foreach ($types as $type) {
if (in_array($type, ['iterable', 'array'])) {
return true;
}
}
return false;
}
private function resolveAllowedTypes(string $definition): array
{
return $this->normaliseTypes(...explode('|', $definition));
}
private function resolveAllowedArrayTypes(string $definition): array
{
// Iterators flatten the array for multiple return types from DataTransferObjectCollection::current
return $this->normaliseTypes(...(new RecursiveIteratorIterator(new RecursiveArrayIterator(array_map(
function (string $type) {
if (! $type) {
return;
}
if (strpos($type, '[]') !== false) {
return str_replace('[]', '', $type);
}
if (strpos($type, '>') !== false) {
preg_match('/([\w\\\\]+)(>)/', $type, $matches);
return $matches[1];
}
if (is_subclass_of($type, DataTransferObjectCollection::class)) {
return $this->resolveAllowedArrayTypesFromCollection($type);
}
return null;
},
explode('|', $definition)
)))));
}
private function resolveAllowedArrayKeyTypes(string $definition): array
{
return $this->normaliseTypes(...array_map(
function (string $type) {
if (strpos($type, '<') === false) {
return;
}
preg_match('/(<)([\w\\\\]+)(,)/', $type, $matches);
return $matches[2] ?? null;
},
explode('|', $definition)
));
}
}