- */
- private $values;
-
- /**
- * @var int
- */
- private $size = 0;
-
- /**
- * Creates a new enum map.
- *
- * @param string $keyType the type of the keys, must extend AbstractEnum
- * @param string $valueType the type of the values
- * @param bool $allowNullValues whether to allow null values
- * @throws IllegalArgumentException when key type does not extend AbstractEnum
- */
- public function __construct(string $keyType, string $valueType, bool $allowNullValues)
- {
- if (! is_subclass_of($keyType, AbstractEnum::class)) {
- throw new IllegalArgumentException(sprintf(
- 'Class %s does not extend %s',
- $keyType,
- AbstractEnum::class
- ));
- }
-
- $this->keyType = $keyType;
- $this->valueType = $valueType;
- $this->allowNullValues = $allowNullValues;
- $this->keyUniverse = $keyType::values();
- $this->values = array_fill(0, count($this->keyUniverse), null);
- }
-
- public function __serialize(): array
- {
- $values = [];
-
- foreach ($this->values as $ordinal => $value) {
- if (null === $value) {
- continue;
- }
-
- $values[$ordinal] = $this->unmaskNull($value);
- }
-
- return [
- 'keyType' => $this->keyType,
- 'valueType' => $this->valueType,
- 'allowNullValues' => $this->allowNullValues,
- 'values' => $values,
- ];
- }
-
- public function __unserialize(array $data): void
- {
- $this->unserialize(serialize($data));
- }
-
- /**
- * Checks whether the map types match the supplied ones.
- *
- * You should call this method when an EnumMap is passed to you and you want to ensure that it's made up of the
- * correct types.
- *
- * @throws ExpectationException when supplied key type mismatches local key type
- * @throws ExpectationException when supplied value type mismatches local value type
- * @throws ExpectationException when the supplied map allows null values, abut should not
- */
- public function expect(string $keyType, string $valueType, bool $allowNullValues) : void
- {
- if ($keyType !== $this->keyType) {
- throw new ExpectationException(sprintf(
- 'Callee expected an EnumMap with key type %s, but got %s',
- $keyType,
- $this->keyType
- ));
- }
-
- if ($valueType !== $this->valueType) {
- throw new ExpectationException(sprintf(
- 'Callee expected an EnumMap with value type %s, but got %s',
- $keyType,
- $this->keyType
- ));
- }
-
- if ($allowNullValues !== $this->allowNullValues) {
- throw new ExpectationException(sprintf(
- 'Callee expected an EnumMap with nullable flag %s, but got %s',
- ($allowNullValues ? 'true' : 'false'),
- ($this->allowNullValues ? 'true' : 'false')
- ));
- }
- }
-
- /**
- * Returns the number of key-value mappings in this map.
- */
- public function size() : int
- {
- return $this->size;
- }
-
- /**
- * Returns true if this map maps one or more keys to the specified value.
- */
- public function containsValue($value) : bool
- {
- return in_array($this->maskNull($value), $this->values, true);
- }
-
- /**
- * Returns true if this map contains a mapping for the specified key.
- */
- public function containsKey(AbstractEnum $key) : bool
- {
- $this->checkKeyType($key);
- return null !== $this->values[$key->ordinal()];
- }
-
- /**
- * Returns the value to which the specified key is mapped, or null if this map contains no mapping for the key.
- *
- * More formally, if this map contains a mapping from a key to a value, then this method returns the value;
- * otherwise it returns null (there can be at most one such mapping).
- *
- * A return value of null does not necessarily indicate that the map contains no mapping for the key; it's also
- * possible that hte map explicitly maps the key to null. The {@see self::containsKey()} operation may be used to
- * distinguish these two cases.
- *
- * @return mixed
- */
- public function get(AbstractEnum $key)
- {
- $this->checkKeyType($key);
- return $this->unmaskNull($this->values[$key->ordinal()]);
- }
-
- /**
- * Associates the specified value with the specified key in this map.
- *
- * If the map previously contained a mapping for this key, the old value is replaced.
- *
- * @return mixed the previous value associated with the specified key, or null if there was no mapping for the key.
- * (a null return can also indicate that the map previously associated null with the specified key.)
- * @throws IllegalArgumentException when the passed values does not match the internal value type
- */
- public function put(AbstractEnum $key, $value)
- {
- $this->checkKeyType($key);
-
- if (! $this->isValidValue($value)) {
- throw new IllegalArgumentException(sprintf('Value is not of type %s', $this->valueType));
- }
-
- $index = $key->ordinal();
- $oldValue = $this->values[$index];
- $this->values[$index] = $this->maskNull($value);
-
- if (null === $oldValue) {
- ++$this->size;
- }
-
- return $this->unmaskNull($oldValue);
- }
-
- /**
- * Removes the mapping for this key frm this map if present.
- *
- * @return mixed the previous value associated with the specified key, or null if there was no mapping for the key.
- * (a null return can also indicate that the map previously associated null with the specified key.)
- */
- public function remove(AbstractEnum $key)
- {
- $this->checkKeyType($key);
-
- $index = $key->ordinal();
- $oldValue = $this->values[$index];
- $this->values[$index] = null;
-
- if (null !== $oldValue) {
- --$this->size;
- }
-
- return $this->unmaskNull($oldValue);
- }
-
- /**
- * Removes all mappings from this map.
- */
- public function clear() : void
- {
- $this->values = array_fill(0, count($this->keyUniverse), null);
- $this->size = 0;
- }
-
- /**
- * Compares the specified map with this map for quality.
- *
- * Returns true if the two maps represent the same mappings.
- */
- public function equals(self $other) : bool
- {
- if ($this === $other) {
- return true;
- }
-
- if ($this->size !== $other->size) {
- return false;
- }
-
- return $this->values === $other->values;
- }
-
- /**
- * Returns the values contained in this map.
- *
- * The array will contain the values in the order their corresponding keys appear in the map, which is their natural
- * order (the order in which the num constants are declared).
- */
- public function values() : array
- {
- return array_values(array_map(function ($value) {
- return $this->unmaskNull($value);
- }, array_filter($this->values, function ($value) : bool {
- return null !== $value;
- })));
- }
-
- public function serialize() : string
- {
- return serialize($this->__serialize());
- }
-
- public function unserialize($serialized) : void
- {
- $data = unserialize($serialized);
- $this->__construct($data['keyType'], $data['valueType'], $data['allowNullValues']);
-
- foreach ($this->keyUniverse as $key) {
- if (array_key_exists($key->ordinal(), $data['values'])) {
- $this->put($key, $data['values'][$key->ordinal()]);
- }
- }
- }
-
- public function getIterator() : Traversable
- {
- foreach ($this->keyUniverse as $key) {
- if (null === $this->values[$key->ordinal()]) {
- continue;
- }
-
- yield $key => $this->unmaskNull($this->values[$key->ordinal()]);
- }
- }
-
- private function maskNull($value)
- {
- if (null === $value) {
- return NullValue::instance();
- }
-
- return $value;
- }
-
- private function unmaskNull($value)
- {
- if ($value instanceof NullValue) {
- return null;
- }
-
- return $value;
- }
-
- /**
- * @throws IllegalArgumentException when the passed key does not match the internal key type
- */
- private function checkKeyType(AbstractEnum $key) : void
- {
- if (get_class($key) !== $this->keyType) {
- throw new IllegalArgumentException(sprintf(
- 'Object of type %s is not the same type as %s',
- get_class($key),
- $this->keyType
- ));
- }
- }
-
- private function isValidValue($value) : bool
- {
- if (null === $value) {
- if ($this->allowNullValues) {
- return true;
- }
-
- return false;
- }
-
- switch ($this->valueType) {
- case 'mixed':
- return true;
-
- case 'bool':
- case 'boolean':
- return is_bool($value);
-
- case 'int':
- case 'integer':
- return is_int($value);
-
- case 'float':
- case 'double':
- return is_float($value);
-
- case 'string':
- return is_string($value);
-
- case 'object':
- return is_object($value);
-
- case 'array':
- return is_array($value);
- }
-
- return $value instanceof $this->valueType;
- }
-}
diff --git a/data/web/inc/lib/vendor/dasprid/enum/src/Exception/CloneNotSupportedException.php b/data/web/inc/lib/vendor/dasprid/enum/src/Exception/CloneNotSupportedException.php
deleted file mode 100644
index 4b37dbebe..000000000
--- a/data/web/inc/lib/vendor/dasprid/enum/src/Exception/CloneNotSupportedException.php
+++ /dev/null
@@ -1,10 +0,0 @@
-
**Environment:**
- LDAP Server Type: [e.g. ActiveDirectory / OpenLDAP / FreeIPA]
- - PHP Version: [e.g. 8.1 / 8.2]
+ - PHP Version: [e.g. 7.3 / 7.4 / 8.0]
**Describe the bug:**
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/.github/ISSUE_TEMPLATE/support---help-request.md b/data/web/inc/lib/vendor/directorytree/ldaprecord/.github/ISSUE_TEMPLATE/support---help-request.md
index b97a977cb..731d5cea0 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/.github/ISSUE_TEMPLATE/support---help-request.md
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/.github/ISSUE_TEMPLATE/support---help-request.md
@@ -17,4 +17,4 @@ assignees: ''
-->
**Environment:**
- LDAP Server Type: [e.g. ActiveDirectory / OpenLDAP / FreeIPA]
- - PHP Version: [e.g. 8.1 / 8.2]
+ - PHP Version: [e.g. 7.3 / 7.4 / 8.0]
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/.github/workflows/run-cs-fix.yml b/data/web/inc/lib/vendor/directorytree/ldaprecord/.github/workflows/run-cs-fix.yml
deleted file mode 100644
index 80cd34d61..000000000
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/.github/workflows/run-cs-fix.yml
+++ /dev/null
@@ -1,34 +0,0 @@
-name: run-cs-fix
-
-on:
- push:
-
-jobs:
- lint:
- runs-on: ubuntu-latest
- strategy:
- fail-fast: true
- matrix:
- php: [8.3]
-
- steps:
- - name: Checkout code
- uses: actions/checkout@v4
-
- - name: Setup PHP
- uses: shivammathur/setup-php@v2
- with:
- php-version: ${{ matrix.php }}
- extensions: json, dom, curl, libxml, mbstring
- coverage: none
-
- - name: Install Pint
- run: composer global require laravel/pint
-
- - name: Run Pint
- run: pint
-
- - name: Commit linted files
- uses: stefanzweifel/git-auto-commit-action@v5
- with:
- commit_message: "Fix code style"
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/.github/workflows/run-integration-tests.yml b/data/web/inc/lib/vendor/directorytree/ldaprecord/.github/workflows/run-integration-tests.yml
index de67e91c9..6a6b2f9e5 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/.github/workflows/run-integration-tests.yml
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/.github/workflows/run-integration-tests.yml
@@ -1,62 +1,62 @@
name: run-integration-tests
on:
- push:
- pull_request:
- schedule:
- - cron: "0 0 * * *"
+ push:
+ pull_request:
+ schedule:
+ - cron: "0 0 * * *"
jobs:
- run-tests:
- runs-on: ${{ matrix.os }}
+ run-tests:
+ runs-on: ${{ matrix.os }}
- services:
- ldap:
- image: osixia/openldap:1.4.0
- env:
- LDAP_TLS_VERIFY_CLIENT: try
- LDAP_OPENLDAP_UID: 1000
- LDAP_OPENLDAP_GID: 1000
- LDAP_ORGANISATION: Local
- LDAP_DOMAIN: local.com
- LDAP_ADMIN_PASSWORD: secret
- ports:
- - 389:389
- - 636:636
+ services:
+ ldap:
+ image: osixia/openldap:1.4.0
+ env:
+ LDAP_TLS_VERIFY_CLIENT: try
+ LDAP_OPENLDAP_UID: 1000
+ LDAP_OPENLDAP_GID: 1000
+ LDAP_ORGANISATION: Local
+ LDAP_DOMAIN: local.com
+ LDAP_ADMIN_PASSWORD: secret
+ ports:
+ - 389:389
+ - 636:636
- strategy:
- fail-fast: false
- matrix:
- os: [ubuntu-latest]
- php: [8.1, 8.2, 8.3]
+ strategy:
+ fail-fast: false
+ matrix:
+ os: [ubuntu-latest]
+ php: [8.1, 8.0, 7.4]
- name: ${{ matrix.os }} - P${{ matrix.php }}
+ name: ${{ matrix.os }} - P${{ matrix.php }}
- steps:
- - name: Checkout code
- uses: actions/checkout@v2
+ steps:
+ - name: Checkout code
+ uses: actions/checkout@v2
- - name: Cache dependencies
- uses: actions/cache@v3
- with:
- path: ~/.composer/cache/files
- key: dependencies-php-${{ matrix.php }}-composer-${{ hashFiles('composer.json') }}
+ - name: Cache dependencies
+ uses: actions/cache@v2
+ with:
+ path: ~/.composer/cache/files
+ key: dependencies-php-${{ matrix.php }}-composer-${{ hashFiles('composer.json') }}
- - name: Set ldap.conf file permissions
- run: sudo chown -R $USER:$USER /etc/ldap/ldap.conf
+ - name: Set ldap.conf file permissions
+ run: sudo chown -R $USER:$USER /etc/ldap/ldap.conf
- - name: Create ldap.conf file disabling TLS verification
- run: sudo echo "TLS_REQCERT never" > "/etc/ldap/ldap.conf"
+ - name: Create ldap.conf file disabling TLS verification
+ run: sudo echo "TLS_REQCERT never" > "/etc/ldap/ldap.conf"
- - name: Setup PHP
- uses: shivammathur/setup-php@v2
- with:
- php-version: ${{ matrix.php }}
- extensions: ldap, json
- coverage: none
+ - name: Setup PHP
+ uses: shivammathur/setup-php@v2
+ with:
+ php-version: ${{ matrix.php }}
+ extensions: ldap, json
+ coverage: none
- - name: Install dependencies
- run: composer update --prefer-dist --no-interaction
+ - name: Install dependencies
+ run: composer update --prefer-dist --no-interaction
- - name: Execute tests
- run: vendor/bin/phpunit --testsuite Integration
+ - name: Execute tests
+ run: vendor/bin/phpunit --testsuite Integration
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/.github/workflows/run-tests.yml b/data/web/inc/lib/vendor/directorytree/ldaprecord/.github/workflows/run-tests.yml
index 8781e918a..6aaa3fd4a 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/.github/workflows/run-tests.yml
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/.github/workflows/run-tests.yml
@@ -1,41 +1,41 @@
name: run-tests
on:
- push:
- pull_request:
- schedule:
- - cron: "0 0 * * *"
+ push:
+ pull_request:
+ schedule:
+ - cron: "0 0 * * *"
jobs:
- run-tests:
- runs-on: ${{ matrix.os }}
- name: ${{ matrix.os }} - P${{ matrix.php }}
+ run-tests:
+ runs-on: ${{ matrix.os }}
+ name: ${{ matrix.os }} - P${{ matrix.php }}
- strategy:
- fail-fast: false
- matrix:
- os: [ubuntu-latest, windows-latest]
- php: [8.1, 8.2, 8.3, 8.4]
+ strategy:
+ fail-fast: false
+ matrix:
+ os: [ubuntu-latest, windows-latest]
+ php: [8.1, 8.0, 7.4, 7.3]
- steps:
- - name: Checkout code
- uses: actions/checkout@v2
+ steps:
+ - name: Checkout code
+ uses: actions/checkout@v2
- - name: Cache dependencies
- uses: actions/cache@v3
- with:
- path: ~/.composer/cache/files
- key: dependencies-php-${{ matrix.php }}-composer-${{ hashFiles('composer.json') }}
+ - name: Cache dependencies
+ uses: actions/cache@v2
+ with:
+ path: ~/.composer/cache/files
+ key: dependencies-php-${{ matrix.php }}-composer-${{ hashFiles('composer.json') }}
- - name: Setup PHP
- uses: shivammathur/setup-php@v2
- with:
- php-version: ${{ matrix.php }}
- extensions: ldap, json
- coverage: none
+ - name: Setup PHP
+ uses: shivammathur/setup-php@v2
+ with:
+ php-version: ${{ matrix.php }}
+ extensions: ldap, json
+ coverage: none
- - name: Install dependencies
- run: composer update --prefer-dist --no-interaction
+ - name: Install dependencies
+ run: composer update --prefer-dist --no-interaction
- - name: Execute tests
- run: vendor/bin/phpunit --testsuite Unit
+ - name: Execute tests
+ run: vendor/bin/phpunit --testsuite Unit
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/.scrutinizer.yml b/data/web/inc/lib/vendor/directorytree/ldaprecord/.scrutinizer.yml
new file mode 100644
index 000000000..b3f8f88b2
--- /dev/null
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/.scrutinizer.yml
@@ -0,0 +1,9 @@
+filter:
+ excluded_paths:
+ - tests/*
+build:
+ nodes:
+ analysis:
+ tests:
+ override:
+ - command: php-scrutinizer-run
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/.styleci.yml b/data/web/inc/lib/vendor/directorytree/ldaprecord/.styleci.yml
new file mode 100644
index 000000000..0285f1790
--- /dev/null
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/.styleci.yml
@@ -0,0 +1 @@
+preset: laravel
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/composer.json b/data/web/inc/lib/vendor/directorytree/ldaprecord/composer.json
index 97e84cd5e..65d7dd8f6 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/composer.json
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/composer.json
@@ -29,22 +29,20 @@
}
],
"require": {
- "php": ">=8.1",
+ "php": ">=7.3",
"ext-ldap": "*",
"ext-json": "*",
- "ext-iconv": "*",
- "psr/log": "*",
- "nesbot/carbon": "*",
- "psr/simple-cache": "^1.0|^2.0|^3.0",
- "illuminate/contracts": "^8.0|^9.0|^10.0|^11.0|^12.0",
- "illuminate/collections": "^8.0|^9.0|^10.0|^11.0|^12.0"
+ "psr/log": "^1.0|^2.0|^3.0",
+ "psr/simple-cache": "^1.0|^2.0",
+ "nesbot/carbon": "^1.0|^2.0",
+ "tightenco/collect": "^5.6|^6.0|^7.0|^8.0|^9.0",
+ "illuminate/contracts": "^5.0|^6.0|^7.0|^8.0|^9.0|^10.0",
+ "symfony/polyfill-php80": "^1.25"
},
"require-dev": {
"phpunit/phpunit": "^9.0",
"mockery/mockery": "^1.0",
- "spatie/ray": "^1.24",
- "laravel/pint": "^1.6",
- "fakerphp/faker": "^1.21"
+ "spatie/ray": "^1.24"
},
"archive": {
"exclude": [
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/docker-compose.yml b/data/web/inc/lib/vendor/directorytree/ldaprecord/docker-compose.yml
index 1abf0979d..de96b1398 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/docker-compose.yml
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/docker-compose.yml
@@ -1,3 +1,5 @@
+version: '3'
+
services:
ldap:
image: osixia/openldap:1.4.0
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/readme.md b/data/web/inc/lib/vendor/directorytree/ldaprecord/readme.md
index 4e34bd727..e00f8ef69 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/readme.md
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/readme.md
@@ -1,12 +1,25 @@
+
+
-
+
-
-
-
-
+
+
+
+
+ 
+
+
+
+
+
+
+
+
+
+
@@ -19,9 +32,9 @@
- Quickstart
+ Quickstart
·
- Documentation
+ Documentation
·
Laravel Integration
·
@@ -54,15 +67,15 @@ Active Directory Features
🚪 **Enable / Disable Accounts**
-Detect and assign User Account Control values on accounts with the fluent [Account Control builder](https://ldaprecord.com/docs/core/v3/active-directory/users/#uac).
+Detect and assign User Account Control values on accounts with the fluent [Account Control builder](https://ldaprecord.com/docs/core/v2/active-directory/users/#uac).
🔑 **Reset / Change Passwords**
-Built-in support for [changing](https://ldaprecord.com/docs/core/v3/active-directory/users/#changing-passwords) and [resetting](https://ldaprecord.com/docs/core/v3/active-directory/users/#resetting-passwords) passwords on Active Directory accounts.
+Built-in support for [changing](https://ldaprecord.com/docs/core/v2/active-directory/users/#changing-passwords) and [resetting](https://ldaprecord.com/docs/core/v2/active-directory/users/#resetting-passwords) passwords on Active Directory accounts.
🗑 **Restore Deleted Objects**
-Seamlessly access your Active Directory recycle bin and [restore deleted objects](https://ldaprecord.com/docs/core/v3/models/#restoring-deleted-models).
+We've all been there -- accidentally deleting a user or group in Active Directory. [Restore them](https://ldaprecord.com/docs/core/v2/models/#restoring-deleted-models) by seamlessly accessing your directory's recycle bin.
---
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Auth/Events/Event.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Auth/Events/Event.php
index 29687dbf2..7c1bb3c87 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Auth/Events/Event.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Auth/Events/Event.php
@@ -8,23 +8,33 @@ abstract class Event
{
/**
* The connection that the username and password is being bound on.
+ *
+ * @var LdapInterface
*/
- protected LdapInterface $connection;
+ protected $connection;
/**
* The username that is being used for binding.
+ *
+ * @var string
*/
- protected ?string $username;
+ protected $username;
/**
* The password that is being used for binding.
+ *
+ * @var string
*/
- protected ?string $password;
+ protected $password;
/**
* Constructor.
+ *
+ * @param LdapInterface $connection
+ * @param string $username
+ * @param string $password
*/
- public function __construct(LdapInterface $connection, ?string $username = null, ?string $password = null)
+ public function __construct(LdapInterface $connection, $username, $password)
{
$this->connection = $connection;
$this->username = $username;
@@ -32,25 +42,31 @@ abstract class Event
}
/**
- * Get the event's connection.
+ * Returns the events connection.
+ *
+ * @return LdapInterface
*/
- public function getConnection(): LdapInterface
+ public function getConnection()
{
return $this->connection;
}
/**
- * Get the authentication event's username.
+ * Returns the authentication events username.
+ *
+ * @return string
*/
- public function getUsername(): ?string
+ public function getUsername()
{
return $this->username;
}
/**
- * Get the authentication event's password.
+ * Returns the authentication events password.
+ *
+ * @return string
*/
- public function getPassword(): ?string
+ public function getPassword()
{
return $this->password;
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Auth/Events/Failed.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Auth/Events/Failed.php
index b26049169..7133e4390 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Auth/Events/Failed.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Auth/Events/Failed.php
@@ -2,32 +2,7 @@
namespace LdapRecord\Auth\Events;
-use Exception;
-use LdapRecord\Auth\BindException;
-use LdapRecord\LdapInterface;
-
class Failed extends Event
{
- /**
- * The exception that was thrown during the bind attempt.
- */
- protected BindException $exception;
-
- /**
- * Constructor.
- */
- public function __construct(LdapInterface $connection, ?string $username, ?string $password, BindException $exception)
- {
- parent::__construct($connection, $username, $password);
-
- $this->exception = $exception;
- }
-
- /**
- * Get the exception that was thrown during the bind attempt.
- */
- public function getException(): BindException
- {
- return $this->exception;
- }
+ //
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Auth/Guard.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Auth/Guard.php
index d560098b7..c00989ae6 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Auth/Guard.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Auth/Guard.php
@@ -3,6 +3,11 @@
namespace LdapRecord\Auth;
use Exception;
+use LdapRecord\Auth\Events\Attempting;
+use LdapRecord\Auth\Events\Binding;
+use LdapRecord\Auth\Events\Bound;
+use LdapRecord\Auth\Events\Failed;
+use LdapRecord\Auth\Events\Passed;
use LdapRecord\Configuration\DomainConfiguration;
use LdapRecord\Events\DispatcherInterface;
use LdapRecord\LdapInterface;
@@ -11,21 +16,30 @@ class Guard
{
/**
* The connection to bind to.
+ *
+ * @var LdapInterface
*/
- protected LdapInterface $connection;
+ protected $connection;
/**
* The domain configuration to utilize.
+ *
+ * @var DomainConfiguration
*/
- protected DomainConfiguration $configuration;
+ protected $configuration;
/**
* The event dispatcher.
+ *
+ * @var DispatcherInterface
*/
- protected ?DispatcherInterface $events = null;
+ protected $events;
/**
* Constructor.
+ *
+ * @param LdapInterface $connection
+ * @param DomainConfiguration $configuration
*/
public function __construct(LdapInterface $connection, DomainConfiguration $configuration)
{
@@ -36,10 +50,15 @@ class Guard
/**
* Attempt binding a user to the LDAP server.
*
+ * @param string $username
+ * @param string $password
+ * @param bool $stayBound
+ * @return bool
+ *
* @throws UsernameRequiredException
* @throws PasswordRequiredException
*/
- public function attempt(string $username, string $password, bool $stayBound = false): bool
+ public function attempt($username, $password, $stayBound = false)
{
switch (true) {
case empty($username):
@@ -48,73 +67,58 @@ class Guard
throw new PasswordRequiredException('A password must be specified.');
}
- $this->fireAuthEvent('attempting', $username, $password);
+ $this->fireAttemptingEvent($username, $password);
try {
$this->bind($username, $password);
- $bound = true;
+ $authenticated = true;
- $this->fireAuthEvent('passed', $username, $password);
- } catch (BindException) {
- $bound = false;
+ $this->firePassedEvent($username, $password);
+ } catch (BindException $e) {
+ $authenticated = false;
}
if (! $stayBound) {
$this->bindAsConfiguredUser();
}
- return $bound;
+ return $authenticated;
}
/**
- * Attempt binding a user to the LDAP server. Supports sasl and anonymous binding.
+ * Attempt binding a user to the LDAP server. Supports anonymous binding.
+ *
+ * @param string|null $username
+ * @param string|null $password
*
* @throws BindException
* @throws \LdapRecord\ConnectionException
*/
- public function bind(?string $username = null, ?string $password = null): void
+ public function bind($username = null, $password = null)
{
- $this->fireAuthEvent('binding', $username, $password);
+ $this->fireBindingEvent($username, $password);
// Prior to binding, we will upgrade our connectivity to TLS on our current
// connection and ensure we are not already bound before upgrading.
// This is to prevent subsequent upgrading on several binds.
- if ($this->connection->isUsingTLS() && ! $this->connection->isSecure()) {
+ if ($this->connection->isUsingTLS() && ! $this->connection->isBound()) {
$this->connection->startTLS();
}
try {
- if (! $this->authenticate($username, $password)) {
+ if (! $this->connection->bind($username, $password)) {
throw new Exception($this->connection->getLastError(), $this->connection->errNo());
}
- $this->fireAuthEvent('bound', $username, $password);
+ $this->fireBoundEvent($username, $password);
} catch (Exception $e) {
- $exception = BindException::withDetailedError($e, $this->connection->getDetailedError());
+ $this->fireFailedEvent($username, $password);
- $this->fireAuthEvent('failed', $username, $password, $exception);
-
- throw $exception;
+ throw BindException::withDetailedError($e, $this->connection->getDetailedError());
}
}
- /**
- * Authenticate by binding to the LDAP server.
- *
- * @throws \LdapRecord\ConnectionException
- */
- protected function authenticate(?string $username = null, ?string $password = null): bool
- {
- if ($this->configuration->get('use_sasl') ?? false) {
- return $this->connection->saslBind(
- $username, $password, $this->configuration->get('sasl_options')
- );
- }
-
- return $this->connection->bind($username, $password)->successful();
- }
-
/**
* Bind to the LDAP server using the configured username and password.
*
@@ -122,7 +126,7 @@ class Guard
* @throws \LdapRecord\ConnectionException
* @throws \LdapRecord\Configuration\ConfigurationException
*/
- public function bindAsConfiguredUser(): void
+ public function bindAsConfiguredUser()
{
$this->bind(
$this->configuration->get('username'),
@@ -132,29 +136,92 @@ class Guard
/**
* Get the event dispatcher instance.
+ *
+ * @return DispatcherInterface
*/
- public function getDispatcher(): ?DispatcherInterface
+ public function getDispatcher()
{
return $this->events;
}
/**
* Set the event dispatcher instance.
+ *
+ * @param DispatcherInterface $dispatcher
+ * @return void
*/
- public function setDispatcher(?DispatcherInterface $dispatcher = null): void
+ public function setDispatcher(DispatcherInterface $dispatcher)
{
$this->events = $dispatcher;
}
/**
- * Fire an authentication event.
+ * Fire the attempting event.
+ *
+ * @param string $username
+ * @param string $password
+ * @return void
*/
- protected function fireAuthEvent(string $name, ?string $username = null, ?string $password = null, ...$args): void
+ protected function fireAttemptingEvent($username, $password)
{
if (isset($this->events)) {
- $event = implode('\\', [Events::class, ucfirst($name)]);
+ $this->events->fire(new Attempting($this->connection, $username, $password));
+ }
+ }
- $this->events->fire(new $event($this->connection, $username, $password, ...$args));
+ /**
+ * Fire the passed event.
+ *
+ * @param string $username
+ * @param string $password
+ * @return void
+ */
+ protected function firePassedEvent($username, $password)
+ {
+ if (isset($this->events)) {
+ $this->events->fire(new Passed($this->connection, $username, $password));
+ }
+ }
+
+ /**
+ * Fire the failed event.
+ *
+ * @param string $username
+ * @param string $password
+ * @return void
+ */
+ protected function fireFailedEvent($username, $password)
+ {
+ if (isset($this->events)) {
+ $this->events->fire(new Failed($this->connection, $username, $password));
+ }
+ }
+
+ /**
+ * Fire the binding event.
+ *
+ * @param string $username
+ * @param string $password
+ * @return void
+ */
+ protected function fireBindingEvent($username, $password)
+ {
+ if (isset($this->events)) {
+ $this->events->fire(new Binding($this->connection, $username, $password));
+ }
+ }
+
+ /**
+ * Fire the bound event.
+ *
+ * @param string $username
+ * @param string $password
+ * @return void
+ */
+ protected function fireBoundEvent($username, $password)
+ {
+ if (isset($this->events)) {
+ $this->events->fire(new Bound($this->connection, $username, $password));
}
}
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Configuration/DomainConfiguration.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Configuration/DomainConfiguration.php
index 425fbd9ed..f71f63d87 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Configuration/DomainConfiguration.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Configuration/DomainConfiguration.php
@@ -8,15 +8,19 @@ class DomainConfiguration
{
/**
* The extended configuration options.
+ *
+ * @var array
*/
- protected static array $extended = [];
+ protected static $extended = [];
/**
* The configuration options array.
*
* The default values for each key indicate the type of value it requires.
+ *
+ * @var array
*/
- protected array $options = [
+ protected $options = [
// An array of LDAP hosts.
'hosts' => [],
@@ -29,9 +33,6 @@ class DomainConfiguration
// The port to use for connecting to your hosts.
'port' => LdapInterface::PORT,
- // The protocol to use for connecting to your hosts (ldap:// or ldaps://).
- 'protocol' => null,
-
// The base distinguished name of your domain.
'base_dn' => '',
@@ -41,28 +42,13 @@ class DomainConfiguration
// The password to use for binding.
'password' => '',
- // Whether to use SSL when connecting.
+ // Whether or not to use SSL when connecting.
'use_ssl' => false,
- // Whether to use TLS when connecting.
+ // Whether or not to use TLS when connecting.
'use_tls' => false,
- // Whether to use SASL when connecting.
- 'use_sasl' => false,
-
- // Whether to allow password changes over plaintext.
- 'allow_insecure_password_changes' => false,
-
- // SASL options
- 'sasl_options' => [
- 'mech' => null,
- 'realm' => null,
- 'authc_id' => null,
- 'authz_id' => null,
- 'props' => null,
- ],
-
- // Whether follow referrals is enabled when performing LDAP operations.
+ // Whether or not follow referrals is enabled when performing LDAP operations.
'follow_referrals' => false,
// Custom LDAP options.
@@ -72,6 +58,8 @@ class DomainConfiguration
/**
* Constructor.
*
+ * @param array $options
+ *
* @throws ConfigurationException When an option value given is an invalid type.
*/
public function __construct(array $options = [])
@@ -85,24 +73,32 @@ class DomainConfiguration
/**
* Extend the configuration with a custom option, or override an existing.
+ *
+ * @param string $option
+ * @param mixed $default
+ * @return void
*/
- public static function extend(string $option, mixed $default = null): void
+ public static function extend($option, $default = null)
{
static::$extended[$option] = $default;
}
/**
* Flush the extended configuration options.
+ *
+ * @return void
*/
- public static function flushExtended(): void
+ public static function flushExtended()
{
static::$extended = [];
}
/**
* Get all configuration options.
+ *
+ * @return array
*/
- public function all(): array
+ public function all()
{
return $this->options;
}
@@ -110,9 +106,12 @@ class DomainConfiguration
/**
* Set a configuration option.
*
+ * @param string $key
+ * @param mixed $value
+ *
* @throws ConfigurationException When an option value given is an invalid type.
*/
- public function set(string $key, mixed $value): void
+ public function set($key, $value)
{
if ($this->validate($key, $value)) {
$this->options[$key] = $value;
@@ -120,14 +119,17 @@ class DomainConfiguration
}
/**
- * Get the value for the specified configuration options.
+ * Returns the value for the specified configuration options.
+ *
+ * @param string $key
+ * @return mixed
*
* @throws ConfigurationException When the option specified does not exist.
*/
- public function get(string $key): mixed
+ public function get($key)
{
if (! $this->has($key)) {
- throw new ConfigurationException("Option $key does not exist.");
+ throw new ConfigurationException("Option {$key} does not exist.");
}
return $this->options[$key];
@@ -135,8 +137,11 @@ class DomainConfiguration
/**
* Checks if a configuration option exists.
+ *
+ * @param string $key
+ * @return bool
*/
- public function has(string $key): bool
+ public function has($key)
{
return array_key_exists($key, $this->options);
}
@@ -144,9 +149,13 @@ class DomainConfiguration
/**
* Validate the configuration option.
*
+ * @param string $key
+ * @param mixed $value
+ * @return bool
+ *
* @throws ConfigurationException When an option value given is an invalid type.
*/
- protected function validate(string $key, mixed $value): bool
+ protected function validate($key, $value)
{
$default = $this->get($key);
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Configuration/Validators/ArrayValidator.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Configuration/Validators/ArrayValidator.php
index 1324d1681..4aa43ed46 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Configuration/Validators/ArrayValidator.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Configuration/Validators/ArrayValidator.php
@@ -6,13 +6,15 @@ class ArrayValidator extends Validator
{
/**
* The validation exception message.
+ *
+ * @var string
*/
- protected string $message = 'Option [:option] must be an array.';
+ protected $message = 'Option [:option] must be an array.';
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function passes(): bool
+ public function passes()
{
return is_array($this->value);
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Configuration/Validators/BooleanValidator.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Configuration/Validators/BooleanValidator.php
index 1156859d3..1d25a4b25 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Configuration/Validators/BooleanValidator.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Configuration/Validators/BooleanValidator.php
@@ -6,13 +6,15 @@ class BooleanValidator extends Validator
{
/**
* The validation exception message.
+ *
+ * @var string
*/
- protected string $message = 'Option [:option] must be a boolean.';
+ protected $message = 'Option [:option] must be a boolean.';
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function passes(): bool
+ public function passes()
{
return is_bool($this->value);
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Configuration/Validators/IntegerValidator.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Configuration/Validators/IntegerValidator.php
index d7015888e..5c4f0f95e 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Configuration/Validators/IntegerValidator.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Configuration/Validators/IntegerValidator.php
@@ -6,13 +6,15 @@ class IntegerValidator extends Validator
{
/**
* The validation exception message.
+ *
+ * @var string
*/
- protected string $message = 'Option [:option] must be an integer.';
+ protected $message = 'Option [:option] must be an integer.';
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function passes(): bool
+ public function passes()
{
return is_numeric($this->value);
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Configuration/Validators/StringOrNullValidator.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Configuration/Validators/StringOrNullValidator.php
index 5ca453c74..bc2337245 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Configuration/Validators/StringOrNullValidator.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Configuration/Validators/StringOrNullValidator.php
@@ -6,13 +6,15 @@ class StringOrNullValidator extends Validator
{
/**
* The validation exception message.
+ *
+ * @var string
*/
- protected string $message = 'Option [:option] must be a string or null.';
+ protected $message = 'Option [:option] must be a string or null.';
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function passes(): bool
+ public function passes()
{
return is_string($this->value) || is_null($this->value);
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Configuration/Validators/Validator.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Configuration/Validators/Validator.php
index 25aedcbfa..d107314d5 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Configuration/Validators/Validator.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Configuration/Validators/Validator.php
@@ -8,23 +8,32 @@ abstract class Validator
{
/**
* The configuration key under validation.
+ *
+ * @var string
*/
- protected string $key;
+ protected $key;
/**
* The configuration value under validation.
+ *
+ * @var mixed
*/
- protected mixed $value;
+ protected $value;
/**
* The validation exception message.
+ *
+ * @var string
*/
- protected string $message;
+ protected $message;
/**
* Constructor.
+ *
+ * @param string $key
+ * @param mixed $value
*/
- public function __construct(string $key, mixed $value)
+ public function __construct($key, $value)
{
$this->key = $key;
$this->value = $value;
@@ -32,15 +41,19 @@ abstract class Validator
/**
* Determine if the validation rule passes.
+ *
+ * @return bool
*/
- abstract public function passes(): bool;
+ abstract public function passes();
/**
* Validate the configuration value.
*
+ * @return bool
+ *
* @throws ConfigurationException
*/
- public function validate(): bool
+ public function validate()
{
if (! $this->passes()) {
$this->fail();
@@ -52,9 +65,11 @@ abstract class Validator
/**
* Throw a configuration exception.
*
+ * @return void
+ *
* @throws ConfigurationException
*/
- protected function fail(): void
+ protected function fail()
{
throw new ConfigurationException(
str_replace(':option', $this->key, $this->message)
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Connection.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Connection.php
index e04393a27..6e55cffc9 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Connection.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Connection.php
@@ -5,7 +5,6 @@ namespace LdapRecord;
use Carbon\Carbon;
use Closure;
use LdapRecord\Auth\Guard;
-use LdapRecord\Configuration\ConfigurationException;
use LdapRecord\Configuration\DomainConfiguration;
use LdapRecord\Events\DispatcherInterface;
use LdapRecord\Query\Builder;
@@ -18,64 +17,85 @@ class Connection
/**
* The underlying LDAP connection.
+ *
+ * @var Ldap
*/
- protected LdapInterface $ldap;
+ protected $ldap;
/**
* The cache driver.
+ *
+ * @var Cache|null
*/
- protected ?Cache $cache = null;
+ protected $cache;
/**
* The domain configuration.
+ *
+ * @var DomainConfiguration
*/
- protected DomainConfiguration $configuration;
+ protected $configuration;
/**
- * The event dispatcher.
+ * The event dispatcher;.
+ *
+ * @var DispatcherInterface|null
*/
- protected ?DispatcherInterface $dispatcher = null;
+ protected $dispatcher;
/**
- * The currently connected host.
+ * The current host connected to.
+ *
+ * @var string
*/
- protected string $host;
+ protected $host;
/**
* The configured domain hosts.
+ *
+ * @var array
*/
- protected array $hosts = [];
+ protected $hosts = [];
/**
* The attempted hosts that failed connecting to.
+ *
+ * @var array
*/
- protected array $attempted = [];
+ protected $attempted = [];
/**
* The callback to execute upon total connection failure.
+ *
+ * @var Closure
*/
- protected Closure $failed;
+ protected $failed;
/**
* The authentication guard resolver.
+ *
+ * @var Closure
*/
- protected Closure $authGuardResolver;
+ protected $authGuardResolver;
/**
* Whether the connection is retrying the initial connection attempt.
+ *
+ * @var bool
*/
- protected bool $retryingInitialConnection = false;
+ protected $retryingInitialConnection = false;
/**
* Constructor.
*
- * @throws ConfigurationException
+ * @param array|DomainConfiguration $config
+ * @param LdapInterface|null $ldap
*/
- public function __construct(DomainConfiguration|array $config = [], ?LdapInterface $ldap = null)
+ public function __construct($config = [], LdapInterface $ldap = null)
{
$this->setConfiguration($config);
- $this->setLdapConnection($ldap ?? new Ldap);
+ $this->setLdapConnection($ldap ?? new Ldap());
$this->failed = function () {
$this->dispatch(new Events\ConnectionFailed($this));
@@ -89,9 +109,12 @@ class Connection
/**
* Set the connection configuration.
*
+ * @param array|DomainConfiguration $config
+ * @return $this
+ *
* @throws Configuration\ConfigurationException
*/
- public function setConfiguration(DomainConfiguration|array $config = []): void
+ public function setConfiguration($config = [])
{
if (! $config instanceof DomainConfiguration) {
$config = new DomainConfiguration($config);
@@ -102,50 +125,54 @@ class Connection
$this->hosts = $this->configuration->get('hosts');
$this->host = reset($this->hosts);
+
+ return $this;
}
/**
* Set the LDAP connection.
+ *
+ * @param LdapInterface $ldap
+ * @return $this
*/
- public function setLdapConnection(LdapInterface $ldap): void
+ public function setLdapConnection(LdapInterface $ldap)
{
$this->ldap = $ldap;
+
+ return $this;
}
/**
* Set the event dispatcher.
+ *
+ * @param DispatcherInterface $dispatcher
+ * @return $this
*/
- public function setDispatcher(DispatcherInterface $dispatcher): void
+ public function setDispatcher(DispatcherInterface $dispatcher)
{
$this->dispatcher = $dispatcher;
+
+ return $this;
}
/**
- * Get the event dispatcher.
+ * Initializes the LDAP connection.
+ *
+ * @return void
*/
- public function getDispatcher(): ?DispatcherInterface
- {
- return $this->dispatcher;
- }
-
- /**
- * Initialize the LDAP connection.
- */
- public function initialize(): void
+ public function initialize()
{
$this->configure();
- $this->ldap->connect(
- $this->host,
- $this->configuration->get('port'),
- $this->configuration->get('protocol')
- );
+ $this->ldap->connect($this->host, $this->configuration->get('port'));
}
/**
* Configure the LDAP connection.
+ *
+ * @return void
*/
- protected function configure(): void
+ protected function configure()
{
if ($this->configuration->get('use_ssl')) {
$this->ldap->ssl();
@@ -165,53 +192,60 @@ class Connection
/**
* Set the cache store.
+ *
+ * @param CacheInterface $store
+ * @return $this
*/
- public function setCache(CacheInterface $store): void
+ public function setCache(CacheInterface $store)
{
$this->cache = new Cache($store);
+
+ return $this;
}
/**
* Get the cache store.
+ *
+ * @return Cache|null
*/
- public function getCache(): ?Cache
+ public function getCache()
{
return $this->cache;
}
/**
* Get the LDAP configuration instance.
+ *
+ * @return DomainConfiguration
*/
- public function getConfiguration(): DomainConfiguration
+ public function getConfiguration()
{
return $this->configuration;
}
/**
* Get the LDAP connection instance.
+ *
+ * @return Ldap
*/
- public function getLdapConnection(): LdapInterface
+ public function getLdapConnection()
{
return $this->ldap;
}
- /**
- * Set the auth guard resolver callback.
- */
- public function setGuardResolver(Closure $callback): void
- {
- $this->authGuardResolver = $callback;
- }
-
/**
* Bind to the LDAP server.
*
* If no username or password is specified, then the configured credentials are used.
*
+ * @param string|null $username
+ * @param string|null $password
+ * @return Connection
+ *
* @throws Auth\BindException
* @throws LdapRecordException
*/
- public function connect(?string $username = null, ?string $password = null): void
+ public function connect($username = null, $password = null)
{
$attempt = function () use ($username, $password) {
$this->dispatch(new Events\Connecting($this));
@@ -232,16 +266,19 @@ class Connection
$this->retryOnNextHost($e, $attempt);
}
+
+ return $this;
}
/**
* Reconnect to the LDAP server.
*
+ * @return void
+ *
* @throws Auth\BindException
* @throws ConnectionException
- * @throws LdapRecordException
*/
- public function reconnect(): void
+ public function reconnect()
{
$this->reinitialize();
@@ -250,8 +287,10 @@ class Connection
/**
* Reinitialize the connection.
+ *
+ * @return void
*/
- protected function reinitialize(): void
+ protected function reinitialize()
{
$this->disconnect();
@@ -260,24 +299,31 @@ class Connection
/**
* Clone the connection.
+ *
+ * @return static
*/
- public function replicate(): static
+ public function replicate()
{
return new static($this->configuration, new $this->ldap);
}
/**
* Disconnect from the LDAP server.
+ *
+ * @return void
*/
- public function disconnect(): void
+ public function disconnect()
{
$this->ldap->close();
}
/**
* Dispatch an event.
+ *
+ * @param object $event
+ * @return void
*/
- public function dispatch(object $event): void
+ public function dispatch($event)
{
if (isset($this->dispatcher)) {
$this->dispatcher->dispatch($event);
@@ -286,20 +332,25 @@ class Connection
/**
* Get the attempted hosts that failed connecting to.
+ *
+ * @return array
*/
- public function attempted(): array
+ public function attempted()
{
return $this->attempted;
}
/**
* Perform the operation on the LDAP connection.
+ *
+ * @param Closure $operation
+ * @return mixed
*/
- public function run(Closure $operation): mixed
+ public function run(Closure $operation)
{
try {
// Before running the operation, we will check if the current
- // connection is bound and connect if necessary. Otherwise,
+ // connection is bound and connect if necessary. Otherwise
// some LDAP operations will not be executed properly.
if (! $this->isConnected()) {
$this->connect();
@@ -317,8 +368,11 @@ class Connection
/**
* Perform the operation on an isolated LDAP connection.
+ *
+ * @param Closure $operation
+ * @return mixed
*/
- public function isolate(Closure $operation): mixed
+ public function isolate(Closure $operation)
{
$connection = $this->replicate();
@@ -331,8 +385,11 @@ class Connection
/**
* Attempt to get an exception for the cause of failure.
+ *
+ * @param LdapRecordException $e
+ * @return mixed
*/
- protected function getExceptionForCauseOfFailure(LdapRecordException $e): ?LdapRecordException
+ protected function getExceptionForCauseOfFailure(LdapRecordException $e)
{
switch (true) {
case $this->errorContainsMessage($e->getMessage(), 'Already exists'):
@@ -342,22 +399,29 @@ class Connection
case $this->errorContainsMessage($e->getMessage(), 'Constraint violation'):
return Exceptions\ConstraintViolationException::withDetailedError($e, $e->getDetailedError());
default:
- return null;
+ return;
}
}
/**
* Run the operation callback on the current LDAP connection.
+ *
+ * @param Closure $operation
+ * @return mixed
+ *
+ * @throws LdapRecordException
*/
- protected function runOperationCallback(Closure $operation): mixed
+ protected function runOperationCallback(Closure $operation)
{
return $operation($this->ldap);
}
/**
* Get a new auth guard instance.
+ *
+ * @return Auth\Guard
*/
- public function auth(): Guard
+ public function auth()
{
if (! $this->ldap->isConnected()) {
$this->initialize();
@@ -366,7 +430,7 @@ class Connection
$guard = call_user_func($this->authGuardResolver);
$guard->setDispatcher(
- Container::getInstance()->getDispatcher()
+ Container::getInstance()->getEventDispatcher()
);
return $guard;
@@ -374,8 +438,10 @@ class Connection
/**
* Get a new query builder for the connection.
+ *
+ * @return Query\Builder
*/
- public function query(): Builder
+ public function query()
{
return (new Builder($this))
->setCache($this->cache)
@@ -384,8 +450,10 @@ class Connection
/**
* Determine if the LDAP connection is bound.
+ *
+ * @return bool
*/
- public function isConnected(): bool
+ public function isConnected()
{
return $this->ldap->isBound();
}
@@ -393,9 +461,13 @@ class Connection
/**
* Attempt to retry an LDAP operation if due to a lost connection.
*
+ * @param LdapRecordException $e
+ * @param Closure $operation
+ * @return mixed
+ *
* @throws LdapRecordException
*/
- protected function tryAgainIfCausedByLostConnection(LdapRecordException $e, Closure $operation): mixed
+ protected function tryAgainIfCausedByLostConnection(LdapRecordException $e, Closure $operation)
{
// If the operation failed due to a lost or failed connection,
// we'll attempt reconnecting and running the operation again
@@ -410,9 +482,12 @@ class Connection
/**
* Retry the operation on the current host.
*
+ * @param Closure $operation
+ * @return mixed
+ *
* @throws LdapRecordException
*/
- protected function retry(Closure $operation): mixed
+ protected function retry(Closure $operation)
{
try {
$this->retryingInitialConnection
@@ -428,9 +503,13 @@ class Connection
/**
* Attempt the operation again on the next host.
*
+ * @param LdapRecordException $e
+ * @param Closure $operation
+ * @return mixed
+ *
* @throws LdapRecordException
*/
- protected function retryOnNextHost(LdapRecordException $e, Closure $operation): mixed
+ protected function retryOnNextHost(LdapRecordException $e, Closure $operation)
{
$this->attempted[$this->host] = Carbon::now();
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/ConnectionManager.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/ConnectionManager.php
index 8bef8d150..0597f1f68 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/ConnectionManager.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/ConnectionManager.php
@@ -2,6 +2,7 @@
namespace LdapRecord;
+use BadMethodCallException;
use LdapRecord\Events\Dispatcher;
use LdapRecord\Events\DispatcherInterface;
use LdapRecord\Events\Logger;
@@ -9,83 +10,148 @@ use Psr\Log\LoggerInterface;
class ConnectionManager
{
+ /**
+ * The logger instance.
+ *
+ * @var LoggerInterface|null
+ */
+ protected $logger;
+
+ /**
+ * The event dispatcher instance.
+ *
+ * @var DispatcherInterface|null
+ */
+ protected $dispatcher;
+
/**
* The added LDAP connections.
*
* @var Connection[]
*/
- protected array $connections = [];
+ protected $connections = [];
/**
* The name of the default connection.
+ *
+ * @var string
*/
- protected string $default = 'default';
+ protected $default = 'default';
/**
* The events to register listeners for during initialization.
+ *
+ * @var array
*/
- protected array $listen = [
+ protected $listen = [
'LdapRecord\Auth\Events\*',
'LdapRecord\Query\Events\*',
'LdapRecord\Models\Events\*',
];
/**
- * The logger instance.
+ * The method calls to proxy for compatibility.
+ *
+ * To be removed in the next major version.
+ *
+ * @var array
*/
- protected ?LoggerInterface $logger = null;
-
- /**
- * The event dispatcher instance.
- */
- protected ?DispatcherInterface $dispatcher = null;
+ protected $proxy = [
+ 'reset' => 'flush',
+ 'addConnection' => 'add',
+ 'getConnection' => 'get',
+ 'allConnections' => 'all',
+ 'removeConnection' => 'remove',
+ 'getDefaultConnection' => 'getDefault',
+ 'setDefaultConnection' => 'setDefault',
+ 'getEventDispatcher' => 'dispatcher',
+ 'setEventDispatcher' => 'setDispatcher',
+ ];
/**
* Constructor.
+ *
+ * @return void
*/
- public function __construct($dispatcher = new Dispatcher)
+ public function __construct()
{
- $this->dispatcher = $dispatcher;
+ $this->dispatcher = new Dispatcher();
+ }
+
+ /**
+ * Forward missing method calls onto the instance.
+ *
+ * @param string $method
+ * @param mixed $args
+ * @return mixed
+ */
+ public function __call($method, $args)
+ {
+ $method = $this->proxy[$method] ?? $method;
+
+ if (! method_exists($this, $method)) {
+ throw new BadMethodCallException(sprintf(
+ 'Call to undefined method %s::%s()',
+ static::class,
+ $method
+ ));
+ }
+
+ return $this->{$method}(...$args);
}
/**
* Add a new connection.
+ *
+ * @param Connection $connection
+ * @param string|null $name
+ * @return $this
*/
- public function addConnection(Connection $connection, ?string $name = null): void
+ public function add(Connection $connection, $name = null)
{
$this->connections[$name ?? $this->default] = $connection;
if ($this->dispatcher) {
$connection->setDispatcher($this->dispatcher);
}
+
+ return $this;
}
/**
- * Remove a connection by its name.
+ * Remove a connection.
+ *
+ * @param $name
+ * @return $this
*/
- public function removeConnection(string $name): void
+ public function remove($name)
{
unset($this->connections[$name]);
+
+ return $this;
}
/**
- * Get all the registered connections.
+ * Get all of the connections.
*
* @return Connection[]
*/
- public function getConnections(): array
+ public function all()
{
return $this->connections;
}
/**
- * Get a connection by its name or return the default.
+ * Get a connection by name or return the default.
+ *
+ * @param string|null $name
+ * @return Connection
*
* @throws ContainerException If the given connection does not exist.
*/
- public function getConnection(?string $name = null): Connection
+ public function get($name = null)
{
- if ($this->hasConnection($name = $name ?? $this->default)) {
+ if ($this->exists($name = $name ?? $this->default)) {
return $this->connections[$name];
}
@@ -93,61 +159,82 @@ class ConnectionManager
}
/**
- * Get the default connection.
+ * Return the default connection.
+ *
+ * @return Connection
*/
- public function getDefaultConnection(): Connection
+ public function getDefault()
{
- return $this->getConnection($this->default);
- }
-
- /**
- * Set the default connection by its name.
- */
- public function setDefaultConnection(string $name): void
- {
- $this->default = $name;
+ return $this->get($this->default);
}
/**
* Get the default connection name.
+ *
+ * @return string
*/
- public function getDefaultConnectionName(): string
+ public function getDefaultConnectionName()
{
return $this->default;
}
/**
- * Determine if a connection exists.
+ * Checks if the connection exists.
+ *
+ * @param string $name
+ * @return bool
*/
- public function hasConnection(string $name): bool
+ public function exists($name)
{
return array_key_exists($name, $this->connections);
}
/**
- * Flush the manager of all instances and connections.
+ * Set the default connection name.
+ *
+ * @param string $name
+ * @return $this
*/
- public function flush(): void
+ public function setDefault($name = null)
+ {
+ $this->default = $name;
+
+ return $this;
+ }
+
+ /**
+ * Flush the manager of all instances and connections.
+ *
+ * @return $this
+ */
+ public function flush()
{
$this->logger = null;
$this->connections = [];
- $this->dispatcher->forgetAll();
+ $this->dispatcher = new Dispatcher();
+
+ return $this;
}
/**
* Get the logger instance.
+ *
+ * @return LoggerInterface|null
*/
- public function getLogger(): ?LoggerInterface
+ public function getLogger()
{
return $this->logger;
}
/**
* Set the event logger to use.
+ *
+ * @param LoggerInterface $logger
+ * @return void
*/
- public function setLogger(LoggerInterface $logger): void
+ public function setLogger(LoggerInterface $logger)
{
$this->logger = $logger;
@@ -156,8 +243,10 @@ class ConnectionManager
/**
* Initialize the event logger.
+ *
+ * @return void
*/
- protected function initEventLogger(): void
+ public function initEventLogger()
{
$logger = $this->newEventLogger();
@@ -172,40 +261,51 @@ class ConnectionManager
/**
* Make a new event logger instance.
+ *
+ * @return Logger
*/
- protected function newEventLogger(): Logger
+ protected function newEventLogger()
{
return new Logger($this->logger);
}
/**
* Unset the logger instance.
+ *
+ * @return void
*/
- public function unsetLogger(): void
+ public function unsetLogger()
{
$this->logger = null;
}
/**
* Get the event dispatcher.
+ *
+ * @return DispatcherInterface|null
*/
- public function getDispatcher(): ?DispatcherInterface
+ public function dispatcher()
{
return $this->dispatcher;
}
/**
* Set the event dispatcher.
+ *
+ * @param DispatcherInterface $dispatcher
+ * @return void
*/
- public function setDispatcher(DispatcherInterface $dispatcher): void
+ public function setDispatcher(DispatcherInterface $dispatcher)
{
$this->dispatcher = $dispatcher;
}
/**
* Unset the event dispatcher.
+ *
+ * @return void
*/
- public function unsetDispatcher(): void
+ public function unsetEventDispatcher()
{
$this->dispatcher = null;
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Container.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Container.php
index 5a3bd7f4c..0c125593d 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Container.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Container.php
@@ -2,79 +2,122 @@
namespace LdapRecord;
-/** @mixin ConnectionManager */
+/**
+ * @method static $this reset()
+ * @method static Connection[] all()
+ * @method static Connection[] allConnections()
+ * @method static Connection getDefaultConnection()
+ * @method static Connection get(string|null $name = null)
+ * @method static Connection getConnection(string|null $name = null)
+ * @method static bool exists(string $name)
+ * @method static $this remove(string|null $name = null)
+ * @method static $this removeConnection(string|null $name = null)
+ * @method static $this setDefault(string|null $name = null)
+ * @method static $this setDefaultConnection(string|null $name = null)
+ * @method static $this add(Connection $connection, string|null $name = null)
+ * @method static $this addConnection(Connection $connection, string|null $name = null)
+ */
class Container
{
/**
* The current container instance.
+ *
+ * @var Container
*/
- protected static Container $instance;
+ protected static $instance;
/**
* The connection manager instance.
+ *
+ * @var ConnectionManager
*/
- protected ConnectionManager $manager;
+ protected $manager;
+
+ /**
+ * The methods to passthru, for compatibility.
+ *
+ * @var array
+ */
+ protected $passthru = [
+ 'reset', 'flush',
+ 'add', 'addConnection',
+ 'remove', 'removeConnection',
+ 'setDefault', 'setDefaultConnection',
+ ];
+
+ /**
+ * Forward missing static calls onto the current instance.
+ *
+ * @param string $method
+ * @param mixed $args
+ * @return mixed
+ */
+ public static function __callStatic($method, $args)
+ {
+ return static::getInstance()->{$method}(...$args);
+ }
/**
* Get or set the current instance of the container.
+ *
+ * @return Container
*/
- public static function getInstance(): static
+ public static function getInstance()
{
return static::$instance ?? static::getNewInstance();
}
/**
* Set the container instance.
+ *
+ * @param Container|null $container
+ * @return Container|null
*/
- public static function setInstance(?self $container = null): ?static
+ public static function setInstance(self $container = null)
{
return static::$instance = $container;
}
/**
* Set and get a new instance of the container.
+ *
+ * @return Container
*/
- public static function getNewInstance(): static
+ public static function getNewInstance()
{
- return static::setInstance(new static);
- }
-
- /**
- * Forward missing static calls onto the current instance.
- */
- public static function __callStatic(string $method, array $parameters): mixed
- {
- return static::getInstance()->{$method}(...$parameters);
+ return static::setInstance(new static());
}
/**
* Constructor.
+ *
+ * @return void
*/
- public function __construct(ConnectionManager $manager = new ConnectionManager)
+ public function __construct()
{
- $this->manager = $manager;
+ $this->manager = new ConnectionManager();
}
/**
* Forward missing method calls onto the connection manager.
+ *
+ * @param string $method
+ * @param mixed $args
+ * @return mixed
*/
- public function __call(string $method, array $parameters): mixed
+ public function __call($method, $args)
{
- return $this->manager->{$method}(...$parameters);
- }
+ $value = $this->manager->{$method}(...$args);
- /**
- * Set the current container instance available globally.
- */
- public function setAsGlobal(): void
- {
- static::setInstance($this);
+ return in_array($method, $this->passthru) ? $this : $value;
}
/**
* Get the connection manager.
+ *
+ * @return ConnectionManager
*/
- public function getConnectionManager(): ConnectionManager
+ public function manager()
{
return $this->manager;
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/DetailedError.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/DetailedError.php
index e9d9609dc..fff528c98 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/DetailedError.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/DetailedError.php
@@ -5,34 +5,66 @@ namespace LdapRecord;
class DetailedError
{
/**
- * Constructor.
+ * The error code from ldap_errno.
+ *
+ * @var int|null
*/
- public function __construct(
- protected int $errorCode,
- protected string $errorMessage,
- protected ?string $diagnosticMessage
- ) {}
+ protected $errorCode;
/**
- * Get the LDAP error code.
+ * The error message from ldap_error.
+ *
+ * @var string|null
*/
- public function getErrorCode(): int
+ protected $errorMessage;
+
+ /**
+ * The diagnostic message when retrieved after an ldap_error.
+ *
+ * @var string|null
+ */
+ protected $diagnosticMessage;
+
+ /**
+ * Constructor.
+ *
+ * @param int $errorCode
+ * @param string $errorMessage
+ * @param string $diagnosticMessage
+ */
+ public function __construct($errorCode, $errorMessage, $diagnosticMessage)
+ {
+ $this->errorCode = $errorCode;
+ $this->errorMessage = $errorMessage;
+ $this->diagnosticMessage = $diagnosticMessage;
+ }
+
+ /**
+ * Returns the LDAP error code.
+ *
+ * @return int
+ */
+ public function getErrorCode()
{
return $this->errorCode;
}
/**
- * Get the LDAP error message.
+ * Returns the LDAP error message.
+ *
+ * @return string
*/
- public function getErrorMessage(): string
+ public function getErrorMessage()
{
return $this->errorMessage;
}
/**
- * Get the LDAP diagnostic message.
+ * Returns the LDAP diagnostic message.
+ *
+ * @return string
*/
- public function getDiagnosticMessage(): ?string
+ public function getDiagnosticMessage()
{
return $this->diagnosticMessage;
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/DetectsErrors.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/DetectsErrors.php
index bb6f675f0..61fc4a02e 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/DetectsErrors.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/DetectsErrors.php
@@ -6,43 +6,59 @@ trait DetectsErrors
{
/**
* Determine if the error was caused by a lost connection.
+ *
+ * @param string $error
+ * @return bool
*/
- protected function causedByLostConnection(string $error): bool
+ protected function causedByLostConnection($error)
{
return $this->errorContainsMessage($error, ["Can't contact LDAP server", 'Operations error']);
}
/**
* Determine if the error was caused by lack of pagination support.
+ *
+ * @param string $error
+ * @return bool
*/
- protected function causedByPaginationSupport(string $error): bool
+ protected function causedByPaginationSupport($error)
{
return $this->errorContainsMessage($error, 'No server controls in result');
}
/**
* Determine if the error was caused by a size limit warning.
+ *
+ * @param $error
+ * @return bool
*/
- protected function causedBySizeLimit(string $error): bool
+ protected function causedBySizeLimit($error)
{
return $this->errorContainsMessage($error, ['Partial search results returned', 'Size limit exceeded']);
}
/**
* Determine if the error was caused by a "No such object" warning.
+ *
+ * @param string $error
+ * @return bool
*/
- protected function causedByNoSuchObject(string $error): bool
+ protected function causedByNoSuchObject($error)
{
return $this->errorContainsMessage($error, ['No such object']);
}
/**
- * Determine if the error contains any of the messages.
+ * Determine if the error contains the any of the messages.
+ *
+ * @param string $error
+ * @param string|array $messages
+ * @return bool
*/
- protected function errorContainsMessage(string $error, string|array $messages = []): bool
+ protected function errorContainsMessage($error, $messages = [])
{
foreach ((array) $messages as $message) {
- if (str_contains($error, $message)) {
+ if (str_contains((string) $error, $message)) {
return true;
}
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/EscapesValues.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/EscapesValues.php
index 088b50013..ea53a2f93 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/EscapesValues.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/EscapesValues.php
@@ -8,8 +8,13 @@ trait EscapesValues
{
/**
* Prepare a value to be escaped.
+ *
+ * @param string $value
+ * @param string $ignore
+ * @param int $flags
+ * @return EscapedValue
*/
- public function escape(mixed $value = null, string $ignore = '', int $flags = 0): EscapedValue
+ public function escape($value, $ignore = '', $flags = 0)
{
return new EscapedValue($value, $ignore, $flags);
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Events/ConnectionEvent.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Events/ConnectionEvent.php
index 99a6e6f1c..d2d77e2fc 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Events/ConnectionEvent.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Events/ConnectionEvent.php
@@ -8,11 +8,15 @@ abstract class ConnectionEvent
{
/**
* The LDAP connection.
+ *
+ * @var Connection
*/
- protected Connection $connection;
+ protected $connection;
/**
* Constructor.
+ *
+ * @param Connection $connection
*/
public function __construct(Connection $connection)
{
@@ -21,8 +25,10 @@ abstract class ConnectionEvent
/**
* Get the connection pertaining to the event.
+ *
+ * @return Connection
*/
- public function getConnection(): Connection
+ public function getConnection()
{
return $this->connection;
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Events/Dispatcher.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Events/Dispatcher.php
index 304e15ccd..4fedbc2ef 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Events/Dispatcher.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Events/Dispatcher.php
@@ -2,9 +2,7 @@
namespace LdapRecord\Events;
-use Closure;
use LdapRecord\Support\Arr;
-use LdapRecord\Support\Str;
/**
* Class Dispatcher.
@@ -23,23 +21,29 @@ class Dispatcher implements DispatcherInterface
{
/**
* The registered event listeners.
+ *
+ * @var array
*/
- protected array $listeners = [];
+ protected $listeners = [];
/**
* The wildcard listeners.
+ *
+ * @var array
*/
- protected array $wildcards = [];
+ protected $wildcards = [];
/**
* The cached wildcard listeners.
+ *
+ * @var array
*/
- protected array $wildcardsCache = [];
+ protected $wildcardsCache = [];
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function listen(string|array $events, mixed $listener): void
+ public function listen($events, $listener)
{
foreach ((array) $events as $event) {
if (str_contains((string) $event, '*')) {
@@ -52,8 +56,12 @@ class Dispatcher implements DispatcherInterface
/**
* Setup a wildcard listener callback.
+ *
+ * @param string $event
+ * @param mixed $listener
+ * @return void
*/
- protected function setupWildcardListen(string $event, mixed $listener): void
+ protected function setupWildcardListen($event, $listener)
{
$this->wildcards[$event][] = $this->makeListener($listener, true);
@@ -61,33 +69,33 @@ class Dispatcher implements DispatcherInterface
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function hasListeners(string $event): bool
+ public function hasListeners($eventName)
{
- return isset($this->listeners[$event]) || isset($this->wildcards[$event]);
+ return isset($this->listeners[$eventName]) || isset($this->wildcards[$eventName]);
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function until(string|object $event, mixed $payload = []): mixed
+ public function until($event, $payload = [])
{
return $this->dispatch($event, $payload, true);
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function fire(string|object $event, mixed $payload = [], bool $halt = false): void
+ public function fire($event, $payload = [], $halt = false)
{
- $this->dispatch($event, $payload, $halt);
+ return $this->dispatch($event, $payload, $halt);
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function dispatch(string|object $event, mixed $payload = [], $halt = false): mixed
+ public function dispatch($event, $payload = [], $halt = false)
{
// When the given "event" is actually an object we will assume it is an event
// object and use the class as the event name and this event itself as the
@@ -124,8 +132,12 @@ class Dispatcher implements DispatcherInterface
/**
* Parse the given event and payload and prepare them for dispatching.
+ *
+ * @param mixed $event
+ * @param mixed $payload
+ * @return array
*/
- protected function parseEventAndPayload(string|object $event, mixed $payload): array
+ protected function parseEventAndPayload($event, $payload)
{
if (is_object($event)) {
[$payload, $event] = [[$event], get_class($event)];
@@ -135,42 +147,89 @@ class Dispatcher implements DispatcherInterface
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function getListeners(string $event): array
+ public function getListeners($eventName)
{
- $listeners = $this->listeners[$event] ?? [];
+ $listeners = $this->listeners[$eventName] ?? [];
$listeners = array_merge(
$listeners,
- $this->wildcardsCache[$event] ?? $this->getWildcardListeners($event)
+ $this->wildcardsCache[$eventName] ?? $this->getWildcardListeners($eventName)
);
- return class_exists($event, false)
- ? $this->addInterfaceListeners($event, $listeners)
+ return class_exists($eventName, false)
+ ? $this->addInterfaceListeners($eventName, $listeners)
: $listeners;
}
/**
* Get the wildcard listeners for the event.
+ *
+ * @param string $eventName
+ * @return array
*/
- protected function getWildcardListeners(string $event): array
+ protected function getWildcardListeners($eventName)
{
$wildcards = [];
foreach ($this->wildcards as $key => $listeners) {
- if (Str::is($key, $event)) {
+ if ($this->wildcardContainsEvent($key, $eventName)) {
$wildcards = array_merge($wildcards, $listeners);
}
}
- return $this->wildcardsCache[$event] = $wildcards;
+ return $this->wildcardsCache[$eventName] = $wildcards;
+ }
+
+ /**
+ * Determine if the wildcard matches or contains the given event.
+ *
+ * This function is a direct excerpt from Laravel's Str::is().
+ *
+ * @param string $wildcard
+ * @param string $eventName
+ * @return bool
+ */
+ protected function wildcardContainsEvent($wildcard, $eventName)
+ {
+ $patterns = Arr::wrap($wildcard);
+
+ if (empty($patterns)) {
+ return false;
+ }
+
+ foreach ($patterns as $pattern) {
+ // If the given event is an exact match we can of course return true right
+ // from the beginning. Otherwise, we will translate asterisks and do an
+ // actual pattern match against the two strings to see if they match.
+ if ($pattern == $eventName) {
+ return true;
+ }
+
+ $pattern = preg_quote($pattern, '#');
+
+ // Asterisks are translated into zero-or-more regular expression wildcards
+ // to make it convenient to check if the strings starts with the given
+ // pattern such as "library/*", making any string check convenient.
+ $pattern = str_replace('\*', '.*', $pattern);
+
+ if (preg_match('#^'.$pattern.'\z#u', $eventName) === 1) {
+ return true;
+ }
+ }
+
+ return false;
}
/**
* Add the listeners for the event's interfaces to the given array.
+ *
+ * @param string $eventName
+ * @param array $listeners
+ * @return array
*/
- protected function addInterfaceListeners(string $eventName, array $listeners = []): array
+ protected function addInterfaceListeners($eventName, array $listeners = [])
{
foreach (class_implements($eventName) as $interface) {
if (isset($this->listeners[$interface])) {
@@ -185,8 +244,12 @@ class Dispatcher implements DispatcherInterface
/**
* Register an event listener with the dispatcher.
+ *
+ * @param \Closure|string $listener
+ * @param bool $wildcard
+ * @return \Closure
*/
- public function makeListener(Closure|string $listener, bool $wildcard = false): Closure
+ public function makeListener($listener, $wildcard = false)
{
if (is_string($listener)) {
return $this->createClassListener($listener, $wildcard);
@@ -203,8 +266,12 @@ class Dispatcher implements DispatcherInterface
/**
* Create a class based listener.
+ *
+ * @param string $listener
+ * @param bool $wildcard
+ * @return \Closure
*/
- protected function createClassListener(string $listener, bool $wildcard = false): Closure
+ protected function createClassListener($listener, $wildcard = false)
{
return function ($event, $payload) use ($listener, $wildcard) {
if ($wildcard) {
@@ -220,53 +287,39 @@ class Dispatcher implements DispatcherInterface
/**
* Create the class based event callable.
+ *
+ * @param string $listener
+ * @return callable
*/
- protected function createClassCallable(string $listener): callable
+ protected function createClassCallable($listener)
{
[$class, $method] = $this->parseListenerCallback($listener);
- return [new $class, $method];
+ return [new $class(), $method];
}
/**
* Parse the class listener into class and method.
+ *
+ * @param string $listener
+ * @return array
*/
- protected function parseListenerCallback(string $listener): array
+ protected function parseListenerCallback($listener)
{
- return str_contains($listener, '@')
+ return str_contains((string) $listener, '@')
? explode('@', $listener, 2)
: [$listener, 'handle'];
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function forget(string $event): void
+ public function forget($event)
{
- if (str_contains($event, '*')) {
+ if (str_contains((string) $event, '*')) {
unset($this->wildcards[$event]);
} else {
unset($this->listeners[$event]);
}
-
- foreach ($this->wildcardsCache as $key => $listeners) {
- if (Str::is($event, $key)) {
- unset($this->wildcardsCache[$key]);
- }
- }
- }
-
- /**
- * Remove all the listeners from the dispatcher.
- */
- public function forgetAll(): void
- {
- $listeners = array_merge(
- $this->listeners, $this->wildcards
- );
-
- foreach (array_keys($listeners) as $listener) {
- $this->forget($listener);
- }
}
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Events/DispatcherInterface.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Events/DispatcherInterface.php
index 71de892c0..590328f09 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Events/DispatcherInterface.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Events/DispatcherInterface.php
@@ -6,41 +6,63 @@ interface DispatcherInterface
{
/**
* Register an event listener with the dispatcher.
+ *
+ * @param string|array $events
+ * @param mixed $listener
+ * @return void
*/
- public function listen(string|array $events, mixed $listener): void;
+ public function listen($events, $listener);
/**
* Determine if a given event has listeners.
+ *
+ * @param string $eventName
+ * @return bool
*/
- public function hasListeners(string $event): bool;
+ public function hasListeners($eventName);
/**
* Fire an event until the first non-null response is returned.
+ *
+ * @param string|object $event
+ * @param mixed $payload
+ * @return array|null
*/
- public function until(string|object $event, mixed $payload = []): mixed;
+ public function until($event, $payload = []);
/**
* Fire an event and call the listeners.
+ *
+ * @param string|object $event
+ * @param mixed $payload
+ * @param bool $halt
+ * @return mixed
*/
- public function fire(string|object $event, mixed $payload = [], bool $halt = false): void;
+ public function fire($event, $payload = [], $halt = false);
/**
* Fire an event and call the listeners.
+ *
+ * @param string|object $event
+ * @param mixed $payload
+ * @param bool $halt
+ * @return array|null
*/
- public function dispatch(string|object $event, mixed $payload = [], $halt = false): mixed;
+ public function dispatch($event, $payload = [], $halt = false);
/**
- * Get all the listeners for a given event name.
+ * Get all of the listeners for a given event name.
+ *
+ * @param string $eventName
+ * @return array
*/
- public function getListeners(string $event): array;
+ public function getListeners($eventName);
/**
* Remove a set of listeners from the dispatcher.
+ *
+ * @param string $event
+ * @return void
*/
- public function forget(string $event): void;
-
- /**
- * Remove all the listeners from the dispatcher.
- */
- public function forgetAll(): void;
+ public function forget($event);
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Events/Logger.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Events/Logger.php
index 5ac66f278..b8a849169 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Events/Logger.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Events/Logger.php
@@ -13,21 +13,28 @@ class Logger
{
/**
* The logger instance.
+ *
+ * @var LoggerInterface|null
*/
- protected ?LoggerInterface $logger;
+ protected $logger;
/**
* Constructor.
+ *
+ * @param LoggerInterface|null $logger
*/
- public function __construct(?LoggerInterface $logger = null)
+ public function __construct(LoggerInterface $logger = null)
{
$this->logger = $logger;
}
/**
* Logs the given event.
+ *
+ * @param mixed $event
+ * @return void
*/
- public function log($event): void
+ public function log($event)
{
switch (true) {
case $event instanceof AuthEvent:
@@ -44,8 +51,11 @@ class Logger
/**
* Logs an authentication event.
+ *
+ * @param AuthEvent $event
+ * @return void
*/
- public function auth(AuthEvent $event): void
+ public function auth(AuthEvent $event)
{
if (isset($this->logger)) {
$connection = $event->getConnection();
@@ -68,8 +78,11 @@ class Logger
/**
* Logs a model event.
+ *
+ * @param ModelEvent $event
+ * @return void
*/
- public function model(ModelEvent $event): void
+ public function model(ModelEvent $event)
{
if (isset($this->logger)) {
$model = $event->getModel();
@@ -89,8 +102,11 @@ class Logger
/**
* Logs a query event.
+ *
+ * @param QueryEvent $event
+ * @return void
*/
- public function query(QueryEvent $event): void
+ public function query(QueryEvent $event)
{
if (isset($this->logger)) {
$query = $event->getQuery();
@@ -111,9 +127,12 @@ class Logger
}
/**
- * Get the operational name of the given event.
+ * Returns the operational name of the given event.
+ *
+ * @param mixed $event
+ * @return string
*/
- protected function getOperationName($event): string
+ protected function getOperationName($event)
{
return (new ReflectionClass($event))->getShortName();
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Events/NullDispatcher.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Events/NullDispatcher.php
index 31f95cb77..7683d1f80 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Events/NullDispatcher.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Events/NullDispatcher.php
@@ -6,11 +6,15 @@ class NullDispatcher implements DispatcherInterface
{
/**
* The underlying dispatcher instance.
+ *
+ * @var DispatcherInterface
*/
- protected DispatcherInterface $dispatcher;
+ protected $dispatcher;
/**
* Constructor.
+ *
+ * @param DispatcherInterface $dispatcher
*/
public function __construct(DispatcherInterface $dispatcher)
{
@@ -19,62 +23,84 @@ class NullDispatcher implements DispatcherInterface
/**
* Register an event listener with the dispatcher.
+ *
+ * @param string|array $events
+ * @param mixed $listener
+ * @return void
*/
- public function listen(string|array $events, mixed $listener): void
+ public function listen($events, $listener)
{
$this->dispatcher->listen($events, $listener);
}
/**
* Determine if a given event has listeners.
+ *
+ * @param string $eventName
+ * @return bool
*/
- public function hasListeners(string $event): bool
+ public function hasListeners($eventName)
{
- return $this->dispatcher->hasListeners($event);
+ return $this->dispatcher->hasListeners($eventName);
}
/**
* Fire an event until the first non-null response is returned.
+ *
+ * @param string|object $event
+ * @param mixed $payload
+ * @return null
*/
- public function until(string|object $event, mixed $payload = []): ?array
+ public function until($event, $payload = [])
{
return null;
}
/**
* Fire an event and call the listeners.
+ *
+ * @param string|object $event
+ * @param mixed $payload
+ * @param bool $halt
+ * @return null
*/
- public function fire(string|object $event, mixed $payload = [], bool $halt = false): void {}
-
- /**
- * Fire an event and call the listeners.
- */
- public function dispatch(string|object $event, mixed $payload = [], $halt = false): mixed
+ public function fire($event, $payload = [], $halt = false)
{
return null;
}
/**
- * Get all the listeners for a given event name.
+ * Fire an event and call the listeners.
+ *
+ * @param string|object $event
+ * @param mixed $payload
+ * @param bool $halt
+ * @return null
*/
- public function getListeners(string $event): array
+ public function dispatch($event, $payload = [], $halt = false)
{
- return $this->dispatcher->getListeners($event);
+ return null;
+ }
+
+ /**
+ * Get all of the listeners for a given event name.
+ *
+ * @param string $eventName
+ * @return array
+ */
+ public function getListeners($eventName)
+ {
+ return $this->dispatcher->getListeners($eventName);
}
/**
* Remove a set of listeners from the dispatcher.
+ *
+ * @param string $event
+ * @return void
*/
- public function forget(string $event): void
+ public function forget($event)
{
$this->dispatcher->forget($event);
}
-
- /**
- * Remove all the listeners from the dispatcher.
- */
- public function forgetAll(): void
- {
- $this->dispatcher->forgetAll();
- }
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Exceptions/ConstraintViolationException.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Exceptions/ConstraintViolationException.php
index b5d30a739..641843a9b 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Exceptions/ConstraintViolationException.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Exceptions/ConstraintViolationException.php
@@ -11,17 +11,25 @@ class ConstraintViolationException extends LdapRecordException
/**
* Determine if the exception was generated due to the password policy.
+ *
+ * @return bool
*/
- public function causedByPasswordPolicy(): bool
+ public function causedByPasswordPolicy()
{
- return isset($this->detailedError) && $this->errorContainsMessage($this->detailedError->getDiagnosticMessage(), '0000052D');
+ return isset($this->detailedError)
+ ? $this->errorContainsMessage($this->detailedError->getDiagnosticMessage(), '0000052D')
+ : false;
}
/**
* Determine if the exception was generated due to an incorrect password.
+ *
+ * @return bool
*/
- public function causedByIncorrectPassword(): bool
+ public function causedByIncorrectPassword()
{
- return isset($this->detailedError) && $this->errorContainsMessage($this->detailedError->getDiagnosticMessage(), '00000056');
+ return isset($this->detailedError)
+ ? $this->errorContainsMessage($this->detailedError->getDiagnosticMessage(), '00000056')
+ : false;
}
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/HandlesConnection.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/HandlesConnection.php
index e47904d8b..4a2e27598 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/HandlesConnection.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/HandlesConnection.php
@@ -5,100 +5,88 @@ namespace LdapRecord;
use Closure;
use ErrorException;
use Exception;
-use LDAP\Connection;
-/** @mixin Ldap */
trait HandlesConnection
{
/**
* The LDAP host that is currently connected.
+ *
+ * @var string|null
*/
- protected ?string $host = null;
-
- /**
- * The LDAP protocol to use (ldap:// or ldaps://).
- */
- protected ?string $protocol = null;
+ protected $host;
/**
* The LDAP connection resource.
*
- * @var Connection
+ * @var resource|null
*/
- protected mixed $connection = null;
+ protected $connection;
/**
- * Whether the connection is bound.
+ * The bound status of the connection.
+ *
+ * @var bool
*/
- protected bool $bound = false;
-
- /**
- * Whether the connection is secured over TLS or SSL.
- */
- protected bool $secure = false;
+ protected $bound = false;
/**
* Whether the connection must be bound over SSL.
+ *
+ * @var bool
*/
- protected bool $useSSL = false;
+ protected $useSSL = false;
/**
* Whether the connection must be bound over TLS.
+ *
+ * @var bool
*/
- protected bool $useTLS = false;
+ protected $useTLS = false;
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function isUsingSSL(): bool
+ public function isUsingSSL()
{
return $this->useSSL;
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function isUsingTLS(): bool
+ public function isUsingTLS()
{
return $this->useTLS;
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function isBound(): bool
+ public function isBound()
{
return $this->bound;
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function isSecure(): bool
- {
- return $this->secure;
- }
-
- /**
- * {@inheritdoc}
- */
- public function isConnected(): bool
+ public function isConnected()
{
return ! is_null($this->connection);
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function canChangePasswords(): bool
+ public function canChangePasswords()
{
return $this->isUsingSSL() || $this->isUsingTLS();
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function ssl(bool $enabled = true): static
+ public function ssl($enabled = true)
{
$this->useSSL = $enabled;
@@ -106,9 +94,9 @@ trait HandlesConnection
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function tls(bool $enabled = true): static
+ public function tls($enabled = true)
{
$this->useTLS = $enabled;
@@ -116,9 +104,9 @@ trait HandlesConnection
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function setOptions(array $options = []): void
+ public function setOptions(array $options = [])
{
foreach ($options as $option => $value) {
$this->setOption($option, $value);
@@ -126,57 +114,46 @@ trait HandlesConnection
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function getHost(): ?string
+ public function getHost()
{
return $this->host;
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function getConnection(): ?Connection
+ public function getConnection()
{
return $this->connection;
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function getProtocol(): string
+ public function getProtocol()
{
- return $this->protocol ?: (
- $this->isUsingSSL()
- ? LdapInterface::PROTOCOL_SSL
- : LdapInterface::PROTOCOL
- );
+ return $this->isUsingSSL() ? LdapInterface::PROTOCOL_SSL : LdapInterface::PROTOCOL;
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function getExtendedError(): ?string
+ public function getExtendedError()
{
return $this->getDiagnosticMessage();
}
- /**
- * Handle the bind response.
- */
- protected function handleBindResponse(LdapResultResponse $response): void
- {
- $this->bound = $response->successful();
-
- $this->secure = $this->secure ?: $this->bound && $this->isUsingSSL();
- }
-
/**
* Convert warnings to exceptions for the given operation.
*
+ * @param Closure $operation
+ * @return mixed
+ *
* @throws LdapRecordException
*/
- protected function executeFailableOperation(Closure $operation): mixed
+ protected function executeFailableOperation(Closure $operation)
{
// If some older versions of PHP, errors are reported instead of throwing
// exceptions, which could be a significant detriment to our application.
@@ -195,8 +172,8 @@ trait HandlesConnection
}
// If the failed query operation was a based on a query being executed
- // -- such as a search, read, or list, then we can safely return
- // the failed response here and prevent throwing an exception.
+ // -- such as a search, read, or listing, then we can safely return
+ // the failed response here and prevent throwning an exception.
if ($this->shouldBypassFailure($method = debug_backtrace()[1]['function'])) {
return $result;
}
@@ -211,24 +188,46 @@ trait HandlesConnection
/**
* Determine if the failed operation should be bypassed.
+ *
+ * @param string $method
+ * @return bool
*/
- protected function shouldBypassFailure(string $method): bool
+ protected function shouldBypassFailure($method)
{
- return in_array($method, ['search', 'read', 'list']);
+ return in_array($method, ['search', 'read', 'listing']);
}
/**
* Determine if the error should be bypassed.
+ *
+ * @param string $error
+ * @return bool
*/
- protected function shouldBypassError(string $error): bool
+ protected function shouldBypassError($error)
{
return $this->causedByPaginationSupport($error) || $this->causedBySizeLimit($error) || $this->causedByNoSuchObject($error);
}
/**
- * Generates an LDAP connection string for each host given.
+ * Determine if the current PHP version supports server controls.
+ *
+ * @deprecated since v2.5.0
+ *
+ * @return bool
*/
- protected function makeConnectionUris(array|string $hosts, string|int $port): string
+ public function supportsServerControlsInMethods()
+ {
+ return version_compare(PHP_VERSION, '7.3.0') >= 0;
+ }
+
+ /**
+ * Generates an LDAP connection string for each host given.
+ *
+ * @param string|array $hosts
+ * @param string $port
+ * @return string
+ */
+ protected function makeConnectionUris($hosts, $port)
{
// If an attempt to connect via SSL protocol is being performed,
// and we are still using the default port, we will swap it
@@ -245,9 +244,15 @@ trait HandlesConnection
/**
* Assemble the host URI strings.
+ *
+ * @param array|string $hosts
+ * @param string $port
+ * @return array
*/
- protected function assembleHostUris(array|string $hosts, string|int $port): array
+ protected function assembleHostUris($hosts, $port)
{
- return array_map(fn ($host) => "{$this->getProtocol()}{$host}:{$port}", (array) $hosts);
+ return array_map(function ($host) use ($port) {
+ return "{$this->getProtocol()}{$host}:{$port}";
+ }, (array) $hosts);
}
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Ldap.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Ldap.php
index 7f2be60b6..76c372040 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Ldap.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Ldap.php
@@ -6,16 +6,15 @@ use LDAP\Connection as RawLdapConnection;
class Ldap implements LdapInterface
{
- use DetectsErrors;
- use HandlesConnection;
+ use HandlesConnection, DetectsErrors;
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function getEntries(mixed $result): array
+ public function getEntries($searchResults)
{
- return $this->executeFailableOperation(function () use ($result) {
- return ldap_get_entries($this->connection, $result);
+ return $this->executeFailableOperation(function () use ($searchResults) {
+ return ldap_get_entries($this->connection, $searchResults);
});
}
@@ -24,12 +23,13 @@ class Ldap implements LdapInterface
*
* @see http://php.net/manual/en/function.ldap-first-entry.php
*
- * @param \Ldap\Result $result
+ * @param resource $searchResults
+ * @return resource
*/
- public function getFirstEntry(mixed $result): mixed
+ public function getFirstEntry($searchResults)
{
- return $this->executeFailableOperation(function () use ($result) {
- return ldap_first_entry($this->connection, $result);
+ return $this->executeFailableOperation(function () use ($searchResults) {
+ return ldap_first_entry($this->connection, $searchResults);
});
}
@@ -38,9 +38,10 @@ class Ldap implements LdapInterface
*
* @see http://php.net/manual/en/function.ldap-next-entry.php
*
- * @param \Ldap\ResultEntry $entry
+ * @param resource $entry
+ * @return resource
*/
- public function getNextEntry(mixed $entry): mixed
+ public function getNextEntry($entry)
{
return $this->executeFailableOperation(function () use ($entry) {
return ldap_next_entry($this->connection, $entry);
@@ -52,9 +53,10 @@ class Ldap implements LdapInterface
*
* @see http://php.net/manual/en/function.ldap-get-attributes.php
*
- * @param \Ldap\ResultEntry $entry
+ * @param resource $entry
+ * @return array|false
*/
- public function getAttributes(mixed $entry): array|false
+ public function getAttributes($entry)
{
return $this->executeFailableOperation(function () use ($entry) {
return ldap_get_attributes($this->connection, $entry);
@@ -62,29 +64,41 @@ class Ldap implements LdapInterface
}
/**
- * {@inheritDoc}
+ * Returns the number of entries from a search result.
+ *
+ * @see http://php.net/manual/en/function.ldap-count-entries.php
+ *
+ * @param resource $searchResults
+ * @return int
*/
- public function countEntries(mixed $result): int
+ public function countEntries($searchResults)
{
- return $this->executeFailableOperation(function () use ($result) {
- return ldap_count_entries($this->connection, $result);
+ return $this->executeFailableOperation(function () use ($searchResults) {
+ return ldap_count_entries($this->connection, $searchResults);
});
}
/**
- * {@inheritDoc}
+ * Compare value of attribute found in entry specified with DN.
+ *
+ * @see http://php.net/manual/en/function.ldap-compare.php
+ *
+ * @param string $dn
+ * @param string $attribute
+ * @param string $value
+ * @return mixed
*/
- public function compare(string $dn, string $attribute, string $value, ?array $controls = null): bool|int
+ public function compare($dn, $attribute, $value)
{
- return $this->executeFailableOperation(function () use ($dn, $attribute, $value, $controls) {
- return ldap_compare($this->connection, $dn, $attribute, $value, $controls);
+ return $this->executeFailableOperation(function () use ($dn, $attribute, $value) {
+ return ldap_compare($this->connection, $dn, $attribute, $value);
});
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function getLastError(): ?string
+ public function getLastError()
{
if (! $this->connection) {
return null;
@@ -94,9 +108,9 @@ class Ldap implements LdapInterface
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function getDetailedError(): ?DetailedError
+ public function getDetailedError()
{
if (! $number = $this->errNo()) {
return null;
@@ -108,9 +122,15 @@ class Ldap implements LdapInterface
}
/**
- * {@inheritDoc}
+ * Get all binary values from the specified result entry.
+ *
+ * @see http://php.net/manual/en/function.ldap-get-values-len.php
+ *
+ * @param $entry
+ * @param $attribute
+ * @return array
*/
- public function getValuesLen(mixed $entry, string $attribute): array|false
+ public function getValuesLen($entry, $attribute)
{
return $this->executeFailableOperation(function () use ($entry, $attribute) {
return ldap_get_values_len($this->connection, $entry, $attribute);
@@ -118,17 +138,17 @@ class Ldap implements LdapInterface
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function setOption(int $option, mixed $value): bool
+ public function setOption($option, $value)
{
return ldap_set_option($this->connection, $option, $value);
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function getOption(int $option, mixed &$value = null): mixed
+ public function getOption($option, &$value = null)
{
ldap_get_option($this->connection, $option, $value);
@@ -139,63 +159,59 @@ class Ldap implements LdapInterface
* Set a callback function to do re-binds on referral chasing.
*
* @see http://php.net/manual/en/function.ldap-set-rebind-proc.php
+ *
+ * @param callable $callback
+ * @return bool
*/
- public function setRebindCallback(callable $callback): bool
+ public function setRebindCallback(callable $callback)
{
return ldap_set_rebind_proc($this->connection, $callback);
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function startTLS(): bool
+ public function startTLS()
{
- return $this->secure = $this->executeFailableOperation(function () {
+ return $this->executeFailableOperation(function () {
return ldap_start_tls($this->connection);
});
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function connect(string|array $hosts = [], int $port = 389, ?string $protocol = null): bool
+ public function connect($hosts = [], $port = 389)
{
$this->bound = false;
- $this->protocol = $protocol;
+
$this->host = $this->makeConnectionUris($hosts, $port);
- $this->connection = $this->executeFailableOperation(function () {
+ return $this->connection = $this->executeFailableOperation(function () {
return ldap_connect($this->host);
});
-
- return $this->connection instanceof RawLdapConnection;
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function close(): bool
+ public function close()
{
- $result = false;
+ $result = (is_resource($this->connection) || $this->connection instanceof RawLdapConnection)
+ ? @ldap_close($this->connection)
+ : false;
- if ($this->connection instanceof RawLdapConnection) {
- $result = @ldap_close($this->connection);
- }
-
- $this->bound = false;
- $this->secure = false;
-
- $this->host = null;
- $this->protocol = null;
$this->connection = null;
+ $this->bound = false;
+ $this->host = null;
return $result;
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function search(string $dn, string $filter, array $fields, bool $onlyAttributes = false, int $size = 0, int $time = 0, int $deref = LDAP_DEREF_NEVER, ?array $controls = null): mixed
+ public function search($dn, $filter, array $fields, $onlyAttributes = false, $size = 0, $time = 0, $deref = LDAP_DEREF_NEVER, $serverControls = [])
{
return $this->executeFailableOperation(function () use (
$dn,
@@ -205,16 +221,18 @@ class Ldap implements LdapInterface
$size,
$time,
$deref,
- $controls
+ $serverControls
) {
- return ldap_search($this->connection, $dn, $filter, $fields, $onlyAttributes, $size, $time, $deref, $controls);
+ return empty($serverControls)
+ ? ldap_search($this->connection, $dn, $filter, $fields, $onlyAttributes, $size, $time, $deref)
+ : ldap_search($this->connection, $dn, $filter, $fields, $onlyAttributes, $size, $time, $deref, $serverControls);
});
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function list(string $dn, string $filter, array $fields, bool $onlyAttributes = false, int $size = 0, int $time = 0, int $deref = LDAP_DEREF_NEVER, ?array $controls = null): mixed
+ public function listing($dn, $filter, array $fields, $onlyAttributes = false, $size = 0, $time = 0, $deref = LDAP_DEREF_NEVER, $serverControls = [])
{
return $this->executeFailableOperation(function () use (
$dn,
@@ -224,16 +242,18 @@ class Ldap implements LdapInterface
$size,
$time,
$deref,
- $controls
+ $serverControls
) {
- return ldap_list($this->connection, $dn, $filter, $fields, $onlyAttributes, $size, $time, $deref, $controls);
+ return empty($serverControls)
+ ? ldap_list($this->connection, $dn, $filter, $fields, $onlyAttributes, $size, $time, $deref)
+ : ldap_list($this->connection, $dn, $filter, $fields, $onlyAttributes, $size, $time, $deref, $serverControls);
});
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function read(string $dn, string $filter, array $fields, bool $onlyAttributes = false, int $size = 0, int $time = 0, int $deref = LDAP_DEREF_NEVER, ?array $controls = null): mixed
+ public function read($dn, $filter, array $fields, $onlyAttributes = false, $size = 0, $time = 0, $deref = LDAP_DEREF_NEVER, $serverControls = [])
{
return $this->executeFailableOperation(function () use (
$dn,
@@ -243,78 +263,47 @@ class Ldap implements LdapInterface
$size,
$time,
$deref,
- $controls
+ $serverControls
) {
- return ldap_read($this->connection, $dn, $filter, $fields, $onlyAttributes, $size, $time, $deref, $controls);
+ return empty($serverControls)
+ ? ldap_read($this->connection, $dn, $filter, $fields, $onlyAttributes, $size, $time, $deref)
+ : ldap_read($this->connection, $dn, $filter, $fields, $onlyAttributes, $size, $time, $deref, $serverControls);
});
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function parseResult(mixed $result, int &$errorCode = 0, ?string &$dn = null, ?string &$errorMessage = null, ?array &$referrals = null, ?array &$controls = null): LdapResultResponse|false
+ public function parseResult($result, &$errorCode, &$dn, &$errorMessage, &$referrals, &$serverControls = [])
{
- if (ldap_parse_result($this->connection, $result, $errorCode, $dn, $errorMessage, $referrals, $controls)) {
- return new LdapResultResponse(
- $errorCode,
- $dn,
- $errorMessage,
- $referrals,
- $controls
- );
- }
-
- return false;
- }
-
- /**
- * {@inheritdoc}
- */
- public function bind(?string $dn = null, ?string $password = null, ?array $controls = null): LdapResultResponse
- {
- /** @var \LDAP\Result $result */
- $result = $this->executeFailableOperation(function () use ($dn, $password, $controls) {
- return ldap_bind_ext($this->connection, $dn, $password ? html_entity_decode($password) : null, $controls);
- });
-
- $response = $this->parseResult($result);
-
- $this->handleBindResponse($response);
-
- return $response;
- }
-
- /**
- * {@inheritDoc}
- */
- public function saslBind(?string $dn = null, ?string $password = null, array $options = []): bool
- {
- return $this->executeFailableOperation(function () use ($dn, $password, $options) {
- $options = array_merge([
- 'mech' => null,
- 'realm' => null,
- 'authc_id' => null,
- 'authz_id' => null,
- 'props' => null,
- ], $options);
-
- return $this->bound = ldap_sasl_bind(
- $this->connection,
- $dn,
- $password ? html_entity_decode($password) : null,
- $options['mech'],
- $options['realm'],
- $options['authc_id'],
- $options['authz_id'],
- $options['props'],
- );
+ return $this->executeFailableOperation(function () use (
+ $result,
+ &$errorCode,
+ &$dn,
+ &$errorMessage,
+ &$referrals,
+ &$serverControls
+ ) {
+ return empty($serverControls)
+ ? ldap_parse_result($this->connection, $result, $errorCode, $dn, $errorMessage, $referrals)
+ : ldap_parse_result($this->connection, $result, $errorCode, $dn, $errorMessage, $referrals, $serverControls);
});
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function add(string $dn, array $entry): bool
+ public function bind($username, $password)
+ {
+ return $this->bound = $this->executeFailableOperation(function () use ($username, $password) {
+ return ldap_bind($this->connection, $username, $password ? html_entity_decode($password) : null);
+ });
+ }
+
+ /**
+ * @inheritdoc
+ */
+ public function add($dn, array $entry)
{
return $this->executeFailableOperation(function () use ($dn, $entry) {
return ldap_add($this->connection, $dn, $entry);
@@ -322,9 +311,9 @@ class Ldap implements LdapInterface
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function delete(string $dn): bool
+ public function delete($dn)
{
return $this->executeFailableOperation(function () use ($dn) {
return ldap_delete($this->connection, $dn);
@@ -332,9 +321,9 @@ class Ldap implements LdapInterface
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function rename(string $dn, string $newRdn, string $newParent, bool $deleteOldRdn = false): bool
+ public function rename($dn, $newRdn, $newParent, $deleteOldRdn = false)
{
return $this->executeFailableOperation(function () use (
$dn,
@@ -347,9 +336,9 @@ class Ldap implements LdapInterface
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function modify(string $dn, array $entry): bool
+ public function modify($dn, array $entry)
{
return $this->executeFailableOperation(function () use ($dn, $entry) {
return ldap_modify($this->connection, $dn, $entry);
@@ -357,9 +346,9 @@ class Ldap implements LdapInterface
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function modifyBatch(string $dn, array $values): bool
+ public function modifyBatch($dn, array $values)
{
return $this->executeFailableOperation(function () use ($dn, $values) {
return ldap_modify_batch($this->connection, $dn, $values);
@@ -367,9 +356,9 @@ class Ldap implements LdapInterface
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function modAdd(string $dn, array $entry): bool
+ public function modAdd($dn, array $entry)
{
return $this->executeFailableOperation(function () use ($dn, $entry) {
return ldap_mod_add($this->connection, $dn, $entry);
@@ -377,9 +366,9 @@ class Ldap implements LdapInterface
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function modReplace(string $dn, array $entry): bool
+ public function modReplace($dn, array $entry)
{
return $this->executeFailableOperation(function () use ($dn, $entry) {
return ldap_mod_replace($this->connection, $dn, $entry);
@@ -387,9 +376,9 @@ class Ldap implements LdapInterface
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function modDelete(string $dn, array $entry): bool
+ public function modDelete($dn, array $entry)
{
return $this->executeFailableOperation(function () use ($dn, $entry) {
return ldap_mod_del($this->connection, $dn, $entry);
@@ -397,63 +386,88 @@ class Ldap implements LdapInterface
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function freeResult(mixed $result): bool
+ public function controlPagedResult($pageSize = 1000, $isCritical = false, $cookie = '')
+ {
+ return $this->executeFailableOperation(function () use ($pageSize, $isCritical, $cookie) {
+ return ldap_control_paged_result($this->connection, $pageSize, $isCritical, $cookie);
+ });
+ }
+
+ /**
+ * @inheritdoc
+ */
+ public function controlPagedResultResponse($result, &$cookie, &$estimated = null)
+ {
+ return $this->executeFailableOperation(function () use ($result, &$cookie, &$estimated) {
+ return ldap_control_paged_result_response($this->connection, $result, $cookie, $estimated);
+ });
+ }
+
+ /**
+ * @inheritdoc
+ */
+ public function freeResult($result)
{
return ldap_free_result($result);
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function errNo(): ?int
+ public function errNo()
{
return $this->connection ? ldap_errno($this->connection) : null;
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function err2Str(int $number): string
+ public function err2Str($number)
{
return ldap_err2str($number);
}
/**
- * Get the extended error hex code of the last command.
+ * Returns the extended error hex code of the last command.
+ *
+ * @return string|null
*/
- public function getExtendedErrorHex(): ?string
+ public function getExtendedErrorHex()
{
if (preg_match("/(?<=data\s).*?(?=,)/", $this->getExtendedError(), $code)) {
return $code[0];
}
-
- return null;
}
/**
- * Get the extended error code of the last command.
+ * Returns the extended error code of the last command.
+ *
+ * @return bool|string
*/
- public function getExtendedErrorCode(): string|false
+ public function getExtendedErrorCode()
{
return $this->extractDiagnosticCode($this->getExtendedError());
}
/**
* Extract the diagnostic code from the message.
+ *
+ * @param string $message
+ * @return string|bool
*/
- public function extractDiagnosticCode(string $message): string|false
+ public function extractDiagnosticCode($message)
{
preg_match('/^([\da-fA-F]+):/', $message, $matches);
- return $matches[1] ?? false;
+ return isset($matches[1]) ? $matches[1] : false;
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function getDiagnosticMessage(): ?string
+ public function getDiagnosticMessage()
{
$this->getOption(LDAP_OPT_ERROR_STRING, $message);
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/LdapInterface.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/LdapInterface.php
index 735f858ca..fcff57f48 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/LdapInterface.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/LdapInterface.php
@@ -2,22 +2,8 @@
namespace LdapRecord;
-use LDAP\Connection;
-
-/**
- * @see https://ldap.com/ldap-oid-reference-guide
- * @see http://msdn.microsoft.com/en-us/library/cc223359.aspx
- * @see https://help.univention.com/t/openldap-debug-level/19301
- */
interface LdapInterface
{
- /**
- * The standard LDAP protocol string.
- *
- * @var string
- */
- public const PROTOCOL = 'ldap://';
-
/**
* The SSL LDAP protocol string.
*
@@ -26,363 +12,143 @@ interface LdapInterface
public const PROTOCOL_SSL = 'ldaps://';
/**
- * The standard LDAP port number.
+ * The standard LDAP protocol string.
*
- * @var int
+ * @var string
*/
- public const PORT = 389;
+ public const PROTOCOL = 'ldap://';
/**
* The LDAP SSL port number.
*
- * @var int
+ * @var string
*/
public const PORT_SSL = 636;
/**
- * Print entry and exit from routines.
- *
- * @var int
- */
- public const DEBUG_TRACE = 1;
-
- /**
- * Print packet activity.
- *
- * @var int
- */
- public const DEBUG_PACKETS = 2;
-
- /**
- * Print data arguments from requests.
- *
- * @var int
- */
- public const DEBUG_ARGS = 4;
-
- /**
- * Print connection activity.
- *
- * @var int
- */
- public const DEBUG_CONNS = 8;
-
- /**
- * Print encoding and decoding of data.
- *
- * @var int
- */
- public const DEBUG_BER = 16;
-
- /**
- * Print search filters.
- *
- * @var int
- */
- public const DEBUG_FILTER = 32;
-
- /**
- * Print configuration file processing.
- *
- * @var int
- */
- public const DEBUG_CONFIG = 64;
-
- /**
- * Print Access Control List activities.
- *
- * @var int
- */
- public const DEBUG_ACL = 128;
-
- /**
- * Print operational statistics.
- *
- * @var int
- */
- public const DEBUG_STATS = 256;
-
- /**
- * Print more detailed statistics.
- *
- * @var int
- */
- public const DEBUG_STATS2 = 512;
-
- /**
- * Print communication with shell backends.
- *
- * @var int
- */
- public const DEBUG_SHELL = 1024;
-
- /**
- * Print entry parsing.
- *
- * @var int
- */
- public const DEBUG_PARSE = 2048;
-
- /**
- * Print LDAPSync replication.
- *
- * @var int
- */
- public const DEBUG_SYNC = 16384;
-
- /**
- * Print referral activities.
- *
- * @var int
- */
- public const DEBUG_REFERRAL = 32768;
-
- /**
- * Print error conditions.
- *
- * @var int
- */
- public const DEBUG_ERROR = 32768;
-
- /**
- * Print all levels of debug.
- *
- * @var int
- */
- public const DEBUG_ANY = 65535;
-
- /**
- * OID for StartTLS extended operation. Signals the server to initiate a TLS connection.
+ * The standard LDAP port number.
*
* @var string
*/
+ public const PORT = 389;
+
+ /**
+ * Various useful server control OID's.
+ *
+ * @see https://ldap.com/ldap-oid-reference-guide/
+ * @see http://msdn.microsoft.com/en-us/library/cc223359.aspx
+ */
public const OID_SERVER_START_TLS = '1.3.6.1.4.1.1466.20037';
-
- /**
- * OID for Paged Results Control. Used to retrieve search results in pages.
- *
- * @var string
- */
public const OID_SERVER_PAGED_RESULTS = '1.2.840.113556.1.4.319';
-
- /**
- * OID for Show Deleted Control. Includes deleted entries in the search results.
- *
- * @var string
- */
public const OID_SERVER_SHOW_DELETED = '1.2.840.113556.1.4.417';
-
- /**
- * OID for Server Side Sort Control. Requests the server to sort the search results.
- *
- * @var string
- */
public const OID_SERVER_SORT = '1.2.840.113556.1.4.473';
-
- /**
- * OID for Cross-Domain Move Target Control. Used in cross-domain move operations.
- *
- * @var string
- */
public const OID_SERVER_CROSSDOM_MOVE_TARGET = '1.2.840.113556.1.4.521';
-
- /**
- * OID for LDAP Notification Control. Used to register for change notifications.
- *
- * @var string
- */
public const OID_SERVER_NOTIFICATION = '1.2.840.113556.1.4.528';
-
- /**
- * OID for Extended DN Control. Requests extended DN information in search results.
- *
- * @var string
- */
public const OID_SERVER_EXTENDED_DN = '1.2.840.113556.1.4.529';
-
- /**
- * OID for Lazy Commit Control. Delays the actual commit of changes until requested.
- *
- * @var string
- */
public const OID_SERVER_LAZY_COMMIT = '1.2.840.113556.1.4.619';
-
- /**
- * OID for Security Descriptor Flags Control. Used to manipulate security descriptor flags.
- *
- * @var string
- */
public const OID_SERVER_SD_FLAGS = '1.2.840.113556.1.4.801';
-
- /**
- * OID for Tree Delete Control. Enables the deletion of an entire subtree.
- *
- * @var string
- */
public const OID_SERVER_TREE_DELETE = '1.2.840.113556.1.4.805';
-
- /**
- * OID for DirSync Control. Used for directory synchronization operations.
- *
- * @var string
- */
public const OID_SERVER_DIRSYNC = '1.2.840.113556.1.4.841';
-
- /**
- * OID for Verify Name Control. Allows verification of an entry without retrieving attributes.
- *
- * @var string
- */
public const OID_SERVER_VERIFY_NAME = '1.2.840.113556.1.4.1338';
-
- /**
- * OID for Domain Scope Control. Limits a search to the current domain.
- *
- * @var string
- */
public const OID_SERVER_DOMAIN_SCOPE = '1.2.840.113556.1.4.1339';
-
- /**
- * OID for Search Options Control. Used to set various search options.
- *
- * @var string
- */
public const OID_SERVER_SEARCH_OPTIONS = '1.2.840.113556.1.4.1340';
-
- /**
- * OID for Permissive Modify Control. Allows modifications even if some attributes are missing.
- *
- * @var string
- */
public const OID_SERVER_PERMISSIVE_MODIFY = '1.2.840.113556.1.4.1413';
-
- /**
- * OID for Authentication Service Queries (ASQ) Control. Used to perform ASQ operations.
- *
- * @var string
- */
public const OID_SERVER_ASQ = '1.2.840.113556.1.4.1504';
-
- /**
- * OID for Fast Bind Control. Optimizes the bind process for faster authentication.
- *
- * @var string
- */
public const OID_SERVER_FAST_BIND = '1.2.840.113556.1.4.1781';
-
- /**
- * OID for Virtual List View (VLV) Request Control. Used to request a specific range of entries.
- *
- * @var string
- */
public const OID_SERVER_CONTROL_VLVREQUEST = '2.16.840.1.113730.3.4.9';
/**
- * OID for the 'matchingRuleInChain' matching rule. Used for substring searches in multi-valued attributes.
+ * Query OID's.
+ *
+ * @see https://ldapwiki.com/wiki/LDAP_MATCHING_RULE_IN_CHAIN
*/
public const OID_MATCHING_RULE_IN_CHAIN = '1.2.840.113556.1.4.1941';
/**
* Set the current connection to use SSL.
+ *
+ * @param bool $enabled
+ * @return $this
*/
- public function ssl(): static;
+ public function ssl();
/**
* Determine if the current connection instance is using SSL.
+ *
+ * @return bool
*/
- public function isUsingSSL(): bool;
+ public function isUsingSSL();
/**
* Set the current connection to use TLS.
+ *
+ * @param bool $enabled
+ * @return $this
*/
- public function tls(): static;
+ public function tls();
/**
* Determine if the current connection instance is using TLS.
+ *
+ * @return bool
*/
- public function isUsingTLS(): bool;
+ public function isUsingTLS();
/**
* Determine if the connection is bound.
+ *
+ * @return bool
*/
- public function isBound(): bool;
-
- /**
- * Determine if the connection is secure over TLS or SSL.
- */
- public function isSecure(): bool;
+ public function isBound();
/**
* Determine if the connection has been created.
+ *
+ * @return bool
*/
- public function isConnected(): bool;
+ public function isConnected();
/**
* Determine the connection is able to modify passwords.
+ *
+ * @return bool
*/
- public function canChangePasswords(): bool;
+ public function canChangePasswords();
/**
- * Get the full LDAP host URL.
+ * Returns the full LDAP host URL.
*
* Ex: ldap://192.168.1.1:386
+ *
+ * @return string|null
*/
- public function getHost(): ?string;
+ public function getHost();
/**
- * Get the underlying raw LDAP connection.
+ * Get the underlying connection resource.
+ *
+ * @return resource|null
*/
- public function getConnection(): ?Connection;
+ public function getConnection();
/**
* Retrieve the entries from a search result.
*
* @see http://php.net/manual/en/function.ldap-get-entries.php
*
- * @param \LDAP\Result $result
+ * @param resource $searchResults
+ * @return array
*/
- public function getEntries(mixed $result): array;
-
- /**
- * Get the entry identifier for first entry in the result.
- *
- * @see https://www.php.net/manual/en/function.ldap-first-entry.php
- *
- * @param \LDAP\Result $result
- */
- public function getFirstEntry(mixed $result): mixed;
-
- /**
- * Retrieve the next result entry.
- *
- * @see https://www.php.net/manual/en/function.ldap-next-entry.php
- *
- * @param \LDAP\Result $entry
- */
- public function getNextEntry(mixed $entry): mixed;
-
- /**
- * Reads attributes and values from an entry in the search result.
- *
- * @see https://www.php.net/manual/en/function.ldap-get-attributes.php
- *
- * @param \LDAP\Result $entry
- */
- public function getAttributes(mixed $entry): array|false;
-
- /**
- * Reads all the values of the attribute in the entry in the result.
- *
- * @param \LDAP\Result $entry
- */
- public function getValuesLen(mixed $entry, string $attribute): array|false;
+ public function getEntries($searchResults);
/**
* Retrieve the last error on the current connection.
*
* @see http://php.net/manual/en/function.ldap-error.php
+ *
+ * @return string|null
*/
- public function getLastError(): ?string;
+ public function getLastError();
/**
* Return detailed information about an error.
@@ -390,64 +156,62 @@ interface LdapInterface
* Returns null when there was a successful last request.
*
* Returns DetailedError when there was an error.
- */
- public function getDetailedError(): ?DetailedError;
-
- /**
- * Count the number of entries in a search.
*
- * @see https://www.php.net/manual/en/function.ldap-count-entries.php
- *
- * @param \LDAP\Result $result
+ * @return DetailedError|null
*/
- public function countEntries(mixed $result): int;
-
- /**
- * Compare value of attribute found in entry specified with DN.
- */
- public function compare(string $dn, string $attribute, string $value, ?array $controls = null): bool|int;
+ public function getDetailedError();
/**
* Set an option on the current connection.
*
* @see http://php.net/manual/en/function.ldap-set-option.php
- */
- public function setOption(int $option, mixed $value): bool;
-
- /**
- * Set multiple options on the current connection.
- */
- public function setOptions(array $options = []): void;
-
- /**
- * Set a callback function to do re-binds on referral chasing.
*
- * @see https://www.php.net/manual/en/function.ldap-set-rebind-proc.php
+ * @param int $option
+ * @param mixed $value
+ * @return bool
*/
- public function setRebindCallback(callable $callback): bool;
+ public function setOption($option, $value);
+
+ /**
+ * Set options on the current connection.
+ *
+ * @param array $options
+ * @return void
+ */
+ public function setOptions(array $options = []);
/**
* Get the value for the LDAP option.
*
* @see https://www.php.net/manual/en/function.ldap-get-option.php
+ *
+ * @param int $option
+ * @param mixed $value
+ * @return mixed
*/
- public function getOption(int $option, mixed &$value = null): mixed;
+ public function getOption($option, &$value = null);
/**
* Starts a connection using TLS.
*
* @see http://php.net/manual/en/function.ldap-start-tls.php
*
+ * @return bool
+ *
* @throws LdapRecordException
*/
- public function startTLS(): bool;
+ public function startTLS();
/**
* Connects to the specified hostname using the specified port.
*
* @see http://php.net/manual/en/function.ldap-start-tls.php
+ *
+ * @param string|array $hosts
+ * @param int $port
+ * @return resource|false
*/
- public function connect(string|array $hosts = [], int $port = 389, ?string $protocol = null): bool;
+ public function connect($hosts = [], $port = 389);
/**
* Closes the current connection.
@@ -455,176 +219,275 @@ interface LdapInterface
* Returns false if no connection is present.
*
* @see http://php.net/manual/en/function.ldap-close.php
+ *
+ * @return bool
*/
- public function close(): bool;
+ public function close();
/**
* Performs a search on the current connection.
*
* @see http://php.net/manual/en/function.ldap-search.php
*
- * @return \LDAP\Result
+ * @param string $dn
+ * @param string $filter
+ * @param array $fields
+ * @param bool $onlyAttributes
+ * @param int $size
+ * @param int $time
+ * @param int $deref
+ * @param array $serverControls
+ * @return resource
*/
- public function search(string $dn, string $filter, array $fields, bool $onlyAttributes = false, int $size = 0, int $time = 0, int $deref = LDAP_DEREF_NEVER, ?array $controls = null): mixed;
+ public function search($dn, $filter, array $fields, $onlyAttributes = false, $size = 0, $time = 0, $deref = LDAP_DEREF_NEVER, $serverControls = []);
/**
* Performs a single level search on the current connection.
*
* @see http://php.net/manual/en/function.ldap-list.php
*
- * @return \LDAP\Result
+ * @param string $dn
+ * @param string $filter
+ * @param array $fields
+ * @param bool $onlyAttributes
+ * @param int $size
+ * @param int $time
+ * @param int $deref
+ * @param array $serverControls
+ * @return resource
*/
- public function list(string $dn, string $filter, array $fields, bool $onlyAttributes = false, int $size = 0, int $time = 0, int $deref = LDAP_DEREF_NEVER, ?array $controls = null): mixed;
+ public function listing($dn, $filter, array $fields, $onlyAttributes = false, $size = 0, $time = 0, $deref = LDAP_DEREF_NEVER, $serverControls = []);
/**
* Reads an entry on the current connection.
*
* @see http://php.net/manual/en/function.ldap-read.php
*
- * @return \LDAP\Result
+ * @param string $dn
+ * @param string $filter
+ * @param array $fields
+ * @param bool $onlyAttributes
+ * @param int $size
+ * @param int $time
+ * @param int $deref
+ * @param array $serverControls
+ * @return resource
*/
- public function read(string $dn, string $filter, array $fields, bool $onlyAttributes = false, int $size = 0, int $time = 0, int $deref = LDAP_DEREF_NEVER, ?array $controls = null): mixed;
+ public function read($dn, $filter, array $fields, $onlyAttributes = false, $size = 0, $time = 0, $deref = LDAP_DEREF_NEVER, $serverControls = []);
/**
* Extract information from an LDAP result.
*
* @see https://www.php.net/manual/en/function.ldap-parse-result.php
*
- * @param \LDAP\Result $result
+ * @param resource $result
+ * @param int $errorCode
+ * @param ?string $dn
+ * @param ?string $errorMessage
+ * @param ?array $referrals
+ * @param ?array $serverControls
+ * @return bool
*/
- public function parseResult(mixed $result, int &$errorCode = 0, ?string &$dn = null, ?string &$errorMessage = null, ?array &$referrals = null, ?array &$controls = null): LdapResultResponse|false;
+ public function parseResult($result, &$errorCode, &$dn, &$errorMessage, &$referrals, &$serverControls = []);
/**
- * Bind to the LDAP directory.
+ * Binds to the current connection using the specified username and password.
+ * If sasl is true, the current connection is bound using SASL.
*
* @see http://php.net/manual/en/function.ldap-bind.php
*
+ * @param string $username
+ * @param string $password
+ * @return bool
+ *
* @throws LdapRecordException
*/
- public function bind(?string $dn = null, ?string $password = null, ?array $controls = null): LdapResultResponse;
-
- /**
- * Bind to the LDAP directory using SASL.
- *
- * SASL options:
- * - mech: Mechanism (Defaults: null)
- * - realm: Realm (Defaults: null)
- * - authc_id: Verification Identity (Defaults: null)
- * - authz_id: Authorization Identity (Defaults: null)
- * - props: Options for Authorization Identity (Defaults: null)
- *
- * @see https://php.net/manual/en/function.ldap-sasl-bind.php
- * @see https://www.iana.org/assignments/sasl-mechanisms/sasl-mechanisms.xhtml
- */
- public function saslBind(?string $dn = null, ?string $password = null, array $options = []): bool;
+ public function bind($username, $password);
/**
* Adds an entry to the current connection.
*
* @see http://php.net/manual/en/function.ldap-add.php
*
+ * @param string $dn
+ * @param array $entry
+ * @return bool
+ *
* @throws LdapRecordException
*/
- public function add(string $dn, array $entry): bool;
+ public function add($dn, array $entry);
/**
* Deletes an entry on the current connection.
*
* @see http://php.net/manual/en/function.ldap-delete.php
*
+ * @param string $dn
+ * @return bool
+ *
* @throws LdapRecordException
*/
- public function delete(string $dn): bool;
+ public function delete($dn);
/**
* Modify the name of an entry on the current connection.
*
* @see http://php.net/manual/en/function.ldap-rename.php
*
+ * @param string $dn
+ * @param string $newRdn
+ * @param string $newParent
+ * @param bool $deleteOldRdn
+ * @return bool
+ *
* @throws LdapRecordException
*/
- public function rename(string $dn, string $newRdn, string $newParent, bool $deleteOldRdn = false): bool;
+ public function rename($dn, $newRdn, $newParent, $deleteOldRdn = false);
/**
* Modifies an existing entry on the current connection.
*
* @see http://php.net/manual/en/function.ldap-modify.php
*
+ * @param string $dn
+ * @param array $entry
+ * @return bool
+ *
* @throws LdapRecordException
*/
- public function modify(string $dn, array $entry): bool;
+ public function modify($dn, array $entry);
/**
* Batch modifies an existing entry on the current connection.
*
* @see http://php.net/manual/en/function.ldap-modify-batch.php
*
+ * @param string $dn
+ * @param array $values
+ * @return bool
+ *
* @throws LdapRecordException
*/
- public function modifyBatch(string $dn, array $values): bool;
+ public function modifyBatch($dn, array $values);
/**
* Add attribute values to current attributes.
*
* @see http://php.net/manual/en/function.ldap-mod-add.php
*
+ * @param string $dn
+ * @param array $entry
+ * @return bool
+ *
* @throws LdapRecordException
*/
- public function modAdd(string $dn, array $entry): bool;
+ public function modAdd($dn, array $entry);
/**
* Replaces attribute values with new ones.
*
* @see http://php.net/manual/en/function.ldap-mod-replace.php
*
+ * @param string $dn
+ * @param array $entry
+ * @return bool
+ *
* @throws LdapRecordException
*/
- public function modReplace(string $dn, array $entry): bool;
+ public function modReplace($dn, array $entry);
/**
* Delete attribute values from current attributes.
*
* @see http://php.net/manual/en/function.ldap-mod-del.php
*
+ * @param string $dn
+ * @param array $entry
+ * @return bool
+ *
* @throws LdapRecordException
*/
- public function modDelete(string $dn, array $entry): bool;
+ public function modDelete($dn, array $entry);
+
+ /**
+ * Send LDAP pagination control.
+ *
+ * @see http://php.net/manual/en/function.ldap-control-paged-result.php
+ *
+ * @param int $pageSize
+ * @param bool $isCritical
+ * @param string $cookie
+ * @return bool
+ */
+ public function controlPagedResult($pageSize = 1000, $isCritical = false, $cookie = '');
+
+ /**
+ * Retrieve the LDAP pagination cookie.
+ *
+ * @see http://php.net/manual/en/function.ldap-control-paged-result-response.php
+ *
+ * @param resource $result
+ * @param string $cookie
+ * @return bool
+ */
+ public function controlPagedResultResponse($result, &$cookie);
/**
* Frees up the memory allocated internally to store the result.
*
* @see https://www.php.net/manual/en/function.ldap-free-result.php
*
- * @param \LDAP\Result $result
+ * @param resource $result
+ * @return bool
*/
- public function freeResult(mixed $result): bool;
+ public function freeResult($result);
/**
- * Get the error number of the last command executed.
+ * Returns the error number of the last command executed.
*
* @see http://php.net/manual/en/function.ldap-errno.php
+ *
+ * @return int|null
*/
- public function errNo(): ?int;
+ public function errNo();
/**
- * Get the error string of the specified error number.
+ * Returns the error string of the specified error number.
*
* @see http://php.net/manual/en/function.ldap-err2str.php
+ *
+ * @param int $number
+ * @return string
*/
- public function err2Str(int $number): string;
+ public function err2Str($number);
/**
- * Get the LDAP protocol to utilize for the current connection.
+ * Returns the LDAP protocol to utilize for the current connection.
+ *
+ * @return string
*/
- public function getProtocol(): string;
+ public function getProtocol();
/**
- * Get the extended error code of the last command.
+ * Returns the extended error code of the last command.
+ *
+ * @return string
*/
- public function getExtendedError(): ?string;
+ public function getExtendedError();
/**
- * Get the diagnostic message.
+ * Return the diagnostic Message.
+ *
+ * @return string
*/
- public function getDiagnosticMessage(): ?string;
+ public function getDiagnosticMessage();
+
+ /**
+ * Determine if the current PHP version supports server controls.
+ *
+ * @deprecated since v2.5.0
+ *
+ * @return bool
+ */
+ public function supportsServerControlsInMethods();
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/LdapRecordException.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/LdapRecordException.php
index f574b9bc4..0669b4c65 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/LdapRecordException.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/LdapRecordException.php
@@ -8,21 +8,30 @@ class LdapRecordException extends Exception
{
/**
* The detailed LDAP error (if available).
+ *
+ * @var DetailedError|null
*/
- protected ?DetailedError $detailedError = null;
+ protected $detailedError;
/**
* Create a new Bind Exception with a detailed connection error.
+ *
+ * @param Exception $e
+ * @param DetailedError|null $error
+ * @return $this
*/
- public static function withDetailedError(Exception $e, ?DetailedError $error = null): static
+ public static function withDetailedError(Exception $e, DetailedError $error = null)
{
return (new static($e->getMessage(), $e->getCode(), $e))->setDetailedError($error);
}
/**
* Set the detailed error.
+ *
+ * @param DetailedError|null $error
+ * @return $this
*/
- public function setDetailedError(?DetailedError $error = null): static
+ public function setDetailedError(DetailedError $error = null)
{
$this->detailedError = $error;
@@ -30,9 +39,11 @@ class LdapRecordException extends Exception
}
/**
- * Get the detailed error.
+ * Returns the detailed error.
+ *
+ * @return DetailedError|null
*/
- public function getDetailedError(): ?DetailedError
+ public function getDetailedError()
{
return $this->detailedError;
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/LdapResultResponse.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/LdapResultResponse.php
deleted file mode 100644
index c0c1e8306..000000000
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/LdapResultResponse.php
+++ /dev/null
@@ -1,33 +0,0 @@
-errorCode === 0;
- }
-
- /**
- * Determine if the LDAP response indicates a failed status.
- */
- public function failed(): bool
- {
- return ! $this->successful();
- }
-}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/Computer.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/Computer.php
index 3900c61a9..72db0a0d8 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/Computer.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/Computer.php
@@ -2,21 +2,18 @@
namespace LdapRecord\Models\ActiveDirectory;
-use LdapRecord\Models\ActiveDirectory\Concerns\HasAccountControl;
use LdapRecord\Models\ActiveDirectory\Concerns\HasPrimaryGroup;
-use LdapRecord\Models\ActiveDirectory\Relations\HasOnePrimaryGroup;
-use LdapRecord\Models\Relations\HasMany;
-use LdapRecord\Models\Relations\HasOne;
class Computer extends Entry
{
- use HasAccountControl;
use HasPrimaryGroup;
/**
* The object classes of the LDAP model.
+ *
+ * @var array
*/
- public static array $objectClasses = [
+ public static $objectClasses = [
'top',
'person',
'organizationalperson',
@@ -26,24 +23,32 @@ class Computer extends Entry
/**
* The groups relationship.
+ *
+ * Retrieves groups that the current computer is apart of.
+ *
+ * @return \LdapRecord\Models\Relations\HasMany
*/
- public function groups(): HasMany
+ public function groups()
{
return $this->hasMany(Group::class, 'member')->with($this->primaryGroup());
}
/**
* The primary group relationship.
+ *
+ * @return Relations\HasOnePrimaryGroup
*/
- public function primaryGroup(): HasOnePrimaryGroup
+ public function primaryGroup()
{
return $this->hasOnePrimaryGroup(Group::class, 'primarygroupid');
}
/**
* The managed by relationship.
+ *
+ * @return \LdapRecord\Models\Relations\HasOne
*/
- public function managedBy(): HasOne
+ public function managedBy()
{
return $this->hasOne([Contact::class, Group::class, User::class], 'managedby');
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/Concerns/HasAccountControl.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/Concerns/HasAccountControl.php
deleted file mode 100644
index 425cc548f..000000000
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/Concerns/HasAccountControl.php
+++ /dev/null
@@ -1,46 +0,0 @@
-isDisabled();
- }
-
- /**
- * Determine if the user's account is disabled.
- */
- public function isDisabled(): bool
- {
- return $this->accountControl()->hasFlag(AccountControl::ACCOUNTDISABLE);
- }
-
- /**
- * Get the user's account control.
- */
- public function accountControl(): AccountControl
- {
- return new AccountControl(
- $this->getFirstAttribute('userAccountControl')
- );
- }
-
- /**
- * Set the user's account control attribute.
- */
- public function setUserAccountControlAttribute(mixed $value): void
- {
- if ($value instanceof AccountControl) {
- $value = $value->getValue();
- }
-
- $this->attributes['useraccountcontrol'] = [(int) $value];
- }
-}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/Concerns/HasPrimaryGroup.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/Concerns/HasPrimaryGroup.php
index c8e69915a..b7138d30c 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/Concerns/HasPrimaryGroup.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/Concerns/HasPrimaryGroup.php
@@ -8,8 +8,13 @@ trait HasPrimaryGroup
{
/**
* Returns a new has one primary group relationship.
+ *
+ * @param mixed $related
+ * @param string $relationKey
+ * @param string $foreignKey
+ * @return HasOnePrimaryGroup
*/
- public function hasOnePrimaryGroup(string $related, string $relationKey, string $foreignKey = 'primarygroupid'): HasOnePrimaryGroup
+ public function hasOnePrimaryGroup($related, $relationKey, $foreignKey = 'primarygroupid')
{
return new HasOnePrimaryGroup($this->newQuery(), $this, $related, $relationKey, $foreignKey);
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/Contact.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/Contact.php
index 9087f058e..52c451fe4 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/Contact.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/Contact.php
@@ -2,14 +2,14 @@
namespace LdapRecord\Models\ActiveDirectory;
-use LdapRecord\Models\Relations\HasMany;
-
class Contact extends Entry
{
/**
* The object classes of the LDAP model.
+ *
+ * @var array
*/
- public static array $objectClasses = [
+ public static $objectClasses = [
'top',
'person',
'organizationalperson',
@@ -18,8 +18,12 @@ class Contact extends Entry
/**
* The groups relationship.
+ *
+ * Retrieves groups that the current contact is apart of.
+ *
+ * @return \LdapRecord\Models\Relations\HasMany
*/
- public function groups(): HasMany
+ public function groups()
{
return $this->hasMany(Group::class, 'member');
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/Container.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/Container.php
index e17fb1f70..1636cf393 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/Container.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/Container.php
@@ -6,8 +6,10 @@ class Container extends Entry
{
/**
* The object classes of the LDAP model.
+ *
+ * @var array
*/
- public static array $objectClasses = [
+ public static $objectClasses = [
'top',
'container',
];
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/Entry.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/Entry.php
index e9924f433..e1a0233cc 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/Entry.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/Entry.php
@@ -16,8 +16,10 @@ class Entry extends BaseEntry implements ActiveDirectory
{
/**
* The default attributes that should be mutated to dates.
+ *
+ * @var array
*/
- protected array $defaultDates = [
+ protected $defaultDates = [
'whenchanged' => 'windows',
'whencreated' => 'windows',
'dscorepropagationdata' => 'windows',
@@ -25,73 +27,83 @@ class Entry extends BaseEntry implements ActiveDirectory
/**
* The attribute key that contains the Object SID.
+ *
+ * @var string
*/
- protected string $sidKey = 'objectsid';
+ protected $sidKey = 'objectsid';
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function getObjectSidKey(): string
+ public function getObjectSidKey()
{
return $this->sidKey;
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function getObjectSid(): ?string
+ public function getObjectSid()
{
return $this->getFirstAttribute($this->sidKey);
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function getConvertedSid($sid = null): ?string
+ public function getConvertedSid($sid = null)
{
try {
- return $this->newObjectSid(
- (string) ($sid ?? $this->getObjectSid())
+ return (string) $this->newObjectSid(
+ $sid ?? $this->getObjectSid()
);
- } catch (InvalidArgumentException) {
- return null;
+ } catch (InvalidArgumentException $e) {
+ return;
}
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function getBinarySid($sid = null): ?string
+ public function getBinarySid($sid = null)
{
try {
return $this->newObjectSid(
$sid ?? $this->getObjectSid()
)->getBinary();
- } catch (InvalidArgumentException) {
- return null;
+ } catch (InvalidArgumentException $e) {
+ return;
}
}
/**
* Make a new object Sid instance.
+ *
+ * @param string $value
+ * @return Sid
*/
- protected function newObjectSid(string $value): Sid
+ protected function newObjectSid($value)
{
return new Sid($value);
}
/**
* Create a new query builder.
+ *
+ * @param Connection $connection
+ * @return ActiveDirectoryBuilder
*/
- public function newQueryBuilder(Connection $connection): ActiveDirectoryBuilder
+ public function newQueryBuilder(Connection $connection)
{
return new ActiveDirectoryBuilder($connection);
}
/**
* Determine if the object is deleted.
+ *
+ * @return bool
*/
- public function isDeleted(): bool
+ public function isDeleted()
{
return strtoupper((string) $this->getFirstAttribute('isDeleted')) === 'TRUE';
}
@@ -99,9 +111,12 @@ class Entry extends BaseEntry implements ActiveDirectory
/**
* Restore a deleted object.
*
+ * @param string|null $newParentDn
+ * @return bool
+ *
* @throws \LdapRecord\LdapRecordException
*/
- public function restore(?string $newParentDn = null): bool
+ public function restore($newParentDn = null)
{
if (! $this->isDeleted()) {
return false;
@@ -123,27 +138,30 @@ class Entry extends BaseEntry implements ActiveDirectory
$this->setRawAttribute('distinguishedname', $newDn);
$this->save(['isDeleted' => null]);
-
- return true;
}
/**
* Get the objects restore location.
+ *
+ * @return string
*/
- protected function getDefaultRestoreLocation(): ?string
+ protected function getDefaultRestoreLocation()
{
return $this->getFirstAttribute('lastKnownParent') ?? $this->getParentDn($this->getParentDn($this->getDn()));
}
/**
* Convert the attributes for JSON serialization.
+ *
+ * @param array $attributes
+ * @return array
*/
- protected function convertAttributesForJson(array $attributes = []): array
+ protected function convertAttributesForJson(array $attributes = [])
{
$attributes = parent::convertAttributesForJson($attributes);
// If the model has a SID set, we need to convert it to its
- // string format, due to it being in binary. Otherwise,
+ // string format, due to it being in binary. Otherwise
// we will receive a JSON serialization exception.
if (isset($attributes[$this->sidKey])) {
$attributes[$this->sidKey] = [$this->getConvertedSid(
@@ -156,11 +174,23 @@ class Entry extends BaseEntry implements ActiveDirectory
/**
* Convert the attributes from JSON serialization.
+ *
+ * @param array $attributes
+ * @return array
*/
- protected function convertAttributesFromJson(array $attributes = []): array
+ protected function convertAttributesFromJson(array $attributes = [])
{
$attributes = parent::convertAttributesFromJson($attributes);
+ // Here we are converting the model's GUID and SID attributes
+ // back to their original values from serialization, so that
+ // their original value may be used and compared against.
+ if (isset($attributes[$this->guidKey])) {
+ $attributes[$this->guidKey] = [$this->getBinaryGuid(
+ Arr::first($attributes[$this->guidKey])
+ )];
+ }
+
if (isset($attributes[$this->sidKey])) {
$attributes[$this->sidKey] = [$this->getBinarySid(
Arr::first($attributes[$this->sidKey])
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/ExchangeDatabase.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/ExchangeDatabase.php
index e32f82009..77abbbcf5 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/ExchangeDatabase.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/ExchangeDatabase.php
@@ -5,17 +5,17 @@ namespace LdapRecord\Models\ActiveDirectory;
class ExchangeDatabase extends Entry
{
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public static array $objectClasses = ['msExchMDB'];
+ public static $objectClasses = ['msExchMDB'];
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public static function boot(): void
+ public static function boot()
{
parent::boot();
- static::addGlobalScope(new Scopes\InConfigurationContext);
+ static::addGlobalScope(new Scopes\InConfigurationContext());
}
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/ExchangeServer.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/ExchangeServer.php
index 5e13d405d..d304876ab 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/ExchangeServer.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/ExchangeServer.php
@@ -5,18 +5,18 @@ namespace LdapRecord\Models\ActiveDirectory;
class ExchangeServer extends Entry
{
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public static array $objectClasses = ['msExchExchangeServer'];
+ public static $objectClasses = ['msExchExchangeServer'];
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public static function boot(): void
+ public static function boot()
{
parent::boot();
- static::addGlobalScope(new Scopes\HasServerRoleAttribute);
- static::addGlobalScope(new Scopes\InConfigurationContext);
+ static::addGlobalScope(new Scopes\HasServerRoleAttribute());
+ static::addGlobalScope(new Scopes\InConfigurationContext());
}
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/ForeignSecurityPrincipal.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/ForeignSecurityPrincipal.php
index 34e6c3358..25287ae4a 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/ForeignSecurityPrincipal.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/ForeignSecurityPrincipal.php
@@ -2,23 +2,23 @@
namespace LdapRecord\Models\ActiveDirectory;
-use LdapRecord\Models\Relations\HasMany;
-
class ForeignSecurityPrincipal extends Entry
{
/**
* The object classes of the LDAP model.
+ *
+ * @var array
*/
- public static array $objectClasses = [
- 'foreignsecurityprincipal',
- ];
+ public static $objectClasses = ['foreignsecurityprincipal'];
/**
* The groups relationship.
*
- * Retrieves groups that the current security principal is a part of.
+ * Retrieves groups that the current security principal is apart of.
+ *
+ * @return \LdapRecord\Models\Relations\HasMany
*/
- public function groups(): HasMany
+ public function groups()
{
return $this->hasMany(Group::class, 'member');
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/Group.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/Group.php
index 165bd90f8..784588771 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/Group.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/Group.php
@@ -2,14 +2,14 @@
namespace LdapRecord\Models\ActiveDirectory;
-use LdapRecord\Models\Relations\HasMany;
-
class Group extends Entry
{
/**
* The object classes of the LDAP model.
+ *
+ * @var array
*/
- public static array $objectClasses = [
+ public static $objectClasses = [
'top',
'group',
];
@@ -17,17 +17,23 @@ class Group extends Entry
/**
* The groups relationship.
*
- * Retrieves groups that the current group is a part of.
+ * Retrieves groups that the current group is apart of.
+ *
+ * @return \LdapRecord\Models\Relations\HasMany
*/
- public function groups(): HasMany
+ public function groups()
{
return $this->hasMany(static::class, 'member');
}
/**
* The members relationship.
+ *
+ * Retrieves members that are apart of the group.
+ *
+ * @return \LdapRecord\Models\Relations\HasMany
*/
- public function members(): HasMany
+ public function members()
{
return $this->hasMany([
static::class, User::class, Contact::class, Computer::class,
@@ -38,8 +44,12 @@ class Group extends Entry
/**
* The primary group members relationship.
+ *
+ * Retrieves members that are apart the primary group.
+ *
+ * @return \LdapRecord\Models\Relations\HasMany
*/
- public function primaryGroupMembers(): HasMany
+ public function primaryGroupMembers()
{
return $this->hasMany([
static::class, User::class, Contact::class, Computer::class,
@@ -48,11 +58,13 @@ class Group extends Entry
/**
* Get the RID of the group.
+ *
+ * @return array
*/
- public function getRidAttribute(): array
+ public function getRidAttribute()
{
- return array_filter([
- last(explode('-', (string) $this->getConvertedSid())),
- ]);
+ $objectSidComponents = explode('-', (string) $this->getConvertedSid());
+
+ return [end($objectSidComponents)];
}
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/OrganizationalUnit.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/OrganizationalUnit.php
index 0801d1080..80aae9f47 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/OrganizationalUnit.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/OrganizationalUnit.php
@@ -6,16 +6,20 @@ class OrganizationalUnit extends Entry
{
/**
* The object classes of the LDAP model.
+ *
+ * @var array
*/
- public static array $objectClasses = [
+ public static $objectClasses = [
'top',
'organizationalunit',
];
/**
* Get the creatable RDN attribute name.
+ *
+ * @return string
*/
- public function getCreatableRdnAttribute(): string
+ public function getCreatableRdnAttribute()
{
return 'ou';
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/Printer.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/Printer.php
index 71534981d..df7421610 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/Printer.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/Printer.php
@@ -6,6 +6,8 @@ class Printer extends Entry
{
/**
* The object classes of the LDAP model.
+ *
+ * @var array
*/
- public static array $objectClasses = ['printqueue'];
+ public static $objectClasses = ['printqueue'];
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/Relations/HasOnePrimaryGroup.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/Relations/HasOnePrimaryGroup.php
index 971f79066..40350c97a 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/Relations/HasOnePrimaryGroup.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/Relations/HasOnePrimaryGroup.php
@@ -9,8 +9,11 @@ class HasOnePrimaryGroup extends HasOne
{
/**
* Get the foreign model by the given value.
+ *
+ * @param string $value
+ * @return Model|null
*/
- protected function getForeignModelByValue(string $value): ?Model
+ protected function getForeignModelByValue($value)
{
return $this->query->findBySid(
$this->getParentModelObjectSid()
@@ -21,8 +24,11 @@ class HasOnePrimaryGroup extends HasOne
* Get the foreign value from the given model.
*
* Retrieves the last RID from the models Object SID.
+ *
+ * @param Model $model
+ * @return string
*/
- protected function getForeignValueFromModel(Model $model): ?string
+ protected function getForeignValueFromModel(Model $model)
{
$objectSidComponents = explode('-', $model->getConvertedSid());
@@ -31,8 +37,10 @@ class HasOnePrimaryGroup extends HasOne
/**
* Get the parent relationship models converted object sid.
+ *
+ * @return string
*/
- protected function getParentModelObjectSid(): string
+ protected function getParentModelObjectSid()
{
return preg_replace(
'/\d+$/',
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/Scopes/HasServerRoleAttribute.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/Scopes/HasServerRoleAttribute.php
index 24a2387d3..76df79ca3 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/Scopes/HasServerRoleAttribute.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/Scopes/HasServerRoleAttribute.php
@@ -10,8 +10,12 @@ class HasServerRoleAttribute implements Scope
{
/**
* Includes condition of having a serverRole attribute.
+ *
+ * @param Builder $query
+ * @param Model $model
+ * @return void
*/
- public function apply(Builder $query, Model $model): void
+ public function apply(Builder $query, Model $model)
{
$query->whereHas('serverRole');
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/Scopes/InConfigurationContext.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/Scopes/InConfigurationContext.php
index b7942cf4d..dc8a4d21b 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/Scopes/InConfigurationContext.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/Scopes/InConfigurationContext.php
@@ -12,9 +12,13 @@ class InConfigurationContext implements Scope
/**
* Refines the base dn to be inside the configuration context.
*
+ * @param Builder $query
+ * @param Model $model
+ * @return void
+ *
* @throws \LdapRecord\Models\ModelNotFoundException
*/
- public function apply(Builder $query, Model $model): void
+ public function apply(Builder $query, Model $model)
{
$query->in($this->getConfigurationNamingContext($model));
}
@@ -22,6 +26,9 @@ class InConfigurationContext implements Scope
/**
* Get the LDAP server configuration naming context distinguished name.
*
+ * @param Model $model
+ * @return mixed
+ *
* @throws \LdapRecord\Models\ModelNotFoundException
*/
protected function getConfigurationNamingContext(Model $model)
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/Scopes/RejectComputerObjectClass.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/Scopes/RejectComputerObjectClass.php
index 30545b802..9d00cf8fa 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/Scopes/RejectComputerObjectClass.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/Scopes/RejectComputerObjectClass.php
@@ -10,8 +10,12 @@ class RejectComputerObjectClass implements Scope
{
/**
* Prevent computer objects from being included in results.
+ *
+ * @param Builder $query
+ * @param Model $model
+ * @return void
*/
- public function apply(Builder $query, Model $model): void
+ public function apply(Builder $query, Model $model)
{
$query->where('objectclass', '!=', 'computer');
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/User.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/User.php
index 3faec3882..c2ea0325d 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/User.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ActiveDirectory/User.php
@@ -4,36 +4,39 @@ namespace LdapRecord\Models\ActiveDirectory;
use Carbon\Carbon;
use Illuminate\Contracts\Auth\Authenticatable;
-use LdapRecord\Models\ActiveDirectory\Concerns\HasAccountControl;
use LdapRecord\Models\ActiveDirectory\Concerns\HasPrimaryGroup;
use LdapRecord\Models\ActiveDirectory\Scopes\RejectComputerObjectClass;
+use LdapRecord\Models\Attributes\AccountControl;
use LdapRecord\Models\Concerns\CanAuthenticate;
use LdapRecord\Models\Concerns\HasPassword;
-use LdapRecord\Models\Relations\HasMany;
-use LdapRecord\Models\Relations\HasOne;
use LdapRecord\Query\Model\Builder;
class User extends Entry implements Authenticatable
{
- use CanAuthenticate;
- use HasAccountControl;
use HasPassword;
use HasPrimaryGroup;
+ use CanAuthenticate;
/**
* The password's attribute name.
+ *
+ * @var string
*/
- protected string $passwordAttribute = 'unicodepwd';
+ protected $passwordAttribute = 'unicodepwd';
/**
* The password's hash method.
+ *
+ * @var string
*/
- protected string $passwordHashMethod = 'encode';
+ protected $passwordHashMethod = 'encode';
/**
* The object classes of the LDAP model.
+ *
+ * @var array
*/
- public static array $objectClasses = [
+ public static $objectClasses = [
'top',
'person',
'organizationalperson',
@@ -42,8 +45,10 @@ class User extends Entry implements Authenticatable
/**
* The attributes that should be mutated to dates.
+ *
+ * @var array
*/
- protected array $dates = [
+ protected $dates = [
'lastlogon' => 'windows-int',
'lastlogoff' => 'windows-int',
'pwdlastset' => 'windows-int',
@@ -54,9 +59,9 @@ class User extends Entry implements Authenticatable
];
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- protected static function boot(): void
+ protected static function boot()
{
parent::boot();
@@ -64,23 +69,49 @@ class User extends Entry implements Authenticatable
// class. This is needed due to computer objects containing all
// of the ActiveDirectory 'user' object classes. Without
// this scope, they would be included in results.
- static::addGlobalScope(new RejectComputerObjectClass);
+ static::addGlobalScope(new RejectComputerObjectClass());
}
/**
- * Get the unique identifier for the user.
+ * Determine if the user's account is enabled.
+ *
+ * @return bool
*/
- public function getAuthIdentifier(): ?string
+ public function isEnabled()
{
- return $this->getConvertedGuid();
+ return ! $this->isDisabled();
+ }
+
+ /**
+ * Determine if the user's account is disabled.
+ *
+ * @return bool
+ */
+ public function isDisabled()
+ {
+ return $this->accountControl()->has(AccountControl::ACCOUNTDISABLE);
+ }
+
+ /**
+ * Get the user's account control.
+ *
+ * @return AccountControl
+ */
+ public function accountControl()
+ {
+ return new AccountControl(
+ $this->getFirstAttribute('userAccountControl')
+ );
}
/**
* The groups relationship.
*
- * Retrieves groups that the user is a part of.
+ * Retrieves groups that the user is apart of.
+ *
+ * @return \LdapRecord\Models\Relations\HasMany
*/
- public function groups(): HasMany
+ public function groups()
{
return $this->hasMany(Group::class, 'member')->with($this->primaryGroup());
}
@@ -89,8 +120,10 @@ class User extends Entry implements Authenticatable
* The manager relationship.
*
* Retrieves the manager of the user.
+ *
+ * @return \LdapRecord\Models\Relations\HasOne
*/
- public function manager(): HasOne
+ public function manager()
{
return $this->hasOne(static::class, 'manager');
}
@@ -98,25 +131,33 @@ class User extends Entry implements Authenticatable
/**
* The primary group relationship of the current user.
*
- * Retrieves the primary group the user is a part of.
+ * Retrieves the primary group the user is apart of.
+ *
+ * @return \LdapRecord\Models\Relations\HasOne
*/
- public function primaryGroup(): HasOne
+ public function primaryGroup()
{
return $this->hasOnePrimaryGroup(Group::class, 'primarygroupid');
}
/**
* Scopes the query to exchange mailbox users.
+ *
+ * @param Builder $query
+ * @return Builder
*/
- public function scopeWhereHasMailbox(Builder $query): Builder
+ public function scopeWhereHasMailbox(Builder $query)
{
return $query->whereHas('msExchMailboxGuid');
}
/**
* Scopes the query to users having a lockout value set.
+ *
+ * @param Builder $query
+ * @return Builder
*/
- public function scopeWhereHasLockout(Builder $query): Builder
+ public function scopeWhereHasLockout(Builder $query)
{
return $query->where('lockoutTime', '>=', 1);
}
@@ -126,8 +167,12 @@ class User extends Entry implements Authenticatable
*
* @see https://ldapwiki.com/wiki/Active%20Directory%20Account%20Lockout
* @see https://docs.microsoft.com/en-us/windows/security/threat-protection/security-policy-settings/account-lockout-duration
+ *
+ * @param string|int $localTimezone
+ * @param int|null $durationInMinutes
+ * @return bool
*/
- public function isLockedOut(string|int $localTimezone, ?int $durationInMinutes = null): bool
+ public function isLockedOut($localTimezone, $durationInMinutes = null)
{
$time = $this->getFirstAttribute('lockouttime');
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Attributes/AccountControl.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Attributes/AccountControl.php
index 9024b934e..45fae214d 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Attributes/AccountControl.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Attributes/AccountControl.php
@@ -3,9 +3,8 @@
namespace LdapRecord\Models\Attributes;
use ReflectionClass;
-use Stringable;
-class AccountControl implements Stringable
+class AccountControl
{
public const SCRIPT = 1;
@@ -52,122 +51,151 @@ class AccountControl implements Stringable
public const PARTIAL_SECRETS_ACCOUNT = 67108864;
/**
- * The account control flags.
+ * The account control flag values.
*
* @var array
*/
- protected array $flags = [];
+ protected $values = [];
/**
* Constructor.
+ *
+ * @param ?int $flag
*/
- public function __construct(?int $flag = null)
+ public function __construct($flag = null)
{
if (! is_null($flag)) {
- $this->applyFlags($flag);
+ $this->apply($flag);
}
}
/**
- * Get the value when cast to string.
+ * Get the value when casted to string.
+ *
+ * @return string
*/
- public function __toString(): string
+ public function __toString()
{
return (string) $this->getValue();
}
/**
- * Get the value when cast to int.
+ * Get the value when casted to int.
+ *
+ * @return int
*/
- public function __toInt(): int
+ public function __toInt()
{
return $this->getValue();
}
/**
- * Set a flag on the account control.
+ * Add the flag to the account control values.
+ *
+ * @param int $flag
+ * @return $this
*/
- public function setFlag(int $flag): static
+ public function add($flag)
{
// Use the value as a key so if the same value
// is used, it will always be overwritten
- $this->flags[$flag] = $flag;
+ $this->values[$flag] = $flag;
return $this;
}
/**
- * Unset a flag from the account control.
+ * Remove the flag from the account control.
+ *
+ * @param int $flag
+ * @return $this
*/
- public function unsetFlag(int $flag): static
+ public function remove($flag)
{
- unset($this->flags[$flag]);
+ unset($this->values[$flag]);
return $this;
}
/**
- * Extract and apply several flags.
+ * Extract and apply the flag.
+ *
+ * @param int $flag
+ * @return void
*/
- public function applyFlags(int $flags): void
+ public function apply($flag)
{
- $this->setFlags($this->extractFlags($flags));
+ $this->setValues($this->extractFlags($flag));
}
/**
- * Determine if the account control contains the given flag(s).
+ * Determine if the account control contains the given UAC flag(s).
+ *
+ * @param int $flag
+ * @return bool
*/
- public function hasFlag(int $flag): bool
+ public function has($flag)
{
// Here we will extract the given flag into an array
// of possible flags. This will allow us to see if
// our AccountControl object contains any of them.
$flagsUsed = array_intersect(
$this->extractFlags($flag),
- $this->flags
+ $this->values
);
return in_array($flag, $flagsUsed);
}
/**
- * Determine if the account control does not contain the given flag(s).
+ * Determine if the account control does not contain the given UAC flag(s).
+ *
+ * @param int $flag
+ * @return bool
*/
- public function doesntHaveFlag(int $flag): bool
+ public function doesntHave($flag)
{
- return ! $this->hasFlag($flag);
+ return ! $this->has($flag);
}
/**
* Generate an LDAP filter based on the current value.
+ *
+ * @return string
*/
- public function filter(): string
+ public function filter()
{
- return sprintf('(UserAccountControl:1.2.840.113556.1.4.803:=%s)', $this);
+ return sprintf('(UserAccountControl:1.2.840.113556.1.4.803:=%s)', $this->getValue());
}
/**
* The logon script will be run.
+ *
+ * @return $this
*/
- public function setRunLoginScript(): static
+ public function runLoginScript()
{
- return $this->setFlag(static::SCRIPT);
+ return $this->add(static::SCRIPT);
}
/**
* The user account is locked.
+ *
+ * @return $this
*/
- public function setAccountIsLocked(): static
+ public function accountIsLocked()
{
- return $this->setFlag(static::LOCKOUT);
+ return $this->add(static::LOCKOUT);
}
/**
* The user account is disabled.
+ *
+ * @return $this
*/
- public function setAccountIsDisabled(): static
+ public function accountIsDisabled()
{
- return $this->setFlag(static::ACCOUNTDISABLE);
+ return $this->add(static::ACCOUNTDISABLE);
}
/**
@@ -175,95 +203,117 @@ class AccountControl implements Stringable
*
* This account provides user access to this domain, but not to any domain that
* trusts this domain. This is sometimes referred to as a local user account.
+ *
+ * @return $this
*/
- public function setAccountIsTemporary(): static
+ public function accountIsTemporary()
{
- return $this->setFlag(static::TEMP_DUPLICATE_ACCOUNT);
+ return $this->add(static::TEMP_DUPLICATE_ACCOUNT);
}
/**
* This is a default account type that represents a typical user.
+ *
+ * @return $this
*/
- public function setAccountIsNormal(): static
+ public function accountIsNormal()
{
- return $this->setFlag(static::NORMAL_ACCOUNT);
+ return $this->add(static::NORMAL_ACCOUNT);
}
/**
* This is a permit to trust an account for a system domain that trusts other domains.
+ *
+ * @return $this
*/
- public function setAccountIsForInterdomain(): static
+ public function accountIsForInterdomain()
{
- return $this->setFlag(static::INTERDOMAIN_TRUST_ACCOUNT);
+ return $this->add(static::INTERDOMAIN_TRUST_ACCOUNT);
}
/**
* This is a computer account for a computer that is running Microsoft
* Windows NT 4.0 Workstation, Microsoft Windows NT 4.0 Server, Microsoft
* Windows 2000 Professional, or Windows 2000 Server and is a member of this domain.
+ *
+ * @return $this
*/
- public function setAccountIsForWorkstation(): static
+ public function accountIsForWorkstation()
{
- return $this->setFlag(static::WORKSTATION_TRUST_ACCOUNT);
+ return $this->add(static::WORKSTATION_TRUST_ACCOUNT);
}
/**
* This is a computer account for a domain controller that is a member of this domain.
+ *
+ * @return $this
*/
- public function setAccountIsForServer(): static
+ public function accountIsForServer()
{
- return $this->setFlag(static::SERVER_TRUST_ACCOUNT);
+ return $this->add(static::SERVER_TRUST_ACCOUNT);
}
/**
* This is an MNS logon account.
+ *
+ * @return $this
*/
- public function setAccountIsMnsLogon(): static
+ public function accountIsMnsLogon()
{
- return $this->setFlag(static::MNS_LOGON_ACCOUNT);
+ return $this->add(static::MNS_LOGON_ACCOUNT);
}
/**
* (Windows 2000/Windows Server 2003) This account does
* not require Kerberos pre-authentication for logging on.
+ *
+ * @return $this
*/
- public function setAccountDoesNotRequirePreAuth(): static
+ public function accountDoesNotRequirePreAuth()
{
- return $this->setFlag(static::DONT_REQ_PREAUTH);
+ return $this->add(static::DONT_REQ_PREAUTH);
}
/**
* When this flag is set, it forces the user to log on by using a smart card.
+ *
+ * @return $this
*/
- public function setAccountRequiresSmartCard(): static
+ public function accountRequiresSmartCard()
{
- return $this->setFlag(static::SMARTCARD_REQUIRED);
+ return $this->add(static::SMARTCARD_REQUIRED);
}
/**
* (Windows Server 2008/Windows Server 2008 R2) The account is a read-only domain controller (RODC).
*
* This is a security-sensitive setting. Removing this setting from an RODC compromises security on that server.
+ *
+ * @return $this
*/
- public function setAccountIsReadOnly(): static
+ public function accountIsReadOnly()
{
- return $this->setFlag(static::PARTIAL_SECRETS_ACCOUNT);
+ return $this->add(static::PARTIAL_SECRETS_ACCOUNT);
}
/**
* The home folder is required.
+ *
+ * @return $this
*/
- public function setHomeFolderIsRequired(): static
+ public function homeFolderIsRequired()
{
- return $this->setFlag(static::HOMEDIR_REQUIRED);
+ return $this->add(static::HOMEDIR_REQUIRED);
}
/**
* No password is required.
+ *
+ * @return $this
*/
- public function setPasswordIsNotRequired(): static
+ public function passwordIsNotRequired()
{
- return $this->setFlag(static::PASSWD_NOTREQD);
+ return $this->add(static::PASSWD_NOTREQD);
}
/**
@@ -272,34 +322,42 @@ class AccountControl implements Stringable
* For information about how to programmatically set this permission, visit the following link:
*
* @see http://msdn2.microsoft.com/en-us/library/aa746398.aspx
+ *
+ * @return $this
*/
- public function setPasswordCannotBeChanged(): static
+ public function passwordCannotBeChanged()
{
- return $this->setFlag(static::PASSWD_CANT_CHANGE);
+ return $this->add(static::PASSWD_CANT_CHANGE);
}
/**
* Represents the password, which should never expire on the account.
+ *
+ * @return $this
*/
- public function setPasswordDoesNotExpire(): static
+ public function passwordDoesNotExpire()
{
- return $this->setFlag(static::DONT_EXPIRE_PASSWORD);
+ return $this->add(static::DONT_EXPIRE_PASSWORD);
}
/**
* (Windows 2000/Windows Server 2003) The user's password has expired.
+ *
+ * @return $this
*/
- public function setPasswordIsExpired(): static
+ public function passwordIsExpired()
{
- return $this->setFlag(static::PASSWORD_EXPIRED);
+ return $this->add(static::PASSWORD_EXPIRED);
}
/**
* The user can send an encrypted password.
+ *
+ * @return $this
*/
- public function setAllowEncryptedTextPassword(): static
+ public function allowEncryptedTextPassword()
{
- return $this->setFlag(static::ENCRYPTED_TEXT_PWD_ALLOWED);
+ return $this->add(static::ENCRYPTED_TEXT_PWD_ALLOWED);
}
/**
@@ -310,10 +368,12 @@ class AccountControl implements Stringable
*
* To enable a service for Kerberos delegation, you must set this
* flag on the userAccountControl property of the service account.
+ *
+ * @return $this
*/
- public function setTrustForDelegation(): static
+ public function trustForDelegation()
{
- return $this->setFlag(static::TRUSTED_FOR_DELEGATION);
+ return $this->add(static::TRUSTED_FOR_DELEGATION);
}
/**
@@ -323,36 +383,44 @@ class AccountControl implements Stringable
* should be tightly controlled. This setting lets a service that runs under the
* account assume a client's identity and authenticate as that user to other remote
* servers on the network.
+ *
+ * @return $this
*/
- public function setTrustToAuthForDelegation(): static
+ public function trustToAuthForDelegation()
{
- return $this->setFlag(static::TRUSTED_TO_AUTH_FOR_DELEGATION);
+ return $this->add(static::TRUSTED_TO_AUTH_FOR_DELEGATION);
}
/**
* When this flag is set, the security context of the user is not delegated to a
* service even if the service account is set as trusted for Kerberos delegation.
+ *
+ * @return $this
*/
- public function setDoNotTrustForDelegation(): static
+ public function doNotTrustForDelegation()
{
- return $this->setFlag(static::NOT_DELEGATED);
+ return $this->add(static::NOT_DELEGATED);
}
/**
* (Windows 2000/Windows Server 2003) Restrict this principal to
* use only Data Encryption Standard (DES) encryption types for keys.
+ *
+ * @return $this
*/
- public function setUseDesKeyOnly(): static
+ public function useDesKeyOnly()
{
- return $this->setFlag(static::USE_DES_KEY_ONLY);
+ return $this->add(static::USE_DES_KEY_ONLY);
}
/**
* Get the account control value.
+ *
+ * @return int
*/
- public function getValue(): int
+ public function getValue()
{
- return array_sum($this->flags);
+ return array_sum($this->values);
}
/**
@@ -360,56 +428,64 @@ class AccountControl implements Stringable
*
* @return array
*/
- public function getFlags(): array
+ public function getValues()
{
- return $this->flags;
+ return $this->values;
}
/**
* Set the account control values.
*
* @param array $flags
+ * @return void
*/
- public function setFlags(array $flags): void
+ public function setValues(array $flags)
{
- $this->flags = $flags;
+ $this->values = $flags;
}
/**
* Get all flags that are currently applied to the value.
+ *
+ * @return array
*/
- public function getAppliedFlags(): array
+ public function getAppliedFlags()
{
$flags = $this->getAllFlags();
- $applied = [];
+ $exists = [];
foreach ($flags as $name => $flag) {
- if ($this->hasFlag($flag)) {
- $applied[$name] = $flag;
+ if ($this->has($flag)) {
+ $exists[$name] = $flag;
}
}
- return $applied;
+ return $exists;
}
/**
* Get all possible account control flags.
+ *
+ * @return array
*/
- public function getAllFlags(): array
+ public function getAllFlags()
{
return (new ReflectionClass(__CLASS__))->getConstants();
}
/**
* Extracts the given flag into an array of flags used.
+ *
+ * @param int $flag
+ * @return array
*/
- protected function extractFlags(int $flag): array
+ public function extractFlags($flag)
{
$flags = [];
for ($i = 0; $i <= 26; $i++) {
- if ($flag & (1 << $i)) {
+ if ((int) $flag & (1 << $i)) {
$flags[1 << $i] = 1 << $i;
}
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Attributes/DistinguishedName.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Attributes/DistinguishedName.php
index 09391091b..fc981299a 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Attributes/DistinguishedName.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Attributes/DistinguishedName.php
@@ -4,69 +4,89 @@ namespace LdapRecord\Models\Attributes;
use LdapRecord\EscapesValues;
use LdapRecord\Support\Arr;
-use Stringable;
-class DistinguishedName implements Stringable
+class DistinguishedName
{
use EscapesValues;
/**
- * The underlying raw distinguished name value.
+ * The underlying raw value.
+ *
+ * @var string
*/
- protected string $value;
+ protected $value;
/**
* Constructor.
+ *
+ * @param string|null $value
*/
- public function __construct(?string $value = null)
+ public function __construct($value = null)
{
$this->value = trim((string) $value);
}
/**
* Get the distinguished name value.
+ *
+ * @return string
*/
- public function __toString(): string
+ public function __toString()
{
- return $this->value;
+ return (string) $this->value;
}
/**
* Alias of the "build" method.
+ *
+ * @param string|null $value
+ * @return DistinguishedNameBuilder
*/
- public static function of(?string $value = null): DistinguishedNameBuilder
+ public static function of($value = null)
{
return static::build($value);
}
/**
* Get a new DN builder object from the given DN.
+ *
+ * @param string|null $value
+ * @return DistinguishedNameBuilder
*/
- public static function build(?string $value = null): DistinguishedNameBuilder
+ public static function build($value = null)
{
return new DistinguishedNameBuilder($value);
}
/**
* Make a new distinguished name instance.
+ *
+ * @param string|null $value
+ * @return static
*/
- public static function make(?string $value = null): static
+ public static function make($value = null)
{
return new static($value);
}
/**
* Determine if the given value is a valid distinguished name.
+ *
+ * @param string $value
+ * @return bool
*/
- public static function isValid(?string $value = null): bool
+ public static function isValid($value)
{
return ! static::make($value)->isEmpty();
}
/**
* Explode a distinguished name into relative distinguished names.
+ *
+ * @param string $dn
+ * @return array
*/
- public static function explode(string $dn): array
+ public static function explode($dn)
{
$components = ldap_explode_dn($dn, (int) $withoutAttributes = false);
@@ -84,33 +104,57 @@ class DistinguishedName implements Stringable
}
/**
- * Explode the RDN into an attribute and value.
+ * Un-escapes a hexadecimal string into its original string representation.
+ *
+ * @param string $value
+ * @return string
*/
- public static function explodeRdn(string $rdn): array
+ public static function unescape($value)
+ {
+ return preg_replace_callback('/\\\([0-9A-Fa-f]{2})/', function ($matches) {
+ return chr(hexdec($matches[1]));
+ }, $value);
+ }
+
+ /**
+ * Explode the RDN into an attribute and value.
+ *
+ * @param string $rdn
+ * @return array
+ */
+ public static function explodeRdn($rdn)
{
return explode('=', $rdn, $limit = 2);
}
/**
* Implode the component attribute and value into an RDN.
+ *
+ * @param string $rdn
+ * @return string
*/
- public static function makeRdn(array $component): string
+ public static function makeRdn(array $component)
{
return implode('=', $component);
}
/**
* Get the underlying value.
+ *
+ * @return string|null
*/
- public function get(): ?string
+ public function get()
{
return $this->value;
}
/**
* Set the underlying value.
+ *
+ * @param string|null $value
+ * @return $this
*/
- public function set(?string $value = null): static
+ public function set($value)
{
$this->value = $value;
@@ -119,13 +163,15 @@ class DistinguishedName implements Stringable
/**
* Get the distinguished name values without attributes.
+ *
+ * @return array
*/
- public function values(): array
+ public function values()
{
$values = [];
foreach ($this->multi() as [, $value]) {
- $values[] = EscapedValue::unescape($value);
+ $values[] = static::unescape($value);
}
return $values;
@@ -133,8 +179,10 @@ class DistinguishedName implements Stringable
/**
* Get the distinguished name attributes without values.
+ *
+ * @return array
*/
- public function attributes(): array
+ public function attributes()
{
$attributes = [];
@@ -147,8 +195,10 @@ class DistinguishedName implements Stringable
/**
* Get the distinguished name components with attributes.
+ *
+ * @return array
*/
- public function components(): array
+ public function components()
{
$components = [];
@@ -157,7 +207,7 @@ class DistinguishedName implements Stringable
// escaped. This cannot be opted out of. Here we will unescape
// the attribute value, then re-escape it to its original
// representation from the server using the "dn" flag.
- $value = $this->escape(EscapedValue::unescape($value))->forDn();
+ $value = $this->escape(static::unescape($value))->dn();
$components[] = static::makeRdn([$attribute, $value]);
}
@@ -167,8 +217,10 @@ class DistinguishedName implements Stringable
/**
* Convert the distinguished name into an associative array.
+ *
+ * @return array
*/
- public function assoc(): array
+ public function assoc()
{
$map = [];
@@ -185,40 +237,52 @@ class DistinguishedName implements Stringable
/**
* Split the RDNs into a multi-dimensional array.
+ *
+ * @return array
*/
- public function multi(): array
+ public function multi()
{
- return array_map(fn ($rdn) => static::explodeRdn($rdn), $this->rdns());
+ return array_map(function ($rdn) {
+ return static::explodeRdn($rdn);
+ }, $this->rdns());
}
/**
* Split the distinguished name into an array of unescaped RDN's.
+ *
+ * @return array
*/
- public function rdns(): array
+ public function rdns()
{
return static::explode($this->value);
}
/**
* Get the first RDNs value.
+ *
+ * @return string|null
*/
- public function name(): ?string
+ public function name()
{
return Arr::first($this->values());
}
/**
* Get the first RDNs attribute.
+ *
+ * @return string|null
*/
- public function head(): ?string
+ public function head()
{
return Arr::first($this->attributes());
}
/**
* Get the relative distinguished name.
+ *
+ * @return string|null
*/
- public function relative(): ?string
+ public function relative()
{
return Arr::first($this->components());
}
@@ -227,16 +291,20 @@ class DistinguishedName implements Stringable
* Alias of relative().
*
* Get the first RDN from the distinguished name.
+ *
+ * @return string|null
*/
- public function first(): ?string
+ public function first()
{
return $this->relative();
}
/**
* Get the parent distinguished name.
+ *
+ * @return string|null
*/
- public function parent(): ?string
+ public function parent()
{
$components = $this->components();
@@ -247,91 +315,112 @@ class DistinguishedName implements Stringable
/**
* Determine if the distinguished name is empty.
+ *
+ * @return bool
*/
- public function isEmpty(): bool
+ public function isEmpty()
{
return empty(
- array_filter(
- array_map('trim', $this->values())
- )
+ array_filter($this->values())
);
}
- /**
- * Determine if the distinguished name is not empty.
- */
- public function isNotEmpty(): bool
- {
- return ! $this->isEmpty();
- }
-
/**
* Determine if the current distinguished name is a parent of the given child.
+ *
+ * @param DistinguishedName $child
+ * @return bool
*/
- public function isParentOf(self $child): bool
+ public function isParentOf(self $child)
{
return $child->isChildOf($this);
}
/**
* Determine if the current distinguished name is a child of the given parent.
+ *
+ * @param DistinguishedName $parent
+ * @return bool
*/
- public function isChildOf(self $parent): bool
+ public function isChildOf(self $parent)
{
- if (! $this->isComparable($this->parent(), $parent->get())) {
+ if (
+ empty($components = $this->components()) ||
+ empty($parentComponents = $parent->components())
+ ) {
return false;
}
- return $this->normalize($this->parent()) === $this->normalize($parent->get());
+ array_shift($components);
+
+ return $this->compare($components, $parentComponents);
}
/**
* Determine if the current distinguished name is an ancestor of the descendant.
+ *
+ * @param DistinguishedName $descendant
+ * @return bool
*/
- public function isAncestorOf(self $descendant): bool
+ public function isAncestorOf(self $descendant)
{
return $descendant->isDescendantOf($this);
}
/**
* Determine if the current distinguished name is a descendant of the ancestor.
+ *
+ * @param DistinguishedName $ancestor
+ * @return bool
*/
- public function isDescendantOf(self $ancestor): bool
+ public function isDescendantOf(self $ancestor)
{
- if (! $this->isComparable($this->parent(), $ancestor->get())) {
+ if (
+ empty($components = $this->components()) ||
+ empty($ancestorComponents = $ancestor->components())
+ ) {
return false;
}
- return str_ends_with(
- $this->normalize($this->parent()),
- $this->normalize($ancestor->get())
- );
- }
-
- /**
- * Determine if the current distinguished name is a sibling of the given distinguished name.
- */
- public function isSiblingOf(self $sibling): bool
- {
- if (! $this->isComparable($this->parent(), $sibling->parent())) {
+ if (! $length = count($components) - count($ancestorComponents)) {
return false;
}
- return $this->normalize($this->parent()) === $this->normalize($sibling->parent());
+ array_splice($components, $offset = 0, $length);
+
+ return $this->compare($components, $ancestorComponents);
}
/**
- * Determine if the distinguished names are comparable.
+ * Compare whether the two distinguished name values are equal.
+ *
+ * @param array $values
+ * @param array $other
+ * @return bool
*/
- protected function isComparable(?string $first, ?string $second): bool
+ protected function compare(array $values, array $other)
{
- return static::make($first)->isNotEmpty() && static::make($second)->isNotEmpty();
+ return $this->recase($values) == $this->recase($other);
+ }
+
+ /**
+ * Recase the array values.
+ *
+ * @param array $values
+ * @return array
+ */
+ protected function recase(array $values)
+ {
+ return array_map([$this, 'normalize'], $values);
}
/**
* Normalize the string value.
+ *
+ * @param string $value
+ * @return string
*/
- protected function normalize(string $value): string
+ protected function normalize($value)
{
return strtolower($value);
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Attributes/DistinguishedNameBuilder.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Attributes/DistinguishedNameBuilder.php
index 7345cb92d..a0d84d828 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Attributes/DistinguishedNameBuilder.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Attributes/DistinguishedNameBuilder.php
@@ -4,53 +4,67 @@ namespace LdapRecord\Models\Attributes;
use LdapRecord\EscapesValues;
use LdapRecord\Support\Arr;
-use Stringable;
-class DistinguishedNameBuilder implements Stringable
+class DistinguishedNameBuilder
{
use EscapesValues;
/**
* The components of the DN.
+ *
+ * @var array
*/
- protected array $components = [];
+ protected $components = [];
/**
* Whether to output the DN in reverse.
+ *
+ * @var bool
*/
- protected bool $reverse = false;
+ protected $reverse = false;
/**
* Constructor.
+ *
+ * @param string|null $value
*/
public function __construct($dn = null)
{
- $this->components = array_map(
- fn ($rdn) => DistinguishedName::explodeRdn($rdn),
- DistinguishedName::make($dn)->components()
- );
+ $this->components = array_map(function ($rdn) {
+ return DistinguishedName::explodeRdn($rdn);
+ }, DistinguishedName::make($dn)->components());
}
/**
* Forward missing method calls onto the Distinguished Name object.
+ *
+ * @param string $method
+ * @param array $args
+ * @return mixed
*/
- public function __call(string $method, array $args): mixed
+ public function __call($method, $args)
{
return $this->get()->{$method}(...$args);
}
/**
* Get the distinguished name value.
+ *
+ * @return string
*/
- public function __toString(): string
+ public function __toString()
{
return (string) $this->get();
}
/**
* Prepend an RDN onto the DN.
+ *
+ * @param string|array $attribute
+ * @param string|null $value
+ * @return $this
*/
- public function prepend(array|string $attribute, ?string $value = null): static
+ public function prepend($attribute, $value = null)
{
array_unshift(
$this->components,
@@ -62,8 +76,12 @@ class DistinguishedNameBuilder implements Stringable
/**
* Append an RDN onto the DN.
+ *
+ * @param string|array $attribute
+ * @param string|null $value
+ * @return $this
*/
- public function append(array|string $attribute, ?string $value = null): static
+ public function append($attribute, $value = null)
{
array_push(
$this->components,
@@ -75,8 +93,12 @@ class DistinguishedNameBuilder implements Stringable
/**
* Componentize the attribute and value.
+ *
+ * @param string|array $attribute
+ * @param string|null $value
+ * @return array
*/
- protected function componentize(array|string $attribute, ?string $value = null): array
+ protected function componentize($attribute, $value = null)
{
// Here we will make the assumption that an array of
// RDN's have been given if the value is null, and
@@ -98,50 +120,65 @@ class DistinguishedNameBuilder implements Stringable
/**
* Make a componentized array by exploding the value if it's a string.
+ *
+ * @param string $value
+ * @return array
*/
- protected function makeComponentizedArray(array|string $value): array
+ protected function makeComponentizedArray($value)
{
return is_array($value) ? $value : DistinguishedName::explodeRdn($value);
}
/**
* Make an appendable component array from the attribute and value.
+ *
+ * @param string|array $attribute
+ * @param string|null $value
+ * @return array
*/
- protected function makeAppendableComponent(string|array $attribute, ?string $value = null): array
+ protected function makeAppendableComponent($attribute, $value = null)
{
- return [trim($attribute), $this->escape(trim($value))->forDn()];
+ return [trim($attribute), $this->escape(trim($value))->dn()];
}
/**
* Pop an RDN off of the end of the DN.
+ *
+ * @param int $amount
+ * @param array $removed
+ * @return $this
*/
- public function pop(int $amount = 1, ?array &$removed = null): static
+ public function pop($amount = 1, &$removed = [])
{
- $removed = array_map(
- fn ($component) => DistinguishedName::makeRdn($component),
- array_splice($this->components, -$amount, $amount)
- );
+ $removed = array_map(function ($component) {
+ return DistinguishedName::makeRdn($component);
+ }, array_splice($this->components, -$amount, $amount));
return $this;
}
/**
* Shift an RDN off of the beginning of the DN.
+ *
+ * @param int $amount
+ * @param array $removed
+ * @return $this
*/
- public function shift(int $amount = 1, ?array &$removed = null): static
+ public function shift($amount = 1, &$removed = [])
{
- $removed = array_map(
- fn ($component) => DistinguishedName::makeRdn($component),
- array_splice($this->components, 0, $amount)
- );
+ $removed = array_map(function ($component) {
+ return DistinguishedName::makeRdn($component);
+ }, array_splice($this->components, 0, $amount));
return $this;
}
/**
* Whether to output the DN in reverse.
+ *
+ * @return $this
*/
- public function reverse(): static
+ public function reverse()
{
$this->reverse = true;
@@ -150,8 +187,11 @@ class DistinguishedNameBuilder implements Stringable
/**
* Get the components of the DN.
+ *
+ * @param null|string $type
+ * @return array
*/
- public function components(?string $type = null): array
+ public function components($type = null)
{
return is_null($type)
? $this->components
@@ -160,36 +200,42 @@ class DistinguishedNameBuilder implements Stringable
/**
* Get the components of a particular type.
+ *
+ * @param string $type
+ * @return array
*/
- protected function componentsOfType(string $type): array
+ protected function componentsOfType($type)
{
- $components = array_filter($this->components, fn ($component) => (
- ([$name] = $component) && strtolower($name) === strtolower($type)
- ));
+ $components = array_filter($this->components, function ($component) use ($type) {
+ return ([$name] = $component) && strtolower($name) === strtolower($type);
+ });
return array_values($components);
}
/**
* Get the fully qualified DN.
+ *
+ * @return DistinguishedName
*/
- public function get(): DistinguishedName
+ public function get()
{
return new DistinguishedName($this->build());
}
/**
* Build the distinguished name from the components.
+ *
+ * @return string
*/
- protected function build(): string
+ protected function build()
{
$components = $this->reverse
? array_reverse($this->components)
: $this->components;
- return implode(',', array_map(
- fn ($component) => DistinguishedName::makeRdn($component),
- $components
- ));
+ return implode(',', array_map(function ($component) {
+ return DistinguishedName::makeRdn($component);
+ }, $components));
}
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Attributes/EscapedValue.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Attributes/EscapedValue.php
index c28d95c20..3c9d4db0a 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Attributes/EscapedValue.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Attributes/EscapedValue.php
@@ -2,75 +2,80 @@
namespace LdapRecord\Models\Attributes;
-use Stringable;
-
-class EscapedValue implements Stringable
+class EscapedValue
{
/**
* The value to be escaped.
+ *
+ * @var string
*/
- protected mixed $value;
+ protected $value;
/**
* The characters to ignore when escaping.
+ *
+ * @var string
*/
- protected string $ignore;
+ protected $ignore;
/**
* The escape flags.
+ *
+ * @var int
*/
- protected int $flags;
+ protected $flags;
/**
* Constructor.
+ *
+ * @param string $value
+ * @param string $ignore
+ * @param int $flags
*/
- public function __construct(mixed $value, string $ignore = '', int $flags = 0)
+ public function __construct($value, $ignore = '', $flags = 0)
{
- $this->value = $value;
+ $this->value = (string) $value;
$this->ignore = $ignore;
$this->flags = $flags;
}
/**
- * Un-escapes a hexadecimal string into its original string representation.
+ * Get the escaped value.
+ *
+ * @return string
*/
- public static function unescape(string $value): string
+ public function __toString()
{
- return preg_replace_callback(
- '/\\\([0-9A-Fa-f]{2})/',
- fn ($matches) => chr(hexdec($matches[1])),
- $value
- );
+ return (string) $this->get();
}
/**
* Get the escaped value.
+ *
+ * @return mixed
*/
- public function __toString(): string
+ public function get()
{
- return $this->get();
- }
-
- /**
- * Get the escaped value.
- */
- public function get(): string
- {
- return ldap_escape((string) $this->value, $this->ignore, $this->flags);
+ return ldap_escape($this->value, $this->ignore, $this->flags);
}
/**
* Get the raw (unescaped) value.
+ *
+ * @return mixed
*/
- public function getRaw(): mixed
+ public function raw()
{
return $this->value;
}
/**
* Set the characters to exclude from being escaped.
+ *
+ * @param string $characters
+ * @return $this
*/
- public function ignore(string $characters): static
+ public function ignore($characters)
{
$this->ignore = $characters;
@@ -79,8 +84,10 @@ class EscapedValue implements Stringable
/**
* Prepare the value to be escaped for use in a distinguished name.
+ *
+ * @return $this
*/
- public function forDn(): static
+ public function dn()
{
$this->flags = LDAP_ESCAPE_DN;
@@ -89,8 +96,10 @@ class EscapedValue implements Stringable
/**
* Prepare the value to be escaped for use in a filter.
+ *
+ * @return $this
*/
- public function forFilter(): static
+ public function filter()
{
$this->flags = LDAP_ESCAPE_FILTER;
@@ -99,8 +108,10 @@ class EscapedValue implements Stringable
/**
* Prepare the value to be escaped for use in a distinguished name and filter.
+ *
+ * @return $this
*/
- public function forDnAndFilter(): static
+ public function both()
{
$this->flags = LDAP_ESCAPE_FILTER + LDAP_ESCAPE_DN;
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Attributes/Guid.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Attributes/Guid.php
index dfde16429..e04b5cd3f 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Attributes/Guid.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Attributes/Guid.php
@@ -3,14 +3,33 @@
namespace LdapRecord\Models\Attributes;
use InvalidArgumentException;
-use Stringable;
+use LdapRecord\Utilities;
-class Guid implements Stringable
+class Guid
{
/**
* The string GUID value.
+ *
+ * @var string
*/
- protected ?string $value = null;
+ protected $value;
+
+ /**
+ * The guid structure in order by section to parse using substr().
+ *
+ * @author Chad Sikorra
+ *
+ * @see https://github.com/ldaptools/ldaptools
+ *
+ * @var array
+ */
+ protected $guidSections = [
+ [[-26, 2], [-28, 2], [-30, 2], [-32, 2]],
+ [[-22, 2], [-24, 2]],
+ [[-18, 2], [-20, 2]],
+ [[-16, 4]],
+ [[-12, 12]],
+ ];
/**
* The hexadecimal octet order based on string position.
@@ -18,8 +37,10 @@ class Guid implements Stringable
* @author Chad Sikorra
*
* @see https://github.com/ldaptools/ldaptools
+ *
+ * @var array
*/
- protected array $octetSections = [
+ protected $octetSections = [
[6, 4, 2, 0],
[10, 8],
[14, 12],
@@ -27,19 +48,24 @@ class Guid implements Stringable
];
/**
- * Determine if the specified GUID is valid.
+ * Determines if the specified GUID is valid.
+ *
+ * @param string $guid
+ * @return bool
*/
- public static function isValid(string $guid): bool
+ public static function isValid($guid)
{
- return (bool) preg_match('/^([0-9a-fA-F]){8}(-([0-9a-fA-F]){4}){3}-([0-9a-fA-F]){12}$/', $guid);
+ return Utilities::isValidGuid($guid);
}
/**
* Constructor.
*
+ * @param mixed $value
+ *
* @throws InvalidArgumentException
*/
- public function __construct(string $value)
+ public function __construct($value)
{
if (static::isValid($value)) {
$this->value = $value;
@@ -51,83 +77,66 @@ class Guid implements Stringable
}
/**
- * Get the string value of the GUID.
+ * Returns the string value of the GUID.
+ *
+ * @return string
*/
- public function __toString(): string
+ public function __toString()
{
return $this->getValue();
}
/**
- * Get the string value of the GUID.
+ * Returns the string value of the SID.
+ *
+ * @return string
*/
- public function getValue(): string
+ public function getValue()
{
return $this->value;
}
/**
* Get the binary representation of the GUID string.
+ *
+ * @return string
*/
- public function getBinary(): string
+ public function getBinary()
{
return hex2bin($this->getHex());
}
- /**
- * Get the encoded hexadecimal representation of the GUID string.
- */
- public function getEncodedHex(): string
- {
- return '\\'.implode('\\', str_split($this->getHex(), 2));
- }
-
/**
* Get the hexadecimal representation of the GUID string.
+ *
+ * @return string
*/
- public function getHex(): string
+ public function getHex()
{
- return implode($this->getOctetSections());
- }
-
- /**
- * Get the octect sections of the GUID.
- */
- protected function getOctetSections(): array
- {
- $sections = [];
+ $data = '';
$guid = str_replace('-', '', $this->value);
foreach ($this->octetSections as $section) {
- $sections[] = $this->parseSection($guid, $section, true);
+ $data .= $this->parseSection($guid, $section, $octet = true);
}
- return $sections;
+ return $data;
}
/**
- * Get the string variant of a binary GUID.
+ * Returns the string variant of a binary GUID.
+ *
+ * @param string $binary
+ * @return string|null
*/
- protected function binaryGuidToString(string $binary): ?string
+ protected function binaryGuidToString($binary)
{
- if (trim($binary) === '') {
- return null;
- }
-
- $hex = unpack('H*hex', $binary)['hex'];
-
- $hex1 = substr($hex, -26, 2).substr($hex, -28, 2).substr($hex, -30, 2).substr($hex, -32, 2);
- $hex2 = substr($hex, -22, 2).substr($hex, -24, 2);
- $hex3 = substr($hex, -18, 2).substr($hex, -20, 2);
- $hex4 = substr($hex, -16, 4);
- $hex5 = substr($hex, -12, 12);
-
- return sprintf('%s-%s-%s-%s-%s', $hex1, $hex2, $hex3, $hex4, $hex5);
+ return Utilities::binaryGuidToString($binary);
}
/**
- * Get the specified section of the hexadecimal string.
+ * Return the specified section of the hexadecimal string.
*
* @author Chad Sikorra
*
@@ -138,7 +147,7 @@ class Guid implements Stringable
* @param bool $octet Whether this is for octet string form.
* @return string The concatenated sections in upper-case.
*/
- protected function parseSection(string $hex, array $sections, bool $octet = false): string
+ protected function parseSection($hex, array $sections, $octet = false)
{
$parsedString = '';
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Attributes/MbString.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Attributes/MbString.php
index c6eb4985e..72d4c6f48 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Attributes/MbString.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Attributes/MbString.php
@@ -6,8 +6,11 @@ class MbString
{
/**
* Get the integer value of a specific character.
+ *
+ * @param $string
+ * @return int
*/
- public static function ord(string $string): int
+ public static function ord($string)
{
if (static::isLoaded()) {
$result = unpack('N', mb_convert_encoding($string, 'UCS-4BE', 'UTF-8'));
@@ -22,8 +25,11 @@ class MbString
/**
* Get the character for a specific integer value.
+ *
+ * @param $int
+ * @return string
*/
- public static function chr(int $int): string
+ public static function chr($int)
{
if (static::isLoaded()) {
return mb_convert_encoding(pack('n', $int), 'UTF-8', 'UTF-16BE');
@@ -34,28 +40,36 @@ class MbString
/**
* Split a string into its individual characters and return it as an array.
+ *
+ * @param string $value
+ * @return string[]
*/
- public static function split(string $value): array
+ public static function split($value)
{
return preg_split('/(? ['$1$', 12],
- static::CRYPT_SALT_TYPE_SHA256 => ['$5$', 16],
- static::CRYPT_SALT_TYPE_SHA512 => ['$6$', 16],
- default => throw new InvalidArgumentException("Invalid crypt type [$type]."),
- };
+ switch ($type) {
+ case static::CRYPT_SALT_TYPE_MD5:
+ return ['$1$', 12];
+ case static::CRYPT_SALT_TYPE_SHA256:
+ return ['$5$', 16];
+ case static::CRYPT_SALT_TYPE_SHA512:
+ return ['$6$', 16];
+ default:
+ throw new InvalidArgumentException("Invalid crypt type [$type].");
+ }
}
/**
* Attempt to retrieve the hash method used for the password.
+ *
+ * @param string $password
+ * @return string|void
*/
- public static function getHashMethod(string $password): ?string
+ public static function getHashMethod($password)
{
if (! preg_match('/^\{(\w+)\}/', $password, $matches)) {
- return null;
+ return;
}
return $matches[1];
@@ -198,11 +272,14 @@ class Password
/**
* Attempt to retrieve the hash method and algorithm used for the password.
+ *
+ * @param string $password
+ * @return array|void
*/
- public static function getHashMethodAndAlgo(string $password): ?array
+ public static function getHashMethodAndAlgo($password)
{
if (! preg_match('/^\{(\w+)\}\$([0-9a-z]{1})\$/', $password, $matches)) {
- return null;
+ return;
}
return [$matches[1], $matches[2]];
@@ -211,9 +288,11 @@ class Password
/**
* Attempt to retrieve a salt from the encrypted password.
*
+ * @return string
+ *
* @throws LdapRecordException
*/
- public static function getSalt(string $encryptedPassword): string
+ public static function getSalt($encryptedPassword)
{
// crypt() methods.
if (preg_match('/^\{(\w+)\}(\$.*\$).*$/', $encryptedPassword, $matches)) {
@@ -231,9 +310,12 @@ class Password
/**
* Determine if the hash method requires a salt to be given.
*
+ * @param string $method
+ * @return bool
+ *
* @throws \ReflectionException
*/
- public static function hashMethodRequiresSalt(string $method): bool
+ public static function hashMethodRequiresSalt($method): bool
{
$parameters = (new ReflectionMethod(static::class, $method))->getParameters();
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Attributes/Sid.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Attributes/Sid.php
index 08c36267c..7760453ce 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Attributes/Sid.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Attributes/Sid.php
@@ -3,29 +3,36 @@
namespace LdapRecord\Models\Attributes;
use InvalidArgumentException;
-use Stringable;
+use LdapRecord\Utilities;
-class Sid implements Stringable
+class Sid
{
/**
* The string SID value.
+ *
+ * @var string
*/
- protected string $value;
+ protected $value;
/**
- * Determine if the specified SID is valid.
+ * Determines if the specified SID is valid.
+ *
+ * @param string $sid
+ * @return bool
*/
- public static function isValid(string $sid): bool
+ public static function isValid($sid)
{
- return (bool) preg_match("/^S-\d(-\d{1,10}){1,16}$/i", $sid);
+ return Utilities::isValidSid($sid);
}
/**
* Constructor.
*
+ * @param mixed $value
+ *
* @throws InvalidArgumentException
*/
- public function __construct(string $value)
+ public function __construct($value)
{
if (static::isValid($value)) {
$this->value = $value;
@@ -37,25 +44,31 @@ class Sid implements Stringable
}
/**
- * Get the string value of the SID.
+ * Returns the string value of the SID.
+ *
+ * @return string
*/
- public function __toString(): string
+ public function __toString()
{
return $this->getValue();
}
/**
- * Get the string value of the SID.
+ * Returns the string value of the SID.
+ *
+ * @return string
*/
- public function getValue(): string
+ public function getValue()
{
return $this->value;
}
/**
- * Get the binary variant of the SID.
+ * Returns the binary variant of the SID.
+ *
+ * @return string
*/
- public function getBinary(): string
+ public function getBinary()
{
$sid = explode('-', ltrim($this->value, 'S-'));
@@ -74,50 +87,13 @@ class Sid implements Stringable
}
/**
- * Get the string variant of a binary SID.
+ * Returns the string variant of a binary SID.
+ *
+ * @param string $binary
+ * @return string|null
*/
- protected function binarySidToString(string $binary): ?string
+ protected function binarySidToString($binary)
{
- if (trim($binary) === '') {
- return null;
- }
-
- // Revision - 8bit unsigned int (C1)
- // Count - 8bit unsigned int (C1)
- // 2 null bytes
- // ID - 32bit unsigned long, big-endian order
- $sid = @unpack('C1rev/C1count/x2/N1id', $binary);
-
- if (! isset($sid['id']) || ! isset($sid['rev'])) {
- return null;
- }
-
- $revisionLevel = $sid['rev'];
-
- $identifierAuthority = $sid['id'];
-
- $subs = $sid['count'] ?? 0;
-
- $sidHex = $subs ? bin2hex($binary) : '';
-
- $subAuthorities = [];
-
- // The sub-authorities depend on the count, so only get as
- // many as the count, regardless of data beyond it.
- for ($i = 0; $i < $subs; $i++) {
- $data = implode(array_reverse(
- str_split(
- substr($sidHex, 16 + ($i * 8), 8),
- 2
- )
- ));
-
- $subAuthorities[] = hexdec($data);
- }
-
- // Tack on the 'S-' and glue it all together...
- return 'S-'.$revisionLevel.'-'.$identifierAuthority.implode(
- preg_filter('/^/', '-', $subAuthorities)
- );
+ return Utilities::binarySidToString($binary);
}
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Attributes/TSProperty.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Attributes/TSProperty.php
index dd2d0ebda..499579f82 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Attributes/TSProperty.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Attributes/TSProperty.php
@@ -29,8 +29,10 @@ class TSProperty
* cannot find any information on them in Microsoft documentation. However, their values appear to stay in sync with
* their non 'W' counterparts. But not doing so when manipulating the data manually does not seem to affect anything.
* This probably needs more investigation.
+ *
+ * @var array
*/
- protected array $propTypes = [
+ protected $propTypes = [
'string' => [
'CtxWFHomeDir',
'CtxWFHomeDirW',
@@ -61,23 +63,31 @@ class TSProperty
/**
* The property name.
+ *
+ * @var string
*/
- protected ?string $name = null;
+ protected $name;
/**
* The property value.
+ *
+ * @var string|int
*/
- protected string|int|null $value = null;
+ protected $value;
/**
* The property value type.
+ *
+ * @var int
*/
- protected int $valueType = 1;
+ protected $valueType = 1;
/**
* Pass binary TSProperty data to construct its object representation.
+ *
+ * @param string|null $value
*/
- public function __construct(string|int|null $value = null)
+ public function __construct($value = null)
{
if ($value) {
$this->decode(bin2hex($value));
@@ -86,8 +96,11 @@ class TSProperty
/**
* Set the name for the TSProperty.
+ *
+ * @param string $name
+ * @return TSProperty
*/
- public function setName(string $name): static
+ public function setName($name)
{
$this->name = $name;
@@ -96,16 +109,21 @@ class TSProperty
/**
* Get the name for the TSProperty.
+ *
+ * @return string
*/
- public function getName(): ?string
+ public function getName()
{
return $this->name;
}
/**
* Set the value for the TSProperty.
+ *
+ * @param string|int $value
+ * @return TSProperty
*/
- public function setValue(string|int $value): static
+ public function setValue($value)
{
$this->value = $value;
@@ -114,8 +132,10 @@ class TSProperty
/**
* Get the value for the TSProperty.
+ *
+ * @return string|int
*/
- public function getValue(): string|int|null
+ public function getValue()
{
return $this->value;
}
@@ -123,8 +143,10 @@ class TSProperty
/**
* Convert the TSProperty name/value back to its binary
* representation for the userParameters blob.
+ *
+ * @return string
*/
- public function toBinary(): string
+ public function toBinary()
{
$name = bin2hex($this->name);
@@ -144,8 +166,10 @@ class TSProperty
/**
* Given a TSProperty blob, decode the name/value/type/etc.
+ *
+ * @param string $tsProperty
*/
- protected function decode(string $tsProperty): void
+ protected function decode($tsProperty)
{
$nameLength = hexdec(substr($tsProperty, 0, 2));
@@ -159,8 +183,12 @@ class TSProperty
/**
* Based on the property name/value in question, get its encoded form.
+ *
+ * @param string $propName
+ * @param string|int $propValue
+ * @return string
*/
- protected function getEncodedValueForProp(string $propName, string|int $propValue): string
+ protected function getEncodedValueForProp($propName, $propValue)
{
if (in_array($propName, $this->propTypes['string'])) {
// Simple strings are null terminated. Unsure if this is
@@ -178,8 +206,12 @@ class TSProperty
/**
* Based on the property name in question, get its actual value from the binary blob value.
+ *
+ * @param string $propName
+ * @param string $propValue
+ * @return string|int
*/
- protected function getDecodedValueForProp(string $propName, string $propValue): string|int
+ protected function getDecodedValueForProp($propName, $propValue)
{
if (in_array($propName, $this->propTypes['string'])) {
// Strip away null terminators. I think this should
@@ -202,9 +234,11 @@ class TSProperty
* Decode the property by inspecting the nibbles of each blob, checking
* the control, and adding up the results into a final value.
*
- * @param bool $string Whether this is simple string data.
+ * @param string $hex
+ * @param bool $string Whether or not this is simple string data.
+ * @return string
*/
- protected function decodePropValue(string $hex, bool $string = false): string
+ protected function decodePropValue($hex, $string = false)
{
$decodePropValue = '';
@@ -232,8 +266,12 @@ class TSProperty
/**
* Get the encoded property value as a binary blob.
+ *
+ * @param string $value
+ * @param bool $string
+ * @return string
*/
- protected function encodePropValue(string $value, bool $string = false): string
+ protected function encodePropValue($value, $string = false)
{
// An int must be properly padded. (then split and reversed).
// For a string, we just split the chars. This seems
@@ -269,8 +307,12 @@ class TSProperty
* PHP's pack() function has no 'b' or 'B' template. This is
* a workaround that turns a literal bit-string into a
* packed byte-string with 8 bits per byte.
+ *
+ * @param string $bits
+ * @param bool $len
+ * @return string
*/
- protected function packBitString(string $bits, int $len): string
+ protected function packBitString($bits, $len)
{
$bits = substr($bits, 0, $len);
// Pad input with zeros to next multiple of 4 above $len
@@ -287,8 +329,12 @@ class TSProperty
/**
* Based on the control, adjust the nibble accordingly.
+ *
+ * @param string $nibble
+ * @param string $control
+ * @return string
*/
- protected function nibbleControl(string $nibble, string $control): string
+ protected function nibbleControl($nibble, $control)
{
// This control stays constant for the low/high nibbles,
// so it doesn't matter which we compare to
@@ -309,8 +355,10 @@ class TSProperty
* must be subtracted by 9 before the final value is constructed.
*
* @param string $nibbleType Either X or Y
+ * @param string $nibble
+ * @return string
*/
- protected function getNibbleWithControl(string $nibbleType, string $nibble): string
+ protected function getNibbleWithControl($nibbleType, $nibble)
{
$dec = bindec($nibble);
@@ -327,9 +375,11 @@ class TSProperty
/**
* Need to make sure hex values are always an even length, so pad as needed.
*
+ * @param int $int
* @param int $padLength The hex string must be padded to this length (with zeros).
+ * @return string
*/
- protected function dec2hex(int $int, int $padLength = 2): string
+ protected function dec2hex($int, $padLength = 2)
{
return str_pad(dechex($int), $padLength, 0, STR_PAD_LEFT);
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Attributes/TSPropertyArray.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Attributes/TSPropertyArray.php
index a81018143..8320dd8ed 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Attributes/TSPropertyArray.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Attributes/TSPropertyArray.php
@@ -36,31 +36,33 @@ class TSPropertyArray
];
/**
- * The default data that occurs before the TSPropertyArray (CtxCfgPresent with a bunch of spaces...?).
+ * @var string The default data that occurs before the TSPropertyArray (CtxCfgPresent with a bunch of spaces...?)
*/
- protected string $defaultPreBinary = '43747843666750726573656e742020202020202020202020202020202020202020202020202020202020202020202020';
+ protected $defaultPreBinary = '43747843666750726573656e742020202020202020202020202020202020202020202020202020202020202020202020';
/**
- * The TSProperty array.
- *
* @var TSProperty[]
*/
- protected array $tsProperty = [];
+ protected $tsProperty = [];
/**
- * The TSProperty signature.
+ * @var string
*/
- protected string $signature = self::VALID_SIGNATURE;
+ protected $signature = self::VALID_SIGNATURE;
/**
* Binary data that occurs before the TSPropertyArray data in userParameters.
+ *
+ * @var string
*/
- protected string $preBinary = '';
+ protected $preBinary = '';
/**
* Binary data that occurs after the TSPropertyArray data in userParameters.
+ *
+ * @var string
*/
- protected string $postBinary = '';
+ protected $postBinary = '';
/**
* Construct in one of the following ways:.
@@ -68,8 +70,10 @@ class TSPropertyArray
* - Pass an array of TSProperty key => value pairs (See DEFAULTS constant).
* - Pass the userParameters binary value. The object representation of that will be decoded and constructed.
* - Pass nothing and a default set of TSProperty key => value pairs will be used (See DEFAULTS constant).
+ *
+ * @param mixed $tsPropertyArray
*/
- public function __construct(mixed $tsPropertyArray = null)
+ public function __construct($tsPropertyArray = null)
{
$this->preBinary = hex2bin($this->defaultPreBinary);
@@ -77,7 +81,7 @@ class TSPropertyArray
$tsPropertyArray = $tsPropertyArray ?: self::DEFAULTS;
foreach ($tsPropertyArray as $key => $value) {
- $tsProperty = new TSProperty;
+ $tsProperty = new TSProperty();
$this->tsProperty[$key] = $tsProperty->setName($key)->setValue($value);
}
@@ -88,16 +92,22 @@ class TSPropertyArray
/**
* Check if a specific TSProperty exists by its property name.
+ *
+ * @param string $propName
+ * @return bool
*/
- public function has(string $propName): bool
+ public function has($propName)
{
return array_key_exists(strtolower($propName), array_change_key_case($this->tsProperty));
}
/**
* Get a TSProperty object by its property name (ie. CtxWFProfilePath).
+ *
+ * @param string $propName
+ * @return TSProperty
*/
- public function get(string $propName): TSProperty
+ public function get($propName)
{
$this->validateProp($propName);
@@ -106,8 +116,11 @@ class TSPropertyArray
/**
* Add a TSProperty object. If it already exists, it will be overwritten.
+ *
+ * @param TSProperty $tsProperty
+ * @return $this
*/
- public function add(TSProperty $tsProperty): static
+ public function add(TSProperty $tsProperty)
{
$this->tsProperty[$tsProperty->getName()] = $tsProperty;
@@ -115,9 +128,12 @@ class TSPropertyArray
}
/**
- * Remove a TSProperty by its property name (i.e. CtxMinEncryptionLevel).
+ * Remove a TSProperty by its property name (ie. CtxMinEncryptionLevel).
+ *
+ * @param string $propName
+ * @return $this
*/
- public function remove(string $propName): static
+ public function remove($propName)
{
foreach (array_keys($this->tsProperty) as $property) {
if (strtolower($propName) == strtolower($property)) {
@@ -130,8 +146,12 @@ class TSPropertyArray
/**
* Set the value for a specific TSProperty by its name.
+ *
+ * @param string $propName
+ * @param mixed $propValue
+ * @return $this
*/
- public function set(string $propName, string|int $propValue): static
+ public function set($propName, $propValue)
{
$this->validateProp($propName);
@@ -142,8 +162,10 @@ class TSPropertyArray
/**
* Get the full binary representation of the userParameters containing the TSPropertyArray data.
+ *
+ * @return string
*/
- public function toBinary(): string
+ public function toBinary()
{
$binary = $this->preBinary;
@@ -160,8 +182,10 @@ class TSPropertyArray
/**
* Get a simple associative array containing of all TSProperty names and values.
+ *
+ * @return array
*/
- public function toArray(): array
+ public function toArray()
{
$userParameters = [];
@@ -177,15 +201,17 @@ class TSPropertyArray
*
* @return TSProperty[]
*/
- public function getTSProperties(): array
+ public function getTSProperties()
{
return $this->tsProperty;
}
/**
* Validates that the given property name exists.
+ *
+ * @param string $propName
*/
- protected function validateProp(string $propName): void
+ protected function validateProp($propName)
{
if (! $this->has($propName)) {
throw new InvalidArgumentException(sprintf('TSProperty for "%s" does not exist.', $propName));
@@ -193,17 +219,21 @@ class TSPropertyArray
}
/**
- * Get the TS property object for the given property.
+ * @param string $propName
+ * @return TSProperty
*/
- protected function getTsPropObj(string $propName): TSProperty
+ protected function getTsPropObj($propName)
{
return array_change_key_case($this->tsProperty)[strtolower($propName)];
}
/**
- * Get an associative array with all the userParameters property names and values.
+ * Get an associative array with all of the userParameters property names and values.
+ *
+ * @param string $userParameters
+ * @return void
*/
- protected function decodeUserParameters(string $userParameters): void
+ protected function decodeUserParameters($userParameters)
{
$userParameters = bin2hex($userParameters);
@@ -233,9 +263,11 @@ class TSPropertyArray
* individual TSProperty structures. Return the full length
* of the TSPropertyArray data.
*
+ * @param string $tsPropertyArray
+ * @param int $tsPropCount
* @return int The length of the data in the TSPropertyArray
*/
- protected function addTSPropData(string $tsPropertyArray, int $tsPropCount): int
+ protected function addTSPropData($tsPropertyArray, $tsPropCount)
{
$length = 0;
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Attributes/Timestamp.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Attributes/Timestamp.php
index 4046eb715..0f07bc5a0 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Attributes/Timestamp.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Attributes/Timestamp.php
@@ -7,37 +7,38 @@ use Carbon\CarbonInterface;
use DateTime;
use DateTimeZone;
use LdapRecord\LdapRecordException;
+use LdapRecord\Utilities;
class Timestamp
{
- public const TYPE_LDAP = 'ldap';
-
- public const TYPE_WINDOWS = 'windows';
-
- public const TYPE_WINDOWS_INT = 'windows-int';
-
public const WINDOWS_INT_MAX = 9223372036854775807;
/**
* The current timestamp type.
+ *
+ * @var string
*/
- protected string $type;
+ protected $type;
/**
* The available timestamp types.
+ *
+ * @var array
*/
- protected array $types = [
- Timestamp::TYPE_LDAP,
- Timestamp::TYPE_WINDOWS,
- Timestamp::TYPE_WINDOWS_INT,
+ protected $types = [
+ 'ldap',
+ 'windows',
+ 'windows-int',
];
/**
* Constructor.
*
+ * @param string $type
+ *
* @throws LdapRecordException
*/
- public function __construct(string $type)
+ public function __construct($type)
{
$this->setType($type);
}
@@ -45,9 +46,11 @@ class Timestamp
/**
* Set the type of timestamp to convert from / to.
*
+ * @param string $type
+ *
* @throws LdapRecordException
*/
- public function setType(string $type): void
+ public function setType($type)
{
if (! in_array($type, $this->types)) {
throw new LdapRecordException("Unrecognized LDAP date type [$type]");
@@ -59,15 +62,18 @@ class Timestamp
/**
* Converts the value to an LDAP date string.
*
+ * @param mixed $value
+ * @return float|string
+ *
* @throws LdapRecordException
*/
- public function fromDateTime(mixed $value): int|string
+ public function fromDateTime($value)
{
$value = is_array($value) ? reset($value) : $value;
- // If the value is being converted to a windows integer format, but it
+ // If the value is being converted to a windows integer format but it
// is already in that format, we will simply return the value back.
- if ($this->type === Timestamp::TYPE_WINDOWS_INT && $this->valueIsWindowsIntegerType($value)) {
+ if ($this->type == 'windows-int' && $this->valueIsWindowsIntegerType($value)) {
return $value;
}
// If the value is numeric, we will assume it's a UNIX timestamp.
@@ -83,18 +89,30 @@ class Timestamp
$value = Carbon::instance($value);
}
- return match ($this->type) {
- Timestamp::TYPE_LDAP => $this->convertDateTimeToLdapTime($value),
- Timestamp::TYPE_WINDOWS => $this->convertDateTimeToWindows($value),
- Timestamp::TYPE_WINDOWS_INT => $this->convertDateTimeToWindowsInteger($value),
- default => throw new LdapRecordException("Unrecognized date type [{$this->type}]"),
- };
+ switch ($this->type) {
+ case 'ldap':
+ $value = $this->convertDateTimeToLdapTime($value);
+ break;
+ case 'windows':
+ $value = $this->convertDateTimeToWindows($value);
+ break;
+ case 'windows-int':
+ $value = $this->convertDateTimeToWindowsInteger($value);
+ break;
+ default:
+ throw new LdapRecordException("Unrecognized date type [{$this->type}]");
+ }
+
+ return $value;
}
/**
* Determine if the value given is in Windows Integer (NTFS Filetime) format.
+ *
+ * @param int|string $value
+ * @return bool
*/
- protected function valueIsWindowsIntegerType(mixed $value): bool
+ protected function valueIsWindowsIntegerType($value)
{
return is_numeric($value) && in_array(strlen((string) $value), [18, 19]);
}
@@ -102,9 +120,12 @@ class Timestamp
/**
* Converts the LDAP timestamp value to a Carbon instance.
*
+ * @param mixed $value
+ * @return Carbon|int|false
+ *
* @throws LdapRecordException
*/
- public function toDateTime(mixed $value): Carbon|int|false
+ public function toDateTime($value)
{
$value = is_array($value) ? reset($value) : $value;
@@ -112,70 +133,87 @@ class Timestamp
return Carbon::instance($value);
}
- $value = match ($this->type) {
- Timestamp::TYPE_LDAP => $this->convertLdapTimeToDateTime($value),
- Timestamp::TYPE_WINDOWS => $this->convertWindowsTimeToDateTime($value),
- Timestamp::TYPE_WINDOWS_INT => $this->convertWindowsIntegerTimeToDateTime($value),
- default => throw new LdapRecordException("Unrecognized date type [{$this->type}]"),
- };
+ switch ($this->type) {
+ case 'ldap':
+ $value = $this->convertLdapTimeToDateTime($value);
+ break;
+ case 'windows':
+ $value = $this->convertWindowsTimeToDateTime($value);
+ break;
+ case 'windows-int':
+ $value = $this->convertWindowsIntegerTimeToDateTime($value);
+ break;
+ default:
+ throw new LdapRecordException("Unrecognized date type [{$this->type}]");
+ }
return $value instanceof DateTime ? Carbon::instance($value) : $value;
}
/**
* Converts standard LDAP timestamps to a date time object.
+ *
+ * @param string $value
+ * @return DateTime|false
*/
- protected function convertLdapTimeToDateTime(string $value): DateTime|false
+ protected function convertLdapTimeToDateTime($value)
{
- return DateTime::createFromFormat(match (true) {
- str_ends_with($value, '.000Z') => 'YmdHis.000\Z',
- str_ends_with($value, '.0Z') => 'YmdHis.0\Z',
- str_ends_with($value, 'Z') => 'YmdHis\Z',
- default => 'YmdHisT',
- }, $value);
+ return DateTime::createFromFormat(
+ str_contains((string) $value, 'Z') ? 'YmdHis\Z' : 'YmdHisT',
+ $value
+ );
}
/**
* Converts date objects to a standard LDAP timestamp.
+ *
+ * @param DateTime $date
+ * @return string
*/
- protected function convertDateTimeToLdapTime(DateTime $date): string
+ protected function convertDateTimeToLdapTime(DateTime $date)
{
return $date->format(
- $date->getOffset() == 0
- ? 'YmdHis\Z'
- : 'YmdHisO'
+ $date->getOffset() == 0 ? 'YmdHis\Z' : 'YmdHisO'
);
}
/**
* Converts standard windows timestamps to a date time object.
+ *
+ * @param string $value
+ * @return DateTime|false
*/
- protected function convertWindowsTimeToDateTime(string $value): DateTime|false
+ protected function convertWindowsTimeToDateTime($value)
{
- return DateTime::createFromFormat(match (true) {
- str_ends_with($value, '.0Z') => 'YmdHis.0\Z',
- default => 'YmdHis.0T'
- }, $value, new DateTimeZone('UTC'));
+ return DateTime::createFromFormat(
+ str_contains((string) $value, '0Z') ? 'YmdHis.0\Z' : 'YmdHis.0T',
+ $value,
+ new DateTimeZone('UTC')
+ );
}
/**
* Converts date objects to a windows timestamp.
+ *
+ * @param DateTime $date
+ * @return string
*/
- protected function convertDateTimeToWindows(DateTime $date): string
+ protected function convertDateTimeToWindows(DateTime $date)
{
return $date->format(
- $date->getOffset() == 0
- ? 'YmdHis.0\Z'
- : 'YmdHis.0O'
+ $date->getOffset() == 0 ? 'YmdHis.0\Z' : 'YmdHis.0O'
);
}
/**
* Converts standard windows integer dates to a date time object.
*
+ * @param int $value
+ * @return DateTime|int|false
+ *
* @throws \Exception
*/
- protected function convertWindowsIntegerTimeToDateTime(string|int|null $value = null): DateTime|int|false
+ protected function convertWindowsIntegerTimeToDateTime($value)
{
if (is_null($value) || $value === '') {
return false;
@@ -189,16 +227,19 @@ class Timestamp
return (int) $value;
}
- return (new DateTime)->setTimestamp(
- (int) ($value / 10000000) - 11644473600
+ return (new DateTime())->setTimestamp(
+ Utilities::convertWindowsTimeToUnixTime($value)
);
}
/**
* Converts date objects to a windows integer timestamp.
+ *
+ * @param DateTime $date
+ * @return float
*/
- protected function convertDateTimeToWindowsInteger(DateTime $date): int
+ protected function convertDateTimeToWindowsInteger(DateTime $date)
{
- return ($date->getTimestamp() + 11644473600) * 10000000;
+ return Utilities::convertUnixTimeToWindowsTime($date->getTimestamp());
}
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/BatchModification.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/BatchModification.php
index 3b153095d..954c58fcf 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/BatchModification.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/BatchModification.php
@@ -9,56 +9,61 @@ class BatchModification
use DetectsResetIntegers;
/**
- * The array key identifiers.
+ * The array keys to be used in batch modifications.
*/
public const KEY_ATTRIB = 'attrib';
-
public const KEY_MODTYPE = 'modtype';
-
public const KEY_VALUES = 'values';
/**
* The attribute of the modification.
+ *
+ * @var string|null
*/
- protected ?string $attribute = null;
+ protected $attribute;
/**
* The original value of the attribute before modification.
+ *
+ * @var array
*/
- protected array $original = [];
+ protected $original = [];
/**
* The values of the modification.
+ *
+ * @var array
*/
- protected array $values = [];
+ protected $values = [];
/**
* The modtype integer of the batch modification.
+ *
+ * @var int|null
*/
- protected ?int $type = null;
+ protected $type;
/**
* Constructor.
+ *
+ * @param string|null $attribute
+ * @param string|int|null $type
+ * @param array $values
*/
- public function __construct(?string $attribute = null, ?int $type = null, array $values = [])
+ public function __construct($attribute = null, $type = null, array $values = [])
{
$this->setAttribute($attribute)
->setType($type)
->setValues($values);
}
- /**
- * Make a new batch modification instance.
- */
- public static function make(?string $attribute = null, ?int $type = null, array $values = []): self
- {
- return new static($attribute, $type, $values);
- }
-
/**
* Set the original value of the attribute before modification.
+ *
+ * @param array|string $original
+ * @return $this
*/
- public function setOriginal(array|string $original = []): static
+ public function setOriginal($original = [])
{
$this->original = $this->normalizeAttributeValues($original);
@@ -66,17 +71,22 @@ class BatchModification
}
/**
- * Get the original value of the attribute before modification.
+ * Returns the original value of the attribute before modification.
+ *
+ * @return array
*/
- public function getOriginal(): array
+ public function getOriginal()
{
return $this->original;
}
/**
* Set the attribute of the modification.
+ *
+ * @param string $attribute
+ * @return $this
*/
- public function setAttribute(?string $attribute = null): static
+ public function setAttribute($attribute)
{
$this->attribute = $attribute;
@@ -84,51 +94,64 @@ class BatchModification
}
/**
- * Get the attribute of the modification.
+ * Returns the attribute of the modification.
+ *
+ * @return string
*/
- public function getAttribute(): string
+ public function getAttribute()
{
return $this->attribute;
}
/**
* Set the values of the modification.
+ *
+ * @param array $values
+ * @return $this
*/
- public function setValues(array $values = []): static
+ public function setValues(array $values = [])
{
// Null and empty values must also not be added to a batch
// modification. Passing null or empty values will result
// in an exception when trying to save the modification.
$this->values = array_filter($this->normalizeAttributeValues($values), function ($value) {
- return is_numeric($value) && $this->valueIsResetInteger((int) $value) || ! empty($value);
+ return is_numeric($value) && $this->valueIsResetInteger((int) $value) ?: ! empty($value);
});
return $this;
}
/**
- * Normalize all the attribute values.
+ * Normalize all of the attribute values.
+ *
+ * @param array|string $values
+ * @return array
*/
- protected function normalizeAttributeValues(array|string $values = []): array
+ protected function normalizeAttributeValues($values = [])
{
- // We must convert all the values to strings. Only strings can
+ // We must convert all of the values to strings. Only strings can
// be used in batch modifications, otherwise we will we will
// receive an LDAP exception while attempting to save.
return array_map('strval', (array) $values);
}
/**
- * Get the values of the modification.
+ * Returns the values of the modification.
+ *
+ * @return array
*/
- public function getValues(): array
+ public function getValues()
{
return $this->values;
}
/**
* Set the type of the modification.
+ *
+ * @param int|null $type
+ * @return $this
*/
- public function setType(?int $type = null): static
+ public function setType($type = null)
{
if (is_null($type)) {
return $this;
@@ -144,17 +167,21 @@ class BatchModification
}
/**
- * Get the type of the modification.
+ * Returns the type of the modification.
+ *
+ * @return int
*/
- public function getType(): ?int
+ public function getType()
{
return $this->type;
}
/**
- * Determine if the batch modification is valid in its current state.
+ * Determines if the batch modification is valid in its current state.
+ *
+ * @return bool
*/
- public function isValid(): bool
+ public function isValid()
{
return ! is_null($this->get());
}
@@ -162,43 +189,51 @@ class BatchModification
/**
* Builds the type of modification automatically
* based on the current and original values.
+ *
+ * @return $this
*/
- public function build(): static
+ public function build()
{
- return match (true) {
- empty($this->original) && empty($this->values) => $this,
-
- ! empty($this->original) && empty($this->values) => $this->setType(LDAP_MODIFY_BATCH_REMOVE_ALL),
-
- empty($this->original) && ! empty($this->values) => $this->setType(LDAP_MODIFY_BATCH_ADD),
-
- default => $this->determineBatchTypeFromOriginal(),
- };
+ switch (true) {
+ case empty($this->original) && empty($this->values):
+ return $this;
+ case ! empty($this->original) && empty($this->values):
+ return $this->setType(LDAP_MODIFY_BATCH_REMOVE_ALL);
+ case empty($this->original) && ! empty($this->values):
+ return $this->setType(LDAP_MODIFY_BATCH_ADD);
+ default:
+ return $this->determineBatchTypeFromOriginal();
+ }
}
/**
* Determine the batch modification type from the original values.
+ *
+ * @return $this
*/
- protected function determineBatchTypeFromOriginal(): static
+ protected function determineBatchTypeFromOriginal()
{
$added = $this->getAddedValues();
$removed = $this->getRemovedValues();
- return match (true) {
- ! empty($added) && ! empty($removed) => $this->setType(LDAP_MODIFY_BATCH_REPLACE),
-
- ! empty($added) => $this->setValues($added)->setType(LDAP_MODIFY_BATCH_ADD),
-
- ! empty($removed) => $this->setValues($removed)->setType(LDAP_MODIFY_BATCH_REMOVE),
-
- default => $this,
- };
+ switch (true) {
+ case ! empty($added) && ! empty($removed):
+ return $this->setType(LDAP_MODIFY_BATCH_REPLACE);
+ case ! empty($added):
+ return $this->setValues($added)->setType(LDAP_MODIFY_BATCH_ADD);
+ case ! empty($removed):
+ return $this->setValues($removed)->setType(LDAP_MODIFY_BATCH_REMOVE);
+ default:
+ return $this;
+ }
}
/**
* Get the values that were added to the attribute.
+ *
+ * @return array
*/
- protected function getAddedValues(): array
+ protected function getAddedValues()
{
return array_values(
array_diff($this->values, $this->original)
@@ -207,8 +242,10 @@ class BatchModification
/**
* Get the values that were removed from the attribute.
+ *
+ * @return array
*/
- protected function getRemovedValues(): array
+ protected function getRemovedValues()
{
return array_values(
array_diff($this->original, $this->values)
@@ -216,30 +253,43 @@ class BatchModification
}
/**
- * Get the batch modification array.
+ * Returns the built batch modification array.
+ *
+ * @return array|null
*/
- public function get(): ?array
+ public function get()
{
- return match ($this->type) {
- LDAP_MODIFY_BATCH_REMOVE_ALL => [
- static::KEY_ATTRIB => $this->attribute,
- static::KEY_MODTYPE => $this->type,
- ],
-
- LDAP_MODIFY_BATCH_REMOVE, LDAP_MODIFY_BATCH_ADD, LDAP_MODIFY_BATCH_REPLACE => [
- static::KEY_ATTRIB => $this->attribute,
- static::KEY_MODTYPE => $this->type,
- static::KEY_VALUES => $this->values,
- ],
-
- default => null,
- };
+ switch ($this->type) {
+ case LDAP_MODIFY_BATCH_REMOVE_ALL:
+ // A values key cannot be provided when
+ // a remove all type is selected.
+ return [
+ static::KEY_ATTRIB => $this->attribute,
+ static::KEY_MODTYPE => $this->type,
+ ];
+ case LDAP_MODIFY_BATCH_REMOVE:
+ // Fallthrough.
+ case LDAP_MODIFY_BATCH_ADD:
+ // Fallthrough.
+ case LDAP_MODIFY_BATCH_REPLACE:
+ return [
+ static::KEY_ATTRIB => $this->attribute,
+ static::KEY_MODTYPE => $this->type,
+ static::KEY_VALUES => $this->values,
+ ];
+ default:
+ // If the modtype isn't recognized, we'll return null.
+ return;
+ }
}
/**
- * Determine if the given modtype is valid.
+ * Determines if the given modtype is valid.
+ *
+ * @param int $type
+ * @return bool
*/
- protected function isValidType(int $type): bool
+ protected function isValidType($type)
{
return in_array($type, [
LDAP_MODIFY_BATCH_REMOVE_ALL,
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Collection.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Collection.php
index a0d8126a0..11b4ca522 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Collection.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Collection.php
@@ -11,8 +11,10 @@ class Collection extends QueryCollection
{
/**
* Get a collection of the model's distinguished names.
+ *
+ * @return static
*/
- public function modelDns(): static
+ public function modelDns()
{
return $this->map(function (Model $model) {
return $model->getDn();
@@ -20,11 +22,12 @@ class Collection extends QueryCollection
}
/**
- * Determine if the collection contains all the given models, or any models.
+ * Determine if the collection contains all of the given models, or any models.
*
- * @param QueryCollection|Model|array|string|null $models
+ * @param mixed $models
+ * @return bool
*/
- public function exists(mixed $models = null): bool
+ public function exists($models = null)
{
$models = $this->getArrayableModels($models);
@@ -54,11 +57,19 @@ class Collection extends QueryCollection
/**
* Determine if any of the given models are contained in the collection.
+ *
+ * @param mixed $key
+ * @param mixed $operator
+ * @param mixed $value
+ * @return bool
*/
- public function contains($key, $operator = null, $value = null): bool
+ public function contains($key, $operator = null, $value = null)
{
if (func_num_args() > 1 || $key instanceof Closure) {
- return parent::contains(...func_get_args());
+ // If we are supplied with more than one argument, or
+ // we were passed a closure, we will utilize the
+ // parents contains method, for compatibility.
+ return parent::contains($key, $operator, $value);
}
foreach ($this->getArrayableModels($key) as $model) {
@@ -76,20 +87,25 @@ class Collection extends QueryCollection
/**
* Get the provided models as an array.
+ *
+ * @param mixed $models
+ * @return array
*/
- protected function getArrayableModels(mixed $models = null): array
+ protected function getArrayableModels($models = null)
{
- if ($models instanceof QueryCollection) {
- return $models->all();
- }
-
- return Arr::wrap($models);
+ return $models instanceof QueryCollection
+ ? $models->toArray()
+ : Arr::wrap($models);
}
/**
* Compare the related model with the given.
+ *
+ * @param Model|string $model
+ * @param Model $related
+ * @return bool
*/
- protected function compareModelWithRelated(Model|string $model, Model $related): bool
+ protected function compareModelWithRelated($model, $related)
{
if (is_string($model)) {
return $this->isValidDn($model)
@@ -102,8 +118,11 @@ class Collection extends QueryCollection
/**
* Determine if the given string is a valid distinguished name.
+ *
+ * @param string $dn
+ * @return bool
*/
- protected function isValidDn(string $dn): bool
+ protected function isValidDn($dn)
{
return ! empty((new DistinguishedName($dn))->components());
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Concerns/CanAuthenticate.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Concerns/CanAuthenticate.php
index e52657a44..6e8d4fb5d 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Concerns/CanAuthenticate.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Concerns/CanAuthenticate.php
@@ -7,58 +7,60 @@ trait CanAuthenticate
{
/**
* Get the name of the unique identifier for the user.
+ *
+ * @return string
*/
- public function getAuthIdentifierName(): string
+ public function getAuthIdentifierName()
{
return $this->guidKey;
}
/**
* Get the unique identifier for the user.
+ *
+ * @return string
*/
- public function getAuthIdentifier(): string
+ public function getAuthIdentifier()
{
- return $this->getConvertedGuid(
- $this->getFirstAttribute($this->getAuthIdentifierName())
- );
+ return $this->getConvertedGuid();
}
/**
* Get the password for the user.
+ *
+ * @return string
*/
- public function getAuthPassword(): string
+ public function getAuthPassword()
{
return '';
}
- /**
- * Get the name of the password attribute for the user.
- */
- public function getAuthPasswordName(): string
- {
- return 'password';
- }
-
/**
* Get the token value for the "remember me" session.
+ *
+ * @return string
*/
- public function getRememberToken(): string
+ public function getRememberToken()
{
return '';
}
/**
* Set the token value for the "remember me" session.
+ *
+ * @param string $value
+ * @return void
*/
- public function setRememberToken($value): void
+ public function setRememberToken($value)
{
- // Do nothing.
}
/**
* Get the column name for the "remember me" token.
+ *
+ * @return string
*/
- public function getRememberTokenName(): string
+ public function getRememberTokenName()
{
return '';
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Concerns/HasAttributes.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Concerns/HasAttributes.php
index 67b4cf703..a3d9df7d9 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Concerns/HasAttributes.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Concerns/HasAttributes.php
@@ -10,7 +10,6 @@ use LdapRecord\Models\Attributes\MbString;
use LdapRecord\Models\Attributes\Timestamp;
use LdapRecord\Models\DetectsResetIntegers;
use LdapRecord\Support\Arr;
-use RuntimeException;
trait HasAttributes
{
@@ -18,56 +17,69 @@ trait HasAttributes
/**
* The models original attributes.
+ *
+ * @var array
*/
- protected array $original = [];
-
- /**
- * The models changed attributes.
- */
- protected array $changes = [];
+ protected $original = [];
/**
* The models attributes.
+ *
+ * @var array
*/
- protected array $attributes = [];
+ protected $attributes = [];
/**
* The attributes that should be mutated to dates.
+ *
+ * @var array
*/
- protected array $dates = [];
+ protected $dates = [];
/**
* The attributes that should be cast to their native types.
+ *
+ * @var array
*/
- protected array $casts = [];
+ protected $casts = [];
/**
* The accessors to append to the model's array form.
+ *
+ * @var array
*/
- protected array $appends = [];
+ protected $appends = [];
/**
* The format that dates must be output to for serialization.
+ *
+ * @var string
*/
- protected ?string $dateFormat = null;
+ protected $dateFormat;
/**
* The default attributes that should be mutated to dates.
+ *
+ * @var array
*/
- protected array $defaultDates = [
+ protected $defaultDates = [
'createtimestamp' => 'ldap',
'modifytimestamp' => 'ldap',
];
/**
* The cache of the mutated attributes for each class.
+ *
+ * @var array
*/
- protected static array $mutatorCache = [];
+ protected static $mutatorCache = [];
/**
* Convert the model's original attributes to an array.
+ *
+ * @return array
*/
- public function originalToArray(): array
+ public function originalToArray()
{
return $this->encodeAttributes(
$this->convertAttributesForJson($this->original)
@@ -76,14 +88,16 @@ trait HasAttributes
/**
* Convert the model's attributes to an array.
+ *
+ * @return array
*/
- public function attributesToArray(): array
+ public function attributesToArray()
{
// Here we will replace our LDAP formatted dates with
// properly formatted ones, so dates do not need to
// be converted manually after being returned.
$attributes = $this->addDateAttributesToArray(
- $this->getArrayableAttributes()
+ $attributes = $this->getArrayableAttributes()
);
$attributes = $this->addMutatedAttributesToArray(
@@ -111,30 +125,39 @@ trait HasAttributes
/**
* Convert the model's serialized original attributes to their original form.
+ *
+ * @param array $attributes
+ * @return array
*/
- public function arrayToOriginal(array $attributes): array
+ public function arrayToOriginal(array $attributes)
{
- $attributes = $this->decodeAttributes($attributes);
-
- return $this->convertAttributesFromJson($attributes);
+ return $this->decodeAttributes(
+ $this->convertAttributesFromJson($attributes)
+ );
}
/**
* Convert the model's serialized attributes to their original form.
+ *
+ * @param array $attributes
+ * @return array
*/
- public function arrayToAttributes(array $attributes): array
+ public function arrayToAttributes(array $attributes)
{
$attributes = $this->restoreDateAttributesFromArray($attributes);
- $attributes = $this->decodeAttributes($attributes);
-
- return $this->convertAttributesFromJson($attributes);
+ return $this->decodeAttributes(
+ $this->convertAttributesFromJson($attributes)
+ );
}
/**
* Add the date attributes to the attributes array.
+ *
+ * @param array $attributes
+ * @return array
*/
- protected function addDateAttributesToArray(array $attributes): array
+ protected function addDateAttributesToArray(array $attributes)
{
foreach ($this->getDates() as $attribute => $type) {
if (! isset($attributes[$attribute])) {
@@ -153,15 +176,18 @@ trait HasAttributes
/**
* Restore the date attributes to their true value from serialized attributes.
+ *
+ * @param array $attributes
+ * @return array
*/
- protected function restoreDateAttributesFromArray(array $attributes): array
+ protected function restoreDateAttributesFromArray(array $attributes)
{
foreach ($this->getDates() as $attribute => $type) {
if (! isset($attributes[$attribute])) {
continue;
}
- $date = $this->fromDateTime($attributes[$attribute], $type);
+ $date = $this->fromDateTime($type, $attributes[$attribute]);
$attributes[$attribute] = Arr::wrap($date);
}
@@ -171,16 +197,21 @@ trait HasAttributes
/**
* Prepare a date for array / JSON serialization.
+ *
+ * @param DateTimeInterface $date
+ * @return string
*/
- protected function serializeDate(DateTimeInterface $date): string
+ protected function serializeDate(DateTimeInterface $date)
{
return $date->format($this->getDateFormat());
}
/**
* Recursively UTF-8 encode the given attributes.
+ *
+ * @return array
*/
- protected function encodeAttributes($attributes): array
+ public function encodeAttributes($attributes)
{
array_walk_recursive($attributes, function (&$value) {
$value = $this->encodeValue($value);
@@ -191,8 +222,11 @@ trait HasAttributes
/**
* Recursively UTF-8 decode the given attributes.
+ *
+ * @param array $attributes
+ * @return array
*/
- public function decodeAttributes(array $attributes): array
+ public function decodeAttributes($attributes)
{
array_walk_recursive($attributes, function (&$value) {
$value = $this->decodeValue($value);
@@ -203,8 +237,11 @@ trait HasAttributes
/**
* Encode the value for serialization.
+ *
+ * @param string $value
+ * @return string
*/
- protected function encodeValue(string $value): string
+ protected function encodeValue($value)
{
// If we are able to detect the encoding, we will
// encode only the attributes that need to be,
@@ -213,15 +250,18 @@ trait HasAttributes
return $value;
}
- return mb_convert_encoding($value, 'UTF-8', 'ISO-8859-1');
+ return utf8_encode($value);
}
/**
* Decode the value from serialization.
+ *
+ * @param string $value
+ * @return string
*/
- protected function decodeValue(string $value): string
+ protected function decodeValue($value)
{
- if (MbString::isLoaded() && ! MbString::isUtf8($value)) {
+ if (MbString::isLoaded() && MbString::isUtf8($value)) {
return mb_convert_encoding($value, 'UTF-8', 'ISO-8859-1');
}
@@ -230,8 +270,12 @@ trait HasAttributes
/**
* Add the mutated attributes to the attributes array.
+ *
+ * @param array $attributes
+ * @param array $mutatedAttributes
+ * @return array
*/
- protected function addMutatedAttributesToArray(array $attributes, array $mutatedAttributes): array
+ protected function addMutatedAttributesToArray(array $attributes, array $mutatedAttributes)
{
foreach ($mutatedAttributes as $key) {
// We want to spin through all the mutated attributes for this model and call
@@ -255,28 +299,23 @@ trait HasAttributes
/**
* Set the model's original attributes with the model's current attributes.
+ *
+ * @return $this
*/
- public function syncOriginal(): static
+ public function syncOriginal()
{
$this->original = $this->attributes;
return $this;
}
- /**
- * Sync the changed attributes.
- */
- public function syncChanges(): static
- {
- $this->changes = $this->getDirty();
-
- return $this;
- }
-
/**
* Fills the entry with the supplied attributes.
+ *
+ * @param array $attributes
+ * @return $this
*/
- public function fill(array $attributes = []): static
+ public function fill(array $attributes = [])
{
foreach ($attributes as $key => $value) {
$this->setAttribute($key, $value);
@@ -286,21 +325,29 @@ trait HasAttributes
}
/**
- * Get the models attribute by its key.
+ * Returns the models attribute by its key.
+ *
+ * @param int|string $key
+ * @param mixed $default
+ * @return mixed
*/
- public function getAttribute(?string $key = null, mixed $default = null): mixed
+ public function getAttribute($key, $default = null)
{
if (! $key) {
- return null;
+ return;
}
return $this->getAttributeValue($key, $default);
}
/**
- * Get an attribute's value.
+ * Get an attributes value.
+ *
+ * @param string $key
+ * @param mixed $default
+ * @return mixed
*/
- public function getAttributeValue(string $key, mixed $default = null): mixed
+ public function getAttributeValue($key, $default = null)
{
$key = $this->normalizeAttributeKey($key);
$value = $this->getAttributeFromArray($key);
@@ -320,57 +367,43 @@ trait HasAttributes
return is_null($value) ? $default : $value;
}
- /**
- * Get the model's raw attribute value.
- */
- public function getRawAttribute(string $key, mixed $default = null): mixed
- {
- return Arr::get($this->attributes, $this->normalizeAttributeKey($key), $default);
- }
-
/**
* Determine if the given attribute is a date.
+ *
+ * @param string $key
+ * @return bool
*/
- public function isDateAttribute(string $key): bool
+ public function isDateAttribute($key)
{
return array_key_exists($key, $this->getDates());
}
/**
* Get the attributes that should be mutated to dates.
+ *
+ * @return array
*/
- public function getDates(): array
+ public function getDates()
{
// Since array string keys can be unique depending
// on casing differences, we need to normalize the
// array key case so they are merged properly.
return array_merge(
- array_change_key_case($this->defaultDates),
- array_change_key_case($this->dates),
- array_change_key_case($this->getDateCasts()),
+ array_change_key_case($this->defaultDates, CASE_LOWER),
+ array_change_key_case($this->dates, CASE_LOWER)
);
}
- /**
- * Get the attributes casts that should be mutated to dates.
- */
- protected function getDateCasts(): array
- {
- return array_map(function (string $cast) {
- return explode(':', $cast, 2)[1] ?? throw new RuntimeException(
- "Invalid date cast [$cast]. A date cast must be in the format 'datetime:format'."
- );
- }, array_filter($this->getCasts(), function ($cast) {
- return $this->isDateTimeCast($cast);
- }));
- }
-
/**
* Convert the given date value to an LDAP compatible value.
*
+ * @param string $type
+ * @param mixed $value
+ * @return float|string
+ *
* @throws LdapRecordException
*/
- public function fromDateTime(mixed $value, string $type): float|int|string
+ public function fromDateTime($type, $value)
{
return (new Timestamp($type))->fromDateTime($value);
}
@@ -378,20 +411,28 @@ trait HasAttributes
/**
* Convert the given LDAP date value to a Carbon instance.
*
+ * @param mixed $value
+ * @param string $type
+ * @return Carbon|false
+ *
* @throws LdapRecordException
*/
- public function asDateTime(mixed $value, string $type): Carbon|int|false
+ public function asDateTime($value, $type)
{
return (new Timestamp($type))->toDateTime($value);
}
/**
* Determine whether an attribute should be cast to a native type.
+ *
+ * @param string $key
+ * @param array|string|null $types
+ * @return bool
*/
- public function hasCast(string $key, array|string|null $types = null): bool
+ public function hasCast($key, $types = null)
{
if (array_key_exists($key, $this->getCasts())) {
- return ! $types || in_array($this->getCastType($key), (array) $types, true);
+ return $types ? in_array($this->getCastType($key), (array) $types, true) : true;
}
return false;
@@ -399,24 +440,32 @@ trait HasAttributes
/**
* Get the attributes that should be cast to their native types.
+ *
+ * @return array
*/
- protected function getCasts(): array
+ protected function getCasts()
{
- return array_change_key_case($this->casts);
+ return array_change_key_case($this->casts, CASE_LOWER);
}
/**
* Determine whether a value is JSON castable for inbound manipulation.
+ *
+ * @param string $key
+ * @return bool
*/
- protected function isJsonCastable(string $key): bool
+ protected function isJsonCastable($key)
{
return $this->hasCast($key, ['array', 'json', 'object', 'collection']);
}
/**
* Get the type of cast for a model attribute.
+ *
+ * @param string $key
+ * @return string
*/
- protected function getCastType(string $key): string
+ protected function getCastType($key)
{
if ($this->isDecimalCast($this->getCasts()[$key])) {
return 'decimal';
@@ -431,32 +480,45 @@ trait HasAttributes
/**
* Determine if the cast is a decimal.
+ *
+ * @param string $cast
+ * @return bool
*/
- protected function isDecimalCast(string $cast): bool
+ protected function isDecimalCast($cast)
{
return strncmp($cast, 'decimal:', 8) === 0;
}
/**
* Determine if the cast is a datetime.
+ *
+ * @param string $cast
+ * @return bool
*/
- protected function isDateTimeCast(string $cast): bool
+ protected function isDateTimeCast($cast)
{
return strncmp($cast, 'datetime:', 8) === 0;
}
/**
* Determine if the given attribute must be casted.
+ *
+ * @param string $key
+ * @return bool
*/
- protected function isCastedAttribute(string $key): bool
+ protected function isCastedAttribute($key)
{
- return array_key_exists($key, array_change_key_case($this->casts));
+ return array_key_exists($key, array_change_key_case($this->casts, CASE_LOWER));
}
/**
* Cast an attribute to a native PHP type.
+ *
+ * @param string $key
+ * @param array|null $value
+ * @return mixed
*/
- protected function castAttribute(string $key, ?array $value): mixed
+ protected function castAttribute($key, $value)
{
$value = $this->castRequiresArrayValue($key) ? $value : Arr::first($value);
@@ -480,7 +542,7 @@ trait HasAttributes
case 'boolean':
return $this->asBoolean($value);
case 'object':
- return $this->fromJson($value, true);
+ return $this->fromJson($value, $asObject = true);
case 'array':
case 'json':
return $this->fromJson($value);
@@ -495,16 +557,22 @@ trait HasAttributes
/**
* Determine if the cast type requires the first attribute value.
+ *
+ * @return bool
*/
- protected function castRequiresArrayValue(string $key): bool
+ protected function castRequiresArrayValue($key)
{
- return $this->getCastType($key) === 'collection';
+ return in_array($this->getCastType($key), ['collection']);
}
/**
* Cast the given attribute to JSON.
+ *
+ * @param string $key
+ * @param mixed $value
+ * @return string
*/
- protected function castAttributeAsJson(string $key, mixed $value): string
+ protected function castAttributeAsJson($key, $value)
{
$value = $this->asJson($value);
@@ -512,104 +580,107 @@ trait HasAttributes
$class = get_class($this);
$message = json_last_error_msg();
- throw new Exception("Unable to encode attribute [$key] for model [$class] to JSON: $message.");
+ throw new Exception("Unable to encode attribute [{$key}] for model [{$class}] to JSON: {$message}.");
}
return $value;
}
- /**
- * Cast the given attribute to an LDAP primitive type.
- */
- protected function castAttributeAsPrimitive(string $key, mixed $value): string
- {
- return match ($this->getCastType($key)) {
- 'bool', 'boolean' => $this->fromBoolean($value),
- default => (string) $value,
- };
- }
-
/**
* Convert the model to its JSON representation.
+ *
+ * @return string
*/
- public function toJson(): string
+ public function toJson()
{
return json_encode($this);
}
/**
* Encode the given value as JSON.
+ *
+ * @param mixed $value
+ * @return string
*/
- protected function asJson(mixed $value): string|false
+ protected function asJson($value)
{
return json_encode($value);
}
/**
* Decode the given JSON back into an array or object.
+ *
+ * @param string $value
+ * @param bool $asObject
+ * @return mixed
*/
- public function fromJson(string $value, bool $asObject = false): mixed
+ public function fromJson($value, $asObject = false)
{
return json_decode($value, ! $asObject);
}
/**
* Decode the given float.
+ *
+ * @param mixed $value
+ * @return mixed
*/
- public function fromFloat(float $value): float
+ public function fromFloat($value)
{
- return match ((string) $value) {
- 'NaN' => NAN,
- 'Infinity' => INF,
- '-Infinity' => -INF,
- default => $value,
- };
- }
-
- /**
- * Cast the value from an LDAP boolean string to a primitive boolean.
- */
- protected function asBoolean(mixed $value): bool
- {
- return match (strtolower($value)) {
- 'true' => true,
- 'false' => false,
- default => (bool) $value,
- };
- }
-
- /**
- * Cast the value from a primitive boolean to an LDAP boolean string.
- */
- protected function fromBoolean(mixed $value): string
- {
- if (is_string($value)) {
- $value = $this->asBoolean($value);
+ switch ((string) $value) {
+ case 'Infinity':
+ return INF;
+ case '-Infinity':
+ return -INF;
+ case 'NaN':
+ return NAN;
+ default:
+ return (float) $value;
}
+ }
- return $value ? 'TRUE' : 'FALSE';
+ /**
+ * Cast the value to a boolean.
+ *
+ * @param mixed $value
+ * @return bool
+ */
+ protected function asBoolean($value)
+ {
+ $map = ['true' => true, 'false' => false];
+
+ return $map[strtolower($value)] ?? (bool) $value;
}
/**
* Cast a decimal value as a string.
+ *
+ * @param float $value
+ * @param int $decimals
+ * @return string
*/
- protected function asDecimal(float $value, int $decimals): string
+ protected function asDecimal($value, $decimals)
{
return number_format($value, $decimals, '.', '');
}
/**
* Get an attribute array of all arrayable attributes.
+ *
+ * @return array
*/
- protected function getArrayableAttributes(): array
+ protected function getArrayableAttributes()
{
return $this->getArrayableItems($this->attributes);
}
/**
* Get an attribute array of all arrayable values.
+ *
+ * @param array $values
+ * @return array
*/
- protected function getArrayableItems(array $values): array
+ protected function getArrayableItems(array $values)
{
if (count($visible = $this->getVisible()) > 0) {
$values = array_intersect_key($values, array_flip($visible));
@@ -623,9 +694,11 @@ trait HasAttributes
}
/**
- * Get all the appendable values that are arrayable.
+ * Get all of the appendable values that are arrayable.
+ *
+ * @return array
*/
- protected function getArrayableAppends(): array
+ protected function getArrayableAppends()
{
if (empty($this->appends)) {
return [];
@@ -638,16 +711,21 @@ trait HasAttributes
/**
* Get the format for date serialization.
+ *
+ * @return string
*/
- public function getDateFormat(): string
+ public function getDateFormat()
{
return $this->dateFormat ?: DateTimeInterface::ISO8601;
}
/**
* Set the date format used by the model for serialization.
+ *
+ * @param string $format
+ * @return $this
*/
- public function setDateFormat(string $format): static
+ public function setDateFormat($format)
{
$this->dateFormat = $format;
@@ -656,24 +734,33 @@ trait HasAttributes
/**
* Get an attribute from the $attributes array.
+ *
+ * @param string $key
+ * @return mixed
*/
- protected function getAttributeFromArray(string $key): mixed
+ protected function getAttributeFromArray($key)
{
return $this->getNormalizedAttributes()[$key] ?? null;
}
/**
* Get the attributes with their keys normalized.
+ *
+ * @return array
*/
- protected function getNormalizedAttributes(): array
+ protected function getNormalizedAttributes()
{
- return array_change_key_case($this->attributes);
+ return array_change_key_case($this->attributes, CASE_LOWER);
}
/**
- * Get the first attribute by the specified key.
+ * Returns the first attribute by the specified key.
+ *
+ * @param string $key
+ * @param mixed $default
+ * @return mixed
*/
- public function getFirstAttribute(string $key, mixed $default = null): mixed
+ public function getFirstAttribute($key, $default = null)
{
return Arr::first(
Arr::wrap($this->getAttribute($key, $default)),
@@ -681,36 +768,38 @@ trait HasAttributes
}
/**
- * Returns all the model's attributes.
+ * Returns all of the models attributes.
+ *
+ * @return array
*/
- public function getAttributes(): array
+ public function getAttributes()
{
return $this->attributes;
}
/**
* Set an attribute value by the specified key.
+ *
+ * @param string $key
+ * @param mixed $value
+ * @return $this
*/
- public function setAttribute(string $key, mixed $value): static
+ public function setAttribute($key, $value)
{
$key = $this->normalizeAttributeKey($key);
if ($this->hasSetMutator($key)) {
return $this->setMutatedAttributeValue($key, $value);
- }
-
- if (
+ } elseif (
$value &&
$this->isDateAttribute($key) &&
! $this->valueIsResetInteger($value)
) {
- $value = (string) $this->fromDateTime($value, $this->getDates()[$key]);
+ $value = $this->fromDateTime($this->getDates()[$key], $value);
}
if ($this->isJsonCastable($key) && ! is_null($value)) {
$value = $this->castAttributeAsJson($key, $value);
- } elseif ($this->hasCast($key) && ! is_null($value)) {
- $value = $this->castAttributeAsPrimitive($key, $value);
}
$this->attributes[$key] = Arr::wrap($value);
@@ -720,8 +809,12 @@ trait HasAttributes
/**
* Set an attribute on the model. No checking is done.
+ *
+ * @param string $key
+ * @param mixed $value
+ * @return $this
*/
- public function setRawAttribute(string $key, mixed $value): static
+ public function setRawAttribute($key, $value)
{
$key = $this->normalizeAttributeKey($key);
@@ -732,71 +825,75 @@ trait HasAttributes
/**
* Set the models first attribute value.
+ *
+ * @param string $key
+ * @param mixed $value
+ * @return $this
*/
- public function setFirstAttribute(string $key, mixed $value): static
+ public function setFirstAttribute($key, $value)
{
return $this->setAttribute($key, Arr::wrap($value));
}
/**
* Add a unique value to the given attribute.
+ *
+ * @param string $key
+ * @param mixed $value
+ * @return $this
*/
- public function addAttributeValue(string $key, mixed $value): static
+ public function addAttributeValue($key, $value)
{
- return $this->setRawAttribute($key, array_unique(array_merge(
- $this->getRawAttribute($key, []),
- Arr::wrap($value)
- )));
- }
-
- /**
- * Remove a unique value from the given attribute.
- */
- public function removeAttributeValue(string $key, mixed $value): static
- {
- $values = $this->getRawAttribute($key, []);
-
- foreach (Arr::wrap($value) as $value) {
- $index = array_search($value, $values);
-
- if ($index !== false) {
- unset($values[$index]);
- }
- }
-
- return $this->setRawAttribute($key, array_values($values));
+ return $this->setAttribute($key, array_unique(
+ array_merge(
+ Arr::wrap($this->getAttribute($key)),
+ Arr::wrap($value)
+ )
+ ));
}
/**
* Determine if a get mutator exists for an attribute.
+ *
+ * @param string $key
+ * @return bool
*/
- public function hasGetMutator(string $key): bool
+ public function hasGetMutator($key)
{
return method_exists($this, 'get'.$this->getMutatorMethodName($key).'Attribute');
}
/**
* Determine if a set mutator exists for an attribute.
+ *
+ * @param string $key
+ * @return bool
*/
- public function hasSetMutator(string $key): bool
+ public function hasSetMutator($key)
{
return method_exists($this, 'set'.$this->getMutatorMethodName($key).'Attribute');
}
/**
* Set the value of an attribute using its mutator.
+ *
+ * @param string $key
+ * @param mixed $value
+ * @return mixed
*/
- protected function setMutatedAttributeValue(string $key, mixed $value): static
+ protected function setMutatedAttributeValue($key, $value)
{
- $this->{'set'.$this->getMutatorMethodName($key).'Attribute'}($value);
-
- return $this;
+ return $this->{'set'.$this->getMutatorMethodName($key).'Attribute'}($value);
}
/**
* Get the value of an attribute using its mutator.
+ *
+ * @param string $key
+ * @param mixed $value
+ * @return mixed
*/
- protected function getMutatedAttributeValue(string $key, mixed $value): mixed
+ protected function getMutatedAttributeValue($key, $value)
{
return $this->{'get'.$this->getMutatorMethodName($key).'Attribute'}($value);
}
@@ -805,8 +902,11 @@ trait HasAttributes
* Get the mutator attribute method name.
*
* Hyphenated attributes will use pascal cased methods.
+ *
+ * @param string $key
+ * @return mixed
*/
- protected function getMutatorMethodName(string $key): string
+ protected function getMutatorMethodName($key)
{
$key = ucwords(str_replace('-', ' ', $key));
@@ -815,8 +915,12 @@ trait HasAttributes
/**
* Get the value of an attribute using its mutator for array conversion.
+ *
+ * @param string $key
+ * @param mixed $value
+ * @return array
*/
- protected function mutateAttributeForArray(string $key, mixed $value): array
+ protected function mutateAttributeForArray($key, $value)
{
return Arr::wrap(
$this->getMutatedAttributeValue($key, $value)
@@ -824,22 +928,27 @@ trait HasAttributes
}
/**
- * Set the raw model attributes.
+ * Set the attributes property.
*
* Used when constructing an existing LDAP record.
+ *
+ * @param array $attributes
+ * @return $this
*/
- public function setRawAttributes(array $attributes = []): static
+ public function setRawAttributes(array $attributes = [])
{
// We will filter out those annoying 'count' keys
// returned with LDAP results and lowercase all
// root array keys to prevent any casing issues.
- $raw = array_change_key_case($this->filterRawAttributes($attributes));
+ $raw = array_change_key_case($this->filterRawAttributes($attributes), CASE_LOWER);
// Before setting the models attributes, we will filter
// out the attributes that contain an integer key. LDAP
// search results will contain integer keys that have
// attribute names as values. We don't need these.
- $this->attributes = array_filter($raw, fn ($key) => ! is_int($key), ARRAY_FILTER_USE_KEY);
+ $this->attributes = array_filter($raw, function ($key) {
+ return ! is_int($key);
+ }, ARRAY_FILTER_USE_KEY);
// LDAP search results will contain the distinguished
// name inside of the `dn` key. We will retrieve this,
@@ -862,8 +971,12 @@ trait HasAttributes
/**
* Filters the count key recursively from raw LDAP attributes.
+ *
+ * @param array $attributes
+ * @param array $keys
+ * @return array
*/
- public function filterRawAttributes(array $attributes = [], array $keys = ['count', 'dn']): array
+ public function filterRawAttributes(array $attributes = [], array $keys = ['count', 'dn'])
{
foreach ($keys as $key) {
unset($attributes[$key]);
@@ -880,40 +993,41 @@ trait HasAttributes
/**
* Determine if the model has the given attribute.
+ *
+ * @param int|string $key
+ * @return bool
*/
- public function hasAttribute(int|string $key): bool
+ public function hasAttribute($key)
{
- return ($this->attributes[$this->normalizeAttributeKey($key)] ?? []) !== [];
+ return [] !== ($this->attributes[$this->normalizeAttributeKey($key)] ?? []);
}
/**
- * Get the number of attributes.
+ * Returns the number of attributes.
+ *
+ * @return int
*/
- public function countAttributes(): int
+ public function countAttributes()
{
return count($this->getAttributes());
}
/**
- * Get the model's original attributes.
+ * Returns the models original attributes.
+ *
+ * @return array
*/
- public function getOriginal(): array
+ public function getOriginal()
{
return $this->original;
}
- /**
- * Get the model's raw original attribute values.
- */
- public function getRawOriginal(string $key, mixed $default = null): mixed
- {
- return Arr::get($this->original, $key, $default);
- }
-
/**
* Get the attributes that have been changed since last sync.
+ *
+ * @return array
*/
- public function getDirty(): array
+ public function getDirty()
{
$dirty = [];
@@ -929,70 +1043,34 @@ trait HasAttributes
return $dirty;
}
- /**
- * Get the attributes that have been changed since the model was last saved.
- */
- public function getChanges(): array
- {
- return $this->changes;
- }
-
/**
* Determine if the given attribute is dirty.
+ *
+ * @param string $key
+ * @return bool
*/
- public function isDirty(string $key): bool
+ public function isDirty($key)
{
return ! $this->originalIsEquivalent($key);
}
- /**
- * Determine if given attribute has remained the same.
- */
- public function isClean(string $key): bool
- {
- return ! $this->isDirty($key);
- }
-
- /**
- * Discard attribute changes and reset the attributes to their original state.
- */
- public function discardChanges(): static
- {
- [$this->attributes, $this->changes] = [$this->original, []];
-
- return $this;
- }
-
- /**
- * Determine if the model or any of the given attribute(s) were changed when the model was last saved.
- */
- public function wasChanged(array|string|null $attributes = null): bool
- {
- if (func_num_args() === 0) {
- return count($this->changes) > 0;
- }
-
- foreach ((array) $attributes as $attribute) {
- if (array_key_exists($attribute, $this->changes)) {
- return true;
- }
- }
-
- return false;
- }
-
/**
* Get the accessors being appended to the models array form.
+ *
+ * @return array
*/
- public function getAppends(): array
+ public function getAppends()
{
return $this->appends;
}
/**
* Set the accessors to append to model arrays.
+ *
+ * @param array $appends
+ * @return $this
*/
- public function setAppends(array $appends): static
+ public function setAppends(array $appends)
{
$this->appends = $appends;
@@ -1001,16 +1079,22 @@ trait HasAttributes
/**
* Return whether the accessor attribute has been appended.
+ *
+ * @param string $attribute
+ * @return bool
*/
- public function hasAppended(string $attribute): bool
+ public function hasAppended($attribute)
{
return in_array($attribute, $this->appends);
}
/**
* Returns a normalized attribute key.
+ *
+ * @param string $key
+ * @return string
*/
- public function normalizeAttributeKey(string $key): string
+ public function normalizeAttributeKey($key)
{
// Since LDAP supports hyphens in attribute names,
// we'll convert attributes being retrieved by
@@ -1022,8 +1106,11 @@ trait HasAttributes
/**
* Determine if the new and old values for a given key are equivalent.
+ *
+ * @param string $key
+ * @return bool
*/
- protected function originalIsEquivalent(string $key): bool
+ protected function originalIsEquivalent($key)
{
if (! array_key_exists($key, $this->original)) {
return false;
@@ -1036,15 +1123,17 @@ trait HasAttributes
return true;
}
- return is_numeric($current) &&
+ return is_numeric($current) &&
is_numeric($original) &&
strcmp((string) $current, (string) $original) === 0;
}
/**
* Get the mutated attributes for a given instance.
+ *
+ * @return array
*/
- public function getMutatedAttributes(): array
+ public function getMutatedAttributes()
{
$class = static::class;
@@ -1057,19 +1146,26 @@ trait HasAttributes
/**
* Extract and cache all the mutated attributes of a class.
+ *
+ * @param string $class
+ * @return void
*/
- public static function cacheMutatedAttributes(string $class): void
+ public static function cacheMutatedAttributes($class)
{
- static::$mutatorCache[$class] = collect(static::getMutatorMethods($class))
- ->reject(fn ($match) => $match === 'First')
- ->map(fn ($match) => lcfirst($match))
- ->all();
+ static::$mutatorCache[$class] = collect(static::getMutatorMethods($class))->reject(function ($match) {
+ return $match === 'First';
+ })->map(function ($match) {
+ return lcfirst($match);
+ })->all();
}
/**
* Get all of the attribute mutator methods.
+ *
+ * @param mixed $class
+ * @return array
*/
- protected static function getMutatorMethods(string $class): array
+ protected static function getMutatorMethods($class)
{
preg_match_all('/(?<=^|;)get([^;]+?)Attribute(;|$)/', implode(';', get_class_methods($class)), $matches);
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Concerns/HasEvents.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Concerns/HasEvents.php
index 7537f62f6..d9a41b892 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Concerns/HasEvents.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Concerns/HasEvents.php
@@ -13,15 +13,18 @@ trait HasEvents
{
/**
* Execute the callback without raising any events.
+ *
+ * @param Closure $callback
+ * @return mixed
*/
- protected static function withoutEvents(Closure $callback): mixed
+ protected static function withoutEvents(Closure $callback)
{
$container = static::getConnectionContainer();
- $dispatcher = $container->getDispatcher();
+ $dispatcher = $container->getEventDispatcher();
if ($dispatcher) {
- $container->setDispatcher(
+ $container->setEventDispatcher(
new NullDispatcher($dispatcher)
);
}
@@ -30,15 +33,19 @@ trait HasEvents
return $callback();
} finally {
if ($dispatcher) {
- $container->setDispatcher($dispatcher);
+ $container->setEventDispatcher($dispatcher);
}
}
}
/**
* Dispatch the given model events.
+ *
+ * @param string|array $events
+ * @param array $args
+ * @return void
*/
- protected function dispatch(array|string $events, array $args = []): void
+ protected function dispatch($events, array $args = [])
{
foreach (Arr::wrap($events) as $name) {
$this->fireCustomModelEvent($name, $args);
@@ -47,27 +54,38 @@ trait HasEvents
/**
* Fire a custom model event.
+ *
+ * @param string $name
+ * @param array $args
+ * @return mixed
*/
- protected function fireCustomModelEvent(string $name, array $args = []): void
+ protected function fireCustomModelEvent($name, array $args = [])
{
$event = implode('\\', [Events::class, ucfirst($name)]);
- $this->fireModelEvent(new $event($this, ...$args));
+ return $this->fireModelEvent(new $event($this, ...$args));
}
/**
* Fire a model event.
+ *
+ * @param Event $event
+ * @return mixed
*/
- protected function fireModelEvent(Event $event): void
+ protected function fireModelEvent(Event $event)
{
- static::getConnectionContainer()->getDispatcher()->fire($event);
+ return static::getConnectionContainer()->getEventDispatcher()->fire($event);
}
/**
* Listen to a model event.
+ *
+ * @param string $event
+ * @param Closure $listener
+ * @return mixed
*/
- protected function listenForModelEvent(string $event, Closure $listener): void
+ protected function listenForModelEvent($event, Closure $listener)
{
- static::getConnectionContainer()->getDispatcher()->listen($event, $listener);
+ return static::getConnectionContainer()->getEventDispatcher()->listen($event, $listener);
}
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Concerns/HasGlobalScopes.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Concerns/HasGlobalScopes.php
index 855ba37c3..4d0f2968f 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Concerns/HasGlobalScopes.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Concerns/HasGlobalScopes.php
@@ -12,33 +12,43 @@ trait HasGlobalScopes
/**
* Register a new global scope on the model.
*
+ * @param Scope|Closure|string $scope
+ * @param Closure|null $implementation
+ * @return mixed
+ *
* @throws InvalidArgumentException
*/
- public static function addGlobalScope(Scope|Closure|string $scope, ?Closure $implementation = null): void
+ public static function addGlobalScope($scope, Closure $implementation = null)
{
if (is_string($scope) && ! is_null($implementation)) {
- static::$globalScopes[static::class][$scope] = $implementation;
+ return static::$globalScopes[static::class][$scope] = $implementation;
} elseif ($scope instanceof Closure) {
- static::$globalScopes[static::class][spl_object_hash($scope)] = $scope;
+ return static::$globalScopes[static::class][spl_object_hash($scope)] = $scope;
} elseif ($scope instanceof Scope) {
- static::$globalScopes[static::class][get_class($scope)] = $scope;
- } else {
- throw new InvalidArgumentException('Global scope must be an instance of Closure or Scope.');
+ return static::$globalScopes[static::class][get_class($scope)] = $scope;
}
+
+ throw new InvalidArgumentException('Global scope must be an instance of Closure or Scope.');
}
/**
* Determine if a model has a global scope.
+ *
+ * @param Scope|string $scope
+ * @return bool
*/
- public static function hasGlobalScope(Scope|string $scope): bool
+ public static function hasGlobalScope($scope)
{
return ! is_null(static::getGlobalScope($scope));
}
/**
* Get a global scope registered with the model.
+ *
+ * @param Scope|string $scope
+ * @return Scope|Closure|null
*/
- public static function getGlobalScope(Scope|string $scope): Scope|Closure|null
+ public static function getGlobalScope($scope)
{
if (array_key_exists(static::class, static::$globalScopes)) {
$scopeName = is_string($scope) ? $scope : get_class($scope);
@@ -47,14 +57,14 @@ trait HasGlobalScopes
? static::$globalScopes[static::class][$scopeName]
: null;
}
-
- return null;
}
/**
* Get the global scopes for this class instance.
+ *
+ * @return array
*/
- public function getGlobalScopes(): array
+ public function getGlobalScopes()
{
return array_key_exists(static::class, static::$globalScopes)
? static::$globalScopes[static::class]
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Concerns/HasPassword.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Concerns/HasPassword.php
index c84bd977d..194efa8cf 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Concerns/HasPassword.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Concerns/HasPassword.php
@@ -12,11 +12,13 @@ trait HasPassword
/**
* Set the password on the user.
*
+ * @param string|array $password
+ *
* @throws ConnectionException
*/
- public function setPasswordAttribute(array|string $password): void
+ public function setPasswordAttribute($password)
{
- $this->assertSecureConnection();
+ $this->validateSecureConnection();
// Here we will attempt to determine the password hash method in use
// by parsing the users hashed password (if it as available). If a
@@ -47,25 +49,31 @@ trait HasPassword
/**
* Alias for setting the password on the user.
*
+ * @param string|array $password
+ *
* @throws ConnectionException
*/
- public function setUnicodepwdAttribute(array|string $password): void
+ public function setUnicodepwdAttribute($password)
{
$this->setPasswordAttribute($password);
}
/**
* An accessor for retrieving the user's hashed password value.
+ *
+ * @return string|null
*/
- public function getPasswordAttribute(): ?string
+ public function getPasswordAttribute()
{
return $this->getAttribute($this->getPasswordAttributeName())[0] ?? null;
}
/**
* Get the name of the attribute that contains the user's password.
+ *
+ * @return string
*/
- public function getPasswordAttributeName(): string
+ public function getPasswordAttributeName()
{
if (property_exists($this, 'passwordAttribute')) {
return $this->passwordAttribute;
@@ -80,8 +88,10 @@ trait HasPassword
/**
* Get the name of the method to use for hashing the user's password.
+ *
+ * @return string
*/
- public function getPasswordHashMethod(): string
+ public function getPasswordHashMethod()
{
if (property_exists($this, 'passwordHashMethod')) {
return $this->passwordHashMethod;
@@ -96,8 +106,13 @@ trait HasPassword
/**
* Set the changed password.
+ *
+ * @param string $oldPassword
+ * @param string $newPassword
+ * @param string $attribute
+ * @return void
*/
- protected function setChangedPassword(string $oldPassword, string $newPassword, string $attribute): void
+ protected function setChangedPassword($oldPassword, $newPassword, $attribute)
{
// Create batch modification for removing the old password.
$this->addModification(
@@ -120,15 +135,13 @@ trait HasPassword
/**
* Set the password on the model.
+ *
+ * @param string $password
+ * @param string $attribute
+ * @return void
*/
- protected function setPassword(string $password, string $attribute): void
+ protected function setPassword($password, $attribute)
{
- if (! $this->exists) {
- $this->setRawAttribute($attribute, $password);
-
- return;
- }
-
$this->addModification(
$this->newBatchModification(
$attribute,
@@ -141,9 +154,14 @@ trait HasPassword
/**
* Encode / hash the given password.
*
+ * @param string $method
+ * @param string $password
+ * @param string $salt
+ * @return string
+ *
* @throws LdapRecordException
*/
- protected function getHashedPassword(string $method, string $password, ?string $salt = null): string
+ protected function getHashedPassword($method, $password, $salt = null)
{
if (! method_exists(Password::class, $method)) {
throw new LdapRecordException("Password hashing method [{$method}] does not exist.");
@@ -159,22 +177,18 @@ trait HasPassword
/**
* Validates that the current LDAP connection is secure.
*
+ * @return void
+ *
* @throws ConnectionException
*/
- protected function assertSecureConnection(): void
+ protected function validateSecureConnection()
{
$connection = $this->getConnection();
- $config = $connection->getConfiguration();
-
- if ($config->get('allow_insecure_password_changes') === true) {
- return;
- }
-
if ($connection->isConnected()) {
$secure = $connection->getLdapConnection()->canChangePasswords();
} else {
- $secure = $config->get('use_ssl') || $config->get('use_tls');
+ $secure = $connection->getConfiguration()->get('use_ssl') || $connection->getConfiguration()->get('use_tls');
}
if (! $secure) {
@@ -186,11 +200,14 @@ trait HasPassword
/**
* Attempt to retrieve the password's salt.
+ *
+ * @param string $method
+ * @return string|null
*/
- public function getPasswordSalt(string $method): ?string
+ public function getPasswordSalt($method)
{
if (! Password::hashMethodRequiresSalt($method)) {
- return null;
+ return;
}
return Password::getSalt($this->password);
@@ -217,11 +234,15 @@ trait HasPassword
$value = null
);
- return match ((int) $algo) {
- Password::CRYPT_SALT_TYPE_MD5 => 'md5'.$method,
- Password::CRYPT_SALT_TYPE_SHA256 => 'sha256'.$method,
- Password::CRYPT_SALT_TYPE_SHA512 => 'sha512'.$method,
- default => $method,
- };
+ switch ($algo) {
+ case Password::CRYPT_SALT_TYPE_MD5:
+ return 'md5'.$method;
+ case Password::CRYPT_SALT_TYPE_SHA256:
+ return 'sha256'.$method;
+ case Password::CRYPT_SALT_TYPE_SHA512:
+ return 'sha512'.$method;
+ default:
+ return $method;
+ }
}
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Concerns/HasRelationships.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Concerns/HasRelationships.php
index e81c3a15e..87c0a7cc8 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Concerns/HasRelationships.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Concerns/HasRelationships.php
@@ -12,47 +12,61 @@ trait HasRelationships
{
/**
* Returns a new has one relationship.
+ *
+ * @param mixed $related
+ * @param string $relationKey
+ * @param string $foreignKey
+ * @return HasOne
*/
- public function hasOne(array|string $related, string $relationKey, string $foreignKey = 'dn'): HasOne
+ public function hasOne($related, $relationKey, $foreignKey = 'dn')
{
return new HasOne($this->newQuery(), $this, $related, $relationKey, $foreignKey);
}
/**
* Returns a new has many relationship.
+ *
+ * @param mixed $related
+ * @param string $relationKey
+ * @param string $foreignKey
+ * @return HasMany
*/
- public function hasMany(array|string $related, string $relationKey, string $foreignKey = 'dn'): HasMany
+ public function hasMany($related, $relationKey, $foreignKey = 'dn')
{
return new HasMany($this->newQuery(), $this, $related, $relationKey, $foreignKey, $this->guessRelationshipName());
}
/**
* Returns a new has many in relationship.
+ *
+ * @param mixed $related
+ * @param string $relationKey
+ * @param string $foreignKey
+ * @return HasManyIn
*/
- public function hasManyIn(array|string $related, string $relationKey, string $foreignKey = 'dn'): HasManyIn
+ public function hasManyIn($related, $relationKey, $foreignKey = 'dn')
{
return new HasManyIn($this->newQuery(), $this, $related, $relationKey, $foreignKey, $this->guessRelationshipName());
}
/**
* Get a relationship by its name.
+ *
+ * @param string $relationName
+ * @return Relation|null
*/
- public function getRelation(?string $relationName = null): ?Relation
+ public function getRelation($relationName)
{
- if (is_null($relationName)) {
- return null;
- }
-
if (! method_exists($this, $relationName)) {
- return null;
+ return;
}
if (! $relation = $this->{$relationName}()) {
- return null;
+ return;
}
if (! $relation instanceof Relation) {
- return null;
+ return;
}
return $relation;
@@ -60,8 +74,10 @@ trait HasRelationships
/**
* Get the relationships name.
+ *
+ * @return string|null
*/
- protected function guessRelationshipName(): ?string
+ protected function guessRelationshipName()
{
return Arr::last(debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS, 3))['function'];
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Concerns/HasScopes.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Concerns/HasScopes.php
index 7420620ce..cb227fecc 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Concerns/HasScopes.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Concerns/HasScopes.php
@@ -2,34 +2,38 @@
namespace LdapRecord\Models\Concerns;
-use LdapRecord\Query\Model\Builder;
-
/** @mixin \LdapRecord\Models\Model */
trait HasScopes
{
/**
* Begin querying the direct descendants of the model.
+ *
+ * @return \LdapRecord\Query\Model\Builder
*/
- public function descendants(): Builder
+ public function descendants()
{
- return $this->in($this->getDn())->list();
+ return $this->in($this->getDn())->listing();
}
/**
* Begin querying the direct ancestors of the model.
+ *
+ * @return \LdapRecord\Query\Model\Builder
*/
- public function ancestors(): Builder
+ public function ancestors()
{
$parent = $this->getParentDn($this->getDn());
- return $this->in($this->getParentDn($parent))->list();
+ return $this->in($this->getParentDn($parent))->listing();
}
/**
* Begin querying the direct siblings of the model.
+ *
+ * @return \LdapRecord\Query\Model\Builder
*/
- public function siblings(): Builder
+ public function siblings()
{
- return $this->in($this->getParentDn($this->getDn()))->list();
+ return $this->in($this->getParentDn($this->getDn()))->listing();
}
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Concerns/HidesAttributes.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Concerns/HidesAttributes.php
index 533e8fc58..ecd328dab 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Concerns/HidesAttributes.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Concerns/HidesAttributes.php
@@ -13,29 +13,37 @@ trait HidesAttributes
{
/**
* The attributes that should be hidden for serialization.
+ *
+ * @var array
*/
- protected array $hidden = [];
+ protected $hidden = [];
/**
* The attributes that should be visible in serialization.
+ *
+ * @var array
*/
- protected array $visible = [];
+ protected $visible = [];
/**
* Get the hidden attributes for the model.
+ *
+ * @return array
*/
- public function getHidden(): array
+ public function getHidden()
{
- return array_map(
- $this->normalizeAttributeKey(...),
- $this->hidden
- );
+ return array_map(function ($key) {
+ return $this->normalizeAttributeKey($key);
+ }, $this->hidden);
}
/**
* Set the hidden attributes for the model.
+ *
+ * @param array $hidden
+ * @return $this
*/
- public function setHidden(array $hidden): static
+ public function setHidden(array $hidden)
{
$this->hidden = $hidden;
@@ -44,8 +52,11 @@ trait HidesAttributes
/**
* Add hidden attributes for the model.
+ *
+ * @param array|string|null $attributes
+ * @return void
*/
- public function addHidden(array|string|null $attributes = null): void
+ public function addHidden($attributes = null)
{
$this->hidden = array_merge(
$this->hidden,
@@ -55,19 +66,23 @@ trait HidesAttributes
/**
* Get the visible attributes for the model.
+ *
+ * @return array
*/
- public function getVisible(): array
+ public function getVisible()
{
- return array_map(
- $this->normalizeAttributeKey(...),
- $this->visible
- );
+ return array_map(function ($key) {
+ return $this->normalizeAttributeKey($key);
+ }, $this->visible);
}
/**
* Set the visible attributes for the model.
+ *
+ * @param array $visible
+ * @return $this
*/
- public function setVisible(array $visible): static
+ public function setVisible(array $visible)
{
$this->visible = $visible;
@@ -76,8 +91,11 @@ trait HidesAttributes
/**
* Add visible attributes for the model.
+ *
+ * @param array|string|null $attributes
+ * @return void
*/
- public function addVisible(array|string|null $attributes = null): void
+ public function addVisible($attributes = null)
{
$this->visible = array_merge(
$this->visible,
@@ -87,8 +105,11 @@ trait HidesAttributes
/**
* Make the given, typically hidden, attributes visible.
+ *
+ * @param array|string $attributes
+ * @return $this
*/
- public function makeVisible(array|string $attributes): static
+ public function makeVisible($attributes)
{
$this->hidden = array_diff($this->hidden, (array) $attributes);
@@ -101,8 +122,11 @@ trait HidesAttributes
/**
* Make the given, typically visible, attributes hidden.
+ *
+ * @param array|string $attributes
+ * @return $this
*/
- public function makeHidden(array|string $attributes): static
+ public function makeHidden($attributes)
{
$attributes = (array) $attributes;
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Concerns/SerializesAndRestoresPropertyValues.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Concerns/SerializesAndRestoresPropertyValues.php
index bc4fa28cd..cf550c749 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Concerns/SerializesAndRestoresPropertyValues.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Concerns/SerializesAndRestoresPropertyValues.php
@@ -7,8 +7,12 @@ trait SerializesAndRestoresPropertyValues
{
/**
* Get the property value prepared for serialization.
+ *
+ * @param string $property
+ * @param mixed $value
+ * @return mixed
*/
- protected function getSerializedPropertyValue(string $property, mixed $value): mixed
+ protected function getSerializedPropertyValue($property, $value)
{
if ($property === 'original') {
return $this->originalToArray();
@@ -23,8 +27,12 @@ trait SerializesAndRestoresPropertyValues
/**
* Get the unserialized property value after deserialization.
+ *
+ * @param string $property
+ * @param mixed $value
+ * @return mixed
*/
- protected function getUnserializedPropertyValue(string $property, mixed $value): mixed
+ protected function getUnserializedPropertyValue($property, $value)
{
if ($property === 'original') {
return $this->arrayToOriginal($value);
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Concerns/SerializesProperties.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Concerns/SerializesProperties.php
index 65428fa40..91f4bcfe3 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Concerns/SerializesProperties.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Concerns/SerializesProperties.php
@@ -11,8 +11,10 @@ trait SerializesProperties
/**
* Prepare the attributes for serialization.
+ *
+ * @return array
*/
- public function __sleep(): array
+ public function __sleep()
{
$properties = (new ReflectionClass($this))->getProperties();
@@ -23,15 +25,17 @@ trait SerializesProperties
));
}
- return array_values(array_filter(
- array_map(fn ($p) => $p->isStatic() ? null : $p->getName(), $properties)
- ));
+ return array_values(array_filter(array_map(function ($p) {
+ return $p->isStatic() ? null : $p->getName();
+ }, $properties)));
}
/**
* Restore the attributes after serialization.
+ *
+ * @return void
*/
- public function __wakeup(): void
+ public function __wakeup()
{
foreach ((new ReflectionClass($this))->getProperties() as $property) {
if ($property->isStatic()) {
@@ -47,8 +51,10 @@ trait SerializesProperties
/**
* Prepare the model for serialization.
+ *
+ * @return array
*/
- public function __serialize(): array
+ public function __serialize()
{
$values = [];
@@ -86,8 +92,11 @@ trait SerializesProperties
/**
* Restore the model after serialization.
+ *
+ * @param array $values
+ * @return void
*/
- public function __unserialize(array $values): void
+ public function __unserialize(array $values)
{
$properties = (new ReflectionClass($this))->getProperties();
@@ -121,8 +130,11 @@ trait SerializesProperties
/**
* Get the property value for the given property.
+ *
+ * @param ReflectionProperty $property
+ * @return mixed
*/
- protected function getPropertyValue(ReflectionProperty $property): mixed
+ protected function getPropertyValue(ReflectionProperty $property)
{
$property->setAccessible(true);
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/DetectsResetIntegers.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/DetectsResetIntegers.php
index 1f2e826bf..7b8d1830e 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/DetectsResetIntegers.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/DetectsResetIntegers.php
@@ -10,9 +10,12 @@ trait DetectsResetIntegers
* The integer values '0' and '-1' can be used on certain
* LDAP attributes to instruct the server to reset the
* value to an 'unset' or 'cleared' state.
+ *
+ * @param mixed $value
+ * @return bool
*/
- protected function valueIsResetInteger(mixed $value): bool
+ protected function valueIsResetInteger($value)
{
- return in_array($value, [0, -1], true);
+ return in_array($value, [0, -1], $strict = true);
}
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/DirectoryServer/Entry.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/DirectoryServer/Entry.php
index 947daca1a..a67200e94 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/DirectoryServer/Entry.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/DirectoryServer/Entry.php
@@ -9,6 +9,8 @@ class Entry extends Model implements DirectoryServer
{
/**
* The attribute key that contains the models object GUID.
+ *
+ * @var string
*/
- protected string $guidKey = 'gidNumber';
+ protected $guidKey = 'gidNumber';
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/DirectoryServer/Group.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/DirectoryServer/Group.php
index c5b0c17d8..49a6e0aae 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/DirectoryServer/Group.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/DirectoryServer/Group.php
@@ -6,8 +6,10 @@ class Group extends Entry
{
/**
* The object classes of the LDAP model.
+ *
+ * @var array
*/
- public static array $objectClasses = [
+ public static $objectClasses = [
'top',
'groupOfUniqueNames',
'posixGroup',
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/DirectoryServer/User.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/DirectoryServer/User.php
index 4a3bc143c..430588b0a 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/DirectoryServer/User.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/DirectoryServer/User.php
@@ -6,8 +6,10 @@ class User extends Entry
{
/**
* The object classes of the LDAP model.
+ *
+ * @var array
*/
- public static array $objectClasses = [
+ public static $objectClasses = [
'top',
'nsPerson',
'nsAccount',
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Events/Event.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Events/Event.php
index 340bc2ea5..8dbd1d29a 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Events/Event.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Events/Event.php
@@ -8,11 +8,15 @@ abstract class Event
{
/**
* The model that the event is being triggered on.
+ *
+ * @var Model
*/
- protected Model $model;
+ protected $model;
/**
* Constructor.
+ *
+ * @param Model $model
*/
public function __construct(Model $model)
{
@@ -20,9 +24,11 @@ abstract class Event
}
/**
- * Get the model that generated the event.
+ * Returns the model that generated the event.
+ *
+ * @return Model
*/
- public function getModel(): Model
+ public function getModel()
{
return $this->model;
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Events/Renaming.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Events/Renaming.php
index 4890e2bfc..5e7be97d7 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Events/Renaming.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Events/Renaming.php
@@ -8,18 +8,26 @@ class Renaming extends Event
{
/**
* The models RDN.
+ *
+ * @var string
*/
- protected string $rdn;
+ protected $rdn;
/**
* The models new parent DN.
+ *
+ * @var string
*/
- protected string $newParentDn;
+ protected $newParentDn;
/**
* Constructor.
+ *
+ * @param Model $model
+ * @param string $rdn
+ * @param string $newParentDn
*/
- public function __construct(Model $model, string $rdn, string $newParentDn)
+ public function __construct(Model $model, $rdn, $newParentDn)
{
parent::__construct($model);
@@ -29,16 +37,20 @@ class Renaming extends Event
/**
* Get the models RDN.
+ *
+ * @return string
*/
- public function getRdn(): string
+ public function getRdn()
{
return $this->rdn;
}
/**
* Get the models parent DN.
+ *
+ * @return string
*/
- public function getNewParentDn(): string
+ public function getNewParentDn()
{
return $this->newParentDn;
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/FreeIPA/Entry.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/FreeIPA/Entry.php
index 4f29ef033..be6322b15 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/FreeIPA/Entry.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/FreeIPA/Entry.php
@@ -13,34 +13,41 @@ class Entry extends BaseEntry implements FreeIPA
{
/**
* The attribute key that contains the models object GUID.
+ *
+ * @var string
*/
- protected string $guidKey = 'ipauniqueid';
+ protected $guidKey = 'ipauniqueid';
/**
* The default attributes that should be mutated to dates.
+ *
+ * @var array
*/
- protected array $defaultDates = [
+ protected $defaultDates = [
'krblastpwdchange' => 'ldap',
'krbpasswordexpiration' => 'ldap',
];
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- protected static function boot(): void
+ protected static function boot()
{
parent::boot();
// Here we'll add a global scope to all FreeIPA models to ensure the
// Entry UUID is always selected on each query. This attribute is
// virtual, so it must be manually selected to be included.
- static::addGlobalScope(new AddEntryUuidToSelects);
+ static::addGlobalScope(new AddEntryUuidToSelects());
}
/**
* Create a new query builder.
+ *
+ * @param Connection $connection
+ * @return FreeIpaBuilder
*/
- public function newQueryBuilder(Connection $connection): FreeIpaBuilder
+ public function newQueryBuilder(Connection $connection)
{
return new FreeIpaBuilder($connection);
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/FreeIPA/Group.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/FreeIPA/Group.php
index 941977595..10fd93404 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/FreeIPA/Group.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/FreeIPA/Group.php
@@ -2,14 +2,14 @@
namespace LdapRecord\Models\FreeIPA;
-use LdapRecord\Models\Relations\HasMany;
-
class Group extends Entry
{
/**
* The object classes of the LDAP model.
+ *
+ * @var array
*/
- public static array $objectClasses = [
+ public static $objectClasses = [
'top',
'groupofnames',
'nestedgroup',
@@ -20,17 +20,21 @@ class Group extends Entry
/**
* The groups relationship.
*
- * Retrieves groups that the current group is a part of.
+ * Retrieves groups that the current group is apart of.
+ *
+ * @return \LdapRecord\Models\Relations\HasMany
*/
- public function groups(): HasMany
+ public function groups()
{
return $this->hasMany(self::class, 'member');
}
/**
* Retrieve the members of the group.
+ *
+ * @return \LdapRecord\Models\Relations\HasMany
*/
- public function members(): HasMany
+ public function members()
{
return $this->hasMany(User::class, 'memberof')->using($this, 'member');
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/FreeIPA/Scopes/AddEntryUuidToSelects.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/FreeIPA/Scopes/AddEntryUuidToSelects.php
index d35ed9141..581b5beed 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/FreeIPA/Scopes/AddEntryUuidToSelects.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/FreeIPA/Scopes/AddEntryUuidToSelects.php
@@ -10,8 +10,12 @@ class AddEntryUuidToSelects implements Scope
{
/**
* Add the entry UUID to the selected attributes.
+ *
+ * @param Builder $query
+ * @param Model $model
+ * @return void
*/
- public function apply(Builder $query, Model $model): void
+ public function apply(Builder $query, Model $model)
{
empty($query->columns)
? $query->addSelect(['*', $model->getGuidKey()])
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/FreeIPA/User.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/FreeIPA/User.php
index 47964f010..24c7f3b7d 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/FreeIPA/User.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/FreeIPA/User.php
@@ -2,14 +2,14 @@
namespace LdapRecord\Models\FreeIPA;
-use LdapRecord\Models\Relations\HasMany;
-
class User extends Entry
{
/**
* The object classes of the LDAP model.
+ *
+ * @var array
*/
- public static array $objectClasses = [
+ public static $objectClasses = [
'top',
'person',
'inetorgperson',
@@ -17,9 +17,11 @@ class User extends Entry
];
/**
- * Retrieve groups that the current user is a part of.
+ * Retrieve groups that the current user is apart of.
+ *
+ * @return \LdapRecord\Models\Relations\HasMany
*/
- public function groups(): HasMany
+ public function groups()
{
return $this->hasMany(Group::class, 'member');
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Model.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Model.php
index b17d0793a..932c1a3b1 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Model.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Model.php
@@ -11,92 +11,110 @@ use LdapRecord\Container;
use LdapRecord\EscapesValues;
use LdapRecord\Models\Attributes\DistinguishedName;
use LdapRecord\Models\Attributes\Guid;
-use LdapRecord\Query\Builder as BaseBuilder;
use LdapRecord\Query\Model\Builder;
use LdapRecord\Support\Arr;
-use RuntimeException;
-use Stringable;
use UnexpectedValueException;
/** @mixin Builder */
-abstract class Model implements Arrayable, ArrayAccess, JsonSerializable, Stringable
+abstract class Model implements ArrayAccess, Arrayable, JsonSerializable
{
- use Concerns\HasAttributes;
- use Concerns\HasEvents;
- use Concerns\HasGlobalScopes;
- use Concerns\HasRelationships;
- use Concerns\HasScopes;
- use Concerns\HidesAttributes;
- use Concerns\SerializesProperties;
use EscapesValues;
+ use Concerns\HasEvents;
+ use Concerns\HasScopes;
+ use Concerns\HasAttributes;
+ use Concerns\HasGlobalScopes;
+ use Concerns\HidesAttributes;
+ use Concerns\HasRelationships;
+ use Concerns\SerializesProperties;
/**
* Indicates if the model exists in the directory.
+ *
+ * @var bool
*/
- public bool $exists = false;
+ public $exists = false;
/**
* Indicates whether the model was created during the current request lifecycle.
+ *
+ * @var bool
*/
- public bool $wasRecentlyCreated = false;
+ public $wasRecentlyCreated = false;
/**
* Indicates whether the model was renamed during the current request lifecycle.
+ *
+ * @var bool
*/
- public bool $wasRecentlyRenamed = false;
+ public $wasRecentlyRenamed = false;
/**
* The models distinguished name.
+ *
+ * @var string|null
*/
- protected ?string $dn = null;
+ protected $dn;
/**
* The base DN of where the model should be created in.
+ *
+ * @var string|null
*/
- protected ?string $in = null;
+ protected $in;
/**
* The object classes of the model.
+ *
+ * @var array
*/
- public static array $objectClasses = [];
+ public static $objectClasses = [];
/**
* The connection container instance.
+ *
+ * @var Container
*/
- protected static ?Container $container = null;
+ protected static $container;
/**
* The connection name for the model.
+ *
+ * @var string|null
*/
- protected ?string $connection = null;
+ protected $connection;
/**
- * The attribute key containing the models object GUID.
+ * The attribute key that contains the models object GUID.
+ *
+ * @var string
*/
- protected string $guidKey = 'objectguid';
+ protected $guidKey = 'objectguid';
/**
- * The array of the model's modifications.
+ * Contains the models modifications.
+ *
+ * @var array
*/
- protected array $modifications = [];
-
- /**
- * The array of booted models.
- */
- protected static array $booted = [];
+ protected $modifications = [];
/**
* The array of global scopes on the model.
+ *
+ * @var array
*/
- protected static array $globalScopes = [];
+ protected static $globalScopes = [];
/**
- * The morph model cache containing object classes and their corresponding models.
+ * The array of booted models.
+ *
+ * @var array
*/
- protected static array $morphCache = [];
+ protected static $booted = [];
/**
* Constructor.
+ *
+ * @param array $attributes
*/
public function __construct(array $attributes = [])
{
@@ -107,8 +125,10 @@ abstract class Model implements Arrayable, ArrayAccess, JsonSerializable, String
/**
* Check if the model needs to be booted and if so, do it.
+ *
+ * @return void
*/
- protected function bootIfNotBooted(): void
+ protected function bootIfNotBooted()
{
if (! isset(static::$booted[static::class])) {
static::$booted[static::class] = true;
@@ -119,16 +139,20 @@ abstract class Model implements Arrayable, ArrayAccess, JsonSerializable, String
/**
* The "boot" method of the model.
+ *
+ * @return void
*/
- protected static function boot(): void
+ protected static function boot()
{
//
}
/**
- * Clear the list of booted models, so they will be re-booted.
+ * Clear the list of booted models so they will be re-booted.
+ *
+ * @return void
*/
- public static function clearBootedModels(): void
+ public static function clearBootedModels()
{
static::$booted = [];
@@ -137,8 +161,12 @@ abstract class Model implements Arrayable, ArrayAccess, JsonSerializable, String
/**
* Handle dynamic method calls into the model.
+ *
+ * @param string $method
+ * @param array $parameters
+ * @return mixed
*/
- public function __call(string $method, array $parameters): mixed
+ public function __call($method, $parameters)
{
if (method_exists($this, $method)) {
return $this->$method(...$parameters);
@@ -149,66 +177,88 @@ abstract class Model implements Arrayable, ArrayAccess, JsonSerializable, String
/**
* Handle dynamic static method calls into the method.
+ *
+ * @param string $method
+ * @param array $parameters
+ * @return mixed
*/
- public static function __callStatic(string $method, array $parameters): mixed
+ public static function __callStatic($method, $parameters)
{
- return (new static)->$method(...$parameters);
+ return (new static())->$method(...$parameters);
}
/**
- * Get the models distinguished name.
+ * Returns the models distinguished name.
+ *
+ * @return string|null
*/
- public function getDn(): ?string
+ public function getDn()
{
return $this->dn;
}
/**
- * Set the model's distinguished name.
+ * Set the models distinguished name.
+ *
+ * @param string $dn
+ * @return $this
*/
- public function setDn(?string $dn = null): static
+ public function setDn($dn)
{
- $this->dn = $dn;
+ $this->dn = (string) $dn;
return $this;
}
/**
- * A mutator for setting the model's distinguished name.
+ * A mutator for setting the models distinguished name.
+ *
+ * @param string $dn
+ * @return $this
*/
- public function setDnAttribute(string $dn): static
+ public function setDnAttribute($dn)
{
return $this->setRawAttribute('dn', $dn)->setDn($dn);
}
/**
- * A mutator for setting the model's distinguished name.
+ * A mutator for setting the models distinguished name.
+ *
+ * @param string $dn
+ * @return $this
*/
- public function setDistinguishedNameAttribute(string $dn): static
+ public function setDistinguishedNameAttribute($dn)
{
return $this->setRawAttribute('distinguishedname', $dn)->setDn($dn);
}
/**
* Get the connection for the model.
+ *
+ * @return Connection
*/
- public function getConnection(): Connection
+ public function getConnection()
{
return static::resolveConnection($this->getConnectionName());
}
/**
* Get the current connection name for the model.
+ *
+ * @return string
*/
- public function getConnectionName(): ?string
+ public function getConnectionName()
{
return $this->connection;
}
/**
* Set the connection associated with the model.
+ *
+ * @param string $name
+ * @return $this
*/
- public function setConnection(?string $name = null): static
+ public function setConnection($name)
{
$this->connection = $name;
@@ -217,18 +267,24 @@ abstract class Model implements Arrayable, ArrayAccess, JsonSerializable, String
/**
* Make a new model instance.
+ *
+ * @param array $attributes
+ * @return static
*/
- public static function make(array $attributes = []): static
+ public static function make($attributes = [])
{
return new static($attributes);
}
/**
* Begin querying the model on a given connection.
+ *
+ * @param string|null $connection
+ * @return Builder
*/
- public static function on(?string $connection = null): Builder
+ public static function on($connection = null)
{
- $instance = new static;
+ $instance = new static();
$instance->setConnection($connection);
@@ -237,8 +293,11 @@ abstract class Model implements Arrayable, ArrayAccess, JsonSerializable, String
/**
* Get all the models from the directory.
+ *
+ * @param array|mixed $attributes
+ * @return Collection|static[]
*/
- public static function all(array|string $attributes = ['*']): array|Collection
+ public static function all($attributes = ['*'])
{
return static::query()->select($attributes)->paginate();
}
@@ -246,15 +305,17 @@ abstract class Model implements Arrayable, ArrayAccess, JsonSerializable, String
/**
* Get the RootDSE (AD schema) record from the directory.
*
+ * @param string|null $connection
+ * @return Model
+ *
* @throws \LdapRecord\Models\ModelNotFoundException
*/
- public static function getRootDse(?string $connection = null): Model
+ public static function getRootDse($connection = null)
{
- /** @var Model $model */
$model = static::getRootDseModel();
return $model::on($connection ?? (new $model)->getConnectionName())
- ->in()
+ ->in(null)
->read()
->whereHas('objectclass')
->firstOrFail();
@@ -265,31 +326,40 @@ abstract class Model implements Arrayable, ArrayAccess, JsonSerializable, String
*
* @return class-string
*/
- protected static function getRootDseModel(): string
+ protected static function getRootDseModel()
{
- $instance = new static;
+ $instance = (new static);
- return match (true) {
- $instance instanceof Types\ActiveDirectory => ActiveDirectory\Entry::class,
- $instance instanceof Types\DirectoryServer => DirectoryServer\Entry::class,
- $instance instanceof Types\OpenLDAP => OpenLDAP\Entry::class,
- $instance instanceof Types\FreeIPA => FreeIPA\Entry::class,
- default => Entry::class,
- };
+ switch (true) {
+ case $instance instanceof Types\ActiveDirectory:
+ return ActiveDirectory\Entry::class;
+ case $instance instanceof Types\DirectoryServer:
+ return OpenLDAP\Entry::class;
+ case $instance instanceof Types\OpenLDAP:
+ return OpenLDAP\Entry::class;
+ case $instance instanceof Types\FreeIPA:
+ return FreeIPA\Entry::class;
+ default:
+ return Entry::class;
+ }
}
/**
* Begin querying the model.
+ *
+ * @return Builder
*/
- public static function query(): Builder
+ public static function query()
{
- return (new static)->newQuery();
+ return (new static())->newQuery();
}
/**
* Get a new query for builder filtered by the current models object classes.
+ *
+ * @return Builder
*/
- public function newQuery(): Builder
+ public function newQuery()
{
return $this->registerModelScopes(
$this->newQueryWithoutScopes()
@@ -298,8 +368,10 @@ abstract class Model implements Arrayable, ArrayAccess, JsonSerializable, String
/**
* Get a new query builder that doesn't have any global scopes.
+ *
+ * @return Builder
*/
- public function newQueryWithoutScopes(): Builder
+ public function newQueryWithoutScopes()
{
return static::resolveConnection(
$this->getConnectionName()
@@ -308,64 +380,85 @@ abstract class Model implements Arrayable, ArrayAccess, JsonSerializable, String
/**
* Create a new query builder.
+ *
+ * @param Connection $connection
+ * @return Builder
*/
- public function newQueryBuilder(Connection $connection): Builder
+ public function newQueryBuilder(Connection $connection)
{
return new Builder($connection);
}
/**
* Create a new model instance.
+ *
+ * @param array $attributes
+ * @return static
*/
- public function newInstance(array $attributes = []): static
+ public function newInstance(array $attributes = [])
{
return (new static($attributes))->setConnection($this->getConnectionName());
}
/**
* Resolve a connection instance.
+ *
+ * @param string|null $connection
+ * @return Connection
*/
- public static function resolveConnection(?string $connection = null): Connection
+ public static function resolveConnection($connection = null)
{
- return static::getConnectionContainer()->getConnection($connection);
+ return static::getConnectionContainer()->get($connection);
}
/**
* Get the connection container.
+ *
+ * @return Container
*/
- public static function getConnectionContainer(): Container
+ public static function getConnectionContainer()
{
return static::$container ?? static::getDefaultConnectionContainer();
}
/**
* Get the default singleton container instance.
+ *
+ * @return Container
*/
- public static function getDefaultConnectionContainer(): Container
+ public static function getDefaultConnectionContainer()
{
return Container::getInstance();
}
/**
* Set the connection container.
+ *
+ * @param Container $container
+ * @return void
*/
- public static function setConnectionContainer(Container $container): void
+ public static function setConnectionContainer(Container $container)
{
static::$container = $container;
}
/**
* Unset the connection container.
+ *
+ * @return void
*/
- public static function unsetConnectionContainer(): void
+ public static function unsetConnectionContainer()
{
static::$container = null;
}
/**
* Register the query scopes for this builder instance.
+ *
+ * @param Builder $builder
+ * @return Builder
*/
- public function registerModelScopes(Builder $builder): Builder
+ public function registerModelScopes($builder)
{
$this->applyObjectClassScopes($builder);
@@ -376,8 +469,11 @@ abstract class Model implements Arrayable, ArrayAccess, JsonSerializable, String
/**
* Register the global model scopes.
+ *
+ * @param Builder $builder
+ * @return Builder
*/
- public function registerGlobalScopes(Builder $builder): Builder
+ public function registerGlobalScopes($builder)
{
foreach ($this->getGlobalScopes() as $identifier => $scope) {
$builder->withGlobalScope($identifier, $scope);
@@ -388,8 +484,11 @@ abstract class Model implements Arrayable, ArrayAccess, JsonSerializable, String
/**
* Apply the model object class scopes to the given builder instance.
+ *
+ * @param Builder $query
+ * @return void
*/
- public function applyObjectClassScopes(Builder $query): void
+ public function applyObjectClassScopes(Builder $query)
{
foreach (static::$objectClasses as $objectClass) {
$query->where('objectclass', '=', $objectClass);
@@ -397,121 +496,164 @@ abstract class Model implements Arrayable, ArrayAccess, JsonSerializable, String
}
/**
- * Get the models distinguished name when the model is converted to a string.
+ * Returns the models distinguished name when the model is converted to a string.
+ *
+ * @return null|string
*/
- public function __toString(): string
+ public function __toString()
{
- return (string) $this->getDn();
+ return $this->getDn();
}
/**
* Returns a new batch modification.
+ *
+ * @param string|null $attribute
+ * @param string|int|null $type
+ * @param array $values
+ * @return BatchModification
*/
- public function newBatchModification(?string $attribute = null, ?int $type = null, array $values = []): BatchModification
+ public function newBatchModification($attribute = null, $type = null, $values = [])
{
return new BatchModification($attribute, $type, $values);
}
/**
* Returns a new collection with the specified items.
+ *
+ * @param mixed $items
+ * @return Collection
*/
- public function newCollection(mixed $items = []): Collection
+ public function newCollection($items = [])
{
return new Collection($items);
}
/**
* Dynamically retrieve attributes on the object.
+ *
+ * @param string $key
+ * @return mixed
*/
- public function __get(string $key): mixed
+ public function __get($key)
{
return $this->getAttribute($key);
}
/**
* Dynamically set attributes on the object.
+ *
+ * @param string $key
+ * @param mixed $value
+ * @return $this
*/
- public function __set(string $key, mixed $value): void
+ public function __set($key, $value)
{
- $this->setAttribute($key, $value);
+ return $this->setAttribute($key, $value);
}
/**
* Determine if the given offset exists.
+ *
+ * @param string $offset
+ * @return bool
*/
#[\ReturnTypeWillChange]
- public function offsetExists(mixed $offset): bool
+ public function offsetExists($offset)
{
return ! is_null($this->getAttribute($offset));
}
/**
* Get the value for a given offset.
+ *
+ * @param string $offset
+ * @return mixed
*/
#[\ReturnTypeWillChange]
- public function offsetGet(mixed $offset): mixed
+ public function offsetGet($offset)
{
return $this->getAttribute($offset);
}
/**
* Set the value at the given offset.
+ *
+ * @param string $offset
+ * @param mixed $value
+ * @return void
*/
#[\ReturnTypeWillChange]
- public function offsetSet(mixed $offset, mixed $value): void
+ public function offsetSet($offset, $value)
{
$this->setAttribute($offset, $value);
}
/**
* Unset the value at the given offset.
+ *
+ * @param string $offset
+ * @return void
*/
#[\ReturnTypeWillChange]
- public function offsetUnset(mixed $offset): void
+ public function offsetUnset($offset)
{
unset($this->attributes[$offset]);
}
/**
* Determine if an attribute exists on the model.
+ *
+ * @param string $key
+ * @return bool
*/
- public function __isset(string $key): bool
+ public function __isset($key)
{
return $this->offsetExists($key);
}
/**
* Unset an attribute on the model.
+ *
+ * @param string $key
+ * @return void
*/
- public function __unset(string $key): void
+ public function __unset($key)
{
$this->offsetUnset($key);
}
/**
* Convert the model to its JSON encodeable array form.
+ *
+ * @return array
*/
- public function toArray(): array
+ public function toArray()
{
return $this->attributesToArray();
}
/**
* Convert the model's attributes into JSON encodeable values.
+ *
+ * @return array
*/
#[\ReturnTypeWillChange]
- public function jsonSerialize(): array
+ public function jsonSerialize()
{
return $this->toArray();
}
/**
* Convert the attributes for JSON serialization.
+ *
+ * @param array $attributes
+ * @return array
*/
- protected function convertAttributesForJson(array $attributes = []): array
+ protected function convertAttributesForJson(array $attributes = [])
{
// If the model has a GUID set, we need to convert it to its
- // string format, due to it being in binary. Otherwise,
+ // string format, due to it being in binary. Otherwise
// we will receive a JSON serialization exception.
if (isset($attributes[$this->guidKey])) {
$attributes[$this->guidKey] = [$this->getConvertedGuid(
@@ -524,25 +666,21 @@ abstract class Model implements Arrayable, ArrayAccess, JsonSerializable, String
/**
* Convert the attributes from JSON serialization.
+ *
+ * @param array $attributes
+ * @return array
*/
- protected function convertAttributesFromJson(array $attributes = []): array
+ protected function convertAttributesFromJson(array $attributes = [])
{
- // Here we are converting the model's GUID and SID attributes
- // back to their original values from serialization, so that
- // their original value may be used and compared against.
- if (isset($attributes[$this->guidKey])) {
- $attributes[$this->guidKey] = [$this->getBinaryGuid(
- Arr::first($attributes[$this->guidKey])
- )];
- }
-
return $attributes;
}
/**
* Reload a fresh model instance from the directory.
+ *
+ * @return static|false
*/
- public function fresh(): static|false
+ public function fresh()
{
if (! $this->exists) {
return false;
@@ -553,106 +691,50 @@ abstract class Model implements Arrayable, ArrayAccess, JsonSerializable, String
/**
* Determine if two models have the same distinguished name and belong to the same connection.
+ *
+ * @param Model|null $model
+ * @return bool
*/
- public function is(?Model $model = null): bool
+ public function is($model)
{
return ! is_null($model)
- && ! empty($this->dn)
- && ! empty($model->getDn())
- && $this->dn == $model->getDn()
- && $this->getConnectionName() == $model->getConnectionName();
+ && $this->dn == $model->getDn()
+ && $this->getConnectionName() == $model->getConnectionName();
}
/**
* Determine if two models are not the same.
+ *
+ * @param Model|null $model
+ * @return bool
*/
- public function isNot(?Model $model = null): bool
+ public function isNot($model)
{
return ! $this->is($model);
}
/**
* Hydrate a new collection of models from search results.
+ *
+ * @param array $records
+ * @return Collection
*/
- public function hydrate(array $records): Collection
+ public function hydrate($records)
{
return $this->newCollection($records)->transform(function ($attributes) {
- if ($attributes instanceof static) {
- return $attributes;
- }
-
- return static::newInstance()->setRawAttributes($attributes);
+ return $attributes instanceof static
+ ? $attributes
+ : static::newInstance()->setRawAttributes($attributes);
});
}
- /**
- * Morph the model into a one of matching models using their object classes.
- */
- public function morphInto(array $models, ?callable $resolver = null): Model
- {
- if (class_exists($model = $this->determineMorphModel($this, $models, $resolver))) {
- return $this->convert(new $model);
- }
-
- return $this;
- }
-
- /**
- * Morph the model into a one of matching models or throw an exception.
- */
- public function morphIntoOrFail(array $models, ?callable $resolver = null): Model
- {
- $model = $this->morphInto($models, $resolver);
-
- if ($model instanceof $this) {
- throw new RuntimeException(
- 'The model could not be morphed into any of the given models.'
- );
- }
-
- return $model;
- }
-
- /**
- * Determine the model to morph into from the given models.
- *
- * @return class-string|bool
- */
- protected function determineMorphModel(Model $model, array $models, ?callable $resolver = null): string|bool
- {
- $morphModelMap = [];
-
- foreach ($models as $modelClass) {
- $morphModelMap[$modelClass] = static::$morphCache[$modelClass] ??= $this->normalizeObjectClasses(
- $modelClass::$objectClasses
- );
- }
-
- $objectClasses = $this->normalizeObjectClasses(
- $model->getObjectClasses()
- );
-
- $resolver ??= function (array $objectClasses, array $morphModelMap) {
- return array_search($objectClasses, $morphModelMap);
- };
-
- return $resolver($objectClasses, $morphModelMap);
- }
-
- /**
- * Sort and normalize the object classes.
- */
- protected function normalizeObjectClasses(array $classes): array
- {
- sort($classes);
-
- return array_map('strtolower', $classes);
- }
-
/**
* Converts the current model into the given model.
+ *
+ * @param Model $into
+ * @return Model
*/
- public function convert(self $into): Model
+ public function convert(self $into)
{
$into->setDn($this->getDn());
$into->setConnection($this->getConnectionName());
@@ -666,8 +748,10 @@ abstract class Model implements Arrayable, ArrayAccess, JsonSerializable, String
/**
* Refreshes the current models attributes with the directory values.
+ *
+ * @return bool
*/
- public function refresh(): bool
+ public function refresh()
{
if ($model = $this->fresh()) {
$this->setRawAttributes($model->getAttributes());
@@ -680,8 +764,10 @@ abstract class Model implements Arrayable, ArrayAccess, JsonSerializable, String
/**
* Get the model's batch modifications to be processed.
+ *
+ * @return array
*/
- public function getModifications(): array
+ public function getModifications()
{
$builtModifications = [];
@@ -694,8 +780,11 @@ abstract class Model implements Arrayable, ArrayAccess, JsonSerializable, String
/**
* Set the models batch modifications.
+ *
+ * @param array $modifications
+ * @return $this
*/
- public function setModifications(array $modifications = []): static
+ public function setModifications(array $modifications = [])
{
$this->modifications = [];
@@ -709,9 +798,12 @@ abstract class Model implements Arrayable, ArrayAccess, JsonSerializable, String
/**
* Adds a batch modification to the model.
*
+ * @param array|BatchModification $mod
+ * @return $this
+ *
* @throws InvalidArgumentException
*/
- public function addModification(BatchModification|array $mod = []): static
+ public function addModification($mod = [])
{
if ($mod instanceof BatchModification) {
$mod = $mod->get();
@@ -730,68 +822,85 @@ abstract class Model implements Arrayable, ArrayAccess, JsonSerializable, String
/**
* Get the model's guid attribute key name.
+ *
+ * @return string
*/
- public function getGuidKey(): string
+ public function getGuidKey()
{
return $this->guidKey;
}
/**
* Get the model's ANR attributes for querying when incompatible with ANR.
+ *
+ * @return array
*/
- public function getAnrAttributes(): array
+ public function getAnrAttributes()
{
return ['cn', 'sn', 'uid', 'name', 'mail', 'givenname', 'displayname'];
}
/**
* Get the name of the model, or the given DN.
+ *
+ * @param string|null $dn
+ * @return string|null
*/
- public function getName(?string $dn = null): ?string
+ public function getName($dn = null)
{
return $this->newDn($dn ?? $this->dn)->name();
}
/**
* Get the head attribute of the model, or the given DN.
+ *
+ * @param string|null $dn
+ * @return string|null
*/
- public function getHead(?string $dn = null): ?string
+ public function getHead($dn = null)
{
return $this->newDn($dn ?? $this->dn)->head();
}
/**
* Get the RDN of the model, of the given DN.
+ *
+ * @param string|null
+ * @return string|null
*/
- public function getRdn(?string $dn = null): ?string
+ public function getRdn($dn = null)
{
return $this->newDn($dn ?? $this->dn)->relative();
}
/**
* Get the parent distinguished name of the model, or the given DN.
+ *
+ * @param string|null
+ * @return string|null
*/
- public function getParentDn(?string $dn = null): ?string
+ public function getParentDn($dn = null)
{
return $this->newDn($dn ?? $this->dn)->parent();
}
/**
- * Create a new distinguished name.
+ * Create a new Distinguished Name object.
+ *
+ * @param string|null $dn
+ * @return DistinguishedName
*/
- public function newDn(?string $dn = null): DistinguishedName
+ public function newDn($dn = null)
{
- if (! is_null($dn) && str_contains($dn, BaseBuilder::BASE_DN_PLACEHOLDER)) {
- $dn = $this->newQuery()->substituteBaseDn($dn);
- }
-
return new DistinguishedName($dn);
}
/**
* Get the model's object GUID key.
+ *
+ * @return string
*/
- public function getObjectGuidKey(): string
+ public function getObjectGuidKey()
{
return $this->guidKey;
}
@@ -800,80 +909,89 @@ abstract class Model implements Arrayable, ArrayAccess, JsonSerializable, String
* Get the model's binary object GUID.
*
* @see https://msdn.microsoft.com/en-us/library/ms679021(v=vs.85).aspx
+ *
+ * @return string|null
*/
- public function getObjectGuid(): ?string
+ public function getObjectGuid()
{
return $this->getFirstAttribute($this->guidKey);
}
/**
* Get the model's object classes.
+ *
+ * @return array
*/
- public function getObjectClasses(): array
+ public function getObjectClasses()
{
return $this->getAttribute('objectclass', static::$objectClasses);
}
/**
* Get the model's string GUID.
+ *
+ * @param string|null $guid
+ * @return string|null
*/
- public function getConvertedGuid(?string $guid = null): ?string
+ public function getConvertedGuid($guid = null)
{
try {
- return $this->newObjectGuid(
- (string) ($guid ?? $this->getObjectGuid())
+ return (string) $this->newObjectGuid(
+ $guid ?? $this->getObjectGuid()
);
- } catch (InvalidArgumentException) {
- return null;
+ } catch (InvalidArgumentException $e) {
+ return;
}
}
/**
* Get the model's binary GUID.
+ *
+ * @param string|null $guid
+ * @return string|null
*/
- public function getBinaryGuid(?string $guid = null): ?string
+ public function getBinaryGuid($guid = null)
{
try {
return $this->newObjectGuid(
$guid ?? $this->getObjectGuid()
)->getBinary();
- } catch (InvalidArgumentException) {
- return null;
+ } catch (InvalidArgumentException $e) {
+ return;
}
}
/**
* Make a new object Guid instance.
+ *
+ * @param string $value
+ * @return Guid
*/
- protected function newObjectGuid(string $value): Guid
+ protected function newObjectGuid($value)
{
return new Guid($value);
}
/**
* Determine if the current model is a direct descendant of the given.
+ *
+ * @param static|string $parent
+ * @return bool
*/
- public function isChildOf(Model|string|null $parent = null): bool
+ public function isChildOf($parent)
{
return $this->newDn($this->getDn())->isChildOf(
$this->newDn((string) $parent)
);
}
- /**
- * Determine if the current model is a sibling of the given.
- */
- public function isSiblingOf(Model|string|null $model = null): bool
- {
- return $this->newDn($this->getDn())->isSiblingOf(
- $this->newDn((string) $model)
- );
- }
-
/**
* Determine if the current model is a direct ascendant of the given.
+ *
+ * @param static|string $child
+ * @return bool
*/
- public function isParentOf(Model|string|null $child = null): bool
+ public function isParentOf($child)
{
return $this->newDn($this->getDn())->isParentOf(
$this->newDn((string) $child)
@@ -882,24 +1000,34 @@ abstract class Model implements Arrayable, ArrayAccess, JsonSerializable, String
/**
* Determine if the current model is a descendant of the given.
+ *
+ * @param static|string $model
+ * @return bool
*/
- public function isDescendantOf(Model|string|null $model = null): bool
+ public function isDescendantOf($model)
{
return $this->dnIsInside($this->getDn(), $model);
}
/**
* Determine if the current model is a ancestor of the given.
+ *
+ * @param static|string $model
+ * @return bool
*/
- public function isAncestorOf(Model|string|null $model = null): bool
+ public function isAncestorOf($model)
{
return $this->dnIsInside($model, $this->getDn());
}
/**
- * Determine if the DN is inside the parent DN.
+ * Determines if the DN is inside of the parent DN.
+ *
+ * @param static|string $dn
+ * @param static|string $parentDn
+ * @return bool
*/
- protected function dnIsInside(Model|string|null $dn = null, Model|string|null $parentDn = null): bool
+ protected function dnIsInside($dn, $parentDn)
{
return $this->newDn((string) $dn)->isDescendantOf(
$this->newDn($parentDn)
@@ -908,8 +1036,11 @@ abstract class Model implements Arrayable, ArrayAccess, JsonSerializable, String
/**
* Set the base DN of where the model should be created in.
+ *
+ * @param static|string $dn
+ * @return $this
*/
- public function inside(Model|string $dn): static
+ public function inside($dn)
{
$this->in = $dn instanceof self ? $dn->getDn() : $dn;
@@ -919,9 +1050,12 @@ abstract class Model implements Arrayable, ArrayAccess, JsonSerializable, String
/**
* Save the model to the directory without raising any events.
*
+ * @param array $attributes
+ * @return void
+ *
* @throws \LdapRecord\LdapRecordException
*/
- public function saveQuietly(array $attributes = []): void
+ public function saveQuietly(array $attributes = [])
{
static::withoutEvents(function () use ($attributes) {
$this->save($attributes);
@@ -931,9 +1065,12 @@ abstract class Model implements Arrayable, ArrayAccess, JsonSerializable, String
/**
* Save the model to the directory.
*
+ * @param array $attributes The attributes to update or create for the current entry.
+ * @return void
+ *
* @throws \LdapRecord\LdapRecordException
*/
- public function save(array $attributes = []): void
+ public function save(array $attributes = [])
{
$this->fill($attributes);
@@ -951,9 +1088,11 @@ abstract class Model implements Arrayable, ArrayAccess, JsonSerializable, String
/**
* Inserts the model into the directory.
*
+ * @return void
+ *
* @throws \LdapRecord\LdapRecordException
*/
- protected function performInsert(): void
+ protected function performInsert()
{
// Here we will populate the models object classes if it
// does not already have any set. An LDAP object cannot
@@ -973,18 +1112,11 @@ abstract class Model implements Arrayable, ArrayAccess, JsonSerializable, String
$this->dispatch('creating');
- // Some PHP versions prevent non-numerically indexed arrays
- // from being sent to the server. To resolve this, we will
- // convert the attributes to numerically indexed arrays.
- $attributes = array_map('array_values', array_filter($this->getAttributes()));
-
// Here we perform the insert of new object in the directory,
// but filter out any empty attributes before sending them
// to the server. LDAP servers will throw an exception if
// attributes have been given empty or null values.
- $this->dn = $query->insertAndGetDn($this->getDn(), $attributes);
-
- $this->attributes = $attributes;
+ $query->insert($this->getDn(), array_filter($this->getAttributes()));
$this->dispatch('created');
@@ -998,9 +1130,11 @@ abstract class Model implements Arrayable, ArrayAccess, JsonSerializable, String
/**
* Updates the model in the directory.
*
+ * @return void
+ *
* @throws \LdapRecord\LdapRecordException
*/
- protected function performUpdate(): void
+ protected function performUpdate()
{
if (! count($modifications = $this->getModifications())) {
return;
@@ -1012,17 +1146,18 @@ abstract class Model implements Arrayable, ArrayAccess, JsonSerializable, String
$this->dispatch('updated');
- $this->syncChanges();
-
$this->syncOriginal();
}
/**
* Create the model in the directory.
*
+ * @param array $attributes The attributes for the new entry.
+ * @return Model
+ *
* @throws \LdapRecord\LdapRecordException
*/
- public static function create(array $attributes = []): static
+ public static function create(array $attributes = [])
{
$instance = new static($attributes);
@@ -1032,18 +1167,22 @@ abstract class Model implements Arrayable, ArrayAccess, JsonSerializable, String
}
/**
- * Add an attribute on the model with the given value.
+ * Create an attribute on the model.
+ *
+ * @param string $attribute The attribute to create
+ * @param mixed $value The value of the new attribute
+ * @return void
*
* @throws ModelDoesNotExistException
* @throws \LdapRecord\LdapRecordException
*/
- public function addAttribute(string $attribute, mixed $value): void
+ public function createAttribute($attribute, $value)
{
$this->assertExists();
$this->dispatch(['saving', 'updating']);
- $this->newQuery()->add($this->dn, [$attribute => (array) $value]);
+ $this->newQuery()->insertAttributes($this->dn, [$attribute => (array) $value]);
$this->addAttributeValue($attribute, $value);
@@ -1053,10 +1192,13 @@ abstract class Model implements Arrayable, ArrayAccess, JsonSerializable, String
/**
* Update the model.
*
+ * @param array $attributes The attributes to update for the current entry.
+ * @return void
+ *
* @throws ModelDoesNotExistException
* @throws \LdapRecord\LdapRecordException
*/
- public function update(array $attributes = []): void
+ public function update(array $attributes = [])
{
$this->assertExists();
@@ -1066,16 +1208,20 @@ abstract class Model implements Arrayable, ArrayAccess, JsonSerializable, String
/**
* Update the model attribute with the specified value.
*
+ * @param string $attribute The attribute to modify
+ * @param mixed $value The new value for the attribute
+ * @return void
+ *
* @throws ModelDoesNotExistException
* @throws \LdapRecord\LdapRecordException
*/
- public function replaceAttribute(string $attribute, mixed $value): void
+ public function updateAttribute($attribute, $value)
{
$this->assertExists();
$this->dispatch(['saving', 'updating']);
- $this->newQuery()->replace($this->dn, [$attribute => (array) $value]);
+ $this->newQuery()->updateAttributes($this->dn, [$attribute => (array) $value]);
$this->addAttributeValue($attribute, $value);
@@ -1085,13 +1231,17 @@ abstract class Model implements Arrayable, ArrayAccess, JsonSerializable, String
/**
* Destroy the models for the given distinguished names.
*
+ * @param Collection|array|string $dns
+ * @param bool $recursive
+ * @return int
+ *
* @throws \LdapRecord\LdapRecordException
*/
- public static function destroy(mixed $dns, bool $recursive = false): int
+ public static function destroy($dns, $recursive = false)
{
$count = 0;
- $instance = new static;
+ $instance = new static();
if ($dns instanceof Collection) {
$dns = $dns->modelDns()->toArray();
@@ -1120,10 +1270,13 @@ abstract class Model implements Arrayable, ArrayAccess, JsonSerializable, String
* Throws a ModelNotFoundException if the current model does
* not exist or does not contain a distinguished name.
*
+ * @param bool $recursive Whether to recursively delete leaf nodes (models that are children).
+ * @return void
+ *
* @throws ModelDoesNotExistException
* @throws \LdapRecord\LdapRecordException
*/
- public function delete(bool $recursive = false): void
+ public function delete($recursive = false)
{
$this->assertExists();
@@ -1146,44 +1299,38 @@ abstract class Model implements Arrayable, ArrayAccess, JsonSerializable, String
/**
* Deletes leaf nodes that are attached to the model.
*
+ * @return void
+ *
* @throws \LdapRecord\LdapRecordException
*/
- protected function deleteLeafNodes(): void
+ protected function deleteLeafNodes()
{
$this->newQueryWithoutScopes()
->in($this->dn)
- ->list()
+ ->listing()
->each(function (Model $model) {
- $model->delete(recursive: true);
+ $model->delete($recursive = true);
});
}
/**
- * Remove an attribute on the model.
+ * Delete an attribute on the model.
*
- * @throws ModelDoesNotExistException
- * @throws \LdapRecord\LdapRecordException
- */
- public function removeAttribute(string $attribute, mixed $value = null): void
- {
- $this->removeAttributes([$attribute => $value]);
- }
-
- /**
- * Remove an attribute on the model.
+ * @param string|array $attributes The attribute(s) to delete
*
- * Remove specific values in attributes:
+ * Delete specific values in attributes:
*
* ["memberuid" => "jdoe"]
*
- * Remove an entire attribute:
+ * Delete an entire attribute:
*
* ["memberuid" => []]
+ * @return void
*
* @throws ModelDoesNotExistException
* @throws \LdapRecord\LdapRecordException
*/
- public function removeAttributes(array|string $attributes): void
+ public function deleteAttribute($attributes)
{
$this->assertExists();
@@ -1191,7 +1338,7 @@ abstract class Model implements Arrayable, ArrayAccess, JsonSerializable, String
$this->dispatch(['saving', 'updating']);
- $this->newQuery()->remove($this->dn, $attributes);
+ $this->newQuery()->deleteAttributes($this->dn, $attributes);
foreach ($attributes as $attribute => $value) {
// If the attribute value is empty, we can assume the
@@ -1217,8 +1364,11 @@ abstract class Model implements Arrayable, ArrayAccess, JsonSerializable, String
/**
* Make a deletable attribute array.
+ *
+ * @param string|array $attributes
+ * @return array
*/
- protected function makeDeletableAttributes(string|array $attributes): array
+ protected function makeDeletableAttributes($attributes)
{
$delete = [];
@@ -1236,11 +1386,15 @@ abstract class Model implements Arrayable, ArrayAccess, JsonSerializable, String
*
* For example: $user->move($ou);
*
+ * @param static|string $newParentDn The new parent of the current model.
+ * @param bool $deleteOldRdn Whether to delete the old models relative distinguished name once renamed / moved.
+ * @return void
+ *
* @throws UnexpectedValueException
* @throws ModelDoesNotExistException
* @throws \LdapRecord\LdapRecordException
*/
- public function move(Model|string $newParentDn, bool $deleteOldRdn = true): void
+ public function move($newParentDn, $deleteOldRdn = true)
{
$this->assertExists();
@@ -1254,10 +1408,15 @@ abstract class Model implements Arrayable, ArrayAccess, JsonSerializable, String
/**
* Rename the model to a new RDN and new parent.
*
+ * @param string $rdn The models new relative distinguished name. Example: "cn=JohnDoe"
+ * @param static|string|null $newParentDn The models new parent distinguished name (if moving). Leave this null if you are only renaming. Example: "ou=MovedUsers,dc=acme,dc=org"
+ * @param bool|true $deleteOldRdn Whether to delete the old models relative distinguished name once renamed / moved.
+ * @return void
+ *
* @throws ModelDoesNotExistException
* @throws \LdapRecord\LdapRecordException
*/
- public function rename(string $rdn, Model|string|null $newParentDn = null, bool $deleteOldRdn = true): void
+ public function rename($rdn, $newParentDn = null, $deleteOldRdn = true)
{
$this->assertExists();
@@ -1269,13 +1428,6 @@ abstract class Model implements Arrayable, ArrayAccess, JsonSerializable, String
$newParentDn = $this->getParentDn($this->dn);
}
- // If the RDN we have been given is empty when parsed, we must
- // have been given a string, with no attribute. In this case,
- // we will create a new RDN using the current DN's head.
- if ($this->newDn($rdn)->isEmpty()) {
- $rdn = $this->getUpdateableRdn($rdn);
- }
-
// If the RDN and the new parent DN are the same as the current,
// we will simply return here to prevent a rename operation
// being sent, which would fail anyway in such case.
@@ -1286,12 +1438,21 @@ abstract class Model implements Arrayable, ArrayAccess, JsonSerializable, String
return;
}
+ // If the RDN we have been given is empty when parsed, we must
+ // have been given a string, with no attribute. In this case,
+ // we will create a new RDN using the current DN's head.
+ if ($this->newDn($rdn)->isEmpty()) {
+ $rdn = $this->getUpdateableRdn($rdn);
+ }
+
$this->dispatch('renaming', [$rdn, $newParentDn]);
+ $this->newQuery()->rename($this->dn, $rdn, $newParentDn, $deleteOldRdn);
+
// If the model was successfully renamed, we will set
// its new DN so any further updates to the model
// can be performed without any issues.
- $this->dn = $this->newQuery()->renameAndGetDn($this->dn, $rdn, $newParentDn, $deleteOldRdn);
+ $this->dn = implode(',', [$rdn, $newParentDn]);
$map = $this->newDn($this->dn)->assoc();
@@ -1310,17 +1471,24 @@ abstract class Model implements Arrayable, ArrayAccess, JsonSerializable, String
}
/**
- * Get an updatable RDN for the model.
+ * Get an updateable RDN for the model.
+ *
+ * @param string $name
+ * @return string
*/
- public function getUpdateableRdn(string $name): string
+ public function getUpdateableRdn($name)
{
return $this->getCreatableRdn($name, $this->newDn($this->dn)->head());
}
/**
* Get a distinguished name that is creatable for the model.
+ *
+ * @param string|null $name
+ * @param string|null $attribute
+ * @return string
*/
- public function getCreatableDn(?string $name = null, ?string $attribute = null): string
+ public function getCreatableDn($name = null, $attribute = null)
{
return implode(',', [
$this->getCreatableRdn($name, $attribute),
@@ -1330,30 +1498,39 @@ abstract class Model implements Arrayable, ArrayAccess, JsonSerializable, String
/**
* Get a creatable (escaped) RDN for the model.
+ *
+ * @param string|null $name
+ * @param string|null $attribute
+ * @return string
*/
- public function getCreatableRdn(?string $name = null, ?string $attribute = null): string
+ public function getCreatableRdn($name = null, $attribute = null)
{
$attribute = $attribute ?? $this->getCreatableRdnAttribute();
$name = $this->escape(
$name ?? $this->getFirstAttribute($attribute)
- )->forDn();
+ )->dn();
return "$attribute=$name";
}
/**
* Get the creatable RDN attribute name.
+ *
+ * @return string
*/
- protected function getCreatableRdnAttribute(): string
+ protected function getCreatableRdnAttribute()
{
return 'cn';
}
/**
- * Determine if the given modification is valid.
+ * Determines if the given modification is valid.
+ *
+ * @param mixed $mod
+ * @return bool
*/
- protected function isValidModification(mixed $mod): bool
+ protected function isValidModification($mod)
{
return Arr::accessible($mod)
&& Arr::exists($mod, BatchModification::KEY_MODTYPE)
@@ -1365,7 +1542,7 @@ abstract class Model implements Arrayable, ArrayAccess, JsonSerializable, String
*
* @return BatchModification[]
*/
- protected function buildModificationsFromDirty(): array
+ protected function buildModificationsFromDirty()
{
$modifications = [];
@@ -1392,9 +1569,25 @@ abstract class Model implements Arrayable, ArrayAccess, JsonSerializable, String
/**
* Throw an exception if the model does not exist.
*
+ * @deprecated
+ *
+ * @return void
+ *
* @throws ModelDoesNotExistException
*/
- protected function assertExists(): void
+ protected function requireExistence()
+ {
+ return $this->assertExists();
+ }
+
+ /**
+ * Throw an exception if the model does not exist.
+ *
+ * @return void
+ *
+ * @throws ModelDoesNotExistException
+ */
+ protected function assertExists()
{
if (! $this->exists || is_null($this->dn)) {
throw ModelDoesNotExistException::forModel($this);
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ModelDoesNotExistException.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ModelDoesNotExistException.php
index 98efa9865..508414911 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ModelDoesNotExistException.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/ModelDoesNotExistException.php
@@ -7,22 +7,30 @@ use LdapRecord\LdapRecordException;
class ModelDoesNotExistException extends LdapRecordException
{
/**
- * The instance of the model that does not exist.
+ * The class name of the model that does not exist.
+ *
+ * @var Model
*/
- protected Model $model;
+ protected $model;
/**
* Create a new exception for the given model.
+ *
+ * @param Model $model
+ * @return ModelDoesNotExistException
*/
- public static function forModel(Model $model): static
+ public static function forModel(Model $model)
{
- return (new static)->setModel($model);
+ return (new static())->setModel($model);
}
/**
- * Set the model instance that does not exist.
+ * Set the model that does not exist.
+ *
+ * @param Model $model
+ * @return ModelDoesNotExistException
*/
- public function setModel(Model $model): static
+ public function setModel(Model $model)
{
$this->model = $model;
@@ -32,12 +40,4 @@ class ModelDoesNotExistException extends LdapRecordException
return $this;
}
-
- /**
- * Get the instance of the model that does not exist.
- */
- public function getModel(): Model
- {
- return $this->model;
- }
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/OpenLDAP/Entry.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/OpenLDAP/Entry.php
index e20016a45..c11ca72d4 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/OpenLDAP/Entry.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/OpenLDAP/Entry.php
@@ -13,26 +13,31 @@ class Entry extends BaseEntry implements OpenLDAP
{
/**
* The attribute key that contains the models object GUID.
+ *
+ * @var string
*/
- protected string $guidKey = 'entryuuid';
+ protected $guidKey = 'entryuuid';
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- protected static function boot(): void
+ protected static function boot()
{
parent::boot();
// Here we'll add a global scope to all OpenLDAP models to ensure the
// Entry UUID is always selected on each query. This attribute is
// virtual, so it must be manually selected to be included.
- static::addGlobalScope(new AddEntryUuidToSelects);
+ static::addGlobalScope(new AddEntryUuidToSelects());
}
/**
* Create a new query builder.
+ *
+ * @param Connection $connection
+ * @return OpenLdapBuilder
*/
- public function newQueryBuilder(Connection $connection): OpenLdapBuilder
+ public function newQueryBuilder(Connection $connection)
{
return new OpenLdapBuilder($connection);
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/OpenLDAP/Group.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/OpenLDAP/Group.php
index e7d81ef28..a9a682a06 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/OpenLDAP/Group.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/OpenLDAP/Group.php
@@ -2,23 +2,27 @@
namespace LdapRecord\Models\OpenLDAP;
-use LdapRecord\Models\Relations\HasManyIn;
-
class Group extends Entry
{
/**
* The object classes of the LDAP model.
+ *
+ * @var array
*/
- public static array $objectClasses = [
+ public static $objectClasses = [
'top',
'groupofuniquenames',
];
/**
* The members relationship.
+ *
+ * Retrieves members that are apart of the group.
+ *
+ * @return \LdapRecord\Models\Relations\HasMany
*/
- public function members(): HasManyIn
+ public function members()
{
- return $this->hasManyIn([static::class, User::class], 'uniquemember')->using($this, 'uniquemember');
+ return $this->hasMany([static::class, User::class], 'memberUid');
}
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/OpenLDAP/OrganizationalUnit.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/OpenLDAP/OrganizationalUnit.php
index e304237e7..7ae0a37a4 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/OpenLDAP/OrganizationalUnit.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/OpenLDAP/OrganizationalUnit.php
@@ -6,16 +6,20 @@ class OrganizationalUnit extends Entry
{
/**
* The object classes of the LDAP model.
+ *
+ * @var array
*/
- public static array $objectClasses = [
+ public static $objectClasses = [
'top',
'organizationalunit',
];
/**
* Get the creatable RDN attribute name.
+ *
+ * @return string
*/
- public function getCreatableRdnAttribute(): string
+ public function getCreatableRdnAttribute()
{
return 'ou';
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/OpenLDAP/Scopes/AddEntryUuidToSelects.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/OpenLDAP/Scopes/AddEntryUuidToSelects.php
index 78efa95f4..780a633f3 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/OpenLDAP/Scopes/AddEntryUuidToSelects.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/OpenLDAP/Scopes/AddEntryUuidToSelects.php
@@ -10,8 +10,12 @@ class AddEntryUuidToSelects implements Scope
{
/**
* Add the entry UUID to the selected attributes.
+ *
+ * @param Builder $query
+ * @param Model $model
+ * @return void
*/
- public function apply(Builder $query, Model $model): void
+ public function apply(Builder $query, Model $model)
{
empty($query->columns)
? $query->addSelect(['*', $model->getGuidKey()])
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/OpenLDAP/User.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/OpenLDAP/User.php
index beaba9e4c..c8626de6d 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/OpenLDAP/User.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/OpenLDAP/User.php
@@ -5,46 +5,47 @@ namespace LdapRecord\Models\OpenLDAP;
use Illuminate\Contracts\Auth\Authenticatable;
use LdapRecord\Models\Concerns\CanAuthenticate;
use LdapRecord\Models\Concerns\HasPassword;
-use LdapRecord\Models\Relations\HasMany;
class User extends Entry implements Authenticatable
{
- use CanAuthenticate;
use HasPassword;
+ use CanAuthenticate;
/**
* The password's attribute name.
+ *
+ * @var string
*/
- protected string $passwordAttribute = 'userpassword';
+ protected $passwordAttribute = 'userpassword';
/**
* The password's hash method.
+ *
+ * @var string
*/
- protected string $passwordHashMethod = 'ssha';
+ protected $passwordHashMethod = 'ssha';
/**
* The object classes of the LDAP model.
+ *
+ * @var array
*/
- public static array $objectClasses = [
+ public static $objectClasses = [
'top',
'person',
'organizationalperson',
'inetorgperson',
];
- /**
- * Get the unique identifier for the user.
- */
- public function getAuthIdentifier(): string
- {
- return $this->getFirstAttribute($this->guidKey);
- }
-
/**
* The groups relationship.
+ *
+ * Retrieve groups that the user is a part of.
+ *
+ * @return \LdapRecord\Models\Relations\HasMany
*/
- public function groups(): HasMany
+ public function groups()
{
- return $this->hasMany(Group::class, 'uniquemember');
+ return $this->hasMany(Group::class, 'memberuid', 'uid');
}
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Relations/HasMany.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Relations/HasMany.php
index 16e65b14c..583f81c30 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Relations/HasMany.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Relations/HasMany.php
@@ -3,21 +3,73 @@
namespace LdapRecord\Models\Relations;
use Closure;
+use LdapRecord\DetectsErrors;
+use LdapRecord\LdapRecordException;
use LdapRecord\Models\Collection;
use LdapRecord\Models\Model;
-use LdapRecord\Query\Model\Builder;
+use LdapRecord\Models\ModelNotFoundException;
class HasMany extends OneToMany
{
+ use DetectsErrors;
+
+ /**
+ * The model to use for attaching / detaching.
+ *
+ * @var Model
+ */
+ protected $using;
+
+ /**
+ * The attribute key to use for attaching / detaching.
+ *
+ * @var string
+ */
+ protected $usingKey;
+
/**
* The pagination page size.
+ *
+ * @var int
*/
- protected int $pageSize = 1000;
+ protected $pageSize = 1000;
+
+ /**
+ * The exceptions to bypass for each relation operation.
+ *
+ * @var array
+ */
+ protected $bypass = [
+ 'attach' => [
+ 'Already exists', 'Type or value exists',
+ ],
+ 'detach' => [
+ 'No such attribute', 'Server is unwilling to perform',
+ ],
+ ];
+
+ /**
+ * Set the model and attribute to use for attaching / detaching.
+ *
+ * @param Model $using
+ * @param string $usingKey
+ * @return $this
+ */
+ public function using(Model $using, $usingKey)
+ {
+ $this->using = $using;
+ $this->usingKey = $usingKey;
+
+ return $this;
+ }
/**
* Set the pagination page size of the relation query.
+ *
+ * @param int $pageSize
+ * @return $this
*/
- public function setPageSize(int $pageSize): static
+ public function setPageSize($pageSize)
{
$this->pageSize = $pageSize;
@@ -26,16 +78,22 @@ class HasMany extends OneToMany
/**
* Paginate the relation using the given page size.
+ *
+ * @param int $pageSize
+ * @return Collection
*/
- public function paginate(int $pageSize = 1000): Collection
+ public function paginate($pageSize = 1000)
{
return $this->paginateOnceUsing($pageSize);
}
/**
* Paginate the relation using the page size once.
+ *
+ * @param int $pageSize
+ * @return Collection
*/
- protected function paginateOnceUsing(int $pageSize): Collection
+ protected function paginateOnceUsing($pageSize)
{
$size = $this->pageSize;
@@ -48,32 +106,44 @@ class HasMany extends OneToMany
/**
* Execute a callback over each result while chunking.
+ *
+ * @param Closure $callback
+ * @param int $pageSize
+ * @return bool
*/
- public function each(Closure $callback, int $pageSize = 1000): bool
+ public function each(Closure $callback, $pageSize = 1000)
{
- return $this->chunk($pageSize, function ($results) use ($callback) {
+ $this->chunk($pageSize, function ($results) use ($callback) {
foreach ($results as $key => $value) {
if ($callback($value, $key) === false) {
return false;
}
}
-
- return true;
});
}
/**
* Chunk the relation results using the given callback.
+ *
+ * @param int $pageSize
+ * @param Closure $callback
+ * @param array $loaded
+ * @return bool
*/
- public function chunk(int $pageSize, Closure $callback): bool
+ public function chunk($pageSize, Closure $callback)
{
return $this->chunkRelation($pageSize, $callback);
}
/**
* Execute the callback over chunks of relation results.
+ *
+ * @param int $pageSize
+ * @param Closure $callback
+ * @param array $loaded
+ * @return bool
*/
- protected function chunkRelation(int $pageSize, Closure $callback, array $loaded = []): bool
+ protected function chunkRelation($pageSize, Closure $callback, $loaded = [])
{
return $this->getRelationQuery()->chunk($pageSize, function (Collection $results) use ($pageSize, $callback, $loaded) {
$models = $this->transformResults($results)->when($this->recursive, function (Collection $models) use ($loaded) {
@@ -95,15 +165,15 @@ class HasMany extends OneToMany
}
});
});
-
- return true;
});
}
/**
* Get the relationships results.
+ *
+ * @return Collection
*/
- public function getRelationResults(): Collection
+ public function getRelationResults()
{
return $this->transformResults(
$this->getRelationQuery()->paginate($this->pageSize)
@@ -112,8 +182,10 @@ class HasMany extends OneToMany
/**
* Get the prepared relationship query.
+ *
+ * @return \LdapRecord\Query\Model\Builder
*/
- public function getRelationQuery(): Builder
+ public function getRelationQuery()
{
$columns = $this->query->getSelects();
@@ -137,4 +209,212 @@ class HasMany extends OneToMany
$this->getEscapedForeignValueFromModel($this->parent)
);
}
+
+ /**
+ * Attach a model to the relation.
+ *
+ * @param Model|string $model
+ * @return Model|string|false
+ */
+ public function attach($model)
+ {
+ return $this->attemptFailableOperation(
+ $this->buildAttachCallback($model),
+ $this->bypass['attach'],
+ $model
+ );
+ }
+
+ /**
+ * Build the attach callback.
+ *
+ * @param Model|string $model
+ * @return \Closure
+ */
+ protected function buildAttachCallback($model)
+ {
+ return function () use ($model) {
+ $foreign = $this->getAttachableForeignValue($model);
+
+ if ($this->using) {
+ return $this->using->createAttribute($this->usingKey, $foreign);
+ }
+
+ if (! $model instanceof Model) {
+ $model = $this->getForeignModelByValueOrFail($model);
+ }
+
+ return $model->createAttribute($this->relationKey, $foreign);
+ };
+ }
+
+ /**
+ * Attach a collection of models to the parent instance.
+ *
+ * @param iterable $models
+ * @return iterable
+ */
+ public function attachMany($models)
+ {
+ foreach ($models as $model) {
+ $this->attach($model);
+ }
+
+ return $models;
+ }
+
+ /**
+ * Detach the model from the relation.
+ *
+ * @param Model|string $model
+ * @return Model|string|false
+ */
+ public function detach($model)
+ {
+ return $this->attemptFailableOperation(
+ $this->buildDetachCallback($model),
+ $this->bypass['detach'],
+ $model
+ );
+ }
+
+ /**
+ * Detach the model or delete the parent if the relation is empty.
+ *
+ * @param Model|string $model
+ * @return void
+ */
+ public function detachOrDeleteParent($model)
+ {
+ $count = $this->onceWithoutMerging(function () {
+ return $this->count();
+ });
+
+ if ($count <= 1) {
+ return $this->getParent()->delete();
+ }
+
+ return $this->detach($model);
+ }
+
+ /**
+ * Build the detach callback.
+ *
+ * @param Model|string $model
+ * @return \Closure
+ */
+ protected function buildDetachCallback($model)
+ {
+ return function () use ($model) {
+ $foreign = $this->getAttachableForeignValue($model);
+
+ if ($this->using) {
+ return $this->using->deleteAttribute([$this->usingKey => $foreign]);
+ }
+
+ if (! $model instanceof Model) {
+ $model = $this->getForeignModelByValueOrFail($model);
+ }
+
+ return $model->deleteAttribute([$this->relationKey => $foreign]);
+ };
+ }
+
+ /**
+ * Get the attachable foreign value from the model.
+ *
+ * @param Model|string $model
+ * @return string
+ */
+ protected function getAttachableForeignValue($model)
+ {
+ if ($model instanceof Model) {
+ return $this->using
+ ? $this->getForeignValueFromModel($model)
+ : $this->getParentForeignValue();
+ }
+
+ return $this->using ? $model : $this->getParentForeignValue();
+ }
+
+ /**
+ * Get the foreign model by the given value, or fail.
+ *
+ * @param string $model
+ * @return Model
+ *
+ * @throws ModelNotFoundException
+ */
+ protected function getForeignModelByValueOrFail($model)
+ {
+ if (! is_null($model = $this->getForeignModelByValue($model))) {
+ return $model;
+ }
+
+ throw ModelNotFoundException::forQuery(
+ $this->query->getUnescapedQuery(),
+ $this->query->getDn()
+ );
+ }
+
+ /**
+ * Attempt a failable operation and return the value if successful.
+ *
+ * If a bypassable exception is encountered, the value will be returned.
+ *
+ * @param callable $operation
+ * @param string|array $bypass
+ * @param mixed $value
+ * @return mixed
+ *
+ * @throws LdapRecordException
+ */
+ protected function attemptFailableOperation($operation, $bypass, $value)
+ {
+ try {
+ $operation();
+
+ return $value;
+ } catch (LdapRecordException $e) {
+ if ($this->errorContainsMessage($e->getMessage(), $bypass)) {
+ return $value;
+ }
+
+ throw $e;
+ }
+ }
+
+ /**
+ * Detach all relation models.
+ *
+ * @return Collection
+ */
+ public function detachAll()
+ {
+ return $this->onceWithoutMerging(function () {
+ return $this->get()->each(function (Model $model) {
+ $this->detach($model);
+ });
+ });
+ }
+
+ /**
+ * Detach all relation models or delete the model if its relation is empty.
+ *
+ * @return Collection
+ */
+ public function detachAllOrDelete()
+ {
+ return $this->onceWithoutMerging(function () {
+ return $this->get()->each(function (Model $model) {
+ $relation = $model->getRelation($this->relationName);
+
+ if ($relation && $relation->count() >= 1) {
+ $model->delete();
+ } else {
+ $this->detach($model);
+ }
+ });
+ });
+ }
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Relations/HasManyIn.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Relations/HasManyIn.php
index 8b5d561f0..303a1440d 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Relations/HasManyIn.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Relations/HasManyIn.php
@@ -2,19 +2,21 @@
namespace LdapRecord\Models\Relations;
-use LdapRecord\Models\Collection;
+use LdapRecord\Query\Collection;
class HasManyIn extends OneToMany
{
/**
* Get the relationships results.
+ *
+ * @return Collection
*/
- public function getRelationResults(): Collection
+ public function getRelationResults()
{
$results = $this->parent->newCollection();
foreach ((array) $this->parent->getAttribute($this->relationKey) as $value) {
- if ($value && $foreign = $this->getForeignModelByValue($value)) {
+ if ($foreign = $this->getForeignModelByValue($value)) {
$results->push($foreign);
}
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Relations/HasOne.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Relations/HasOne.php
index 0199f2178..243cd2ed9 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Relations/HasOne.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Relations/HasOne.php
@@ -2,19 +2,20 @@
namespace LdapRecord\Models\Relations;
-use LdapRecord\Models\Collection;
use LdapRecord\Models\Model;
class HasOne extends Relation
{
/**
* Get the results of the relationship.
+ *
+ * @return \LdapRecord\Query\Collection
*/
- public function getResults(): Collection
+ public function getResults()
{
- $relationValue = $this->getFirstAttributeValue($this->parent, $this->relationKey);
-
- $model = $relationValue ? $this->getForeignModelByValue($relationValue) : null;
+ $model = $this->getForeignModelByValue(
+ $this->getFirstAttributeValue($this->parent, $this->relationKey)
+ );
return $this->transformResults(
$this->parent->newCollection($model ? [$model] : null)
@@ -23,20 +24,31 @@ class HasOne extends Relation
/**
* Attach a model instance to the parent model.
+ *
+ * @param Model|string $model
+ * @return Model|string
+ *
+ * @throws \LdapRecord\LdapRecordException
*/
- public function attach(Model|string $model): void
+ public function attach($model)
{
$foreign = $model instanceof Model
? $this->getForeignValueFromModel($model)
: $model;
$this->parent->setAttribute($this->relationKey, $foreign)->save();
+
+ return $model;
}
/**
* Detach the related model from the parent.
+ *
+ * @return void
+ *
+ * @throws \LdapRecord\LdapRecordException
*/
- public function detach(): void
+ public function detach()
{
$this->parent->setAttribute($this->relationKey, null)->save();
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Relations/OneToMany.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Relations/OneToMany.php
index 8eb88cbcf..aa873b60b 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Relations/OneToMany.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Relations/OneToMany.php
@@ -2,80 +2,57 @@
namespace LdapRecord\Models\Relations;
-use Closure;
-use LdapRecord\DetectsErrors;
-use LdapRecord\LdapRecordException;
-use LdapRecord\Models\Collection;
use LdapRecord\Models\Model;
-use LdapRecord\Models\ModelNotFoundException;
+use LdapRecord\Query\Collection;
use LdapRecord\Query\Model\Builder;
abstract class OneToMany extends Relation
{
- use DetectsErrors;
-
- /**
- * The model to use for attaching / detaching.
- */
- protected ?Model $using = null;
-
/**
* The relation to merge results with.
+ *
+ * @var OneToMany|null
*/
- protected ?Relation $with = null;
-
- /**
- * The attribute key to use for attaching / detaching.
- */
- protected ?string $usingKey = null;
+ protected $with;
/**
* The name of the relationship.
+ *
+ * @var string
*/
- protected ?string $relationName = null;
+ protected $relationName;
/**
* Whether to include recursive results.
+ *
+ * @var bool
*/
- protected bool $recursive = false;
-
- /**
- * The exceptions to bypass for each relation operation.
- */
- protected array $bypass = [
- 'attach' => [
- 'Already exists', 'Type or value exists',
- ],
- 'detach' => [
- 'No such attribute', 'Server is unwilling to perform',
- ],
- ];
+ protected $recursive = false;
/**
* Constructor.
+ *
+ * @param Builder $query
+ * @param Model $parent
+ * @param string $related
+ * @param string $relationKey
+ * @param string $foreignKey
+ * @param string $relationName
*/
- public function __construct(Builder $query, Model $parent, array|string $related, string $relationKey, string $foreignKey, string $relationName)
+ public function __construct(Builder $query, Model $parent, $related, $relationKey, $foreignKey, $relationName)
{
$this->relationName = $relationName;
parent::__construct($query, $parent, $related, $relationKey, $foreignKey);
}
- /**
- * Set the model and attribute to use for attaching / detaching.
- */
- public function using(Model $using, string $usingKey): static
- {
- $this->using = $using;
- $this->usingKey = $usingKey;
-
- return $this;
- }
-
/**
* Set the relation to load with its parent.
+ *
+ * @param Relation $relation
+ * @return $this
*/
- public function with(Relation $relation): static
+ public function with(Relation $relation)
{
$this->with = $relation;
@@ -84,23 +61,30 @@ abstract class OneToMany extends Relation
/**
* Whether to include recursive results.
+ *
+ * @param bool $enable
+ * @return $this
*/
- public function recursive(bool $recursive = true): static
+ public function recursive($enable = true)
{
- $this->recursive = $recursive;
+ $this->recursive = $enable;
return $this;
}
/**
* Get the immediate relationships results.
+ *
+ * @return Collection
*/
- abstract public function getRelationResults(): Collection;
+ abstract public function getRelationResults();
/**
* Get the results of the relationship.
+ *
+ * @return Collection
*/
- public function getResults(): Collection
+ public function getResults()
{
$results = $this->recursive
? $this->getRecursiveResults()
@@ -113,8 +97,11 @@ abstract class OneToMany extends Relation
/**
* Execute the callback excluding the merged query result.
+ *
+ * @param callable $callback
+ * @return mixed
*/
- protected function onceWithoutMerging(Closure $callback): mixed
+ protected function onceWithoutMerging($callback)
{
$merging = $this->with;
@@ -129,262 +116,20 @@ abstract class OneToMany extends Relation
/**
* Get the relation name.
+ *
+ * @return string
*/
- public function getRelationName(): string
+ public function getRelationName()
{
return $this->relationName;
}
- /**
- * Attach the model in the relation.
- */
- public function attach(mixed $model): void
- {
- if (is_iterable($model)) {
- array_map($this->attach(...), [...$model]);
-
- return;
- }
-
- $this->attemptFailableOperation(
- $this->buildAttachCallback($model),
- $this->bypass['attach'],
- $model
- );
- }
-
- /**
- * Build the attach callback.
- */
- protected function buildAttachCallback(Model|string $model): Closure
- {
- return function () use ($model) {
- $foreign = $this->getAttachableForeignValue($model);
-
- if ($this->using) {
- $this->using->addAttribute($this->usingKey, $foreign);
-
- return;
- }
-
- if (! $model instanceof Model) {
- $model = $this->getForeignModelByValueOrFail($model);
- }
-
- $model->addAttribute($this->relationKey, $foreign);
- };
- }
-
- /**
- * Get the foreign model by the given value, or fail.
- *
- * @throws ModelNotFoundException
- */
- protected function getForeignModelByValueOrFail(string $model): Model
- {
- if (! is_null($model = $this->getForeignModelByValue($model))) {
- return $model;
- }
-
- throw ModelNotFoundException::forQuery(
- $this->query->getUnescapedQuery(),
- $this->query->getDn()
- );
- }
-
- /**
- * Detach the model from the relation.
- */
- public function detach(mixed $model): void
- {
- if (is_iterable($model)) {
- array_map($this->detach(...), [...$model]);
-
- return;
- }
-
- $this->attemptFailableOperation(
- $this->buildDetachCallback($model),
- $this->bypass['detach'],
- $model
- );
- }
-
- /**
- * Detach the model or delete the parent if the relation is empty.
- */
- public function detachOrDeleteParent(Model|string $model): void
- {
- /** @var Collection $related */
- $related = $this->onceWithoutMerging(function () {
- return $this->get('dn');
- });
-
- if (! $related->exists($model)) {
- return;
- }
-
- if ($related->count() <= 1) {
- $this->getParent()->delete();
-
- return;
- }
-
- $this->detach($model);
- }
-
- /**
- * Build the detach callback.
- */
- protected function buildDetachCallback(Model|string $model): Closure
- {
- return function () use ($model) {
- $foreign = $this->getAttachableForeignValue($model);
-
- if ($this->using) {
- $this->using->removeAttribute($this->usingKey, $foreign);
-
- return;
- }
-
- if (! $model instanceof Model) {
- $model = $this->getForeignModelByValueOrFail($model);
- }
-
- $model->removeAttribute($this->relationKey, $foreign);
- };
- }
-
- /**
- * Associate the model in the relation.
- */
- public function associate(mixed $model): void
- {
- if (is_iterable($model)) {
- array_map($this->associate(...), [...$model]);
-
- return;
- }
-
- $foreign = $this->getAttachableForeignValue($model);
-
- if ($this->using) {
- $this->using->addAttributeValue($this->usingKey, $foreign);
-
- return;
- }
-
- if (! $model instanceof Model) {
- $model = $this->getForeignModelByValueOrFail($model);
- }
-
- $model->addAttributeValue($this->relationKey, $foreign);
- }
-
- /**
- * Dissociate the model in the relation.
- */
- public function dissociate(mixed $model): void
- {
- if (is_iterable($model)) {
- array_map($this->dissociate(...), [...$model]);
-
- return;
- }
-
- $foreign = $this->getAttachableForeignValue($model);
-
- if ($this->using) {
- $this->using->removeAttributeValue($this->usingKey, $foreign);
-
- return;
- }
-
- if (! $model instanceof Model) {
- $model = $this->getForeignModelByValueOrFail($model);
- }
-
- $model->removeAttributeValue($this->relationKey, $foreign);
- }
-
- /**
- * Alias of "dissociate" method.
- */
- public function disassociate(Model|string $model): void
- {
- $this->dissociate($model);
- }
-
- /**
- * Get the attachable foreign value from the model.
- */
- protected function getAttachableForeignValue(Model|string $model): string
- {
- if ($model instanceof Model) {
- return $this->using
- ? $this->getForeignValueFromModel($model)
- : $this->getParentForeignValue();
- }
-
- return $this->using ? $model : $this->getParentForeignValue();
- }
-
- /**
- * Attempt a failable operation and return the value if successful.
- *
- * If a bypassable exception is encountered, the value will be returned.
- *
- * @throws LdapRecordException
- */
- protected function attemptFailableOperation(Closure $operation, string|array $bypass, mixed $value): mixed
- {
- try {
- $operation();
-
- return $value;
- } catch (LdapRecordException $e) {
- if ($this->errorContainsMessage($e->getMessage(), $bypass)) {
- return $value;
- }
-
- throw $e;
- }
- }
-
- /**
- * Detach all relation models.
- */
- public function detachAll(): Collection
- {
- return $this->onceWithoutMerging(
- fn () => $this->get()->each(function (Model $model) {
- $this->detach($model);
- })
- );
- }
-
- /**
- * Detach all relation models or delete the model if its relation is empty.
- */
- public function detachAllOrDelete(): Collection
- {
- return $this->onceWithoutMerging(
- fn () => $this->get()->each(function (Model $model) {
- $relation = $model->getRelation($this->relationName);
-
- if ($relation && $relation->count() >= 1) {
- $model->delete();
- } else {
- $this->detach($model);
- }
- })
- );
- }
-
/**
* Get the results of the merging 'with' relation.
+ *
+ * @return Collection
*/
- protected function getMergingRelationResults(): Collection
+ protected function getMergingRelationResults()
{
return $this->with
? $this->with->recursive($this->recursive)->get()
@@ -392,23 +137,24 @@ abstract class OneToMany extends Relation
}
/**
- * Get the results for the model's relation recursively.
+ * Get the results for the models relation recursively.
*
* @param string[] $loaded The distinguished names of models already loaded
+ * @return Collection
*/
- protected function getRecursiveResults(array $loaded = []): Collection
+ protected function getRecursiveResults(array $loaded = [])
{
- $results = $this->getRelationResults()->reject(fn (Model $model) =>
+ $results = $this->getRelationResults()->reject(function (Model $model) use ($loaded) {
// Here we will exclude the models that we have already
// loaded the recursive results for so we don't run
// into issues with circular relations in LDAP.
- in_array($model->getDn(), $loaded)
- );
+ return in_array($model->getDn(), $loaded);
+ });
foreach ($results as $model) {
$loaded[] = $model->getDn();
- // Finally, we will fetch the related model's relations,
+ // Finally, we will fetch the related models relations,
// passing along our loaded models, to ensure we do
// not attempt fetching already loaded relations.
$results = $results->merge(
@@ -421,8 +167,12 @@ abstract class OneToMany extends Relation
/**
* Get the recursive relation results for given model.
+ *
+ * @param Model $model
+ * @param array $loaded
+ * @return Collection
*/
- protected function getRecursiveRelationResults(Model $model, array $loaded): Collection
+ protected function getRecursiveRelationResults(Model $model, array $loaded)
{
return ($relation = $model->getRelation($this->relationName))
? $relation->getRecursiveResults($loaded)
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Relations/Relation.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Relations/Relation.php
index b2d26100e..31b0969c9 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Relations/Relation.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Relations/Relation.php
@@ -3,13 +3,13 @@
namespace LdapRecord\Models\Relations;
use Closure;
-use LdapRecord\Models\Collection;
use LdapRecord\Models\Entry;
use LdapRecord\Models\Model;
+use LdapRecord\Query\Collection;
use LdapRecord\Query\Model\Builder;
/**
- * @method bool exists($models = null) Determine if the relation contains all the given models, or any models
+ * @method bool exists($models = null) Determine if the relation contains all of the given models, or any models
* @method bool contains($models) Determine if any of the given models are contained in the relation
* @method bool count() Retrieve the "count" result of the query.
*/
@@ -17,48 +17,70 @@ abstract class Relation
{
/**
* The underlying LDAP query.
+ *
+ * @var Builder
*/
- protected Builder $query;
+ protected $query;
/**
* The parent model instance.
+ *
+ * @var Model
*/
- protected Model $parent;
+ protected $parent;
/**
* The related model class names.
+ *
+ * @var array
*/
- protected array $related;
+ protected $related;
/**
* The relation key.
+ *
+ * @var string
*/
- protected string $relationKey;
+ protected $relationKey;
/**
* The foreign key.
+ *
+ * @var string
*/
- protected string $foreignKey;
+ protected $foreignKey;
/**
* The default relation model.
+ *
+ * @var string
*/
- protected string $default = Entry::class;
+ protected $default = Entry::class;
/**
* The callback to use for resolving relation models.
+ *
+ * @var Closure
*/
- protected static ?Closure $modelResolver = null;
+ protected static $modelResolver;
/**
* The methods that should be passed along to a relation collection.
+ *
+ * @var string[]
*/
- protected array $passthru = ['count', 'exists', 'contains'];
+ protected $passthru = ['count', 'exists', 'contains'];
/**
* Constructor.
+ *
+ * @param Builder $query
+ * @param Model $parent
+ * @param string|array $related
+ * @param string $relationKey
+ * @param string $foreignKey
*/
- public function __construct(Builder $query, Model $parent, array|string $related, string $relationKey, string $foreignKey)
+ public function __construct(Builder $query, Model $parent, $related, $relationKey, $foreignKey)
{
$this->query = $query;
$this->parent = $parent;
@@ -66,13 +88,21 @@ abstract class Relation
$this->relationKey = $relationKey;
$this->foreignKey = $foreignKey;
+ static::$modelResolver = static::$modelResolver ?? function (array $modelObjectClasses, array $relationMap) {
+ return array_search($modelObjectClasses, $relationMap);
+ };
+
$this->initRelation();
}
/**
* Handle dynamic method calls to the relationship.
+ *
+ * @param string $method
+ * @param array $parameters
+ * @return mixed
*/
- public function __call(string $method, array $parameters): mixed
+ public function __call($method, $parameters)
{
if (in_array($method, $this->passthru)) {
return $this->get('objectclass')->$method(...$parameters);
@@ -89,16 +119,21 @@ abstract class Relation
/**
* Set the callback to use for resolving models from relation results.
+ *
+ * @param Closure $callback
+ * @return void
*/
- public static function resolveModelsUsing(?Closure $callback = null): void
+ public static function resolveModelsUsing(Closure $callback)
{
static::$modelResolver = $callback;
}
/**
* Only return objects matching the related model's object classes.
+ *
+ * @return $this
*/
- public function onlyRelated(): static
+ public function onlyRelated()
{
$relations = [];
@@ -123,13 +158,18 @@ abstract class Relation
/**
* Get the results of the relationship.
+ *
+ * @return Collection
*/
- abstract public function getResults(): Collection;
+ abstract public function getResults();
/**
* Execute the relationship query.
+ *
+ * @param array|string $columns
+ * @return Collection
*/
- public function get(array|string $columns = ['*']): Collection
+ public function get($columns = ['*'])
{
return $this->getResultsWithColumns($columns);
}
@@ -138,8 +178,11 @@ abstract class Relation
* Get the results of the relationship while selecting the given columns.
*
* If the query columns are empty, the given columns are applied.
+ *
+ * @param array $columns
+ * @return Collection
*/
- protected function getResultsWithColumns(array|string $columns): Collection
+ protected function getResultsWithColumns($columns)
{
if (is_null($this->query->columns)) {
$this->query->select($columns);
@@ -150,16 +193,21 @@ abstract class Relation
/**
* Get the first result of the relationship.
+ *
+ * @param array|string $columns
+ * @return Model|null
*/
- public function first(array|string $columns = ['*']): ?Model
+ public function first($columns = ['*'])
{
return $this->get($columns)->first();
}
/**
* Prepare the relation query.
+ *
+ * @return static
*/
- public function initRelation(): static
+ public function initRelation()
{
$this->query
->clearFilters()
@@ -171,8 +219,11 @@ abstract class Relation
/**
* Set the underlying query for the relation.
+ *
+ * @param Builder $query
+ * @return $this
*/
- public function setQuery(Builder $query): static
+ public function setQuery(Builder $query)
{
$this->query = $query;
@@ -183,58 +234,72 @@ abstract class Relation
/**
* Get the underlying query for the relation.
+ *
+ * @return Builder
*/
- public function getQuery(): Builder
+ public function getQuery()
{
return $this->query;
}
/**
* Get the parent model of the relation.
+ *
+ * @return Model
*/
- public function getParent(): Model
+ public function getParent()
{
return $this->parent;
}
/**
* Get the relation attribute key.
+ *
+ * @return string
*/
- public function getRelationKey(): string
+ public function getRelationKey()
{
return $this->relationKey;
}
/**
* Get the related model classes for the relation.
+ *
+ * @return array
*/
- public function getRelated(): array
+ public function getRelated()
{
return $this->related;
}
/**
* Get the relation foreign attribute key.
+ *
+ * @return string
*/
- public function getForeignKey(): string
+ public function getForeignKey()
{
return $this->foreignKey;
}
/**
* Get the class name of the default model.
+ *
+ * @return string
*/
- public function getDefaultModel(): string
+ public function getDefaultModel()
{
return $this->default;
}
/**
* Get a new instance of the default model on the relation.
+ *
+ * @return Model
*/
- public function getNewDefaultModel(): Model
+ public function getNewDefaultModel()
{
- $model = new $this->default;
+ $model = new $this->default();
$model->setConnection($this->parent->getConnectionName());
@@ -243,65 +308,132 @@ abstract class Relation
/**
* Get the foreign model by the given value.
+ *
+ * @param string $value
+ * @return Model|null
*/
- protected function getForeignModelByValue(string $value): ?Model
+ protected function getForeignModelByValue($value)
{
return $this->foreignKeyIsDistinguishedName()
- ? $this->query->clearFilters()->find($value)
- : $this->query->clearFilters()->findBy($this->foreignKey, $value);
+ ? $this->query->find($value)
+ : $this->query->findBy($this->foreignKey, $value);
}
/**
- * Get the escaped foreign key value for use in an LDAP filter from the model.
+ * Returns the escaped foreign key value for use in an LDAP filter from the model.
+ *
+ * @param Model $model
+ * @return string
*/
- protected function getEscapedForeignValueFromModel(Model $model): string
+ protected function getEscapedForeignValueFromModel(Model $model)
{
return $this->query->escape(
$this->getForeignValueFromModel($model)
- )->forDnAndFilter();
+ )->both();
}
/**
* Get the relation parents foreign value.
+ *
+ * @return string
*/
- protected function getParentForeignValue(): ?string
+ protected function getParentForeignValue()
{
return $this->getForeignValueFromModel($this->parent);
}
/**
* Get the foreign key value from the model.
+ *
+ * @param Model $model
+ * @return string
*/
- protected function getForeignValueFromModel(Model $model): ?string
+ protected function getForeignValueFromModel(Model $model)
{
return $this->foreignKeyIsDistinguishedName()
- ? $model->getDn()
- : $this->getFirstAttributeValue($model, $this->foreignKey);
+ ? $model->getDn()
+ : $this->getFirstAttributeValue($model, $this->foreignKey);
}
/**
* Get the first attribute value from the model.
+ *
+ * @param Model $model
+ * @param string $attribute
+ * @return string|null
*/
- protected function getFirstAttributeValue(Model $model, string $attribute): mixed
+ protected function getFirstAttributeValue(Model $model, $attribute)
{
return $model->getFirstAttribute($attribute);
}
/**
* Transforms the results by converting the models into their related.
+ *
+ * @param Collection $results
+ * @return Collection
*/
- protected function transformResults(Collection $results): Collection
+ protected function transformResults(Collection $results)
{
- return $results->transform(
- fn (Model $entry) => $entry->morphInto($this->related, static::$modelResolver)
+ $relationMap = [];
+
+ foreach ($this->related as $relation) {
+ $relationMap[$relation] = $this->normalizeObjectClasses(
+ $relation::$objectClasses
+ );
+ }
+
+ return $results->transform(function (Model $entry) use ($relationMap) {
+ $model = $this->determineModelFromRelated($entry, $relationMap);
+
+ return class_exists($model) ? $entry->convert(new $model()) : $entry;
+ });
+ }
+
+ /**
+ * Determines if the foreign key is a distinguished name.
+ *
+ * @return bool
+ */
+ protected function foreignKeyIsDistinguishedName()
+ {
+ return in_array($this->foreignKey, ['dn', 'distinguishedname']);
+ }
+
+ /**
+ * Determines the model from the given relation map.
+ *
+ * @param Model $model
+ * @param array $relationMap
+ * @return class-string|bool
+ */
+ protected function determineModelFromRelated(Model $model, array $relationMap)
+ {
+ // We must normalize all the related models object class
+ // names to the same case so we are able to properly
+ // determine the owning model from search results.
+ $modelObjectClasses = $this->normalizeObjectClasses(
+ $model->getObjectClasses()
+ );
+
+ return call_user_func(
+ static::$modelResolver,
+ $modelObjectClasses,
+ $relationMap,
+ $model,
);
}
/**
- * Determine if the foreign key is a distinguished name.
+ * Sort and normalize the object classes.
+ *
+ * @param array $classes
+ * @return array
*/
- protected function foreignKeyIsDistinguishedName(): bool
+ protected function normalizeObjectClasses($classes)
{
- return in_array($this->foreignKey, ['dn', 'distinguishedname']);
+ sort($classes);
+
+ return array_map('strtolower', $classes);
}
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Scope.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Scope.php
index 09c0c0c2c..f61cf686b 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Scope.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Scope.php
@@ -8,6 +8,10 @@ interface Scope
{
/**
* Apply the scope to the given query.
+ *
+ * @param Builder $query
+ * @param Model $model
+ * @return void
*/
- public function apply(Builder $query, Model $model): void;
+ public function apply(Builder $query, Model $model);
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Types/ActiveDirectory.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Types/ActiveDirectory.php
index 2fc54e4a4..3edcf88c9 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Types/ActiveDirectory.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Models/Types/ActiveDirectory.php
@@ -5,24 +5,34 @@ namespace LdapRecord\Models\Types;
interface ActiveDirectory extends TypeInterface
{
/**
- * Get the models object SID key.
+ * Returns the models object SID key.
+ *
+ * @return string
*/
- public function getObjectSidKey(): string;
+ public function getObjectSidKey();
/**
- * Get the model's hex object SID.
+ * Returns the model's hex object SID.
*
* @see https://msdn.microsoft.com/en-us/library/ms679024(v=vs.85).aspx
+ *
+ * @return string
*/
- public function getObjectSid(): ?string;
+ public function getObjectSid();
/**
- * Get the model's SID.
+ * Returns the model's SID.
+ *
+ * @param string|null $sid
+ * @return string|null
*/
- public function getConvertedSid(?string $sid = null): ?string;
+ public function getConvertedSid($sid = null);
/**
- * Get the model's binary SID.
+ * Returns the model's binary SID.
+ *
+ * @param string|null $sid
+ * @return string|null
*/
- public function getBinarySid(?string $sid = null): ?string;
+ public function getBinarySid($sid = null);
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/ArrayCacheStore.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/ArrayCacheStore.php
index d4a9137c0..2fb9c9a72 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/ArrayCacheStore.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/ArrayCacheStore.php
@@ -10,13 +10,15 @@ class ArrayCacheStore implements CacheInterface
/**
* An array of stored values.
+ *
+ * @var array
*/
- protected array $storage = [];
+ protected $storage = [];
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function get($key, $default = null): mixed
+ public function get($key, $default = null)
{
if (! isset($this->storage[$key])) {
return $default;
@@ -36,9 +38,9 @@ class ArrayCacheStore implements CacheInterface
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function set($key, $value, $ttl = null): bool
+ public function set($key, $value, $ttl = null)
{
$this->storage[$key] = [
'value' => $value,
@@ -50,24 +52,30 @@ class ArrayCacheStore implements CacheInterface
/**
* Get the expiration time of the key.
+ *
+ * @param int $seconds
+ * @return int
*/
- protected function calculateExpiration($seconds = null): int
+ protected function calculateExpiration($seconds)
{
return $this->toTimestamp($seconds);
}
/**
* Get the UNIX timestamp for the given number of seconds.
+ *
+ * @param int $seconds
+ * @return int
*/
- protected function toTimestamp($seconds = null): int
+ protected function toTimestamp($seconds)
{
return $seconds > 0 ? $this->availableAt($seconds) : 0;
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function delete($key): bool
+ public function delete($key)
{
unset($this->storage[$key]);
@@ -75,9 +83,9 @@ class ArrayCacheStore implements CacheInterface
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function clear(): bool
+ public function clear()
{
$this->storage = [];
@@ -85,9 +93,9 @@ class ArrayCacheStore implements CacheInterface
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function getMultiple($keys, $default = null): iterable
+ public function getMultiple($keys, $default = null)
{
$values = [];
@@ -99,9 +107,9 @@ class ArrayCacheStore implements CacheInterface
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function setMultiple($values, $ttl = null): bool
+ public function setMultiple($values, $ttl = null)
{
foreach ($values as $key => $value) {
$this->set($key, $value, $ttl);
@@ -111,9 +119,9 @@ class ArrayCacheStore implements CacheInterface
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function deleteMultiple($keys): bool
+ public function deleteMultiple($keys)
{
foreach ($keys as $key) {
$this->delete($key);
@@ -123,9 +131,9 @@ class ArrayCacheStore implements CacheInterface
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function has($key): bool
+ public function has($key)
{
return isset($this->storage[$key]);
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Builder.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Builder.php
index 642cf32af..c93c17809 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Builder.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Builder.php
@@ -5,7 +5,6 @@ namespace LdapRecord\Query;
use BadMethodCallException;
use Closure;
use DateTimeInterface;
-use Generator;
use InvalidArgumentException;
use LDAP\Result;
use LdapRecord\Connection;
@@ -13,42 +12,31 @@ use LdapRecord\Container;
use LdapRecord\EscapesValues;
use LdapRecord\LdapInterface;
use LdapRecord\LdapRecordException;
-use LdapRecord\Models\Attributes\EscapedValue;
use LdapRecord\Models\Model;
use LdapRecord\Query\Events\QueryExecuted;
use LdapRecord\Query\Model\Builder as ModelBuilder;
use LdapRecord\Query\Pagination\LazyPaginator;
use LdapRecord\Query\Pagination\Paginator;
use LdapRecord\Support\Arr;
+use LdapRecord\Utilities;
class Builder
{
use EscapesValues;
- public const TYPE_SEARCH = 'search';
-
- public const TYPE_READ = 'read';
-
- public const TYPE_CHUNK = 'chunk';
-
- public const TYPE_LIST = 'list';
-
- public const TYPE_PAGINATE = 'paginate';
-
- /**
- * The base distinguished name placeholder.
- */
- public const BASE_DN_PLACEHOLDER = '{base}';
-
/**
* The selected columns to retrieve on the query.
+ *
+ * @var array
*/
- public ?array $columns = null;
+ public $columns;
/**
* The query filters.
+ *
+ * @var array
*/
- public array $filters = [
+ public $filters = [
'and' => [],
'or' => [],
'raw' => [],
@@ -56,92 +44,120 @@ class Builder
/**
* The LDAP server controls to be sent.
+ *
+ * @var array
*/
- public array $controls = [];
+ public $controls = [];
/**
* The LDAP server controls that were processed.
+ *
+ * @var array
*/
- public array $controlsResponse = [];
+ public $controlsResponse = [];
/**
* The size limit of the query.
+ *
+ * @var int
*/
- public int $limit = 0;
+ public $limit = 0;
/**
- * Determine whether the current query is paginated.
+ * Determines whether the current query is paginated.
+ *
+ * @var bool
*/
- public bool $paginated = false;
+ public $paginated = false;
/**
* The distinguished name to perform searches upon.
+ *
+ * @var string|null
*/
- protected ?string $dn = null;
+ protected $dn;
/**
* The base distinguished name to perform searches inside.
+ *
+ * @var string|null
*/
- protected ?string $baseDn = null;
+ protected $baseDn;
/**
* The default query type.
+ *
+ * @var string
*/
- protected string $type = self::TYPE_SEARCH;
+ protected $type = 'search';
/**
- * Determine whether the query is nested.
+ * Determines whether the query is nested.
+ *
+ * @var bool
*/
- protected bool $nested = false;
+ protected $nested = false;
/**
- * Determine whether the query should be cached.
+ * Determines whether the query should be cached.
+ *
+ * @var bool
*/
- protected bool $caching = false;
-
- /**
- * The custom cache key to use when caching results.
- */
- protected ?string $cacheKey = null;
+ protected $caching = false;
/**
* How long the query should be cached until.
+ *
+ * @var DateTimeInterface|null
*/
- protected ?DateTimeInterface $cacheUntil = null;
+ protected $cacheUntil = null;
/**
- * Determine whether the query cache must be flushed.
+ * Determines whether the query cache must be flushed.
+ *
+ * @var bool
*/
- protected bool $flushCache = false;
+ protected $flushCache = false;
/**
* The current connection instance.
+ *
+ * @var Connection
*/
- protected Connection $connection;
+ protected $connection;
/**
* The current grammar instance.
+ *
+ * @var Grammar
*/
- protected Grammar $grammar;
+ protected $grammar;
/**
* The current cache instance.
+ *
+ * @var Cache|null
*/
- protected ?Cache $cache = null;
+ protected $cache;
/**
* Constructor.
+ *
+ * @param Connection $connection
*/
public function __construct(Connection $connection)
{
$this->connection = $connection;
- $this->grammar = new Grammar;
+ $this->grammar = new Grammar();
}
/**
* Set the current connection.
+ *
+ * @param Connection $connection
+ * @return $this
*/
- public function setConnection(Connection $connection): static
+ public function setConnection(Connection $connection)
{
$this->connection = $connection;
@@ -150,8 +166,11 @@ class Builder
/**
* Set the current filter grammar.
+ *
+ * @param Grammar $grammar
+ * @return $this
*/
- public function setGrammar(Grammar $grammar): static
+ public function setGrammar(Grammar $grammar)
{
$this->grammar = $grammar;
@@ -160,8 +179,11 @@ class Builder
/**
* Set the cache to store query results.
+ *
+ * @param Cache|null $cache
+ * @return $this
*/
- public function setCache(?Cache $cache = null): static
+ public function setCache(Cache $cache = null)
{
$this->cache = $cache;
@@ -170,18 +192,26 @@ class Builder
/**
* Returns a new Query Builder instance.
+ *
+ * @param string $baseDn
+ * @return $this
*/
- public function newInstance(?string $baseDn = null): Builder
+ public function newInstance($baseDn = null)
{
- return (new static($this->connection))->setDn(
- is_null($baseDn) ? $this->getDn() : $baseDn
- );
+ // We'll set the base DN of the new Builder so
+ // developers don't need to do this manually.
+ $dn = is_null($baseDn) ? $this->getDn() : $baseDn;
+
+ return (new static($this->connection))->setDn($dn);
}
/**
* Returns a new nested Query Builder instance.
+ *
+ * @param Closure|null $closure
+ * @return $this
*/
- public function newNestedInstance(?Closure $closure = null): Builder
+ public function newNestedInstance(Closure $closure = null)
{
$query = $this->newInstance()->nested();
@@ -194,20 +224,27 @@ class Builder
/**
* Executes the LDAP query.
+ *
+ * @param string|array $columns
+ * @return Collection|array
*/
- public function get(array|string $columns = ['*']): Collection|array
+ public function get($columns = ['*'])
{
- return $this->onceWithColumns(
- Arr::wrap($columns), fn () => $this->query($this->getQuery())
- );
+ return $this->onceWithColumns(Arr::wrap($columns), function () {
+ return $this->query($this->getQuery());
+ });
}
/**
* Execute the given callback while selecting the given columns.
*
* After running the callback, the columns are reset to the original value.
+ *
+ * @param array $columns
+ * @param Closure $callback
+ * @return mixed
*/
- protected function onceWithColumns(array $columns, Closure $callback): mixed
+ protected function onceWithColumns($columns, Closure $callback)
{
$original = $this->columns;
@@ -223,9 +260,11 @@ class Builder
}
/**
- * Compile the query into an LDAP filter string.
+ * Compiles and returns the current query string.
+ *
+ * @return string
*/
- public function getQuery(): string
+ public function getQuery()
{
// We need to ensure we have at least one filter, as
// no query results will be returned otherwise.
@@ -237,101 +276,134 @@ class Builder
}
/**
- * Get the unescaped query.
+ * Returns the unescaped query.
+ *
+ * @return string
*/
- public function getUnescapedQuery(): string
+ public function getUnescapedQuery()
{
- return EscapedValue::unescape($this->getQuery());
+ return Utilities::unescape($this->getQuery());
}
/**
- * Get the current Grammar instance.
+ * Returns the current Grammar instance.
+ *
+ * @return Grammar
*/
- public function getGrammar(): Grammar
+ public function getGrammar()
{
return $this->grammar;
}
/**
- * Get the current Cache instance.
+ * Returns the current Cache instance.
+ *
+ * @return Cache|null
*/
- public function getCache(): ?Cache
+ public function getCache()
{
return $this->cache;
}
/**
- * Get the current Connection instance.
+ * Returns the current Connection instance.
+ *
+ * @return Connection
*/
- public function getConnection(): Connection
+ public function getConnection()
{
return $this->connection;
}
/**
- * Get the query type.
+ * Returns the query type.
+ *
+ * @return string
*/
- public function getType(): string
+ public function getType()
{
return $this->type;
}
/**
* Set the base distinguished name of the query.
+ *
+ * @param Model|string $dn
+ * @return $this
*/
- public function setBaseDn(Model|string|null $dn = null): static
+ public function setBaseDn($dn)
{
- $this->baseDn = $this->substituteBaseDn($dn);
+ $this->baseDn = $this->substituteBaseInDn($dn);
return $this;
}
/**
* Get the base distinguished name of the query.
+ *
+ * @return string|null
*/
- public function getBaseDn(): ?string
+ public function getBaseDn()
{
return $this->baseDn;
}
/**
* Get the distinguished name of the query.
+ *
+ * @return string
*/
- public function getDn(): ?string
+ public function getDn()
{
return $this->dn;
}
/**
* Set the distinguished name for the query.
+ *
+ * @param string|Model|null $dn
+ * @return $this
*/
- public function setDn(Model|string|null $dn = null): static
+ public function setDn($dn = null)
{
- $this->dn = $this->substituteBaseDn($dn);
+ $this->dn = $this->substituteBaseInDn($dn);
return $this;
}
/**
* Substitute the base DN string template for the current base.
+ *
+ * @param Model|string $dn
+ * @return string
*/
- public function substituteBaseDn(Model|string|null $dn = null): string
+ protected function substituteBaseInDn($dn)
{
- return str_replace(static::BASE_DN_PLACEHOLDER, $this->baseDn ?? '', (string) $dn);
+ return str_replace(
+ '{base}',
+ $this->baseDn ?: '',
+ (string) ($dn instanceof Model ? $dn->getDn() : $dn)
+ );
}
/**
* Alias for setting the distinguished name for the query.
+ *
+ * @param string|Model|null $dn
+ * @return $this
*/
- public function in(Model|string|null $dn = null): static
+ public function in($dn = null)
{
return $this->setDn($dn);
}
/**
* Set the size limit of the current query.
+ *
+ * @param int $limit
+ * @return $this
*/
- public function limit(int $limit = 0): static
+ public function limit($limit = 0)
{
$this->limit = $limit;
@@ -340,8 +412,11 @@ class Builder
/**
* Returns a new query for the given model.
+ *
+ * @param Model $model
+ * @return ModelBuilder
*/
- public function model(Model $model): ModelBuilder
+ public function model(Model $model)
{
return $model->newQueryBuilder($this->connection)
->setCache($this->connection->getCache())
@@ -351,15 +426,20 @@ class Builder
/**
* Performs the specified query on the current LDAP connection.
+ *
+ * @param string $query
+ * @return Collection|array
*/
- public function query(string $query): Collection|array
+ public function query($query)
{
$start = microtime(true);
// Here we will create the execution callback. This allows us
// to only execute an LDAP request if caching is disabled
// or if no cache of the given query exists yet.
- $callback = fn () => $this->parse($this->run($query));
+ $callback = function () use ($query) {
+ return $this->parse($this->run($query));
+ };
$results = $this->getCachedResponse($query, $callback);
@@ -370,8 +450,12 @@ class Builder
/**
* Paginates the current LDAP query.
+ *
+ * @param int $pageSize
+ * @param bool $isCritical
+ * @return Collection|array
*/
- public function paginate(int $pageSize = 1000, bool $isCritical = false): Collection|array
+ public function paginate($pageSize = 1000, $isCritical = false)
{
$this->paginated = true;
@@ -382,37 +466,42 @@ class Builder
// Here we will create the pagination callback. This allows us
// to only execute an LDAP request if caching is disabled
// or if no cache of the given query exists yet.
- $callback = fn () => $this->runPaginate($query, $pageSize, $isCritical);
+ $callback = function () use ($query, $pageSize, $isCritical) {
+ return $this->runPaginate($query, $pageSize, $isCritical);
+ };
$pages = $this->getCachedResponse($query, $callback);
- $this->logQuery($this, self::TYPE_PAGINATE, $this->getElapsedTime($start));
+ $this->logQuery($this, 'paginate', $this->getElapsedTime($start));
return $this->process($pages);
}
/**
* Runs the paginate operation with the given filter.
+ *
+ * @param string $filter
+ * @param int $perPage
+ * @param bool $isCritical
+ * @return array
*/
- protected function runPaginate(string $filter, int $perPage, bool $isCritical): array
+ protected function runPaginate($filter, $perPage, $isCritical)
{
- return $this->connection->run(
- fn (LdapInterface $ldap) => $this->newPaginator($filter, $perPage, $isCritical)->execute($ldap)
- );
- }
-
- /**
- * Make a new paginator instance.
- */
- protected function newPaginator(string $filter, int $perPage, bool $isCritical): Paginator
- {
- return new Paginator($this, $filter, $perPage, $isCritical);
+ return $this->connection->run(function (LdapInterface $ldap) use ($filter, $perPage, $isCritical) {
+ return (new Paginator($this, $filter, $perPage, $isCritical))->execute($ldap);
+ });
}
/**
* Execute a callback over each item while chunking.
+ *
+ * @param Closure $callback
+ * @param int $pageSize
+ * @param bool $isCritical
+ * @param bool $isolate
+ * @return bool
*/
- public function each(Closure $callback, int $pageSize = 1000, bool $isCritical = false, bool $isolate = false): bool
+ public function each(Closure $callback, $pageSize = 1000, $isCritical = false, $isolate = false)
{
return $this->chunk($pageSize, function ($results) use ($callback) {
foreach ($results as $key => $value) {
@@ -425,11 +514,15 @@ class Builder
/**
* Chunk the results of a paginated LDAP query.
+ *
+ * @param int $pageSize
+ * @param Closure $callback
+ * @param bool $isCritical
+ * @param bool $isolate
+ * @return bool
*/
- public function chunk(int $pageSize, Closure $callback, bool $isCritical = false, bool $isolate = false): bool
+ public function chunk($pageSize, Closure $callback, $isCritical = false, $isolate = false)
{
- $this->limit(0);
-
$start = microtime(true);
$chunk = function (Builder $query) use ($pageSize, $callback, $isCritical) {
@@ -444,40 +537,40 @@ class Builder
}
};
- // Connection isolation creates a new, temporary connection for the pagination
- // request to occur on. This allows connections that do not support executing
- // other queries during a pagination request, to do so without interruption.
- $isolate ? $this->connection->isolate(
- fn (Connection $replicate) => $chunk($this->clone()->setConnection($replicate))
- ) : $chunk($this);
+ $isolate ? $this->connection->isolate(function (Connection $replicate) use ($chunk) {
+ $chunk($this->clone()->setConnection($replicate));
+ }) : $chunk($this);
- $this->logQuery($this, self::TYPE_CHUNK, $this->getElapsedTime($start));
+ $this->logQuery($this, 'chunk', $this->getElapsedTime($start));
return true;
}
/**
* Runs the chunk operation with the given filter.
+ *
+ * @param string $filter
+ * @param int $perPage
+ * @param bool $isCritical
+ * @return \Generator
*/
- protected function runChunk(string $filter, int $perPage, bool $isCritical): Generator
+ protected function runChunk($filter, $perPage, $isCritical)
{
- return $this->connection->run(
- fn (LdapInterface $ldap) => $this->newLazyPaginator($filter, $perPage, $isCritical)->execute($ldap)
- );
- }
-
- /**
- * Make a new lazy paginator instance.
- */
- protected function newLazyPaginator(string $filter, int $perPage, bool $isCritical): LazyPaginator
- {
- return new LazyPaginator($this, $filter, $perPage, $isCritical);
+ return $this->connection->run(function (LdapInterface $ldap) use ($filter, $perPage, $isCritical) {
+ return (new LazyPaginator($this, $filter, $perPage, $isCritical))->execute($ldap);
+ });
}
/**
* Create a slice of the LDAP query into a page.
+ *
+ * @param int $page
+ * @param int $perPage
+ * @param string $orderBy
+ * @param string $orderByDir
+ * @return Slice
*/
- public function slice(int $page = 1, int $perPage = 100, string $orderBy = 'cn', string $orderByDir = 'asc'): Slice
+ public function slice($page = 1, $perPage = 100, $orderBy = 'cn', $orderByDir = 'asc')
{
$results = $this->forPage($page, $perPage, $orderBy, $orderByDir);
@@ -496,8 +589,14 @@ class Builder
/**
* Get the results of a query for a given page.
+ *
+ * @param int $page
+ * @param int $perPage
+ * @param string $orderBy
+ * @param string $orderByDir
+ * @return Collection|array
*/
- public function forPage(int $page = 1, int $perPage = 100, string $orderBy = 'cn', string $orderByDir = 'asc'): Collection|array
+ public function forPage($page = 1, $perPage = 100, $orderBy = 'cn', $orderByDir = 'asc')
{
if (! $this->hasOrderBy()) {
$this->orderBy($orderBy, $orderByDir);
@@ -515,8 +614,11 @@ class Builder
/**
* Processes and converts the given LDAP results into models.
+ *
+ * @param array $results
+ * @return array
*/
- protected function process(array $results): mixed
+ protected function process(array $results)
{
unset($results['count']);
@@ -529,8 +631,11 @@ class Builder
/**
* Flattens LDAP paged results into a single array.
+ *
+ * @param array $pages
+ * @return array
*/
- protected function flattenPages(array $pages): array
+ protected function flattenPages(array $pages)
{
$records = [];
@@ -545,11 +650,15 @@ class Builder
/**
* Get the cached response or execute and cache the callback value.
+ *
+ * @param string $query
+ * @param Closure $callback
+ * @return mixed
*/
- protected function getCachedResponse(string $query, Closure $callback): mixed
+ protected function getCachedResponse($query, Closure $callback)
{
if ($this->cache && $this->caching) {
- $key = $this->cacheKey ?? $this->getCacheKey($query);
+ $key = $this->getCacheKey($query);
if ($this->flushCache) {
$this->cache->delete($key);
@@ -558,20 +667,16 @@ class Builder
return $this->cache->remember($key, $this->cacheUntil, $callback);
}
- try {
- return $callback();
- } finally {
- $this->caching = false;
- $this->cacheKey = null;
- $this->cacheUntil = null;
- $this->flushCache = false;
- }
+ return $callback();
}
/**
* Runs the query operation with the given filter.
+ *
+ * @param string $filter
+ * @return resource
*/
- public function run(string $filter): mixed
+ public function run($filter)
{
return $this->connection->run(function (LdapInterface $ldap) use ($filter) {
// We will avoid setting the controls during any pagination
@@ -585,7 +690,7 @@ class Builder
}
return $ldap->{$this->type}(
- (string) ($this->dn ?? $this->baseDn),
+ $this->dn ?? $this->baseDn,
$filter,
$this->getSelects(),
$onlyAttributes = false,
@@ -596,8 +701,11 @@ class Builder
/**
* Parses the given LDAP resource by retrieving its entries.
+ *
+ * @param resource $resource
+ * @return array
*/
- public function parse(mixed $resource): array
+ public function parse($resource)
{
if (! $resource) {
return [];
@@ -606,10 +714,17 @@ class Builder
return $this->connection->run(function (LdapInterface $ldap) use ($resource) {
$this->controlsResponse = $this->controls;
+ $errorCode = 0;
+ $dn = $errorMessage = $refs = null;
+
// Process the server controls response.
$ldap->parseResult(
- result: $resource,
- controls: $this->controlsResponse
+ $resource,
+ $errorCode,
+ $dn,
+ $errorMessage,
+ $refs,
+ $this->controlsResponse
);
$entries = $ldap->getEntries($resource);
@@ -624,13 +739,16 @@ class Builder
}
/**
- * Get the cache key.
+ * Returns the cache key.
+ *
+ * @param string $query
+ * @return string
*/
- protected function getCacheKey(string $query): string
+ protected function getCacheKey($query)
{
- $host = $this->connection->run(
- fn (LdapInterface $ldap) => $ldap->getHost()
- );
+ $host = $this->connection->run(function (LdapInterface $ldap) {
+ return $ldap->getHost();
+ });
$key = $host
.$this->type
@@ -644,9 +762,12 @@ class Builder
}
/**
- * Get the first entry in a search result.
+ * Returns the first entry in a search result.
+ *
+ * @param array|string $columns
+ * @return Model|null
*/
- public function first(array|string $columns = ['*']): Model|array|null
+ public function first($columns = ['*'])
{
return Arr::first(
$this->limit(1)->get($columns)
@@ -654,13 +775,16 @@ class Builder
}
/**
- * Get the first entry in a search result.
+ * Returns the first entry in a search result.
*
* If no entry is found, an exception is thrown.
*
+ * @param array|string $columns
+ * @return Model|array
+ *
* @throws ObjectNotFoundException
*/
- public function firstOrFail(array|string $columns = ['*']): Model|array
+ public function firstOrFail($columns = ['*'])
{
if (! $record = $this->first($columns)) {
$this->throwNotFoundException($this->getUnescapedQuery(), $this->dn);
@@ -670,9 +794,12 @@ class Builder
}
/**
- * Get the first entry in a result, or execute the callback.
+ * Return the first entry in a result, or execute the callback.
+ *
+ * @param Closure $callback
+ * @return Model|mixed
*/
- public function firstOr(Closure $callback): mixed
+ public function firstOr(Closure $callback)
{
return $this->first() ?: $callback();
}
@@ -680,10 +807,13 @@ class Builder
/**
* Execute the query and get the first result if it's the sole matching record.
*
+ * @param array|string $columns
+ * @return Model|array
+ *
* @throws ObjectsNotFoundException
* @throws MultipleObjectsFoundException
*/
- public function sole(array|string $columns = ['*']): Model|array
+ public function sole($columns = ['*'])
{
$result = $this->limit(2)->get($columns);
@@ -700,24 +830,31 @@ class Builder
/**
* Determine if any results exist for the current query.
+ *
+ * @return bool
*/
- public function exists(): bool
+ public function exists()
{
return ! is_null($this->first());
}
/**
* Determine if no results exist for the current query.
+ *
+ * @return bool
*/
- public function doesntExist(): bool
+ public function doesntExist()
{
return ! $this->exists();
}
/**
* Execute the given callback if no rows exist for the current query.
+ *
+ * @param Closure $callback
+ * @return bool|mixed
*/
- public function existsOr(Closure $callback): mixed
+ public function existsOr(Closure $callback)
{
return $this->exists() ? true : $callback();
}
@@ -725,9 +862,12 @@ class Builder
/**
* Throws a not found exception.
*
+ * @param string $query
+ * @param string $dn
+ *
* @throws ObjectNotFoundException
*/
- protected function throwNotFoundException(string $query, ?string $dn = null): void
+ protected function throwNotFoundException($query, $dn)
{
throw ObjectNotFoundException::forQuery($query, $dn);
}
@@ -735,14 +875,17 @@ class Builder
/**
* Finds a record by the specified attribute and value.
*
+ * @param string $attribute
+ * @param string $value
+ * @param array|string $columns
* @return Model|static|null
*/
- public function findBy(string $attribute, string $value, array|string $columns = ['*']): Model|array|null
+ public function findBy($attribute, $value, $columns = ['*'])
{
try {
return $this->findByOrFail($attribute, $value, $columns);
} catch (ObjectNotFoundException $e) {
- return null;
+ return;
}
}
@@ -751,17 +894,26 @@ class Builder
*
* If no record is found an exception is thrown.
*
+ * @param string $attribute
+ * @param string $value
+ * @param array|string $columns
+ * @return Model
+ *
* @throws ObjectNotFoundException
*/
- public function findByOrFail(string $attribute, string $value, array|string $columns = ['*']): Model|array
+ public function findByOrFail($attribute, $value, $columns = ['*'])
{
return $this->whereEquals($attribute, $value)->firstOrFail($columns);
}
/**
* Find many records by distinguished name.
+ *
+ * @param string|array $dns
+ * @param array $columns
+ * @return array|Collection
*/
- public function findMany(array|string $dns, array|string $columns = ['*']): Collection|array
+ public function findMany($dns, $columns = ['*'])
{
if (empty($dns)) {
return $this->process([]);
@@ -780,8 +932,13 @@ class Builder
/**
* Finds many records by the specified attribute.
+ *
+ * @param string $attribute
+ * @param array $values
+ * @param array $columns
+ * @return Collection
*/
- public function findManyBy(string $attribute, array $values = [], array|string $columns = ['*']): Collection|array
+ public function findManyBy($attribute, array $values = [], $columns = ['*'])
{
$query = $this->select($columns);
@@ -794,8 +951,12 @@ class Builder
/**
* Finds a record by its distinguished name.
+ *
+ * @param string|array $dn
+ * @param array|string $columns
+ * @return Model|static|array|Collection|null
*/
- public function find(array|string $dn, array|string $columns = ['*']): Collection|Model|array|null
+ public function find($dn, $columns = ['*'])
{
if (is_array($dn)) {
return $this->findMany($dn, $columns);
@@ -804,7 +965,7 @@ class Builder
try {
return $this->findOrFail($dn, $columns);
} catch (ObjectNotFoundException $e) {
- return null;
+ return;
}
}
@@ -813,9 +974,13 @@ class Builder
*
* Fails upon no records returned.
*
+ * @param string $dn
+ * @param array|string $columns
+ * @return Model|static
+ *
* @throws ObjectNotFoundException
*/
- public function findOrFail(string $dn, array|string $columns = ['*']): Model|array
+ public function findOrFail($dn, $columns = ['*'])
{
return $this->setDn($dn)
->read()
@@ -825,8 +990,11 @@ class Builder
/**
* Adds the inserted fields to query on the current LDAP connection.
+ *
+ * @param array|string $columns
+ * @return $this
*/
- public function select(array|string $columns = ['*']): static
+ public function select($columns = ['*'])
{
$columns = is_array($columns) ? $columns : func_get_args();
@@ -839,8 +1007,11 @@ class Builder
/**
* Add a new select column to the query.
+ *
+ * @param array|mixed $column
+ * @return $this
*/
- public function addSelect(array|string $column): static
+ public function addSelect($column)
{
$column = is_array($column) ? $column : func_get_args();
@@ -851,38 +1022,46 @@ class Builder
/**
* Add an order by control to the query.
+ *
+ * @param string $attribute
+ * @param string $direction
+ * @return $this
*/
- public function orderBy(string $attribute, string $direction = 'asc', array $options = []): static
+ public function orderBy($attribute, $direction = 'asc')
{
return $this->addControl(LDAP_CONTROL_SORTREQUEST, true, [
- [
- ...$options,
- 'attr' => $attribute,
- 'reverse' => $direction === 'desc',
- ],
+ ['attr' => $attribute, 'reverse' => $direction === 'desc'],
]);
}
/**
* Add an order by descending control to the query.
+ *
+ * @param string $attribute
+ * @return $this
*/
- public function orderByDesc(string $attribute, array $options = []): static
+ public function orderByDesc($attribute)
{
- return $this->orderBy($attribute, 'desc', $options);
+ return $this->orderBy($attribute, 'desc');
}
/**
* Determine if the query has a sotr request control header.
+ *
+ * @return bool
*/
- public function hasOrderBy(): bool
+ public function hasOrderBy()
{
return $this->hasControl(LDAP_CONTROL_SORTREQUEST);
}
/**
* Adds a raw filter to the current query.
+ *
+ * @param array|string $filters
+ * @return $this
*/
- public function rawFilter(array|string $filters = []): static
+ public function rawFilter($filters = [])
{
$filters = is_array($filters) ? $filters : func_get_args();
@@ -895,8 +1074,11 @@ class Builder
/**
* Adds a nested 'and' filter to the current query.
+ *
+ * @param Closure $closure
+ * @return $this
*/
- public function andFilter(Closure $closure): static
+ public function andFilter(Closure $closure)
{
$query = $this->newNestedInstance($closure);
@@ -907,8 +1089,11 @@ class Builder
/**
* Adds a nested 'or' filter to the current query.
+ *
+ * @param Closure $closure
+ * @return $this
*/
- public function orFilter(Closure $closure): static
+ public function orFilter(Closure $closure)
{
$query = $this->newNestedInstance($closure);
@@ -919,8 +1104,11 @@ class Builder
/**
* Adds a nested 'not' filter to the current query.
+ *
+ * @param Closure $closure
+ * @return $this
*/
- public function notFilter(Closure $closure): static
+ public function notFilter(Closure $closure)
{
$query = $this->newNestedInstance($closure);
@@ -932,23 +1120,30 @@ class Builder
/**
* Adds a where clause to the current query.
*
+ * @param string|array $field
+ * @param string $operator
+ * @param string $value
+ * @param string $boolean
+ * @param bool $raw
+ * @return $this
+ *
* @throws InvalidArgumentException
*/
- public function where(array|string $field, mixed $operator = null, mixed $value = null, string $boolean = 'and', bool $raw = false): static
+ public function where($field, $operator = null, $value = null, $boolean = 'and', $raw = false)
{
if (is_array($field)) {
// If the field is an array, we will assume we have been
// provided with an array of key-value pairs and can
- // add them each as their own separate where clause.
+ // add them each as their own seperate where clause.
return $this->addArrayOfWheres($field, $boolean, $raw);
}
// If we have been provided with two arguments not a "has" or
// "not has" operator, we'll assume the developer is creating
// an "equals" clause and set the proper operator in place.
- [$value, $operator] = $this->prepareValueAndOperator(
- $value, $operator, func_num_args() === 2 && ! $this->operatorRequiresValue($operator)
- );
+ if (func_num_args() === 2 && ! in_array($operator, ['*', '!*'])) {
+ [$value, $operator] = [$operator, '='];
+ }
if (! in_array($operator, $this->grammar->getOperators())) {
throw new InvalidArgumentException("Invalid LDAP filter operator [$operator]");
@@ -957,122 +1152,133 @@ class Builder
// We'll escape the value if raw isn't requested.
$value = $this->prepareWhereValue($field, $value, $raw);
- $field = $this->escape($field)->forDnAndFilter()->get();
+ $field = $this->escape($field)->both()->get();
$this->addFilter($boolean, compact('field', 'operator', 'value'));
return $this;
}
- /**
- * Prepare the value and operator for a where clause.
- */
- public function prepareValueAndOperator(mixed $value, mixed $operator, bool $useDefault = false): array
- {
- if ($useDefault) {
- return [$operator, '='];
- }
-
- return [$value, $operator];
- }
-
- /**
- * Determine if the operator requires a value to be present.
- */
- protected function operatorRequiresValue(mixed $operator): bool
- {
- return in_array($operator, ['*', '!*']);
- }
-
/**
* Prepare the value for being queried.
+ *
+ * @param string $field
+ * @param string $value
+ * @param bool $raw
+ * @return string
*/
- protected function prepareWhereValue(string $field, mixed $value = null, bool $raw = false): string
+ protected function prepareWhereValue($field, $value, $raw = false)
{
- return $raw ? $value : $this->escape($value)->get();
+ return $raw ? $value : $this->escape($value);
}
/**
* Adds a raw where clause to the current query.
*
* Values given to this method are not escaped.
+ *
+ * @param string|array $field
+ * @param string $operator
+ * @param string $value
+ * @return $this
*/
- public function whereRaw(array|string $field, ?string $operator = null, mixed $value = null): static
+ public function whereRaw($field, $operator = null, $value = null)
{
return $this->where($field, $operator, $value, 'and', true);
}
/**
* Adds a 'where equals' clause to the current query.
+ *
+ * @param string $field
+ * @param string $value
+ * @return $this
*/
- public function whereEquals(string $field, string $value): static
+ public function whereEquals($field, $value)
{
return $this->where($field, '=', $value);
}
/**
* Adds a 'where not equals' clause to the current query.
+ *
+ * @param string $field
+ * @param string $value
+ * @return $this
*/
- public function whereNotEquals(string $field, string $value): static
+ public function whereNotEquals($field, $value)
{
return $this->where($field, '!', $value);
}
/**
* Adds a 'where approximately equals' clause to the current query.
+ *
+ * @param string $field
+ * @param string $value
+ * @return $this
*/
- public function whereApproximatelyEquals(string $field, string $value): static
+ public function whereApproximatelyEquals($field, $value)
{
return $this->where($field, '~=', $value);
}
/**
* Adds a 'where has' clause to the current query.
+ *
+ * @param string $field
+ * @return $this
*/
- public function whereHas(string $field): static
+ public function whereHas($field)
{
return $this->where($field, '*');
}
/**
* Adds a 'where not has' clause to the current query.
+ *
+ * @param string $field
+ * @return $this
*/
- public function whereNotHas(string $field): static
+ public function whereNotHas($field)
{
return $this->where($field, '!*');
}
/**
* Adds a 'where contains' clause to the current query.
+ *
+ * @param string $field
+ * @param string $value
+ * @return $this
*/
- public function whereContains(string $field, string $value): static
+ public function whereContains($field, $value)
{
return $this->where($field, 'contains', $value);
}
/**
* Adds a 'where contains' clause to the current query.
+ *
+ * @param string $field
+ * @param string $value
+ * @return $this
*/
- public function whereNotContains(string $field, string $value): static
+ public function whereNotContains($field, $value)
{
return $this->where($field, 'not_contains', $value);
}
/**
* Query for entries that match any of the values provided for the given field.
+ *
+ * @param string $field
+ * @param array $values
+ * @return $this
*/
- public function whereIn(string $field, array $values): static
+ public function whereIn($field, array $values)
{
- if (empty($values)) {
- // If the array of values is empty, we will
- // add an empty OR filter to the query to
- // ensure that no results are returned.
- $this->rawFilter('(|)');
-
- return $this;
- }
-
- return $this->orFilter(function (Builder $query) use ($field, $values) {
+ return $this->orFilter(function (self $query) use ($field, $values) {
foreach ($values as $value) {
$query->whereEquals($field, $value);
}
@@ -1081,8 +1287,12 @@ class Builder
/**
* Adds a 'between' clause to the current query.
+ *
+ * @param string $field
+ * @param array $values
+ * @return $this
*/
- public function whereBetween(string $field, array $values): static
+ public function whereBetween($field, array $values)
{
return $this->where([
[$field, '>=', $values[0]],
@@ -1092,56 +1302,81 @@ class Builder
/**
* Adds a 'where starts with' clause to the current query.
+ *
+ * @param string $field
+ * @param string $value
+ * @return $this
*/
- public function whereStartsWith(string $field, string $value): static
+ public function whereStartsWith($field, $value)
{
return $this->where($field, 'starts_with', $value);
}
/**
* Adds a 'where *not* starts with' clause to the current query.
+ *
+ * @param string $field
+ * @param string $value
+ * @return $this
*/
- public function whereNotStartsWith(string $field, string $value): static
+ public function whereNotStartsWith($field, $value)
{
return $this->where($field, 'not_starts_with', $value);
}
/**
* Adds a 'where ends with' clause to the current query.
+ *
+ * @param string $field
+ * @param string $value
+ * @return $this
*/
- public function whereEndsWith(string $field, string $value): static
+ public function whereEndsWith($field, $value)
{
return $this->where($field, 'ends_with', $value);
}
/**
* Adds a 'where *not* ends with' clause to the current query.
+ *
+ * @param string $field
+ * @param string $value
+ * @return $this
*/
- public function whereNotEndsWith(string $field, string $value): static
+ public function whereNotEndsWith($field, $value)
{
return $this->where($field, 'not_ends_with', $value);
}
/**
* Only include deleted models in the results.
+ *
+ * @return $this
*/
- public function whereDeleted(): static
+ public function whereDeleted()
{
return $this->withDeleted()->whereEquals('isDeleted', 'TRUE');
}
/**
* Set the LDAP control option to include deleted LDAP models.
+ *
+ * @return $this
*/
- public function withDeleted(): static
+ public function withDeleted()
{
return $this->addControl(LdapInterface::OID_SERVER_SHOW_DELETED, $isCritical = true);
}
/**
* Add a server control to the query.
+ *
+ * @param string $oid
+ * @param bool $isCritical
+ * @param mixed $value
+ * @return $this
*/
- public function addControl(string $oid, bool $isCritical = false, mixed $value = null): static
+ public function addControl($oid, $isCritical = false, $value = null)
{
$this->controls[$oid] = compact('oid', 'isCritical', 'value');
@@ -1150,21 +1385,25 @@ class Builder
/**
* Determine if the server control exists on the query.
+ *
+ * @param string $oid
+ * @return bool
*/
- public function hasControl(string $oid): bool
+ public function hasControl($oid)
{
return array_key_exists($oid, $this->controls);
}
/**
* Adds an 'or where' clause to the current query.
+ *
+ * @param array|string $field
+ * @param string|null $operator
+ * @param string|null $value
+ * @return $this
*/
- public function orWhere(array|string $field, ?string $operator = null, ?string $value = null): static
+ public function orWhere($field, $operator = null, $value = null)
{
- [$value, $operator] = $this->prepareValueAndOperator(
- $value, $operator, func_num_args() === 2 && ! $this->operatorRequiresValue($operator)
- );
-
return $this->where($field, $operator, $value, 'or');
}
@@ -1172,96 +1411,143 @@ class Builder
* Adds a raw or where clause to the current query.
*
* Values given to this method are not escaped.
+ *
+ * @param string $field
+ * @param string $operator
+ * @param string $value
+ * @return $this
*/
- public function orWhereRaw(array|string $field, ?string $operator = null, ?string $value = null): static
+ public function orWhereRaw($field, $operator = null, $value = null)
{
return $this->where($field, $operator, $value, 'or', true);
}
/**
* Adds an 'or where has' clause to the current query.
+ *
+ * @param string $field
+ * @return $this
*/
- public function orWhereHas(string $field): static
+ public function orWhereHas($field)
{
return $this->orWhere($field, '*');
}
/**
* Adds a 'where not has' clause to the current query.
+ *
+ * @param string $field
+ * @return $this
*/
- public function orWhereNotHas(string $field): static
+ public function orWhereNotHas($field)
{
return $this->orWhere($field, '!*');
}
/**
* Adds an 'or where equals' clause to the current query.
+ *
+ * @param string $field
+ * @param string $value
+ * @return $this
*/
- public function orWhereEquals(string $field, string $value): static
+ public function orWhereEquals($field, $value)
{
return $this->orWhere($field, '=', $value);
}
/**
* Adds an 'or where not equals' clause to the current query.
+ *
+ * @param string $field
+ * @param string $value
+ * @return $this
*/
- public function orWhereNotEquals(string $field, string $value): static
+ public function orWhereNotEquals($field, $value)
{
return $this->orWhere($field, '!', $value);
}
/**
* Adds a 'or where approximately equals' clause to the current query.
+ *
+ * @param string $field
+ * @param string $value
+ * @return $this
*/
- public function orWhereApproximatelyEquals(string $field, string $value): static
+ public function orWhereApproximatelyEquals($field, $value)
{
return $this->orWhere($field, '~=', $value);
}
/**
* Adds an 'or where contains' clause to the current query.
+ *
+ * @param string $field
+ * @param string $value
+ * @return $this
*/
- public function orWhereContains(string $field, string $value): static
+ public function orWhereContains($field, $value)
{
return $this->orWhere($field, 'contains', $value);
}
/**
* Adds an 'or where *not* contains' clause to the current query.
+ *
+ * @param string $field
+ * @param string $value
+ * @return $this
*/
- public function orWhereNotContains(string $field, string $value): static
+ public function orWhereNotContains($field, $value)
{
return $this->orWhere($field, 'not_contains', $value);
}
/**
* Adds an 'or where starts with' clause to the current query.
+ *
+ * @param string $field
+ * @param string $value
+ * @return $this
*/
- public function orWhereStartsWith(string $field, string $value): static
+ public function orWhereStartsWith($field, $value)
{
return $this->orWhere($field, 'starts_with', $value);
}
/**
* Adds an 'or where *not* starts with' clause to the current query.
+ *
+ * @param string $field
+ * @param string $value
+ * @return $this
*/
- public function orWhereNotStartsWith(string $field, string $value): static
+ public function orWhereNotStartsWith($field, $value)
{
return $this->orWhere($field, 'not_starts_with', $value);
}
/**
* Adds an 'or where ends with' clause to the current query.
+ *
+ * @param string $field
+ * @param string $value
+ * @return $this
*/
- public function orWhereEndsWith(string $field, string $value): static
+ public function orWhereEndsWith($field, $value)
{
return $this->orWhere($field, 'ends_with', $value);
}
/**
* Adds an 'or where *not* ends with' clause to the current query.
+ *
+ * @param string $field
+ * @param string $value
+ * @return $this
*/
- public function orWhereNotEndsWith(string $field, string $value): static
+ public function orWhereNotEndsWith($field, $value)
{
return $this->orWhere($field, 'not_ends_with', $value);
}
@@ -1269,9 +1555,13 @@ class Builder
/**
* Adds a filter binding onto the current query.
*
+ * @param string $type The type of filter to add.
+ * @param array $bindings The bindings of the filter.
+ * @return $this
+ *
* @throws InvalidArgumentException
*/
- public function addFilter(string $type, array $bindings): static
+ public function addFilter($type, array $bindings)
{
if (! array_key_exists($type, $this->filters)) {
throw new InvalidArgumentException("Filter type: [$type] is invalid.");
@@ -1293,8 +1583,11 @@ class Builder
/**
* Extract any missing required binding keys.
+ *
+ * @param array $bindings
+ * @return array
*/
- protected function missingBindingKeys(array $bindings): array
+ protected function missingBindingKeys($bindings)
{
$required = array_flip(['field', 'operator', 'value']);
@@ -1305,16 +1598,20 @@ class Builder
/**
* Get all the filters on the query.
+ *
+ * @return array
*/
- public function getFilters(): array
+ public function getFilters()
{
return $this->filters;
}
/**
* Clear the query filters.
+ *
+ * @return $this
*/
- public function clearFilters(): static
+ public function clearFilters()
{
foreach (array_keys($this->filters) as $type) {
$this->filters[$type] = [];
@@ -1325,16 +1622,20 @@ class Builder
/**
* Determine if the query has attributes selected.
+ *
+ * @return bool
*/
- public function hasSelects(): bool
+ public function hasSelects()
{
- return count($this->columns ?? []) > 0;
+ return count($this->columns) > 0;
}
/**
* Get the attributes to select on the search.
+ *
+ * @return array
*/
- public function getSelects(): array
+ public function getSelects()
{
$selects = $this->columns ?? ['*'];
@@ -1358,48 +1659,49 @@ class Builder
* Set the query to search on the base distinguished name.
*
* This will result in one record being returned.
+ *
+ * @return $this
*/
- public function read(): static
+ public function read()
{
- $this->type = self::TYPE_READ;
+ $this->type = 'read';
return $this;
}
/**
* Set the query to search one level on the base distinguished name.
+ *
+ * @return $this
*/
- public function list(): static
+ public function listing()
{
- $this->type = self::TYPE_LIST;
+ $this->type = 'listing';
return $this;
}
- /**
- * Alias for the "search" method.
- */
- public function recursive(): static
- {
- return $this->search();
- }
-
/**
* Set the query to search the entire directory on the base distinguished name.
+ *
+ * @return $this
*/
- public function search(): static
+ public function recursive()
{
- $this->type = self::TYPE_SEARCH;
+ $this->type = 'search';
return $this;
}
/**
* Whether to mark the current query as nested.
+ *
+ * @param bool $nested
+ * @return $this
*/
- public function nested(bool $nested = true): static
+ public function nested($nested = true)
{
- $this->nested = $nested;
+ $this->nested = (bool) $nested;
return $this;
}
@@ -1408,11 +1710,14 @@ class Builder
* Enables caching on the current query until the given date.
*
* If flushing is enabled, the query cache will be flushed and then re-cached.
+ *
+ * @param DateTimeInterface $until When to expire the query cache.
+ * @param bool $flush Whether to force-flush the query cache.
+ * @return $this
*/
- public function cache(?DateTimeInterface $until = null, bool $flush = false, ?string $key = null): static
+ public function cache(DateTimeInterface $until = null, $flush = false)
{
$this->caching = true;
- $this->cacheKey = $key;
$this->cacheUntil = $until;
$this->flushCache = $flush;
@@ -1421,16 +1726,20 @@ class Builder
/**
* Determine if the query is nested.
+ *
+ * @return bool
*/
- public function isNested(): bool
+ public function isNested()
{
return $this->nested === true;
}
/**
* Determine whether the query is paginated.
+ *
+ * @return bool
*/
- public function isPaginated(): bool
+ public function isPaginated()
{
return $this->paginated;
}
@@ -1438,22 +1747,14 @@ class Builder
/**
* Insert an entry into the directory.
*
- * @throws LdapRecordException
- */
- public function insert(string $dn, array $attributes): bool
- {
- return (bool) $this->insertAndGetDn($dn, $attributes);
- }
-
- /**
- * Insert an entry into the directory and get the inserted distinguished name.
+ * @param string $dn
+ * @param array $attributes
+ * @return bool
*
* @throws LdapRecordException
*/
- public function insertAndGetDn(string $dn, array $attributes): string|false
+ public function insert($dn, array $attributes)
{
- $dn = $this->substituteBaseDn($dn);
-
if (empty($dn)) {
throw new LdapRecordException('A new LDAP object must have a distinguished name (dn).');
}
@@ -1464,85 +1765,102 @@ class Builder
);
}
- return $this->connection->run(
- fn (LdapInterface $ldap) => $ldap->add($dn, $attributes)
- ) ? $dn : false;
+ return $this->connection->run(function (LdapInterface $ldap) use ($dn, $attributes) {
+ return $ldap->add($dn, $attributes);
+ });
}
/**
- * Add attributes to an entry in the directory.
+ * Create attributes on the entry in the directory.
+ *
+ * @param string $dn
+ * @param array $attributes
+ * @return bool
*/
- public function add(string $dn, array $attributes): bool
+ public function insertAttributes($dn, array $attributes)
{
- return $this->connection->run(
- fn (LdapInterface $ldap) => $ldap->modAdd($dn, $attributes)
- );
+ return $this->connection->run(function (LdapInterface $ldap) use ($dn, $attributes) {
+ return $ldap->modAdd($dn, $attributes);
+ });
}
/**
* Update the entry with the given modifications.
+ *
+ * @param string $dn
+ * @param array $modifications
+ * @return bool
*/
- public function update(string $dn, array $modifications): bool
+ public function update($dn, array $modifications)
{
- return $this->connection->run(
- fn (LdapInterface $ldap) => $ldap->modifyBatch($dn, $modifications)
- );
+ return $this->connection->run(function (LdapInterface $ldap) use ($dn, $modifications) {
+ return $ldap->modifyBatch($dn, $modifications);
+ });
}
/**
- * Replace an entry's attributes in the directory.
+ * Update an entries attribute in the directory.
+ *
+ * @param string $dn
+ * @param array $attributes
+ * @return bool
*/
- public function replace(string $dn, array $attributes): bool
+ public function updateAttributes($dn, array $attributes)
{
- return $this->connection->run(
- fn (LdapInterface $ldap) => $ldap->modReplace($dn, $attributes)
- );
+ return $this->connection->run(function (LdapInterface $ldap) use ($dn, $attributes) {
+ return $ldap->modReplace($dn, $attributes);
+ });
}
/**
* Delete an entry from the directory.
+ *
+ * @param string $dn
+ * @return bool
*/
- public function delete(string $dn): bool
+ public function delete($dn)
{
- return $this->connection->run(
- fn (LdapInterface $ldap) => $ldap->delete($dn)
- );
+ return $this->connection->run(function (LdapInterface $ldap) use ($dn) {
+ return $ldap->delete($dn);
+ });
}
/**
- * Remove attributes on the entry in the directory.
+ * Delete attributes on the entry in the directory.
+ *
+ * @param string $dn
+ * @param array $attributes
+ * @return bool
*/
- public function remove(string $dn, array $attributes): bool
+ public function deleteAttributes($dn, array $attributes)
{
- return $this->connection->run(
- fn (LdapInterface $ldap) => $ldap->modDelete($dn, $attributes)
- );
+ return $this->connection->run(function (LdapInterface $ldap) use ($dn, $attributes) {
+ return $ldap->modDelete($dn, $attributes);
+ });
}
/**
* Rename an entry in the directory.
+ *
+ * @param string $dn
+ * @param string $rdn
+ * @param string $newParentDn
+ * @param bool $deleteOldRdn
+ * @return bool
*/
- public function rename(string $dn, string $rdn, string $newParentDn, bool $deleteOldRdn = true): bool
+ public function rename($dn, $rdn, $newParentDn, $deleteOldRdn = true)
{
- return (bool) $this->renameAndGetDn($dn, $rdn, $newParentDn, $deleteOldRdn);
- }
-
- /**
- * Rename an entry in the directory and get the new distinguished name.
- */
- public function renameAndGetDn(string $dn, string $rdn, string $newParentDn, bool $deleteOldRdn = true): string|false
- {
- $newParentDn = $this->substituteBaseDn($newParentDn);
-
- return $this->connection->run(
- fn (LdapInterface $ldap) => $ldap->rename($dn, $rdn, $newParentDn, $deleteOldRdn)
- ) ? implode(',', [$rdn, $newParentDn]) : false;
+ return $this->connection->run(function (LdapInterface $ldap) use ($dn, $rdn, $newParentDn, $deleteOldRdn) {
+ return $ldap->rename($dn, $rdn, $newParentDn, $deleteOldRdn);
+ });
}
/**
* Clone the query.
+ *
+ * @return static
*/
- public function clone(): static
+ public function clone()
{
return clone $this;
}
@@ -1550,14 +1868,18 @@ class Builder
/**
* Handle dynamic method calls on the query builder.
*
+ * @param string $method
+ * @param array $parameters
+ * @return mixed
+ *
* @throws BadMethodCallException
*/
- public function __call(string $method, array $parameters): static
+ public function __call($method, $parameters)
{
// If the beginning of the method being called contains
// 'where', we will assume a dynamic 'where' clause is
// being performed and pass the parameters to it.
- if (str_starts_with($method, 'where')) {
+ if (substr($method, 0, 5) === 'where') {
return $this->dynamicWhere($method, $parameters);
}
@@ -1571,9 +1893,11 @@ class Builder
/**
* Handles dynamic "where" clauses to the query.
*
+ * @param string $method
+ * @param array $parameters
* @return $this
*/
- public function dynamicWhere(string $method, array $parameters): static
+ public function dynamicWhere($method, $parameters)
{
$finder = substr($method, 5);
@@ -1609,8 +1933,13 @@ class Builder
/**
* Adds an array of wheres to the current query.
+ *
+ * @param array $wheres
+ * @param string $boolean
+ * @param bool $raw
+ * @return $this
*/
- protected function addArrayOfWheres(array $wheres, string $boolean, bool $raw): static
+ protected function addArrayOfWheres($wheres, $boolean, $raw)
{
foreach ($wheres as $key => $value) {
if (is_numeric($key) && is_array($value)) {
@@ -1635,8 +1964,14 @@ class Builder
/**
* Add a single dynamic where clause statement to the query.
+ *
+ * @param string $segment
+ * @param string $connector
+ * @param array $parameters
+ * @param int $index
+ * @return void
*/
- protected function addDynamic(string $segment, string $connector, array $parameters, int $index): void
+ protected function addDynamic($segment, $connector, $parameters, $index)
{
// If no parameters were given to the dynamic where clause,
// we can assume a "has" attribute filter is being added.
@@ -1649,34 +1984,55 @@ class Builder
/**
* Logs the given executed query information by firing its query event.
+ *
+ * @param Builder $query
+ * @param string $type
+ * @param null|float $time
+ * @return void
*/
- protected function logQuery(Builder $query, string $type, ?float $time = null): void
+ protected function logQuery($query, $type, $time = null)
{
$args = [$query, $time];
- $this->fireQueryEvent(
- match ($type) {
- self::TYPE_READ => new Events\Read(...$args),
- self::TYPE_CHUNK => new Events\Chunk(...$args),
- self::TYPE_LIST => new Events\Listing(...$args),
- self::TYPE_PAGINATE => new Events\Paginate(...$args),
- default => new Events\Search(...$args),
- }
- );
+ switch ($type) {
+ case 'listing':
+ $event = new Events\Listing(...$args);
+ break;
+ case 'read':
+ $event = new Events\Read(...$args);
+ break;
+ case 'chunk':
+ $event = new Events\Chunk(...$args);
+ break;
+ case 'paginate':
+ $event = new Events\Paginate(...$args);
+ break;
+ default:
+ $event = new Events\Search(...$args);
+ break;
+ }
+
+ $this->fireQueryEvent($event);
}
/**
* Fires the given query event.
+ *
+ * @param QueryExecuted $event
+ * @return void
*/
- protected function fireQueryEvent(QueryExecuted $event): void
+ protected function fireQueryEvent(QueryExecuted $event)
{
- Container::getInstance()->getDispatcher()->fire($event);
+ Container::getInstance()->getEventDispatcher()->fire($event);
}
/**
* Get the elapsed time since a given starting point.
+ *
+ * @param int $start
+ * @return float
*/
- protected function getElapsedTime(float $start): float
+ protected function getElapsedTime($start)
{
return round((microtime(true) - $start) * 1000, 2);
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Cache.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Cache.php
index 184455ced..d6057bfb3 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Cache.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Cache.php
@@ -13,11 +13,15 @@ class Cache
/**
* The cache driver.
+ *
+ * @var CacheInterface
*/
- protected CacheInterface $store;
+ protected $store;
/**
* Constructor.
+ *
+ * @param CacheInterface $store
*/
public function __construct(CacheInterface $store)
{
@@ -26,26 +30,47 @@ class Cache
/**
* Get an item from the cache.
+ *
+ * @param string $key
+ * @return mixed
*/
- public function get(string $key): mixed
+ public function get($key)
{
return $this->store->get($key);
}
/**
* Store an item in the cache.
+ *
+ * @param string $key
+ * @param mixed $value
+ * @param DateTimeInterface|DateInterval|int|null $ttl
+ * @return bool
*/
- public function put(string $key, mixed $value, DateTimeInterface|DateInterval|int|null $ttl = null): bool
+ public function put($key, $value, $ttl = null)
{
- return $this->store->set($key, $value, $this->secondsUntil($ttl));
+ $seconds = $this->secondsUntil($ttl);
+
+ if ($seconds <= 0) {
+ return $this->delete($key);
+ }
+
+ return $this->store->set($key, $value, $seconds);
}
/**
* Get an item from the cache, or execute the given Closure and store the result.
+ *
+ * @param string $key
+ * @param DateTimeInterface|DateInterval|int|null $ttl
+ * @param Closure $callback
+ * @return mixed
*/
- public function remember(string $key, DateTimeInterface|DateInterval|int|null $ttl, Closure $callback): mixed
+ public function remember($key, $ttl, Closure $callback)
{
- if (! is_null($value = $this->get($key))) {
+ $value = $this->get($key);
+
+ if (! is_null($value)) {
return $value;
}
@@ -56,16 +81,21 @@ class Cache
/**
* Delete an item from the cache.
+ *
+ * @param string $key
+ * @return bool
*/
- public function delete(string $key): bool
+ public function delete($key)
{
return $this->store->delete($key);
}
/**
* Get the underlying cache store.
+ *
+ * @return CacheInterface
*/
- public function store(): CacheInterface
+ public function store()
{
return $this->store;
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Collection.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Collection.php
index 9cda10cdb..036affa22 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Collection.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Collection.php
@@ -2,23 +2,25 @@
namespace LdapRecord\Query;
-use Illuminate\Support\Collection as BaseCollection;
use LdapRecord\Models\Model;
+use Tightenco\Collect\Support\Collection as BaseCollection;
class Collection extends BaseCollection
{
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- protected function valueRetriever(mixed $value): callable
+ protected function valueRetriever($value)
{
if ($this->useAsCallable($value)) {
/** @var callable $value */
return $value;
}
- return fn ($item) => $item instanceof Model
+ return function ($item) use ($value) {
+ return $item instanceof Model
? $item->getFirstAttribute($value)
: data_get($item, $value);
+ };
}
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Events/QueryExecuted.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Events/QueryExecuted.php
index 95cadd6ae..8ed8f835d 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Events/QueryExecuted.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Events/QueryExecuted.php
@@ -8,35 +8,46 @@ class QueryExecuted
{
/**
* The LDAP filter that was used for the query.
+ *
+ * @var Builder
*/
- protected Builder $query;
+ protected $query;
/**
* The number of milliseconds it took to execute the query.
+ *
+ * @var ?float
*/
- protected ?float $time;
+ protected $time;
/**
* Constructor.
+ *
+ * @param Builder $query
+ * @param null|float $time
*/
- public function __construct(Builder $query, ?float $time = null)
+ public function __construct(Builder $query, $time = null)
{
$this->query = $query;
$this->time = $time;
}
/**
- * Get the LDAP filter that was used for the query.
+ * Returns the LDAP filter that was used for the query.
+ *
+ * @return Builder
*/
- public function getQuery(): Builder
+ public function getQuery()
{
return $this->query;
}
/**
- * Get the number of milliseconds it took to execute the query.
+ * Returns the number of milliseconds it took to execute the query.
+ *
+ * @return float|null
*/
- public function getTime(): ?float
+ public function getTime()
{
return $this->time;
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Filter/ConditionNode.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Filter/ConditionNode.php
index 4dfed722b..6203360c5 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Filter/ConditionNode.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Filter/ConditionNode.php
@@ -8,28 +8,38 @@ class ConditionNode extends Node
{
/**
* The condition's attribute.
+ *
+ * @var string
*/
- protected string $attribute;
+ protected $attribute;
/**
* The condition's operator.
+ *
+ * @var string
*/
- protected string $operator;
+ protected $operator;
/**
* The condition's value.
+ *
+ * @var string
*/
- protected string $value;
+ protected $value;
/**
* The available condition operators.
+ *
+ * @var array
*/
- protected array $operators = ['>=', '<=', '~=', '='];
+ protected $operators = ['>=', '<=', '~=', '='];
/**
* Constructor.
+ *
+ * @param string $filter
*/
- public function __construct(string $filter)
+ public function __construct($filter)
{
$this->raw = $filter;
@@ -38,38 +48,51 @@ class ConditionNode extends Node
/**
* Get the condition's attribute.
+ *
+ * @return string
*/
- public function getAttribute(): string
+ public function getAttribute()
{
return $this->attribute;
}
/**
* Get the condition's operator.
+ *
+ * @return string
*/
- public function getOperator(): string
+ public function getOperator()
{
return $this->operator;
}
/**
* Get the condition's value.
+ *
+ * @return string
*/
- public function getValue(): string
+ public function getValue()
{
return $this->value;
}
/**
* Extract the condition components from the filter.
+ *
+ * @param string $filter
+ * @return array
*/
- protected function extractComponents(string $filter): array
+ protected function extractComponents($filter)
{
$components = Str::whenContains(
$filter,
$this->operators,
- fn ($operator, $filter) => explode($this->operator = $operator, $filter, 2),
- fn ($filter) => throw new ParserException("Invalid query condition. No operator found in [$filter]"),
+ function ($operator, $filter) {
+ return explode($this->operator = $operator, $filter, 2);
+ },
+ function ($filter) {
+ throw new ParserException("Invalid query condition. No operator found in [$filter]");
+ },
);
return $components;
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Filter/GroupNode.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Filter/GroupNode.php
index 1af71369e..1a3596f3e 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Filter/GroupNode.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Filter/GroupNode.php
@@ -6,20 +6,24 @@ class GroupNode extends Node
{
/**
* The group's operator.
+ *
+ * @var string
*/
- protected string $operator;
+ protected $operator;
/**
* The group's sub-nodes.
*
* @var Node[]
*/
- protected array $nodes = [];
+ protected $nodes = [];
/**
* Constructor.
+ *
+ * @param string $filter
*/
- public function __construct(string $filter)
+ public function __construct($filter)
{
$this->raw = $filter;
@@ -30,8 +34,10 @@ class GroupNode extends Node
/**
* Get the group's operator.
+ *
+ * @return string
*/
- public function getOperator(): string
+ public function getOperator()
{
return $this->operator;
}
@@ -41,7 +47,7 @@ class GroupNode extends Node
*
* @return Node[]
*/
- public function getNodes(): array
+ public function getNodes()
{
return $this->nodes;
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Filter/Node.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Filter/Node.php
index 3e9c039f1..faf88d41f 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Filter/Node.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Filter/Node.php
@@ -6,18 +6,24 @@ abstract class Node
{
/**
* The raw value of the node.
+ *
+ * @var string
*/
- protected string $raw;
+ protected $raw;
/**
* Create a new filter node.
+ *
+ * @param string $filter
*/
- abstract public function __construct(string $filter);
+ abstract public function __construct($filter);
/**
* Get the raw value of the node.
+ *
+ * @return string
*/
- public function getRaw(): string
+ public function getRaw()
{
return $this->raw;
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Filter/Parser.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Filter/Parser.php
index 1fea1810d..7717ac522 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Filter/Parser.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Filter/Parser.php
@@ -10,11 +10,12 @@ class Parser
/**
* Parse an LDAP filter into nodes.
*
+ * @param string $string
* @return (ConditionNode|GroupNode)[]
*
* @throws ParserException
*/
- public static function parse(string $string): array
+ public static function parse($string)
{
[$open, $close] = static::countParenthesis($string);
@@ -33,8 +34,11 @@ class Parser
/**
* Perform a match for all filters in the string.
+ *
+ * @param string $string
+ * @return array
*/
- protected static function match(string $string): array
+ protected static function match($string)
{
preg_match_all("/\((((?>[^()]+)|(?R))*)\)/", trim($string), $matches);
@@ -45,18 +49,22 @@ class Parser
* Assemble the parsed nodes into a single filter.
*
* @param Node|Node[] $nodes
+ * @return string
*/
- public static function assemble(Node|array $nodes = []): string
+ public static function assemble($nodes = [])
{
- return array_reduce(Arr::wrap($nodes), fn ($carry, Node $node) => (
- $carry .= static::compileNode($node)
- ));
+ return array_reduce(Arr::wrap($nodes), function ($carry, Node $node) {
+ return $carry .= static::compileNode($node);
+ });
}
/**
* Assemble the node into its string based format.
+ *
+ * @param GroupNode|ConditionNode $node
+ * @return string
*/
- protected static function compileNode(Node $node): string
+ protected static function compileNode(Node $node)
{
switch (true) {
case $node instanceof GroupNode:
@@ -76,7 +84,7 @@ class Parser
*
* @throws ParserException
*/
- protected static function buildNodes(array $filters = []): array
+ protected static function buildNodes(array $filters = [])
{
return array_map(function ($filter) {
if (static::isWrapped($filter)) {
@@ -95,24 +103,33 @@ class Parser
/**
* Count the open and close parenthesis of the sting.
+ *
+ * @param string $string
+ * @return array
*/
- protected static function countParenthesis(string $string): array
+ protected static function countParenthesis($string)
{
return [Str::substrCount($string, '('), Str::substrCount($string, ')')];
}
/**
* Wrap the value in parentheses.
+ *
+ * @param string $value
+ * @return string
*/
- protected static function wrap(string $value): string
+ protected static function wrap($value)
{
return "($value)";
}
/**
* Recursively unwrwap the value from its parentheses.
+ *
+ * @param string $value
+ * @return string
*/
- protected static function unwrap(string $value): string
+ protected static function unwrap($value)
{
$nodes = static::parse($value);
@@ -123,16 +140,22 @@ class Parser
/**
* Determine if the filter is wrapped.
+ *
+ * @param string $filter
+ * @return bool
*/
- protected static function isWrapped(string $filter): bool
+ protected static function isWrapped($filter)
{
return Str::startsWith($filter, '(') && Str::endsWith($filter, ')');
}
/**
* Determine if the filter is a group.
+ *
+ * @param string $filter
+ * @return bool
*/
- protected static function isGroup(string $filter): bool
+ protected static function isGroup($filter)
{
return Str::startsWith($filter, ['&', '|', '!']);
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Filter/ParserException.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Filter/ParserException.php
index 3c3d68e4f..68a4ca171 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Filter/ParserException.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Filter/ParserException.php
@@ -4,4 +4,6 @@ namespace LdapRecord\Query\Filter;
use LdapRecord\LdapRecordException;
-class ParserException extends LdapRecordException {}
+class ParserException extends LdapRecordException
+{
+}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Grammar.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Grammar.php
index 0506c983e..84c4b8d0c 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Grammar.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Grammar.php
@@ -8,8 +8,10 @@ class Grammar
{
/**
* The query operators and their method names.
+ *
+ * @var array
*/
- public array $operators = [
+ public $operators = [
'*' => 'has',
'!*' => 'notHas',
'=' => 'equals',
@@ -28,13 +30,17 @@ class Grammar
/**
* The query wrapper.
+ *
+ * @var string|null
*/
- protected ?string $wrapper = null;
+ protected $wrapper;
/**
* Get all the available operators.
+ *
+ * @return array
*/
- public function getOperators(): array
+ public function getOperators()
{
return array_keys($this->operators);
}
@@ -43,16 +49,24 @@ class Grammar
* Wraps a query string in brackets.
*
* Produces: (query)
+ *
+ * @param string $query
+ * @param string $prefix
+ * @param string $suffix
+ * @return string
*/
- public function wrap(string $query, ?string $prefix = '(', ?string $suffix = ')'): string
+ public function wrap($query, $prefix = '(', $suffix = ')')
{
return $prefix.$query.$suffix;
}
/**
* Compiles the Builder instance into an LDAP query string.
+ *
+ * @param Builder $query
+ * @return string
*/
- public function compile(Builder $query): string
+ public function compile(Builder $query)
{
if ($this->queryMustBeWrapped($query)) {
$this->wrapper = 'and';
@@ -62,37 +76,50 @@ class Grammar
.$this->compileWheres($query)
.$this->compileOrWheres($query);
- return match ($this->wrapper) {
- 'and' => $this->compileAnd($filter),
- 'or' => $this->compileOr($filter),
- default => $filter,
- };
+ switch ($this->wrapper) {
+ case 'and':
+ return $this->compileAnd($filter);
+ case 'or':
+ return $this->compileOr($filter);
+ default:
+ return $filter;
+ }
}
/**
* Determine if the query must be wrapped in an encapsulating statement.
+ *
+ * @param Builder $query
+ * @return bool
*/
- protected function queryMustBeWrapped(Builder $query): bool
+ protected function queryMustBeWrapped(Builder $query)
{
return ! $query->isNested() && $this->hasMultipleFilters($query);
}
/**
- * Assembles all the "raw" filters on the query.
+ * Assembles all of the "raw" filters on the query.
+ *
+ * @param Builder $builder
+ * @return string
*/
- protected function compileRaws(Builder $builder): string
+ protected function compileRaws(Builder $builder)
{
return $this->concatenate($builder->filters['raw']);
}
/**
* Assembles all where clauses in the current wheres property.
+ *
+ * @param Builder $builder
+ * @param string $type
+ * @return string
*/
- protected function compileWheres(Builder $builder, string $type = 'and'): string
+ protected function compileWheres(Builder $builder, $type = 'and')
{
$filter = '';
- foreach ($builder->filters[$type] ?? [] as $where) {
+ foreach ($builder->filters[$type] as $where) {
$filter .= $this->compileWhere($where);
}
@@ -101,8 +128,11 @@ class Grammar
/**
* Assembles all or where clauses in the current orWheres property.
+ *
+ * @param Builder $query
+ * @return string
*/
- protected function compileOrWheres(Builder $query): string
+ protected function compileOrWheres(Builder $query)
{
$filter = $this->compileWheres($query, 'or');
@@ -124,18 +154,24 @@ class Grammar
/**
* Determine if the query can be wrapped in a single or statement.
+ *
+ * @param Builder $query
+ * @return bool
*/
- protected function queryCanBeWrappedInSingleOrStatement(Builder $query): bool
+ protected function queryCanBeWrappedInSingleOrStatement(Builder $query)
{
- return $this->has($query, 'or', '>=', 1)
- && $this->has($query, 'and', '<=', 1)
- && $this->has($query, 'raw', '=', 0);
+ return $this->has($query, 'or', '>=', 1) &&
+ $this->has($query, 'and', '<=', 1) &&
+ $this->has($query, 'raw', '=', 0);
}
/**
* Concatenates filters into a single string.
+ *
+ * @param array $bindings
+ * @return string
*/
- public function concatenate(array $bindings = []): string
+ public function concatenate(array $bindings = [])
{
// Filter out empty query segments.
return implode(
@@ -145,48 +181,69 @@ class Grammar
/**
* Determine if the binding value is not empty.
+ *
+ * @param string $value
+ * @return bool
*/
- protected function bindingValueIsNotEmpty(string $value): bool
+ protected function bindingValueIsNotEmpty($value)
{
return ! empty($value);
}
/**
* Determine if the query is using multiple filters.
+ *
+ * @param Builder $query
+ * @return bool
*/
- protected function hasMultipleFilters(Builder $query): bool
+ protected function hasMultipleFilters(Builder $query)
{
return $this->has($query, ['and', 'or', 'raw'], '>', 1);
}
/**
* Determine if the query contains the given filter statement type.
+ *
+ * @param Builder $query
+ * @param string|array $type
+ * @param string $operator
+ * @param int $count
+ * @return bool
*/
- protected function has(Builder $query, array|string $type, string $operator = '>=', int $count = 1): bool
+ protected function has(Builder $query, $type, $operator = '>=', $count = 1)
{
$types = (array) $type;
$filters = 0;
foreach ($types as $type) {
- $filters += count($query->filters[$type] ?? []);
+ $filters += count($query->filters[$type]);
}
- return match ($operator) {
- '>' => $filters > $count,
- '>=' => $filters >= $count,
- '<' => $filters < $count,
- '<=' => $filters <= $count,
- default => $filters == $count,
- };
+ switch ($operator) {
+ case '>':
+ return $filters > $count;
+ case '>=':
+ return $filters >= $count;
+ case '<':
+ return $filters < $count;
+ case '<=':
+ return $filters <= $count;
+ default:
+ return $filters == $count;
+ }
}
/**
* Returns a query string for equals.
*
* Produces: (field=value)
+ *
+ * @param string $field
+ * @param string $value
+ * @return string
*/
- public function compileEquals(string $field, string $value): string
+ public function compileEquals($field, $value)
{
return $this->wrap($field.'='.$value);
}
@@ -195,8 +252,12 @@ class Grammar
* Returns a query string for does not equal.
*
* Produces: (!(field=value))
+ *
+ * @param string $field
+ * @param string $value
+ * @return string
*/
- public function compileDoesNotEqual(string $field, string $value): string
+ public function compileDoesNotEqual($field, $value)
{
return $this->compileNot(
$this->compileEquals($field, $value)
@@ -207,8 +268,12 @@ class Grammar
* Alias for does not equal operator (!=) operator.
*
* Produces: (!(field=value))
+ *
+ * @param string $field
+ * @param string $value
+ * @return string
*/
- public function compileDoesNotEqualAlias(string $field, string $value): string
+ public function compileDoesNotEqualAlias($field, $value)
{
return $this->compileDoesNotEqual($field, $value);
}
@@ -217,8 +282,12 @@ class Grammar
* Returns a query string for greater than or equals.
*
* Produces: (field>=value)
+ *
+ * @param string $field
+ * @param string $value
+ * @return string
*/
- public function compileGreaterThanOrEquals(string $field, string $value): string
+ public function compileGreaterThanOrEquals($field, $value)
{
return $this->wrap("$field>=$value");
}
@@ -227,8 +296,12 @@ class Grammar
* Returns a query string for less than or equals.
*
* Produces: (field<=value)
+ *
+ * @param string $field
+ * @param string $value
+ * @return string
*/
- public function compileLessThanOrEquals(string $field, string $value): string
+ public function compileLessThanOrEquals($field, $value)
{
return $this->wrap("$field<=$value");
}
@@ -237,8 +310,12 @@ class Grammar
* Returns a query string for approximately equals.
*
* Produces: (field~=value)
+ *
+ * @param string $field
+ * @param string $value
+ * @return string
*/
- public function compileApproximatelyEquals(string $field, string $value): string
+ public function compileApproximatelyEquals($field, $value)
{
return $this->wrap("$field~=$value");
}
@@ -247,8 +324,12 @@ class Grammar
* Returns a query string for starts with.
*
* Produces: (field=value*)
+ *
+ * @param string $field
+ * @param string $value
+ * @return string
*/
- public function compileStartsWith(string $field, string $value): string
+ public function compileStartsWith($field, $value)
{
return $this->wrap("$field=$value*");
}
@@ -257,8 +338,12 @@ class Grammar
* Returns a query string for does not start with.
*
* Produces: (!(field=*value))
+ *
+ * @param string $field
+ * @param string $value
+ * @return string
*/
- public function compileNotStartsWith(string $field, string $value): string
+ public function compileNotStartsWith($field, $value)
{
return $this->compileNot(
$this->compileStartsWith($field, $value)
@@ -269,8 +354,12 @@ class Grammar
* Returns a query string for ends with.
*
* Produces: (field=*value)
+ *
+ * @param string $field
+ * @param string $value
+ * @return string
*/
- public function compileEndsWith(string $field, string $value): string
+ public function compileEndsWith($field, $value)
{
return $this->wrap("$field=*$value");
}
@@ -279,8 +368,12 @@ class Grammar
* Returns a query string for does not end with.
*
* Produces: (!(field=value*))
+ *
+ * @param string $field
+ * @param string $value
+ * @return string
*/
- public function compileNotEndsWith(string $field, string $value): string
+ public function compileNotEndsWith($field, $value)
{
return $this->compileNot($this->compileEndsWith($field, $value));
}
@@ -289,8 +382,12 @@ class Grammar
* Returns a query string for contains.
*
* Produces: (field=*value*)
+ *
+ * @param string $field
+ * @param string $value
+ * @return string
*/
- public function compileContains(string $field, string $value): string
+ public function compileContains($field, $value)
{
return $this->wrap("$field=*$value*");
}
@@ -299,8 +396,12 @@ class Grammar
* Returns a query string for does not contain.
*
* Produces: (!(field=*value*))
+ *
+ * @param string $field
+ * @param string $value
+ * @return string
*/
- public function compileNotContains(string $field, string $value): string
+ public function compileNotContains($field, $value)
{
return $this->compileNot(
$this->compileContains($field, $value)
@@ -311,8 +412,11 @@ class Grammar
* Returns a query string for a where has.
*
* Produces: (field=*)
+ *
+ * @param string $field
+ * @return string
*/
- public function compileHas(string $field): string
+ public function compileHas($field)
{
return $this->wrap("$field=*");
}
@@ -321,8 +425,11 @@ class Grammar
* Returns a query string for a where does not have.
*
* Produces: (!(field=*))
+ *
+ * @param string $field
+ * @return string
*/
- public function compileNotHas(string $field): string
+ public function compileNotHas($field)
{
return $this->compileNot(
$this->compileHas($field)
@@ -333,8 +440,11 @@ class Grammar
* Wraps the inserted query inside an AND operator.
*
* Produces: (&query)
+ *
+ * @param string $query
+ * @return string
*/
- public function compileAnd(string $query): string
+ public function compileAnd($query)
{
return $query ? $this->wrap($query, '(&') : '';
}
@@ -343,16 +453,22 @@ class Grammar
* Wraps the inserted query inside an OR operator.
*
* Produces: (|query)
+ *
+ * @param string $query
+ * @return string
*/
- public function compileOr(string $query): string
+ public function compileOr($query)
{
return $query ? $this->wrap($query, '(|') : '';
}
/**
* Wraps the inserted query inside an NOT operator.
+ *
+ * @param string $query
+ * @return string
*/
- public function compileNot(string $query): string
+ public function compileNot($query)
{
return $query ? $this->wrap($query, '(!') : '';
}
@@ -360,9 +476,12 @@ class Grammar
/**
* Assembles a single where query.
*
+ * @param array $where
+ * @return string
+ *
* @throws UnexpectedValueException
*/
- protected function compileWhere(array $where): string
+ protected function compileWhere(array $where)
{
$method = $this->makeCompileMethod($where['operator']);
@@ -372,9 +491,12 @@ class Grammar
/**
* Make the compile method name for the operator.
*
+ * @param string $operator
+ * @return string
+ *
* @throws UnexpectedValueException
*/
- protected function makeCompileMethod(string $operator): string
+ protected function makeCompileMethod($operator)
{
if (! $this->operatorExists($operator)) {
throw new UnexpectedValueException("Invalid LDAP filter operator ['$operator']");
@@ -385,8 +507,11 @@ class Grammar
/**
* Determine if the operator exists.
+ *
+ * @param string $operator
+ * @return bool
*/
- protected function operatorExists(string $operator): bool
+ protected function operatorExists($operator)
{
return array_key_exists($operator, $this->operators);
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/InteractsWithTime.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/InteractsWithTime.php
index 111c2c201..e8024c033 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/InteractsWithTime.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/InteractsWithTime.php
@@ -15,8 +15,11 @@ trait InteractsWithTime
{
/**
* Get the number of seconds until the given DateTime.
+ *
+ * @param DateTimeInterface|DateInterval|int $delay
+ * @return int
*/
- protected function secondsUntil(DateTimeInterface|DateInterval|int|null $delay = null): int
+ protected function secondsUntil($delay)
{
$delay = $this->parseDateInterval($delay);
@@ -27,8 +30,11 @@ trait InteractsWithTime
/**
* Get the "available at" UNIX timestamp.
+ *
+ * @param DateTimeInterface|DateInterval|int $delay
+ * @return int
*/
- protected function availableAt(DateTimeInterface|DateInterval|int $delay = 0): int
+ protected function availableAt($delay = 0)
{
$delay = $this->parseDateInterval($delay);
@@ -39,8 +45,11 @@ trait InteractsWithTime
/**
* If the given value is an interval, convert it to a DateTime instance.
+ *
+ * @param DateTimeInterface|DateInterval|int $delay
+ * @return DateTimeInterface|int
*/
- protected function parseDateInterval(DateTimeInterface|DateInterval|int|null $delay = null): DateTimeInterface|int|null
+ protected function parseDateInterval($delay)
{
if ($delay instanceof DateInterval) {
$delay = Carbon::now()->add($delay);
@@ -51,8 +60,10 @@ trait InteractsWithTime
/**
* Get the current system time as a UNIX timestamp.
+ *
+ * @return int
*/
- protected function currentTime(): int
+ protected function currentTime()
{
return Carbon::now()->getTimestamp();
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Model/ActiveDirectoryBuilder.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Model/ActiveDirectoryBuilder.php
index 7fb8ab682..3b0e96f79 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Model/ActiveDirectoryBuilder.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Model/ActiveDirectoryBuilder.php
@@ -5,20 +5,23 @@ namespace LdapRecord\Query\Model;
use Closure;
use LdapRecord\LdapInterface;
use LdapRecord\Models\Attributes\AccountControl;
-use LdapRecord\Models\Model;
use LdapRecord\Models\ModelNotFoundException;
class ActiveDirectoryBuilder extends Builder
{
/**
* Finds a record by its Object SID.
+ *
+ * @param string $sid
+ * @param array|string $columns
+ * @return \LdapRecord\Models\ActiveDirectory\Entry|static|null
*/
- public function findBySid(string $sid, array|string $columns = ['*']): ?Model
+ public function findBySid($sid, $columns = [])
{
try {
return $this->findBySidOrFail($sid, $columns);
- } catch (ModelNotFoundException) {
- return null;
+ } catch (ModelNotFoundException $e) {
+ return;
}
}
@@ -27,157 +30,190 @@ class ActiveDirectoryBuilder extends Builder
*
* Fails upon no records returned.
*
+ * @param string $sid
+ * @param array|string $columns
+ * @return \LdapRecord\Models\ActiveDirectory\Entry|static
+ *
* @throws ModelNotFoundException
*/
- public function findBySidOrFail(string $sid, array $columns = ['*']): Model
+ public function findBySidOrFail($sid, $columns = [])
{
return $this->findByOrFail('objectsid', $sid, $columns);
}
/**
* Adds a enabled filter to the current query.
+ *
+ * @return $this
*/
- public function whereEnabled(): static
+ public function whereEnabled()
{
- return $this->notFilter(
- fn (self $query) => $query->whereDisabled()
- );
+ return $this->notFilter(function ($query) {
+ return $query->whereDisabled();
+ });
}
/**
* Adds a disabled filter to the current query.
+ *
+ * @return $this
*/
- public function whereDisabled(): static
+ public function whereDisabled()
{
return $this->rawFilter(
- (new AccountControl)->setAccountIsDisabled()->filter()
+ (new AccountControl())->accountIsDisabled()->filter()
);
}
/**
* Adds a 'where member' filter to the current query.
+ *
+ * @param string $dn
+ * @param bool $nested
+ * @return $this
*/
- public function whereMember(string $dn, bool $nested = false): static
+ public function whereMember($dn, $nested = false)
{
- return $this->nestedMatchQuery(
- fn (string $attribute) => $this->whereEquals($attribute, $this->substituteBaseDn($dn)),
- 'member',
- $nested
- );
+ return $this->nestedMatchQuery(function ($attribute) use ($dn) {
+ return $this->whereEquals($attribute, $dn);
+ }, 'member', $nested);
}
/**
* Adds an 'or where member' filter to the current query.
+ *
+ * @param string $dn
+ * @param bool $nested
+ * @return $this
*/
- public function orWhereMember(string $dn, bool $nested = false): static
+ public function orWhereMember($dn, $nested = false)
{
- return $this->nestedMatchQuery(
- fn (string $attribute) => $this->orWhereEquals($attribute, $this->substituteBaseDn($dn)),
- 'member',
- $nested
- );
+ return $this->nestedMatchQuery(function ($attribute) use ($dn) {
+ return $this->orWhereEquals($attribute, $dn);
+ }, 'member', $nested);
}
/**
* Adds a 'where member of' filter to the current query.
+ *
+ * @param string $dn
+ * @param bool $nested
+ * @return $this
*/
- public function whereMemberOf(string $dn, bool $nested = false): static
+ public function whereMemberOf($dn, $nested = false)
{
- return $this->nestedMatchQuery(
- fn (string $attribute) => $this->whereEquals($attribute, $this->substituteBaseDn($dn)),
- 'memberof',
- $nested
- );
+ return $this->nestedMatchQuery(function ($attribute) use ($dn) {
+ return $this->whereEquals($attribute, $dn);
+ }, 'memberof', $nested);
}
/**
* Adds a 'where not member of' filter to the current query.
+ *
+ * @param string $dn
+ * @param bool $nested
+ * @return $this
*/
- public function whereNotMemberof(string $dn, bool $nested = false): static
+ public function whereNotMemberof($dn, $nested = false)
{
- return $this->nestedMatchQuery(
- fn (string $attribute) => $this->whereNotEquals($attribute, $this->substituteBaseDn($dn)),
- 'memberof',
- $nested
- );
+ return $this->nestedMatchQuery(function ($attribute) use ($dn) {
+ return $this->whereNotEquals($attribute, $dn);
+ }, 'memberof', $nested);
}
/**
* Adds an 'or where member of' filter to the current query.
+ *
+ * @param string $dn
+ * @param bool $nested
+ * @return $this
*/
- public function orWhereMemberOf(string $dn, bool $nested = false): static
+ public function orWhereMemberOf($dn, $nested = false)
{
- return $this->nestedMatchQuery(
- fn (string $attribute) => $this->orWhereEquals($attribute, $this->substituteBaseDn($dn)),
- 'memberof',
- $nested
- );
+ return $this->nestedMatchQuery(function ($attribute) use ($dn) {
+ return $this->orWhereEquals($attribute, $dn);
+ }, 'memberof', $nested);
}
/**
* Adds a 'or where not member of' filter to the current query.
+ *
+ * @param string $dn
+ * @param bool $nested
+ * @return $this
*/
- public function orWhereNotMemberof(string $dn, bool $nested = false): static
+ public function orWhereNotMemberof($dn, $nested = false)
{
- return $this->nestedMatchQuery(
- fn (string $attribute) => $this->orWhereNotEquals($attribute, $this->substituteBaseDn($dn)),
- 'memberof',
- $nested
- );
+ return $this->nestedMatchQuery(function ($attribute) use ($dn) {
+ return $this->orWhereNotEquals($attribute, $dn);
+ }, 'memberof', $nested);
}
/**
* Adds a 'where manager' filter to the current query.
+ *
+ * @param string $dn
+ * @param bool $nested
+ * @return $this
*/
- public function whereManager(string $dn, bool $nested = false): static
+ public function whereManager($dn, $nested = false)
{
- return $this->nestedMatchQuery(
- fn (string $attribute) => $this->whereEquals($attribute, $this->substituteBaseDn($dn)),
- 'manager',
- $nested
- );
+ return $this->nestedMatchQuery(function ($attribute) use ($dn) {
+ return $this->whereEquals($attribute, $dn);
+ }, 'manager', $nested);
}
/**
* Adds a 'where not manager' filter to the current query.
+ *
+ * @param string $dn
+ * @param bool $nested
+ * @return $this
*/
- public function whereNotManager(string $dn, bool $nested = false): static
+ public function whereNotManager($dn, $nested = false)
{
- return $this->nestedMatchQuery(
- fn (string $attribute) => $this->whereNotEquals($attribute, $this->substituteBaseDn($dn)),
- 'manager',
- $nested
- );
+ return $this->nestedMatchQuery(function ($attribute) use ($dn) {
+ return $this->whereNotEquals($attribute, $dn);
+ }, 'manager', $nested);
}
/**
* Adds an 'or where manager' filter to the current query.
+ *
+ * @param string $dn
+ * @param bool $nested
+ * @return $this
*/
- public function orWhereManager(string $dn, bool $nested = false): static
+ public function orWhereManager($dn, $nested = false)
{
- return $this->nestedMatchQuery(
- fn (string $attribute) => $this->orWhereEquals($attribute, $this->substituteBaseDn($dn)),
- 'manager',
- $nested
- );
+ return $this->nestedMatchQuery(function ($attribute) use ($dn) {
+ return $this->orWhereEquals($attribute, $dn);
+ }, 'manager', $nested);
}
/**
* Adds an 'or where not manager' filter to the current query.
+ *
+ * @param string $dn
+ * @param bool $nested
+ * @return $this
*/
- public function orWhereNotManager(string $dn, bool $nested = false): static
+ public function orWhereNotManager($dn, $nested = false)
{
- return $this->nestedMatchQuery(
- fn (string $attribute) => $this->orWhereNotEquals($attribute, $this->substituteBaseDn($dn)),
- 'manager',
- $nested
- );
+ return $this->nestedMatchQuery(function ($attribute) use ($dn) {
+ return $this->orWhereNotEquals($attribute, $dn);
+ }, 'manager', $nested);
}
/**
* Execute the callback with a nested match attribute.
+ *
+ * @param Closure $callback
+ * @param string $attribute
+ * @param bool $nested
+ * @return $this
*/
- protected function nestedMatchQuery(Closure $callback, string $attribute, bool $nested = false): static
+ protected function nestedMatchQuery(Closure $callback, $attribute, $nested = false)
{
return $callback(
$nested ? $this->makeNestedMatchAttribute($attribute) : $attribute
@@ -186,8 +222,11 @@ class ActiveDirectoryBuilder extends Builder
/**
* Make a "nested match" filter attribute for querying descendants.
+ *
+ * @param string $attribute
+ * @return string
*/
- protected function makeNestedMatchAttribute(string $attribute): string
+ protected function makeNestedMatchAttribute($attribute)
{
return sprintf('%s:%s:', $attribute, LdapInterface::OID_MATCHING_RULE_IN_CHAIN);
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Model/Builder.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Model/Builder.php
index 741646e7e..a6886ea96 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Model/Builder.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Model/Builder.php
@@ -4,41 +4,51 @@ namespace LdapRecord\Query\Model;
use Closure;
use DateTime;
-use LdapRecord\Models\Attributes\Guid;
-use LdapRecord\Models\Collection;
use LdapRecord\Models\Model;
use LdapRecord\Models\ModelNotFoundException;
use LdapRecord\Models\Scope;
use LdapRecord\Models\Types\ActiveDirectory;
use LdapRecord\Query\Builder as BaseBuilder;
-use UnexpectedValueException;
+use LdapRecord\Utilities;
class Builder extends BaseBuilder
{
/**
* The model being queried.
+ *
+ * @var Model
*/
- protected Model $model;
+ protected $model;
/**
* The global scopes to be applied.
+ *
+ * @var array
*/
- protected array $scopes = [];
+ protected $scopes = [];
/**
* The removed global scopes.
+ *
+ * @var array
*/
- protected array $removedScopes = [];
+ protected $removedScopes = [];
/**
* The applied global scopes.
+ *
+ * @var array
*/
- protected array $appliedScopes = [];
+ protected $appliedScopes = [];
/**
* Dynamically handle calls into the query instance.
+ *
+ * @param string $method
+ * @param array $parameters
+ * @return mixed
*/
- public function __call(string $method, array $parameters): static
+ public function __call($method, $parameters)
{
if (method_exists($this->model, $scope = 'scope'.ucfirst($method))) {
return $this->callScope([$this->model, $scope], $parameters);
@@ -49,8 +59,12 @@ class Builder extends BaseBuilder
/**
* Apply the given scope on the current builder instance.
+ *
+ * @param callable $scope
+ * @param array $parameters
+ * @return mixed
*/
- protected function callScope(callable $scope, array $parameters = []): static
+ protected function callScope(callable $scope, $parameters = [])
{
array_unshift($parameters, $this);
@@ -59,8 +73,10 @@ class Builder extends BaseBuilder
/**
* Get the attributes to select on the search.
+ *
+ * @return array
*/
- public function getSelects(): array
+ public function getSelects()
{
// Here we will ensure the models GUID attribute is always
// selected. In some LDAP directories, the attribute is
@@ -72,8 +88,11 @@ class Builder extends BaseBuilder
/**
* Set the model instance for the model being queried.
+ *
+ * @param Model $model
+ * @return $this
*/
- public function setModel(Model $model): static
+ public function setModel(Model $model)
{
$this->model = $model;
@@ -81,97 +100,48 @@ class Builder extends BaseBuilder
}
/**
- * Get the model being queried for.
+ * Returns the model being queried for.
+ *
+ * @return Model
*/
- public function getModel(): Model
+ public function getModel()
{
return $this->model;
}
/**
* Get a new model query builder instance.
+ *
+ * @param string|null $baseDn
+ * @return static
*/
- public function newInstance(?string $baseDn = null): BaseBuilder
+ public function newInstance($baseDn = null)
{
return parent::newInstance($baseDn)->model($this->model);
}
/**
- * {@inheritDoc}
+ * Finds a model by its distinguished name.
+ *
+ * @param array|string $dn
+ * @param array|string|string[] $columns
+ * @return Model|\LdapRecord\Query\Collection|static|null
*/
- public function first(array|string $columns = ['*']): ?Model
+ public function find($dn, $columns = ['*'])
{
- return parent::first($columns);
- }
-
- /**
- * {@inheritDoc}
- */
- public function firstOrFail(array|string $columns = ['*']): Model
- {
- return parent::firstOrFail($columns);
- }
-
- /**
- * {@inheritDoc}
- */
- public function sole(array|string $columns = ['*']): Model
- {
- return parent::sole($columns);
- }
-
- /**
- * {@inheritDoc}
- */
- public function find(array|string $dn, array|string $columns = ['*']): Model|Collection|null
- {
- return $this->afterScopes(fn () => parent::find($dn, $columns));
- }
-
- /**
- * {@inheritDoc}
- */
- public function findOrFail(string $dn, array|string $columns = ['*']): Model
- {
- return parent::findOrFail($dn, $columns);
- }
-
- /**
- * {@inheritDoc}
- */
- public function findByOrFail(string $attribute, string $value, array|string $columns = ['*']): Model
- {
- return parent::findByOrFail($attribute, $value, $columns);
- }
-
- /**
- * {@inheritDoc}
- */
- public function findBy(string $attribute, string $value, array|string $columns = ['*']): ?Model
- {
- return parent::findBy($attribute, $value, $columns);
- }
-
- /**
- * {@inheritDoc}
- */
- public function findMany(array|string $dns, array|string $columns = ['*']): Collection
- {
- return parent::findMany($dns, $columns);
- }
-
- /**
- * {@inheritDoc}
- */
- public function findManyBy(string $attribute, array $values = [], array|string $columns = ['*']): Collection
- {
- return parent::findManyBy($attribute, $values, $columns);
+ return $this->afterScopes(function () use ($dn, $columns) {
+ return parent::find($dn, $columns);
+ });
}
/**
* Finds a record using ambiguous name resolution.
+ *
+ * @param string|array $value
+ * @param array|string $columns
+ * @return Model|\LdapRecord\Query\Collection|static|null
*/
- public function findByAnr(array|string $value, array|string $columns = ['*']): Model|Collection|null
+ public function findByAnr($value, $columns = ['*'])
{
if (is_array($value)) {
return $this->findManyByAnr($value, $columns);
@@ -189,8 +159,10 @@ class Builder extends BaseBuilder
/**
* Determine if the current model is compatible with ANR filters.
+ *
+ * @return bool
*/
- protected function modelIsCompatibleWithAnr(): bool
+ protected function modelIsCompatibleWithAnr()
{
return $this->model instanceof ActiveDirectory;
}
@@ -200,9 +172,13 @@ class Builder extends BaseBuilder
*
* If a record is not found, an exception is thrown.
*
+ * @param string $value
+ * @param array|string $columns
+ * @return Model
+ *
* @throws ModelNotFoundException
*/
- public function findByAnrOrFail(string $value, array|string $columns = ['*']): Model
+ public function findByAnrOrFail($value, $columns = ['*'])
{
if (! $entry = $this->findByAnr($value, $columns)) {
$this->throwNotFoundException($this->getUnescapedQuery(), $this->dn);
@@ -214,17 +190,24 @@ class Builder extends BaseBuilder
/**
* Throws a not found exception.
*
+ * @param string $query
+ * @param string $dn
+ *
* @throws ModelNotFoundException
*/
- protected function throwNotFoundException(string $query, ?string $dn = null): void
+ protected function throwNotFoundException($query, $dn)
{
throw ModelNotFoundException::forQuery($query, $dn);
}
/**
* Finds multiple records using ambiguous name resolution.
+ *
+ * @param array $values
+ * @param array $columns
+ * @return \LdapRecord\Query\Collection
*/
- public function findManyByAnr(array $values = [], array|string $columns = ['*']): Collection
+ public function findManyByAnr(array $values = [], $columns = ['*'])
{
$this->select($columns);
@@ -241,10 +224,13 @@ class Builder extends BaseBuilder
/**
* Creates an ANR equivalent query for LDAP distributions that do not support ANR.
+ *
+ * @param string $value
+ * @return $this
*/
- protected function prepareAnrEquivalentQuery(string $value): static
+ protected function prepareAnrEquivalentQuery($value)
{
- return $this->orFilter(function (BaseBuilder $query) use ($value) {
+ return $this->orFilter(function (self $query) use ($value) {
foreach ($this->model->getAnrAttributes() as $attribute) {
$query->whereEquals($attribute, $value);
}
@@ -253,25 +239,35 @@ class Builder extends BaseBuilder
/**
* Finds a record by its string GUID.
+ *
+ * @param string $guid
+ * @param array|string $columns
+ * @return Model|static|null
*/
- public function findByGuid(string $guid, array|string $columns = ['*']): ?Model
+ public function findByGuid($guid, $columns = ['*'])
{
try {
return $this->findByGuidOrFail($guid, $columns);
} catch (ModelNotFoundException $e) {
- return null;
+ return;
}
}
/**
- * Finds a record by its string GUID or throw an exception.
+ * Finds a record by its string GUID.
+ *
+ * Fails upon no records returned.
+ *
+ * @param string $guid
+ * @param array|string $columns
+ * @return Model|static
*
* @throws ModelNotFoundException
*/
- public function findByGuidOrFail(string $guid, array|string $columns = ['*']): Model
+ public function findByGuidOrFail($guid, $columns = ['*'])
{
if ($this->model instanceof ActiveDirectory) {
- $guid = (new Guid($guid))->getEncodedHex();
+ $guid = Utilities::stringGuidToHex($guid);
}
return $this->whereRaw([
@@ -280,17 +276,22 @@ class Builder extends BaseBuilder
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function getQuery(): string
+ public function getQuery()
{
- return $this->afterScopes(fn () => parent::getQuery());
+ return $this->afterScopes(function () {
+ return parent::getQuery();
+ });
}
/**
* Apply the query scopes and execute the callback.
+ *
+ * @param Closure $callback
+ * @return mixed
*/
- protected function afterScopes(Closure $callback): mixed
+ protected function afterScopes(Closure $callback)
{
$this->applyScopes();
@@ -299,8 +300,10 @@ class Builder extends BaseBuilder
/**
* Apply the global query scopes.
+ *
+ * @return $this
*/
- public function applyScopes(): static
+ public function applyScopes()
{
if (! $this->scopes) {
return $this;
@@ -323,8 +326,12 @@ class Builder extends BaseBuilder
/**
* Register a new global scope.
+ *
+ * @param string $identifier
+ * @param Scope|\Closure $scope
+ * @return $this
*/
- public function withGlobalScope(string $identifier, Scope|Closure $scope): static
+ public function withGlobalScope($identifier, $scope)
{
$this->scopes[$identifier] = $scope;
@@ -333,8 +340,11 @@ class Builder extends BaseBuilder
/**
* Remove a registered global scope.
+ *
+ * @param Scope|string $scope
+ * @return $this
*/
- public function withoutGlobalScope(Scope|string $scope): static
+ public function withoutGlobalScope($scope)
{
if (! is_string($scope)) {
$scope = get_class($scope);
@@ -349,8 +359,11 @@ class Builder extends BaseBuilder
/**
* Remove all or passed registered global scopes.
+ *
+ * @param array|null $scopes
+ * @return $this
*/
- public function withoutGlobalScopes(?array $scopes = null): static
+ public function withoutGlobalScopes(array $scopes = null)
{
if (! is_array($scopes)) {
$scopes = array_keys($this->scopes);
@@ -365,44 +378,51 @@ class Builder extends BaseBuilder
/**
* Get an array of global scopes that were removed from the query.
+ *
+ * @return array
*/
- public function removedScopes(): array
+ public function removedScopes()
{
return $this->removedScopes;
}
/**
* Get an array of the global scopes that were applied to the query.
+ *
+ * @return array
*/
- public function appliedScopes(): array
+ public function appliedScopes()
{
return $this->appliedScopes;
}
/**
* Processes and converts the given LDAP results into models.
+ *
+ * @param array $results
+ * @return \LdapRecord\Query\Collection
*/
- protected function process(array $results): Collection
+ protected function process(array $results)
{
return $this->model->hydrate(parent::process($results));
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- protected function prepareWhereValue(string $field, mixed $value = null, $raw = false): string
+ protected function prepareWhereValue($field, $value, $raw = false)
{
if ($value instanceof DateTime) {
$field = $this->model->normalizeAttributeKey($field);
if (! $this->model->isDateAttribute($field)) {
- throw new UnexpectedValueException(
+ throw new \UnexpectedValueException(
"Cannot convert field [$field] to an LDAP timestamp. You must add this field as a model date."
- .' Refer to https://ldaprecord.com/docs/core/v3/model-mutators/#date-mutators'
+ .' Refer to https://ldaprecord.com/docs/core/v2/model-mutators/#date-mutators'
);
}
- $value = $this->model->fromDateTime($value, $this->model->getDates()[$field]);
+ $value = $this->model->fromDateTime($this->model->getDates()[$field], $value);
}
return parent::prepareWhereValue($field, $value, $raw);
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Model/FreeIpaBuilder.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Model/FreeIpaBuilder.php
index cac5ac30b..5e3d43fef 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Model/FreeIpaBuilder.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Model/FreeIpaBuilder.php
@@ -6,16 +6,20 @@ class FreeIpaBuilder extends Builder
{
/**
* Adds a enabled filter to the current query.
+ *
+ * @return $this
*/
- public function whereEnabled(): static
+ public function whereEnabled()
{
return $this->rawFilter('(!(pwdAccountLockedTime=*))');
}
/**
* Adds a disabled filter to the current query.
+ *
+ * @return $this
*/
- public function whereDisabled(): static
+ public function whereDisabled()
{
return $this->rawFilter('(pwdAccountLockedTime=*)');
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Model/OpenLdapBuilder.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Model/OpenLdapBuilder.php
index e0a8d5ebc..dd41344b7 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Model/OpenLdapBuilder.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Model/OpenLdapBuilder.php
@@ -6,16 +6,20 @@ class OpenLdapBuilder extends Builder
{
/**
* Adds a enabled filter to the current query.
+ *
+ * @return $this
*/
- public function whereEnabled(): static
+ public function whereEnabled()
{
return $this->rawFilter('(!(pwdAccountLockedTime=*))');
}
/**
* Adds a disabled filter to the current query.
+ *
+ * @return $this
*/
- public function whereDisabled(): static
+ public function whereDisabled()
{
return $this->rawFilter('(pwdAccountLockedTime=*)');
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/MultipleObjectsFoundException.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/MultipleObjectsFoundException.php
index 79ed1e3ef..0ece752cf 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/MultipleObjectsFoundException.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/MultipleObjectsFoundException.php
@@ -4,4 +4,6 @@ namespace LdapRecord\Query;
use LdapRecord\LdapRecordException;
-class MultipleObjectsFoundException extends LdapRecordException {}
+class MultipleObjectsFoundException extends LdapRecordException
+{
+}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/ObjectNotFoundException.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/ObjectNotFoundException.php
index 8fb22a218..99c2e85e3 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/ObjectNotFoundException.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/ObjectNotFoundException.php
@@ -8,26 +8,38 @@ class ObjectNotFoundException extends LdapRecordException
{
/**
* The query filter that was used.
+ *
+ * @var string
*/
- protected string $query;
+ protected $query;
/**
* The base DN of the query that was used.
+ *
+ * @var string
*/
- protected ?string $baseDn;
+ protected $baseDn;
/**
* Create a new exception for the executed filter.
+ *
+ * @param string $query
+ * @param ?string $baseDn
+ * @return static
*/
- public static function forQuery(string $query, ?string $baseDn = null): static
+ public static function forQuery($query, $baseDn = null)
{
- return (new static)->setQuery($query, $baseDn);
+ return (new static())->setQuery($query, $baseDn);
}
/**
* Set the query that was used.
+ *
+ * @param string $query
+ * @param string|null $baseDn
+ * @return $this
*/
- public function setQuery(string $query, ?string $baseDn = null): static
+ public function setQuery($query, $baseDn = null)
{
$this->query = $query;
$this->baseDn = $baseDn;
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/ObjectsNotFoundException.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/ObjectsNotFoundException.php
index 85edb7f00..a9846005c 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/ObjectsNotFoundException.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/ObjectsNotFoundException.php
@@ -4,4 +4,6 @@ namespace LdapRecord\Query;
use LdapRecord\LdapRecordException;
-class ObjectsNotFoundException extends LdapRecordException {}
+class ObjectsNotFoundException extends LdapRecordException
+{
+}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Pagination/AbstractPaginator.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Pagination/AbstractPaginator.php
index c55677314..11e2dc547 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Pagination/AbstractPaginator.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Pagination/AbstractPaginator.php
@@ -9,28 +9,38 @@ abstract class AbstractPaginator
{
/**
* The query builder instance.
+ *
+ * @var Builder
*/
- protected Builder $query;
+ protected $query;
/**
* The filter to execute.
+ *
+ * @var string
*/
- protected string $filter;
+ protected $filter;
/**
* The amount of objects to fetch per page.
+ *
+ * @var int
*/
- protected int $perPage;
+ protected $perPage;
/**
* Whether the operation is critical.
+ *
+ * @var bool
*/
- protected bool $isCritical;
+ protected $isCritical;
/**
* Constructor.
+ *
+ * @param Builder $query
*/
- public function __construct(Builder $query, string $filter, int $perPage, bool $isCritical = false)
+ public function __construct(Builder $query, $filter, $perPage, $isCritical)
{
$this->query = $query;
$this->filter = $filter;
@@ -40,8 +50,11 @@ abstract class AbstractPaginator
/**
* Execute the pagination request.
+ *
+ * @param LdapInterface $ldap
+ * @return array
*/
- public function execute(LdapInterface $ldap): mixed
+ public function execute(LdapInterface $ldap)
{
$pages = [];
@@ -65,37 +78,53 @@ abstract class AbstractPaginator
}
/**
- * Whether the paginator should continue iterating.
+ * Whether the paginater should continue iterating.
+ *
+ * @return bool
*/
- protected function shouldContinue(): bool
+ protected function shouldContinue()
{
- $cookie = $this->fetchCookie();
+ $cookie = (string) $this->fetchCookie();
return $cookie !== '';
}
/**
* Fetch the pagination cookie.
+ *
+ * @return string
*/
- abstract protected function fetchCookie(): ?string;
+ abstract protected function fetchCookie();
/**
* Prepare the server controls before executing the pagination request.
+ *
+ * @return void
*/
- abstract protected function prepareServerControls(): void;
+ abstract protected function prepareServerControls();
/**
* Apply the server controls.
+ *
+ * @param LdapInterface $ldap
+ * @return void
*/
- abstract protected function applyServerControls(LdapInterface $ldap): void;
+ abstract protected function applyServerControls(LdapInterface $ldap);
/**
* Reset the server controls.
+ *
+ * @param LdapInterface $ldap
+ * @return void
*/
- abstract protected function resetServerControls(LdapInterface $ldap): void;
+ abstract protected function resetServerControls(LdapInterface $ldap);
/**
* Update the server controls.
+ *
+ * @param LdapInterface $ldap
+ * @param resource $resource
+ * @return void
*/
- abstract protected function updateServerControls(LdapInterface $ldap, mixed $resource): void;
+ abstract protected function updateServerControls(LdapInterface $ldap, $resource);
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Pagination/DeprecatedPaginator.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Pagination/DeprecatedPaginator.php
new file mode 100644
index 000000000..b4a7f8db9
--- /dev/null
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Pagination/DeprecatedPaginator.php
@@ -0,0 +1,58 @@
+cookie;
+ }
+
+ /**
+ * @inheritdoc
+ */
+ protected function prepareServerControls()
+ {
+ $this->cookie = '';
+ }
+
+ /**
+ * @inheritdoc
+ */
+ protected function applyServerControls(LdapInterface $ldap)
+ {
+ $ldap->controlPagedResult($this->perPage, $this->isCritical, $this->cookie);
+ }
+
+ /**
+ * @inheritdoc
+ */
+ protected function updateServerControls(LdapInterface $ldap, $resource)
+ {
+ $ldap->controlPagedResultResponse($resource, $this->cookie);
+ }
+
+ /**
+ * @inheritdoc
+ */
+ protected function resetServerControls(LdapInterface $ldap)
+ {
+ $ldap->controlPagedResult();
+ }
+}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Pagination/LazyPaginator.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Pagination/LazyPaginator.php
index d770259ed..8b12d526c 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Pagination/LazyPaginator.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Pagination/LazyPaginator.php
@@ -2,15 +2,17 @@
namespace LdapRecord\Query\Pagination;
-use Generator;
use LdapRecord\LdapInterface;
class LazyPaginator extends Paginator
{
/**
* Execute the pagination request.
+ *
+ * @param LdapInterface $ldap
+ * @return \Generator
*/
- public function execute(LdapInterface $ldap): Generator
+ public function execute(LdapInterface $ldap)
{
$this->prepareServerControls();
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Pagination/Paginator.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Pagination/Paginator.php
index 50671a77a..c0a31afd9 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Pagination/Paginator.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Pagination/Paginator.php
@@ -7,17 +7,17 @@ use LdapRecord\LdapInterface;
class Paginator extends AbstractPaginator
{
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- protected function fetchCookie(): ?string
+ protected function fetchCookie()
{
return $this->query->controls[LDAP_CONTROL_PAGEDRESULTS]['value']['cookie'] ?? null;
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- protected function prepareServerControls(): void
+ protected function prepareServerControls()
{
$this->query->addControl(LDAP_CONTROL_PAGEDRESULTS, $this->isCritical, [
'size' => $this->perPage, 'cookie' => '',
@@ -25,27 +25,31 @@ class Paginator extends AbstractPaginator
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- protected function applyServerControls(LdapInterface $ldap): void
+ protected function applyServerControls(LdapInterface $ldap)
{
$ldap->setOption(LDAP_OPT_SERVER_CONTROLS, $this->query->controls);
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- protected function updateServerControls(LdapInterface $ldap, mixed $resource): void
+ protected function updateServerControls(LdapInterface $ldap, $resource)
{
+ $errorCode = 0;
+ $dn = $errorMessage = $refs = null;
$controls = $this->query->controls;
- $response = $ldap->parseResult(
- result: $resource,
- controls: $controls
+ $ldap->parseResult(
+ $resource,
+ $errorCode,
+ $dn,
+ $errorMessage,
+ $refs,
+ $controls
);
- $controls = array_merge($controls, $response->controls ?? []);
-
$cookie = $controls[LDAP_CONTROL_PAGEDRESULTS]['value']['cookie'] ?? '';
$this->query->controls[LDAP_CONTROL_PAGEDRESULTS]['value'] = [
@@ -55,9 +59,9 @@ class Paginator extends AbstractPaginator
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- protected function resetServerControls(LdapInterface $ldap): void
+ protected function resetServerControls(LdapInterface $ldap)
{
unset($this->query->controls[LDAP_CONTROL_PAGEDRESULTS]);
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Slice.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Slice.php
index 2921724ca..12faa5bd1 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Slice.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Query/Slice.php
@@ -10,34 +10,49 @@ use JsonSerializable;
class Slice implements ArrayAccess, IteratorAggregate, JsonSerializable
{
/**
- * All the items in the slice.
+ * All of the items being paginated.
+ *
+ * @var \LdapRecord\Query\Collection|array
*/
- protected Collection|array $items;
+ protected $items;
/**
* The number of items to be shown per page.
+ *
+ * @var int
*/
- protected int $perPage;
+ protected $perPage;
/**
* The total number of items before slicing.
+ *
+ * @var int
*/
- protected int $total;
+ protected $total;
/**
* The last available page.
+ *
+ * @var int
*/
- protected int $lastPage;
+ protected $lastPage;
/**
* The current page being "viewed".
+ *
+ * @var int
*/
- protected int $currentPage;
+ protected $currentPage;
/**
* Constructor.
+ *
+ * @param \LdapRecord\Query\Collection|array $items
+ * @param int $total
+ * @param int $perPage
+ * @param int|null $currentPage
*/
- public function __construct(Collection|array $items, int $total, int $perPage, ?int $currentPage = null)
+ public function __construct($items, $total, $perPage, $currentPage = null)
{
$this->items = $items;
$this->total = $total;
@@ -48,159 +63,202 @@ class Slice implements ArrayAccess, IteratorAggregate, JsonSerializable
/**
* Get the slice of items being paginated.
+ *
+ * @return \LdapRecord\Query\Collection|array
*/
- public function items(): Collection|array
+ public function items()
{
return $this->items;
}
/**
* Get the total number of items being paginated.
+ *
+ * @return int
*/
- public function total(): int
+ public function total()
{
return $this->total;
}
/**
* Get the number of items shown per page.
+ *
+ * @return int
*/
- public function perPage(): int
+ public function perPage()
{
return $this->perPage;
}
/**
* Determine if there are more items in the data source.
+ *
+ * @return bool
*/
- public function hasMorePages(): bool
+ public function hasMorePages()
{
return $this->currentPage() < $this->lastPage();
}
/**
* Determine if there are enough items to split into multiple pages.
+ *
+ * @return bool
*/
- public function hasPages(): bool
+ public function hasPages()
{
return $this->currentPage() != 1 || $this->hasMorePages();
}
/**
* Determine if the paginator is on the first page.
+ *
+ * @return bool
*/
- public function onFirstPage(): bool
+ public function onFirstPage()
{
return $this->currentPage() <= 1;
}
/**
* Determine if the paginator is on the last page.
+ *
+ * @return bool
*/
- public function onLastPage(): bool
+ public function onLastPage()
{
return ! $this->hasMorePages();
}
/**
* Get the current page.
+ *
+ * @return int
*/
- public function currentPage(): int
+ public function currentPage()
{
return $this->currentPage;
}
/**
* Get the last page.
+ *
+ * @return int
*/
- public function lastPage(): int
+ public function lastPage()
{
return $this->lastPage;
}
/**
* Get an iterator for the items.
+ *
+ * @return \ArrayIterator
*/
#[\ReturnTypeWillChange]
- public function getIterator(): ArrayIterator
+ public function getIterator()
{
return new ArrayIterator($this->items);
}
/**
* Determine if the list of items is empty.
+ *
+ * @return bool
*/
- public function isEmpty(): bool
+ public function isEmpty()
{
return empty($this->items);
}
/**
* Determine if the list of items is not empty.
+ *
+ * @return bool
*/
- public function isNotEmpty(): bool
+ public function isNotEmpty()
{
return ! $this->isEmpty();
}
/**
* Get the number of items for the current page.
+ *
+ * @return int
*/
#[\ReturnTypeWillChange]
- public function count(): int
+ public function count()
{
return count($this->items);
}
/**
* Determine if the given item exists.
+ *
+ * @param mixed $key
+ * @return bool
*/
#[\ReturnTypeWillChange]
- public function offsetExists(mixed $offset): bool
+ public function offsetExists($key)
{
- return array_key_exists($offset, $this->items);
+ return array_key_exists($key, $this->items);
}
/**
* Get the item at the given offset.
+ *
+ * @param mixed $key
+ * @return mixed
*/
#[\ReturnTypeWillChange]
- public function offsetGet(mixed $offset): mixed
+ public function offsetGet($key)
{
- return $this->items[$offset] ?? null;
+ return $this->items[$key] ?? null;
}
/**
* Set the item at the given offset.
+ *
+ * @param mixed $key
+ * @param mixed $value
+ * @return void
*/
#[\ReturnTypeWillChange]
- public function offsetSet(mixed $offset, mixed $value): void
+ public function offsetSet($key, $value)
{
- $this->items[$offset] = $value;
+ $this->items[$key] = $value;
}
/**
* Unset the item at the given key.
+ *
+ * @param mixed $key
+ * @return void
*/
#[\ReturnTypeWillChange]
- public function offsetUnset(mixed $offset): void
+ public function offsetUnset($key)
{
- unset($this->items[$offset]);
+ unset($this->items[$key]);
}
/**
* Convert the object into something JSON serializable.
+ *
+ * @return array
*/
#[\ReturnTypeWillChange]
- public function jsonSerialize(): array
+ public function jsonSerialize()
{
return $this->toArray();
}
/**
* Get the arrayable items.
+ *
+ * @return array
*/
- public function getArrayableItems(): array
+ public function getArrayableItems()
{
return $this->items instanceof Collection
? $this->items->all()
@@ -209,8 +267,10 @@ class Slice implements ArrayAccess, IteratorAggregate, JsonSerializable
/**
* Get the instance as an array.
+ *
+ * @return array
*/
- public function toArray(): array
+ public function toArray()
{
return [
'current_page' => $this->currentPage(),
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Support/Arr.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Support/Arr.php
index 6c3217a50..7475859ae 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Support/Arr.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Support/Arr.php
@@ -8,16 +8,23 @@ class Arr
{
/**
* Determine whether the given value is array accessible.
+ *
+ * @param mixed $value
+ * @return bool
*/
- public static function accessible(mixed $value): bool
+ public static function accessible($value)
{
return is_array($value) || $value instanceof ArrayAccess;
}
/**
* Determine if the given key exists in the provided array.
+ *
+ * @param \ArrayAccess|array $array
+ * @param string|int $key
+ * @return bool
*/
- public static function exists(ArrayAccess|array $array, string|int $key): bool
+ public static function exists($array, $key)
{
if ($array instanceof ArrayAccess) {
return $array->offsetExists($key);
@@ -28,8 +35,11 @@ class Arr
/**
* If the given value is not an array and not null, wrap it in one.
+ *
+ * @param mixed $value
+ * @return array
*/
- public static function wrap(mixed $value): array
+ public static function wrap($value)
{
if (is_null($value)) {
return [];
@@ -39,9 +49,14 @@ class Arr
}
/**
- * Get the first element in an array passing a given truth test.
+ * Return the first element in an array passing a given truth test.
+ *
+ * @param iterable $array
+ * @param callable|null $callback
+ * @param mixed $default
+ * @return mixed
*/
- public static function first(iterable $array, ?callable $callback = null, mixed $default = null): mixed
+ public static function first($array, callable $callback = null, $default = null)
{
if (is_null($callback)) {
if (empty($array)) {
@@ -63,11 +78,14 @@ class Arr
}
/**
- * Get the last element in an array passing a given truth test.
+ * Return the last element in an array passing a given truth test.
*
* @param array $array
+ * @param callable|null $callback
+ * @param mixed $default
+ * @return mixed
*/
- public static function last(iterable $array, ?callable $callback = null, mixed $default = null): mixed
+ public static function last($array, callable $callback = null, $default = null)
{
if (is_null($callback)) {
return empty($array) ? Helpers::value($default) : end($array);
@@ -78,8 +96,13 @@ class Arr
/**
* Get an item from an array using "dot" notation.
+ *
+ * @param ArrayAccess|array $array
+ * @param string|int|null $key
+ * @param mixed $default
+ * @return mixed
*/
- public static function get(ArrayAccess|array $array, string|int|null $key, mixed $default = null): mixed
+ public static function get($array, $key, $default = null)
{
if (! static::accessible($array)) {
return Helpers::value($default);
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Support/Helpers.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Support/Helpers.php
index 5b4bd46fb..ab217d6ff 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Support/Helpers.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Support/Helpers.php
@@ -7,9 +7,13 @@ use Closure;
class Helpers
{
/**
- * Get the default value of the given value.
+ * Return the default value of the given value.
+ *
+ * @param mixed $value
+ * @param mixed $args
+ * @return mixed
*/
- public static function value(mixed $value, mixed ...$args): mixed
+ public static function value($value, ...$args)
{
return $value instanceof Closure ? $value(...$args) : $value;
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Support/Str.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Support/Str.php
index ced2a5fd1..820834e21 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Support/Str.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Support/Str.php
@@ -5,49 +5,19 @@ namespace LdapRecord\Support;
class Str
{
/**
- * Determine if a given string matches a given pattern.
+ * Return the remainder of a string after the last occurrence of a given value.
+ *
+ * @param string $subject
+ * @param string $search
+ * @return string
*/
- public static function is(string|iterable $pattern, string $value): bool
- {
- if (! is_iterable($pattern)) {
- $pattern = [$pattern];
- }
-
- foreach ($pattern as $pattern) {
- $pattern = (string) $pattern;
-
- // If the given value is an exact match we can of course return true right
- // from the beginning. Otherwise, we will translate asterisks and do an
- // actual pattern match against the two strings to see if they match.
- if ($pattern === $value) {
- return true;
- }
-
- $pattern = preg_quote($pattern, '#');
-
- // Asterisks are translated into zero-or-more regular expression wildcards
- // to make it convenient to check if the strings starts with the given
- // pattern such as "library/*", making any string check convenient.
- $pattern = str_replace('\*', '.*', $pattern);
-
- if (preg_match('#^'.$pattern.'\z#u', $value) === 1) {
- return true;
- }
- }
-
- return false;
- }
-
- /**
- * Get the remainder of a string after the last occurrence of a given value.
- */
- public static function afterLast(string $subject, string $search): string
+ public static function afterLast($subject, $search)
{
if ($search === '') {
return $subject;
}
- $position = strrpos($subject, $search);
+ $position = strrpos($subject, (string) $search);
if ($position === false) {
return $subject;
@@ -58,8 +28,12 @@ class Str
/**
* Determine if a given string starts with a given substring.
+ *
+ * @param string $haystack
+ * @param string|string[] $needles
+ * @return bool
*/
- public static function startsWith(string $haystack, array|string $needles): bool
+ public static function startsWith($haystack, $needles)
{
foreach ((array) $needles as $needle) {
if ((string) $needle !== '' && str_starts_with($haystack, $needle)) {
@@ -72,8 +46,12 @@ class Str
/**
* Determine if a given string ends with a given substring.
+ *
+ * @param string $haystack
+ * @param string|string[] $needles
+ * @return bool
*/
- public static function endsWith(string $haystack, array|string $needles): bool
+ public static function endsWith($haystack, $needles)
{
foreach ((array) $needles as $needle) {
if (
@@ -89,8 +67,14 @@ class Str
/**
* Execute a callback when a needle is found in the haystack.
+ *
+ * @param string $haystack
+ * @param string|string[] $needles
+ * @param \Closure|mixed $callback
+ * @param \Closure|mixed $default
+ * @return mixed
*/
- public static function whenContains(string $haystack, array|string $needles, mixed $callback, mixed $default = null): mixed
+ public static function whenContains($haystack, $needles, $callback, $default = null)
{
foreach ((array) $needles as $needle) {
if (static::contains($haystack, $needle)) {
@@ -103,8 +87,13 @@ class Str
/**
* Determine if a given string contains a given substring.
+ *
+ * @param string $haystack
+ * @param string|string[] $needles
+ * @param bool $ignoreCase
+ * @return bool
*/
- public static function contains(string $haystack, array|string $needles, bool $ignoreCase = false): bool
+ public static function contains($haystack, $needles, $ignoreCase = false)
{
if ($ignoreCase) {
$haystack = mb_strtolower($haystack);
@@ -121,9 +110,15 @@ class Str
}
/**
- * Get the number of substring occurrences.
+ * Returns the number of substring occurrences.
+ *
+ * @param string $haystack
+ * @param string $needle
+ * @param int $offset
+ * @param int|null $length
+ * @return int
*/
- public static function substrCount(string $haystack, string $needle, int $offset = 0, ?int $length = null): int
+ public static function substrCount($haystack, $needle, $offset = 0, $length = null)
{
if (! is_null($length)) {
return substr_count($haystack, $needle, $offset, $length);
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Testing/AuthGuardFake.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Testing/AuthGuardFake.php
index 36574c0d5..4a691506d 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Testing/AuthGuardFake.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Testing/AuthGuardFake.php
@@ -8,6 +8,11 @@ class AuthGuardFake extends Guard
{
/**
* Always allow binding as configured user.
+ *
+ * @return bool
*/
- public function bindAsConfiguredUser(): void {}
+ public function bindAsConfiguredUser()
+ {
+ return true;
+ }
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Testing/ConnectionFake.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Testing/ConnectionFake.php
index 2c76a06d5..09530f5c7 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Testing/ConnectionFake.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Testing/ConnectionFake.php
@@ -4,7 +4,6 @@ namespace LdapRecord\Testing;
use LdapRecord\Auth\Guard;
use LdapRecord\Connection;
-use LdapRecord\LdapInterface;
use LdapRecord\Models\Model;
class ConnectionFake extends Connection
@@ -14,19 +13,25 @@ class ConnectionFake extends Connection
*
* @var LdapFake
*/
- protected LdapInterface $ldap;
+ protected $ldap;
/**
* Whether the fake is connected.
+ *
+ * @var bool
*/
- protected bool $connected = false;
+ protected $connected = false;
/**
* Make a new fake LDAP connection instance.
+ *
+ * @param array $config
+ * @param string $ldap
+ * @return static
*/
- public static function make(array $config = [], string $ldap = LdapFake::class): static
+ public static function make(array $config = [], $ldap = LdapFake::class)
{
- $connection = new static($config, new $ldap);
+ $connection = new static($config, new $ldap());
$connection->configure();
@@ -35,10 +40,13 @@ class ConnectionFake extends Connection
/**
* Set the user to authenticate as.
+ *
+ * @param Model|string $user
+ * @return $this
*/
- public function actingAs(Model|string $user): static
+ public function actingAs($user)
{
- $this->ldap->shouldAllowBindWith(
+ $this->ldap->shouldAuthenticateWith(
$user instanceof Model ? $user->getDn() : $user
);
@@ -47,8 +55,10 @@ class ConnectionFake extends Connection
/**
* Set the connection to bypass bind attempts as the configured user.
+ *
+ * @return $this
*/
- public function shouldBeConnected(): static
+ public function shouldBeConnected()
{
$this->connected = true;
@@ -61,8 +71,10 @@ class ConnectionFake extends Connection
/**
* Set the connection to attempt binding as the configured user.
+ *
+ * @return $this
*/
- public function shouldNotBeConnected(): static
+ public function shouldNotBeConnected()
{
$this->connected = false;
@@ -74,20 +86,10 @@ class ConnectionFake extends Connection
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function isConnected(): bool
+ public function isConnected()
{
return $this->connected ?: parent::isConnected();
}
-
- /**
- * Perform tear down tasks on the fake.
- *
- * @throws LdapExpectationException
- */
- public function tearDown(): void
- {
- $this->ldap->assertMinimumExpectationCounts();
- }
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Testing/DirectoryFake.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Testing/DirectoryFake.php
index 90cbf7ae6..72be02af3 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Testing/DirectoryFake.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Testing/DirectoryFake.php
@@ -7,50 +7,44 @@ use LdapRecord\Container;
class DirectoryFake
{
/**
- * The LDAP connections that were replaced with fakes.
+ * Setup the fake connection.
*
- * @var \LdapRecord\Connection[]
- */
- protected static array $replaced = [];
-
- /**
- * Replace a connection a fake.
+ * @param string|null $name
+ * @return ConnectionFake
*
* @throws \LdapRecord\ContainerException
*/
- public static function setup(?string $name = null): ConnectionFake
+ public static function setup($name = null)
{
- $name = $name ?? Container::getDefaultConnectionName();
-
- $connection = static::$replaced[$name] = Container::getConnection($name);
+ $connection = Container::getConnection($name);
$fake = static::makeConnectionFake(
$connection->getConfiguration()->all()
);
+ // Replace the connection with a fake.
Container::addConnection($fake, $name);
return $fake;
}
/**
- * Replace all faked connections with their original.
+ * Reset the container.
+ *
+ * @return void
*/
- public static function tearDown(): void
+ public static function tearDown()
{
- foreach (static::$replaced as $name => $connection) {
- Container::getConnection($name)->tearDown();
- }
-
- Container::flush();
-
- static::$replaced = [];
+ Container::reset();
}
/**
* Make a connection fake.
+ *
+ * @param array $config
+ * @return ConnectionFake
*/
- public static function makeConnectionFake(array $config = []): ConnectionFake
+ public static function makeConnectionFake(array $config = [])
{
return ConnectionFake::make($config)->shouldBeConnected();
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Testing/LdapExpectation.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Testing/LdapExpectation.php
index 2e010d7d7..693459149 100644
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Testing/LdapExpectation.php
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Testing/LdapExpectation.php
@@ -3,9 +3,7 @@
namespace LdapRecord\Testing;
use Closure;
-use Exception;
use LdapRecord\LdapRecordException;
-use LdapRecord\LdapResultResponse;
use PHPUnit\Framework\Constraint\Callback;
use PHPUnit\Framework\Constraint\Constraint;
use PHPUnit\Framework\Constraint\IsEqual;
@@ -15,76 +13,91 @@ class LdapExpectation
{
/**
* The value to return from the expectation.
+ *
+ * @var mixed
*/
- protected mixed $value = null;
+ protected $value;
/**
* The exception to throw from the expectation.
+ *
+ * @var null|LdapRecordException|\Exception
*/
- protected ?Exception $exception = null;
+ protected $exception;
/**
- * The tracked number of times the expectation should be called.
+ * The amount of times the expectation should be called.
+ *
+ * @var int
*/
- protected int $count = 1;
-
- /**
- * The original number of times the expectation should be called.
- */
- protected int $originalCount = 1;
-
- /**
- * The actual number of times the expectation was called.
- */
- protected int $called = 0;
+ protected $count = 1;
/**
* The method that the expectation belongs to.
+ *
+ * @var string
*/
- protected ?string $method = null;
+ protected $method;
/**
* The methods argument's.
+ *
+ * @var array
*/
- protected array $args = [];
+ protected $args = [];
/**
* Whether the same expectation should be returned indefinitely.
+ *
+ * @var bool
*/
- protected bool $indefinitely = true;
+ protected $indefinitely = true;
/**
- * Whether the expectation should return an error.
+ * Whether the expectation should return errors.
+ *
+ * @var bool
*/
- protected bool $errors = false;
+ protected $errors = false;
/**
- * The error code to return.
+ * The error number to return.
+ *
+ * @var int
*/
- protected int $errorCode = 1;
+ protected $errorCode = 1;
/**
- * The error message to return.
+ * The last error string to return.
+ *
+ * @var string
*/
- protected string $errorMessage = 'Unknown error';
+ protected $errorMessage = '';
/**
* The diagnostic message string to return.
+ *
+ * @var string
*/
- protected ?string $errorDiagnosticMessage = null;
+ protected $errorDiagnosticMessage = '';
/**
* Constructor.
+ *
+ * @param string $method
*/
- public function __construct(string $method)
+ public function __construct($method)
{
$this->method = $method;
}
/**
* Set the arguments that the operation should receive.
+ *
+ * @param mixed $args
+ * @return $this
*/
- public function with(mixed $args): static
+ public function with($args)
{
$this->args = array_map(function ($arg) {
if ($arg instanceof Closure) {
@@ -103,71 +116,43 @@ class LdapExpectation
/**
* Set the expected value to return.
+ *
+ * @param mixed $value
+ * @return $this
*/
- public function andReturn(mixed $value): static
+ public function andReturn($value)
{
$this->value = $value;
return $this;
}
- /**
- * Set the expected value to return true.
- */
- public function andReturnTrue(): static
- {
- return $this->andReturn(true);
- }
-
- /**
- * Set the expected value to return false.
- */
- public function andReturnFalse(): static
- {
- return $this->andReturn(false);
- }
-
/**
* The error message to return from the expectation.
+ *
+ * @param int $code
+ * @param string $error
+ * @param string $diagnosticMessage
+ * @return $this
*/
- public function andReturnError(int $errorCode = 1, string $errorMessage = 'Unknown error', ?string $diagnosticMessage = null): static
+ public function andReturnError($code = 1, $error = '', $diagnosticMessage = '')
{
$this->errors = true;
- $this->errorCode = $errorCode;
- $this->errorMessage = $errorMessage;
+ $this->errorCode = $code;
+ $this->errorMessage = $error;
$this->errorDiagnosticMessage = $diagnosticMessage;
return $this;
}
- /**
- * Return an error LDAP result response.
- */
- public function andReturnErrorResponse(int $code = 1, ?string $errorMessage = null): static
- {
- return $this->andReturnResponse($code, $errorMessage);
- }
-
- /**
- * Return an LDAP result response.
- */
- public function andReturnResponse(
- int $errorCode = 0,
- ?string $matchedDn = null,
- ?string $errorMessage = null,
- array $referrals = [],
- array $controls = []
- ): static {
- return $this->andReturn(
- new LdapResultResponse($errorCode, $matchedDn, $errorMessage, $referrals, $controls)
- );
- }
-
/**
* Set the expected exception to throw.
+ *
+ * @param string|\Exception|LdapRecordException $exception
+ * @return $this
*/
- public function andThrow(string|Exception $exception): static
+ public function andThrow($exception)
{
if (is_string($exception)) {
$exception = new LdapRecordException($exception);
@@ -180,36 +165,45 @@ class LdapExpectation
/**
* Set the expectation to be only called once.
+ *
+ * @return $this
*/
- public function once(): static
+ public function once()
{
- return $this->times();
+ return $this->times(1);
}
/**
* Set the expectation to be only called twice.
+ *
+ * @return $this
*/
- public function twice(): static
+ public function twice()
{
return $this->times(2);
}
/**
* Set the expectation to be called the given number of times.
+ *
+ * @param int $count
+ * @return $this
*/
- public function times(int $count = 1): static
+ public function times($count = 1)
{
$this->indefinitely = false;
- $this->originalCount = $this->count = $count;
+ $this->count = $count;
return $this;
}
/**
* Get the method the expectation belongs to.
+ *
+ * @return string
*/
- public function getMethod(): string
+ public function getMethod()
{
if (is_null($this->method)) {
throw new UnexpectedValueException('An expectation must have a method.');
@@ -220,105 +214,89 @@ class LdapExpectation
/**
* Get the expected call count.
+ *
+ * @return int
*/
- public function getExpectedCount(): int
+ public function getExpectedCount()
{
return $this->count;
}
- /**
- * Get the original expected call count.
- */
- public function getOriginalExpectedCount(): int
- {
- return $this->originalCount;
- }
-
- /**
- * Get the count that the expectation was called.
- */
- public function getCalledCount(): int
- {
- return $this->called;
- }
-
/**
* Get the expected arguments.
*
* @return Constraint[]
*/
- public function getExpectedArgs(): array
+ public function getExpectedArgs()
{
return $this->args;
}
/**
* Get the expected exception.
+ *
+ * @return null|\Exception|LdapRecordException
*/
- public function getExpectedException(): ?Exception
+ public function getExpectedException()
{
return $this->exception;
}
/**
* Get the expected value.
+ *
+ * @return mixed
*/
- public function getExpectedValue(): mixed
+ public function getExpectedValue()
{
return $this->value;
}
- /**
- * Determine whether the expectation can be called indefinitely.
- */
- public function isIndefinite(): bool
- {
- return $this->indefinitely;
- }
-
/**
* Determine whether the expectation is returning an error.
+ *
+ * @return bool
*/
- public function isReturningError(): bool
+ public function isReturningError()
{
return $this->errors;
}
/**
- * Get the expected error code.
+ * @return int
*/
- public function getExpectedErrorCode(): int
+ public function getExpectedErrorCode()
{
return $this->errorCode;
}
/**
- * Get the expected error message.
+ * @return string
*/
- public function getExpectedErrorMessage(): ?string
+ public function getExpectedErrorMessage()
{
return $this->errorMessage;
}
/**
- * Get the expected diagnostic message.
+ * @return string
*/
- public function getExpectedErrorDiagnosticMessage(): ?string
+ public function getExpectedErrorDiagnosticMessage()
{
return $this->errorDiagnosticMessage;
}
/**
- * Decrement the expected count of the expectation.
+ * Decrement the call count of the expectation.
+ *
+ * @return $this
*/
- public function decrementExpectedCount(): static
+ public function decrementCallCount()
{
if (! $this->indefinitely) {
$this->count -= 1;
}
- $this->called++;
-
return $this;
}
}
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Testing/LdapExpectationException.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Testing/LdapExpectationException.php
deleted file mode 100644
index 74a3ebe33..000000000
--- a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Testing/LdapExpectationException.php
+++ /dev/null
@@ -1,7 +0,0 @@
-
+ * @var array
*/
- protected array $expectations = [];
+ protected $expectations = [];
/**
* The default fake error number.
+ *
+ * @var int
*/
- protected int $errNo = 1;
+ protected $errNo = 1;
/**
* The default fake last error string.
+ *
+ * @var string
*/
- protected string $lastError = 'Unknown error';
+ protected $lastError = '';
/**
* The default fake diagnostic message string.
+ *
+ * @var string
*/
- protected ?string $diagnosticMessage = null;
+ protected $diagnosticMessage = '';
/**
* Create a new expected operation.
+ *
+ * @param string $method
+ * @return LdapExpectation
*/
- public static function operation(string $method): LdapExpectation
+ public static function operation($method)
{
return new LdapExpectation($method);
}
/**
- * Set the fake LDAP host.
+ * Set the user that will pass binding.
+ *
+ * @param string $dn
+ * @return $this
*/
- public function setHost(string $host): void
+ public function shouldAuthenticateWith($dn)
{
- $this->host = $host;
+ return $this->expect(
+ static::operation('bind')->with($dn, PHPUnit::anything())->andReturn(true)
+ );
}
/**
* Add an LDAP method expectation.
+ *
+ * @param LdapExpectation|array $expectations
+ * @return $this
*/
- public function expect(LdapExpectation|array $expectations = []): static
+ public function expect($expectations = [])
{
$expectations = Arr::wrap($expectations);
@@ -85,8 +101,11 @@ class LdapFake implements LdapInterface
/**
* Determine if the method has any expectations.
+ *
+ * @param string $method
+ * @return bool
*/
- public function hasExpectations(string $method): bool
+ public function hasExpectations($method)
{
return count($this->getExpectations($method)) > 0;
}
@@ -94,55 +113,33 @@ class LdapFake implements LdapInterface
/**
* Get expectations by method.
*
- * @return LdapExpectation[]
+ * @param string $method
+ * @return LdapExpectation[]|mixed
*/
- public function getExpectations(string $method): array
+ public function getExpectations($method)
{
return $this->expectations[$method] ?? [];
}
/**
* Remove an expectation by method and key.
+ *
+ * @param string $method
+ * @param int $key
+ * @return void
*/
- public function removeExpectation(string $method, int $key): void
+ public function removeExpectation($method, $key)
{
unset($this->expectations[$method][$key]);
}
- /**
- * Set the fake to allow any bind attempt.
- */
- public function shouldAllowAnyBind(): static
- {
- return $this->expect(
- static::operation('bind')->andReturnResponse()
- );
- }
-
- /**
- * Set the fake to allow any bind attempt with the given DN.
- */
- public function shouldAllowBindWith(string $dn): static
- {
- return $this->expect(
- static::operation('bind')->with($dn, PHPUnit::anything())->andReturnResponse()
- );
- }
-
- /**
- * Set the user that will pass binding.
- *
- * @deprecated Use shouldAllowBindWith instead.
- */
- public function shouldAuthenticateWith(string $dn): static
- {
- return $this->shouldAllowBindWith($dn);
- }
-
/**
* Set the error number of a failed bind attempt.
+ *
+ * @param int $number
+ * @return $this
*/
- public function shouldReturnErrorNumber(int $number = 1): static
+ public function shouldReturnErrorNumber($number = 1)
{
$this->errNo = $number;
@@ -151,8 +148,11 @@ class LdapFake implements LdapInterface
/**
* Set the last error of a failed bind attempt.
+ *
+ * @param string $message
+ * @return $this
*/
- public function shouldReturnError(string $message): static
+ public function shouldReturnError($message = '')
{
$this->lastError = $message;
@@ -161,8 +161,11 @@ class LdapFake implements LdapInterface
/**
* Set the diagnostic message of a failed bind attempt.
+ *
+ * @param string $message
+ * @return $this
*/
- public function shouldReturnDiagnosticMessage(?string $message): static
+ public function shouldReturnDiagnosticMessage($message = '')
{
$this->diagnosticMessage = $message;
@@ -171,32 +174,38 @@ class LdapFake implements LdapInterface
/**
* Return a fake error number.
+ *
+ * @return int
*/
- public function errNo(): int
+ public function errNo()
{
return $this->errNo;
}
/**
* Return a fake error.
+ *
+ * @return string
*/
- public function getLastError(): string
+ public function getLastError()
{
return $this->lastError;
}
/**
- * Return a fake diagnostic message.
+ * @inheritdoc
*/
- public function getDiagnosticMessage(): ?string
+ public function getDiagnosticMessage()
{
return $this->diagnosticMessage;
}
/**
* Return a fake detailed error.
+ *
+ * @return DetailedError
*/
- public function getDetailedError(): DetailedError
+ public function getDetailedError()
{
return new DetailedError(
$this->errNo(),
@@ -206,309 +215,258 @@ class LdapFake implements LdapInterface
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function getEntries(mixed $result): array
+ public function getEntries($searchResults)
{
- return $result;
+ return $searchResults;
}
/**
- * {@inheritDoc}
+ * @inheritdoc
*/
- public function getValuesLen(mixed $entry, string $attribute): array|false
+ public function isUsingSSL()
{
- return $this->resolveExpectation(__FUNCTION__, func_get_args());
- }
-
- /**
- * {@inheritDoc}
- */
- public function compare(string $dn, string $attribute, string $value, ?array $controls = null): bool|int
- {
- return $this->resolveExpectation(__FUNCTION__, func_get_args());
- }
-
- /**
- * {@inheritDoc}
- */
- public function setRebindCallback(callable $callback): bool
- {
- return $this->resolveExpectation(__FUNCTION__, func_get_args());
- }
-
- /**
- * {@inheritDoc}
- */
- public function getFirstEntry(mixed $result): mixed
- {
- return $this->executeFailableOperation(function () use ($result) {
- return ldap_first_entry($this->connection, $result);
- });
- }
-
- /**
- * {@inheritDoc}
- */
- public function getNextEntry(mixed $entry): mixed
- {
- return $this->executeFailableOperation(function () use ($entry) {
- return ldap_next_entry($this->connection, $entry);
- });
- }
-
- /**
- * {@inheritDoc}
- */
- public function getAttributes(mixed $entry): array|false
- {
- return $this->executeFailableOperation(function () use ($entry) {
- return ldap_get_attributes($this->connection, $entry);
- });
- }
-
- /**
- * {@inheritDoc}
- */
- public function countEntries(mixed $result): int
- {
- return $this->executeFailableOperation(function () use ($result) {
- return ldap_count_entries($this->connection, $result);
- });
- }
-
- /**
- * {@inheritdoc}
- */
- public function isUsingSSL(): bool
- {
- return $this->hasExpectations(__FUNCTION__)
- ? $this->resolveExpectation(__FUNCTION__)
+ return $this->hasExpectations('isUsingSSL')
+ ? $this->resolveExpectation('isUsingSSL')
: $this->useSSL;
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function isUsingTLS(): bool
+ public function isUsingTLS()
{
- return $this->hasExpectations(__FUNCTION__)
- ? $this->resolveExpectation(__FUNCTION__)
+ return $this->hasExpectations('isUsingTLS')
+ ? $this->resolveExpectation('isUsingTLS')
: $this->useTLS;
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function isBound(): bool
+ public function isBound()
{
- return $this->hasExpectations(__FUNCTION__)
- ? $this->resolveExpectation(__FUNCTION__)
+ return $this->hasExpectations('isBound')
+ ? $this->resolveExpectation('isBound')
: $this->bound;
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function setOption(int $option, mixed $value): bool
+ public function getHost()
{
- return $this->hasExpectations(__FUNCTION__)
- ? $this->resolveExpectation(__FUNCTION__, func_get_args())
+ return $this->hasExpectations('getHost')
+ ? $this->resolveExpectation('getHost')
+ : $this->host;
+ }
+
+ /**
+ * @inheritdoc
+ */
+ public function setOption($option, $value)
+ {
+ return $this->hasExpectations('setOption')
+ ? $this->resolveExpectation('setOption', func_get_args())
: true;
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function getOption(int $option, mixed &$value = null): mixed
+ public function getOption($option, &$value = null)
{
- return $this->resolveExpectation(__FUNCTION__, func_get_args());
+ return $this->resolveExpectation('getOption', func_get_args());
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function startTLS(): bool
+ public function startTLS()
{
- return $this->secure = $this->resolveExpectation(__FUNCTION__, func_get_args());
+ return $this->resolveExpectation('startTLS', func_get_args());
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function connect(string|array $hosts = [], int $port = 389, ?string $protocol = null): bool
+ public function connect($hosts = [], $port = 389)
{
$this->bound = false;
- $this->protocol = $protocol;
+
$this->host = $this->makeConnectionUris($hosts, $port);
- return $this->connection = $this->hasExpectations(__FUNCTION__)
- ? $this->resolveExpectation(__FUNCTION__, func_get_args())
+ return $this->connection = $this->hasExpectations('connect')
+ ? $this->resolveExpectation('connect', func_get_args())
: true;
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function close(): bool
+ public function close()
{
- $this->bound = false;
- $this->secure = false;
-
- $this->host = null;
- $this->protocol = null;
$this->connection = null;
+ $this->bound = false;
+ $this->host = null;
- return $this->hasExpectations(__FUNCTION__)
- ? $this->resolveExpectation(__FUNCTION__)
+ return $this->hasExpectations('close')
+ ? $this->resolveExpectation('close')
: true;
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function bind(?string $dn = null, ?string $password = null, ?array $controls = null): LdapResultResponse
+ public function bind($username, $password)
{
- $result = $this->resolveExpectation(__FUNCTION__, func_get_args());
-
- $this->handleBindResponse($result);
-
- return $result;
+ return $this->bound = $this->resolveExpectation('bind', func_get_args());
}
/**
- * {@inheritDoc}
+ * @inheritdoc
*/
- public function saslBind(?string $dn = null, ?string $password = null, ?array $options = null): bool
+ public function search($dn, $filter, array $fields, $onlyAttributes = false, $size = 0, $time = 0, $deref = LDAP_DEREF_NEVER, $serverControls = [])
{
- return $this->bound = $this->resolveExpectation(__FUNCTION__, func_get_args());
+ return $this->resolveExpectation('search', func_get_args());
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function search(string $dn, string $filter, array $fields, bool $onlyAttributes = false, int $size = 0, int $time = 0, int $deref = LDAP_DEREF_NEVER, ?array $controls = null): mixed
+ public function listing($dn, $filter, array $fields, $onlyAttributes = false, $size = 0, $time = 0, $deref = LDAP_DEREF_NEVER, $serverControls = [])
{
- return $this->resolveExpectation(__FUNCTION__, func_get_args());
+ return $this->resolveExpectation('listing', func_get_args());
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function list(string $dn, string $filter, array $fields, bool $onlyAttributes = false, int $size = 0, int $time = 0, int $deref = LDAP_DEREF_NEVER, ?array $controls = null): mixed
+ public function read($dn, $filter, array $fields, $onlyAttributes = false, $size = 0, $time = 0, $deref = LDAP_DEREF_NEVER, $serverControls = [])
{
- return $this->resolveExpectation(__FUNCTION__, func_get_args());
+ return $this->resolveExpectation('read', func_get_args());
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function read(string $dn, string $filter, array $fields, bool $onlyAttributes = false, int $size = 0, int $time = 0, int $deref = LDAP_DEREF_NEVER, ?array $controls = null): mixed
+ public function parseResult($result, &$errorCode, &$dn, &$errorMessage, &$referrals, &$serverControls = [])
{
- return $this->resolveExpectation(__FUNCTION__, func_get_args());
+ return $this->resolveExpectation('parseResult', func_get_args());
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function parseResult(mixed $result, int &$errorCode = 0, ?string &$dn = null, ?string &$errorMessage = null, ?array &$referrals = null, ?array &$controls = null): LdapResultResponse|false
+ public function add($dn, array $entry)
{
- return $this->hasExpectations(__FUNCTION__)
- ? $this->resolveExpectation(__FUNCTION__, func_get_args())
- : new LdapResultResponse;
+ return $this->resolveExpectation('add', func_get_args());
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function add(string $dn, array $entry): bool
+ public function delete($dn)
{
- return $this->resolveExpectation(__FUNCTION__, func_get_args());
+ return $this->resolveExpectation('delete', func_get_args());
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function delete(string $dn): bool
+ public function rename($dn, $newRdn, $newParent, $deleteOldRdn = false)
{
- return $this->resolveExpectation(__FUNCTION__, func_get_args());
+ return $this->resolveExpectation('rename', func_get_args());
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function rename(string $dn, string $newRdn, string $newParent, bool $deleteOldRdn = false): bool
+ public function modify($dn, array $entry)
{
- return $this->resolveExpectation(__FUNCTION__, func_get_args());
+ return $this->resolveExpectation('modify', func_get_args());
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function modify(string $dn, array $entry): bool
+ public function modifyBatch($dn, array $values)
{
- return $this->resolveExpectation(__FUNCTION__, func_get_args());
+ return $this->resolveExpectation('modifyBatch', func_get_args());
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function modifyBatch(string $dn, array $values): bool
+ public function modAdd($dn, array $entry)
{
- return $this->resolveExpectation(__FUNCTION__, func_get_args());
+ return $this->resolveExpectation('modAdd', func_get_args());
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function modAdd(string $dn, array $entry): bool
+ public function modReplace($dn, array $entry)
{
- return $this->resolveExpectation(__FUNCTION__, func_get_args());
+ return $this->resolveExpectation('modReplace', func_get_args());
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function modReplace(string $dn, array $entry): bool
+ public function modDelete($dn, array $entry)
{
- return $this->resolveExpectation(__FUNCTION__, func_get_args());
+ return $this->resolveExpectation('modDelete', func_get_args());
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function modDelete(string $dn, array $entry): bool
+ public function controlPagedResult($pageSize = 1000, $isCritical = false, $cookie = '')
{
- return $this->resolveExpectation(__FUNCTION__, func_get_args());
+ return $this->resolveExpectation('controlPagedResult', func_get_args());
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function freeResult(mixed $result): bool
+ public function controlPagedResultResponse($result, &$cookie)
{
- return $this->resolveExpectation(__FUNCTION__, func_get_args());
+ return $this->resolveExpectation('controlPagedResultResponse', func_get_args());
}
/**
- * {@inheritdoc}
+ * @inheritdoc
*/
- public function err2Str(int $number): string
+ public function freeResult($result)
{
- return $this->resolveExpectation(__FUNCTION__, func_get_args());
+ return $this->resolveExpectation('freeResult', func_get_args());
+ }
+
+ /**
+ * @inheritdoc
+ */
+ public function err2Str($number)
+ {
+ return $this->resolveExpectation('err2Str', func_get_args());
}
/**
* Resolve the methods expectations.
*
- * @throws LdapExpectationException
+ * @param string $method
+ * @param array $args
+ * @return mixed
+ *
+ * @throws Exception
*/
- protected function resolveExpectation(string $method, array $args = []): mixed
+ protected function resolveExpectation($method, array $args = [])
{
foreach ($this->getExpectations($method) as $key => $expectation) {
$this->assertMethodArgumentsMatch($method, $expectation->getExpectedArgs(), $args);
- $expectation->decrementExpectedCount();
+ $expectation->decrementCallCount();
if ($expectation->getExpectedCount() === 0) {
$this->removeExpectation($method, $key);
@@ -525,43 +483,31 @@ class LdapFake implements LdapInterface
return $expectation->getExpectedValue();
}
- throw new LdapExpectationException("LDAP method [$method] was unexpected.");
+ throw new Exception("LDAP method [$method] was unexpected.");
}
/**
* Apply the expectation error to the fake.
+ *
+ * @param LdapExpectation $expectation
+ * @return void
*/
- protected function applyExpectationError(LdapExpectation $expectation): void
+ protected function applyExpectationError(LdapExpectation $expectation)
{
$this->shouldReturnError($expectation->getExpectedErrorMessage());
$this->shouldReturnErrorNumber($expectation->getExpectedErrorCode());
$this->shouldReturnDiagnosticMessage($expectation->getExpectedErrorDiagnosticMessage());
}
- /**
- * Assert that the expectations have been called their minimum amount of times.
- *
- * @throws LdapExpectationException
- */
- public function assertMinimumExpectationCounts(): void
- {
- foreach ($this->expectations as $method => $expectations) {
- foreach ($expectations as $expectation) {
- if (! $expectation->isIndefinite() && $expectation->getExpectedCount()) {
- $remaining = ($original = $expectation->getOriginalExpectedCount()) - $expectation->getExpectedCount();
-
- throw new LdapExpectationException("Method [$method] should be called $original times but was called $remaining times.");
- }
- }
- }
- }
-
/**
* Assert that the expected arguments match the operations arguments.
*
+ * @param string $method
* @param Constraint[] $expectedArgs
+ * @param array $methodArgs
+ * @return void
*/
- protected function assertMethodArgumentsMatch(string $method, array $expectedArgs = [], array $methodArgs = []): void
+ protected function assertMethodArgumentsMatch($method, array $expectedArgs = [], array $methodArgs = [])
{
foreach ($expectedArgs as $key => $constraint) {
$argNumber = $key + 1;
@@ -569,7 +515,7 @@ class LdapFake implements LdapInterface
PHPUnit::assertArrayHasKey(
$key,
$methodArgs,
- "LDAP method [$method] argument #$argNumber does not exist."
+ "LDAP method [$method] argument #{$argNumber} does not exist."
);
$constraint->evaluate(
diff --git a/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Utilities.php b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Utilities.php
new file mode 100644
index 000000000..c4f5190d8
--- /dev/null
+++ b/data/web/inc/lib/vendor/directorytree/ldaprecord/src/Utilities.php
@@ -0,0 +1,187 @@
+ $value) {
+ $dn[$rdn] = static::unescape($value);
+ }
+
+ return $dn;
+ }
+
+ /**
+ * Un-escapes a hexadecimal string into its original string representation.
+ *
+ * @param string $value
+ * @return string
+ */
+ public static function unescape($value)
+ {
+ return preg_replace_callback('/\\\([0-9A-Fa-f]{2})/', function ($matches) {
+ return chr(hexdec($matches[1]));
+ }, $value);
+ }
+
+ /**
+ * Convert a binary SID to a string SID.
+ *
+ * @author Chad Sikorra
+ *
+ * @see https://github.com/ChadSikorra
+ * @see https://stackoverflow.com/questions/39533560/php-ldap-get-user-sid
+ *
+ * @param string $value The Binary SID
+ * @return string|null
+ */
+ public static function binarySidToString($value)
+ {
+ // Revision - 8bit unsigned int (C1)
+ // Count - 8bit unsigned int (C1)
+ // 2 null bytes
+ // ID - 32bit unsigned long, big-endian order
+ $sid = @unpack('C1rev/C1count/x2/N1id', $value);
+
+ if (! isset($sid['id']) || ! isset($sid['rev'])) {
+ return;
+ }
+
+ $revisionLevel = $sid['rev'];
+
+ $identifierAuthority = $sid['id'];
+
+ $subs = isset($sid['count']) ? $sid['count'] : 0;
+
+ $sidHex = $subs ? bin2hex($value) : '';
+
+ $subAuthorities = [];
+
+ // The sub-authorities depend on the count, so only get as
+ // many as the count, regardless of data beyond it.
+ for ($i = 0; $i < $subs; $i++) {
+ $data = implode(array_reverse(
+ str_split(
+ substr($sidHex, 16 + ($i * 8), 8),
+ 2
+ )
+ ));
+
+ $subAuthorities[] = hexdec($data);
+ }
+
+ // Tack on the 'S-' and glue it all together...
+ return 'S-'.$revisionLevel.'-'.$identifierAuthority.implode(
+ preg_filter('/^/', '-', $subAuthorities)
+ );
+ }
+
+ /**
+ * Convert a binary GUID to a string GUID.
+ *
+ * @param string $binGuid
+ * @return string|null
+ */
+ public static function binaryGuidToString($binGuid)
+ {
+ if (is_null($binGuid) || trim($binGuid) == '') {
+ return;
+ }
+
+ $hex = unpack('H*hex', $binGuid)['hex'];
+
+ $hex1 = substr($hex, -26, 2).substr($hex, -28, 2).substr($hex, -30, 2).substr($hex, -32, 2);
+ $hex2 = substr($hex, -22, 2).substr($hex, -24, 2);
+ $hex3 = substr($hex, -18, 2).substr($hex, -20, 2);
+ $hex4 = substr($hex, -16, 4);
+ $hex5 = substr($hex, -12, 12);
+
+ return sprintf('%s-%s-%s-%s-%s', $hex1, $hex2, $hex3, $hex4, $hex5);
+ }
+
+ /**
+ * Converts a string GUID to it's hex variant.
+ *
+ * @param string $string
+ * @return string
+ */
+ public static function stringGuidToHex($string)
+ {
+ $hex = '\\'.substr($string, 6, 2).'\\'.substr($string, 4, 2).'\\'.substr($string, 2, 2).'\\'.substr($string, 0, 2);
+ $hex = $hex.'\\'.substr($string, 11, 2).'\\'.substr($string, 9, 2);
+ $hex = $hex.'\\'.substr($string, 16, 2).'\\'.substr($string, 14, 2);
+ $hex = $hex.'\\'.substr($string, 19, 2).'\\'.substr($string, 21, 2);
+ $hex = $hex.'\\'.substr($string, 24, 2).'\\'.substr($string, 26, 2).'\\'.substr($string, 28, 2).'\\'.substr($string, 30, 2).'\\'.substr($string, 32, 2).'\\'.substr($string, 34, 2);
+
+ return $hex;
+ }
+
+ /**
+ * Round a Windows timestamp down to seconds and remove
+ * the seconds between 1601-01-01 and 1970-01-01.
+ *
+ * @param int $windowsTime
+ * @return int
+ */
+ public static function convertWindowsTimeToUnixTime($windowsTime)
+ {
+ return (int) (round($windowsTime / 10000000) - 11644473600);
+ }
+
+ /**
+ * Convert a Unix timestamp to Windows timestamp.
+ *
+ * @param int $unixTime
+ * @return int
+ */
+ public static function convertUnixTimeToWindowsTime($unixTime)
+ {
+ return ($unixTime + 11644473600) * 10000000;
+ }
+
+ /**
+ * Validates that the inserted string is an object SID.
+ *
+ * @param string $sid
+ * @return bool
+ */
+ public static function isValidSid($sid)
+ {
+ return (bool) preg_match("/^S-\d(-\d{1,10}){1,16}$/i", (string) $sid);
+ }
+
+ /**
+ * Validates that the inserted string is an object GUID.
+ *
+ * @param string $guid
+ * @return bool
+ */
+ public static function isValidGuid($guid)
+ {
+ return (bool) preg_match('/^([0-9a-fA-F]){8}(-([0-9a-fA-F]){4}){3}-([0-9a-fA-F]){12}$/', (string) $guid);
+ }
+}
diff --git a/data/web/inc/lib/vendor/illuminate/collections/ItemNotFoundException.php b/data/web/inc/lib/vendor/illuminate/collections/ItemNotFoundException.php
deleted file mode 100644
index 05a51d954..000000000
--- a/data/web/inc/lib/vendor/illuminate/collections/ItemNotFoundException.php
+++ /dev/null
@@ -1,9 +0,0 @@
-count = $count;
-
- parent::__construct("$count items were found.", $code, $previous);
- }
-
- /**
- * Get the number of items found.
- *
- * @return int
- */
- public function getCount()
- {
- return $this->count;
- }
-}
diff --git a/data/web/inc/lib/vendor/illuminate/collections/composer.json b/data/web/inc/lib/vendor/illuminate/collections/composer.json
deleted file mode 100644
index 5e11a788e..000000000
--- a/data/web/inc/lib/vendor/illuminate/collections/composer.json
+++ /dev/null
@@ -1,42 +0,0 @@
-{
- "name": "illuminate/collections",
- "description": "The Illuminate Collections package.",
- "license": "MIT",
- "homepage": "https://laravel.com",
- "support": {
- "issues": "https://github.com/laravel/framework/issues",
- "source": "https://github.com/laravel/framework"
- },
- "authors": [
- {
- "name": "Taylor Otwell",
- "email": "taylor@laravel.com"
- }
- ],
- "require": {
- "php": "^8.1",
- "illuminate/conditionable": "^10.0",
- "illuminate/contracts": "^10.0",
- "illuminate/macroable": "^10.0"
- },
- "autoload": {
- "psr-4": {
- "Illuminate\\Support\\": ""
- },
- "files": [
- "helpers.php"
- ]
- },
- "extra": {
- "branch-alias": {
- "dev-master": "10.x-dev"
- }
- },
- "suggest": {
- "symfony/var-dumper": "Required to use the dump method (^6.2)."
- },
- "config": {
- "sort-packages": true
- },
- "minimum-stability": "dev"
-}
diff --git a/data/web/inc/lib/vendor/illuminate/collections/functions.php b/data/web/inc/lib/vendor/illuminate/collections/functions.php
deleted file mode 100644
index 6ccd9b3ed..000000000
--- a/data/web/inc/lib/vendor/illuminate/collections/functions.php
+++ /dev/null
@@ -1,27 +0,0 @@
- $value->value,
- $value instanceof \UnitEnum => $value->name,
-
- default => $value ?? value($default),
- };
- }
-}
diff --git a/data/web/inc/lib/vendor/illuminate/collections/helpers.php b/data/web/inc/lib/vendor/illuminate/collections/helpers.php
deleted file mode 100644
index 235edceb1..000000000
--- a/data/web/inc/lib/vendor/illuminate/collections/helpers.php
+++ /dev/null
@@ -1,226 +0,0 @@
-|iterable|null $value
- * @return \Illuminate\Support\Collection
- */
- function collect($value = [])
- {
- return new Collection($value);
- }
-}
-
-if (! function_exists('data_fill')) {
- /**
- * Fill in data where it's missing.
- *
- * @param mixed $target
- * @param string|array $key
- * @param mixed $value
- * @return mixed
- */
- function data_fill(&$target, $key, $value)
- {
- return data_set($target, $key, $value, false);
- }
-}
-
-if (! function_exists('data_get')) {
- /**
- * Get an item from an array or object using "dot" notation.
- *
- * @param mixed $target
- * @param string|array|int|null $key
- * @param mixed $default
- * @return mixed
- */
- function data_get($target, $key, $default = null)
- {
- if (is_null($key)) {
- return $target;
- }
-
- $key = is_array($key) ? $key : explode('.', $key);
-
- foreach ($key as $i => $segment) {
- unset($key[$i]);
-
- if (is_null($segment)) {
- return $target;
- }
-
- if ($segment === '*') {
- if ($target instanceof Collection) {
- $target = $target->all();
- } elseif (! is_iterable($target)) {
- return value($default);
- }
-
- $result = [];
-
- foreach ($target as $item) {
- $result[] = data_get($item, $key);
- }
-
- return in_array('*', $key) ? Arr::collapse($result) : $result;
- }
-
- if (Arr::accessible($target) && Arr::exists($target, $segment)) {
- $target = $target[$segment];
- } elseif (is_object($target) && isset($target->{$segment})) {
- $target = $target->{$segment};
- } else {
- return value($default);
- }
- }
-
- return $target;
- }
-}
-
-if (! function_exists('data_set')) {
- /**
- * Set an item on an array or object using dot notation.
- *
- * @param mixed $target
- * @param string|array $key
- * @param mixed $value
- * @param bool $overwrite
- * @return mixed
- */
- function data_set(&$target, $key, $value, $overwrite = true)
- {
- $segments = is_array($key) ? $key : explode('.', $key);
-
- if (($segment = array_shift($segments)) === '*') {
- if (! Arr::accessible($target)) {
- $target = [];
- }
-
- if ($segments) {
- foreach ($target as &$inner) {
- data_set($inner, $segments, $value, $overwrite);
- }
- } elseif ($overwrite) {
- foreach ($target as &$inner) {
- $inner = $value;
- }
- }
- } elseif (Arr::accessible($target)) {
- if ($segments) {
- if (! Arr::exists($target, $segment)) {
- $target[$segment] = [];
- }
-
- data_set($target[$segment], $segments, $value, $overwrite);
- } elseif ($overwrite || ! Arr::exists($target, $segment)) {
- $target[$segment] = $value;
- }
- } elseif (is_object($target)) {
- if ($segments) {
- if (! isset($target->{$segment})) {
- $target->{$segment} = [];
- }
-
- data_set($target->{$segment}, $segments, $value, $overwrite);
- } elseif ($overwrite || ! isset($target->{$segment})) {
- $target->{$segment} = $value;
- }
- } else {
- $target = [];
-
- if ($segments) {
- data_set($target[$segment], $segments, $value, $overwrite);
- } elseif ($overwrite) {
- $target[$segment] = $value;
- }
- }
-
- return $target;
- }
-}
-
-if (! function_exists('data_forget')) {
- /**
- * Remove / unset an item from an array or object using "dot" notation.
- *
- * @param mixed $target
- * @param string|array|int|null $key
- * @return mixed
- */
- function data_forget(&$target, $key)
- {
- $segments = is_array($key) ? $key : explode('.', $key);
-
- if (($segment = array_shift($segments)) === '*' && Arr::accessible($target)) {
- if ($segments) {
- foreach ($target as &$inner) {
- data_forget($inner, $segments);
- }
- }
- } elseif (Arr::accessible($target)) {
- if ($segments && Arr::exists($target, $segment)) {
- data_forget($target[$segment], $segments);
- } else {
- Arr::forget($target, $segment);
- }
- } elseif (is_object($target)) {
- if ($segments && isset($target->{$segment})) {
- data_forget($target->{$segment}, $segments);
- } elseif (isset($target->{$segment})) {
- unset($target->{$segment});
- }
- }
-
- return $target;
- }
-}
-
-if (! function_exists('head')) {
- /**
- * Get the first element of an array. Useful for method chaining.
- *
- * @param array $array
- * @return mixed
- */
- function head($array)
- {
- return reset($array);
- }
-}
-
-if (! function_exists('last')) {
- /**
- * Get the last element from an array.
- *
- * @param array $array
- * @return mixed
- */
- function last($array)
- {
- return end($array);
- }
-}
-
-if (! function_exists('value')) {
- /**
- * Return the default value of the given value.
- *
- * @param mixed $value
- * @param mixed ...$args
- * @return mixed
- */
- function value($value, ...$args)
- {
- return $value instanceof Closure ? $value(...$args) : $value;
- }
-}
diff --git a/data/web/inc/lib/vendor/illuminate/conditionable/LICENSE.md b/data/web/inc/lib/vendor/illuminate/conditionable/LICENSE.md
deleted file mode 100644
index 79810c848..000000000
--- a/data/web/inc/lib/vendor/illuminate/conditionable/LICENSE.md
+++ /dev/null
@@ -1,21 +0,0 @@
-The MIT License (MIT)
-
-Copyright (c) Taylor Otwell
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-THE SOFTWARE.
diff --git a/data/web/inc/lib/vendor/illuminate/conditionable/composer.json b/data/web/inc/lib/vendor/illuminate/conditionable/composer.json
deleted file mode 100644
index 40b080806..000000000
--- a/data/web/inc/lib/vendor/illuminate/conditionable/composer.json
+++ /dev/null
@@ -1,33 +0,0 @@
-{
- "name": "illuminate/conditionable",
- "description": "The Illuminate Conditionable package.",
- "license": "MIT",
- "homepage": "https://laravel.com",
- "support": {
- "issues": "https://github.com/laravel/framework/issues",
- "source": "https://github.com/laravel/framework"
- },
- "authors": [
- {
- "name": "Taylor Otwell",
- "email": "taylor@laravel.com"
- }
- ],
- "require": {
- "php": "^8.0.2"
- },
- "autoload": {
- "psr-4": {
- "Illuminate\\Support\\": ""
- }
- },
- "extra": {
- "branch-alias": {
- "dev-master": "10.x-dev"
- }
- },
- "config": {
- "sort-packages": true
- },
- "minimum-stability": "dev"
-}
diff --git a/data/web/inc/lib/vendor/illuminate/macroable/LICENSE.md b/data/web/inc/lib/vendor/illuminate/macroable/LICENSE.md
deleted file mode 100644
index 79810c848..000000000
--- a/data/web/inc/lib/vendor/illuminate/macroable/LICENSE.md
+++ /dev/null
@@ -1,21 +0,0 @@
-The MIT License (MIT)
-
-Copyright (c) Taylor Otwell
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-THE SOFTWARE.
diff --git a/data/web/inc/lib/vendor/illuminate/macroable/composer.json b/data/web/inc/lib/vendor/illuminate/macroable/composer.json
deleted file mode 100644
index 231d2333a..000000000
--- a/data/web/inc/lib/vendor/illuminate/macroable/composer.json
+++ /dev/null
@@ -1,33 +0,0 @@
-{
- "name": "illuminate/macroable",
- "description": "The Illuminate Macroable package.",
- "license": "MIT",
- "homepage": "https://laravel.com",
- "support": {
- "issues": "https://github.com/laravel/framework/issues",
- "source": "https://github.com/laravel/framework"
- },
- "authors": [
- {
- "name": "Taylor Otwell",
- "email": "taylor@laravel.com"
- }
- ],
- "require": {
- "php": "^8.1"
- },
- "autoload": {
- "psr-4": {
- "Illuminate\\Support\\": ""
- }
- },
- "extra": {
- "branch-alias": {
- "dev-master": "10.x-dev"
- }
- },
- "config": {
- "sort-packages": true
- },
- "minimum-stability": "dev"
-}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/CHANGELOG.md b/data/web/inc/lib/vendor/symfony/var-dumper/CHANGELOG.md
new file mode 100644
index 000000000..7481cff1a
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/CHANGELOG.md
@@ -0,0 +1,91 @@
+CHANGELOG
+=========
+
+6.4
+---
+
+ * Dump uninitialized properties
+
+6.3
+---
+
+ * Add caster for `WeakMap`
+ * Add support of named arguments to `dd()` and `dump()` to display the argument name
+ * Add support for `Relay\Relay`
+ * Add display of invisible characters
+
+6.2
+---
+
+ * Add support for `FFI\CData` and `FFI\CType`
+ * Deprecate calling `VarDumper::setHandler()` without arguments
+
+5.4
+---
+
+ * Add ability to style integer and double values independently
+ * Add casters for Symfony's UUIDs and ULIDs
+ * Add support for `Fiber`
+
+5.2.0
+-----
+
+ * added support for PHPUnit `--colors` option
+ * added `VAR_DUMPER_FORMAT=server` env var value support
+ * prevent replacing the handler when the `VAR_DUMPER_FORMAT` env var is set
+
+5.1.0
+-----
+
+ * added `RdKafka` support
+
+4.4.0
+-----
+
+ * added `VarDumperTestTrait::setUpVarDumper()` and `VarDumperTestTrait::tearDownVarDumper()`
+ to configure casters & flags to use in tests
+ * added `ImagineCaster` and infrastructure to dump images
+ * added the stamps of a message after it is dispatched in `TraceableMessageBus` and `MessengerDataCollector` collected data
+ * added `UuidCaster`
+ * made all casters final
+ * added support for the `NO_COLOR` env var (https://no-color.org/)
+
+4.3.0
+-----
+
+ * added `DsCaster` to support dumping the contents of data structures from the Ds extension
+
+4.2.0
+-----
+
+ * support selecting the format to use by setting the environment variable `VAR_DUMPER_FORMAT` to `html` or `cli`
+
+4.1.0
+-----
+
+ * added a `ServerDumper` to send serialized Data clones to a server
+ * added a `ServerDumpCommand` and `DumpServer` to run a server collecting
+ and displaying dumps on a single place with multiple formats support
+ * added `CliDescriptor` and `HtmlDescriptor` descriptors for `server:dump` CLI and HTML formats support
+
+4.0.0
+-----
+
+ * support for passing `\ReflectionClass` instances to the `Caster::castObject()`
+ method has been dropped, pass class names as strings instead
+ * the `Data::getRawData()` method has been removed
+ * the `VarDumperTestTrait::assertDumpEquals()` method expects a 3rd `$filter = 0`
+ argument and moves `$message = ''` argument at 4th position.
+ * the `VarDumperTestTrait::assertDumpMatchesFormat()` method expects a 3rd `$filter = 0`
+ argument and moves `$message = ''` argument at 4th position.
+
+3.4.0
+-----
+
+ * added `AbstractCloner::setMinDepth()` function to ensure minimum tree depth
+ * deprecated `MongoCaster`
+
+2.7.0
+-----
+
+ * deprecated `Cloner\Data::getLimitedClone()`. Use `withMaxDepth`, `withMaxItemsPerDepth` or `withRefHandles` instead.
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Caster/AmqpCaster.php b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/AmqpCaster.php
new file mode 100644
index 000000000..22026f46a
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/AmqpCaster.php
@@ -0,0 +1,227 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Caster;
+
+use Symfony\Component\VarDumper\Cloner\Stub;
+
+/**
+ * Casts Amqp related classes to array representation.
+ *
+ * @author Grégoire Pineau
+ *
+ * @final
+ */
+class AmqpCaster
+{
+ private const FLAGS = [
+ \AMQP_DURABLE => 'AMQP_DURABLE',
+ \AMQP_PASSIVE => 'AMQP_PASSIVE',
+ \AMQP_EXCLUSIVE => 'AMQP_EXCLUSIVE',
+ \AMQP_AUTODELETE => 'AMQP_AUTODELETE',
+ \AMQP_INTERNAL => 'AMQP_INTERNAL',
+ \AMQP_NOLOCAL => 'AMQP_NOLOCAL',
+ \AMQP_AUTOACK => 'AMQP_AUTOACK',
+ \AMQP_IFEMPTY => 'AMQP_IFEMPTY',
+ \AMQP_IFUNUSED => 'AMQP_IFUNUSED',
+ \AMQP_MANDATORY => 'AMQP_MANDATORY',
+ \AMQP_IMMEDIATE => 'AMQP_IMMEDIATE',
+ \AMQP_MULTIPLE => 'AMQP_MULTIPLE',
+ \AMQP_NOWAIT => 'AMQP_NOWAIT',
+ \AMQP_REQUEUE => 'AMQP_REQUEUE',
+ ];
+
+ private const EXCHANGE_TYPES = [
+ \AMQP_EX_TYPE_DIRECT => 'AMQP_EX_TYPE_DIRECT',
+ \AMQP_EX_TYPE_FANOUT => 'AMQP_EX_TYPE_FANOUT',
+ \AMQP_EX_TYPE_TOPIC => 'AMQP_EX_TYPE_TOPIC',
+ \AMQP_EX_TYPE_HEADERS => 'AMQP_EX_TYPE_HEADERS',
+ ];
+
+ /**
+ * @return array
+ */
+ public static function castConnection(\AMQPConnection $c, array $a, Stub $stub, bool $isNested)
+ {
+ $prefix = Caster::PREFIX_VIRTUAL;
+
+ $a += [
+ $prefix.'is_connected' => $c->isConnected(),
+ ];
+
+ // Recent version of the extension already expose private properties
+ if (isset($a["\x00AMQPConnection\x00login"])) {
+ return $a;
+ }
+
+ // BC layer in the amqp lib
+ if (method_exists($c, 'getReadTimeout')) {
+ $timeout = $c->getReadTimeout();
+ } else {
+ $timeout = $c->getTimeout();
+ }
+
+ $a += [
+ $prefix.'is_connected' => $c->isConnected(),
+ $prefix.'login' => $c->getLogin(),
+ $prefix.'password' => $c->getPassword(),
+ $prefix.'host' => $c->getHost(),
+ $prefix.'vhost' => $c->getVhost(),
+ $prefix.'port' => $c->getPort(),
+ $prefix.'read_timeout' => $timeout,
+ ];
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castChannel(\AMQPChannel $c, array $a, Stub $stub, bool $isNested)
+ {
+ $prefix = Caster::PREFIX_VIRTUAL;
+
+ $a += [
+ $prefix.'is_connected' => $c->isConnected(),
+ $prefix.'channel_id' => $c->getChannelId(),
+ ];
+
+ // Recent version of the extension already expose private properties
+ if (isset($a["\x00AMQPChannel\x00connection"])) {
+ return $a;
+ }
+
+ $a += [
+ $prefix.'connection' => $c->getConnection(),
+ $prefix.'prefetch_size' => $c->getPrefetchSize(),
+ $prefix.'prefetch_count' => $c->getPrefetchCount(),
+ ];
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castQueue(\AMQPQueue $c, array $a, Stub $stub, bool $isNested)
+ {
+ $prefix = Caster::PREFIX_VIRTUAL;
+
+ $a += [
+ $prefix.'flags' => self::extractFlags($c->getFlags()),
+ ];
+
+ // Recent version of the extension already expose private properties
+ if (isset($a["\x00AMQPQueue\x00name"])) {
+ return $a;
+ }
+
+ $a += [
+ $prefix.'connection' => $c->getConnection(),
+ $prefix.'channel' => $c->getChannel(),
+ $prefix.'name' => $c->getName(),
+ $prefix.'arguments' => $c->getArguments(),
+ ];
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castExchange(\AMQPExchange $c, array $a, Stub $stub, bool $isNested)
+ {
+ $prefix = Caster::PREFIX_VIRTUAL;
+
+ $a += [
+ $prefix.'flags' => self::extractFlags($c->getFlags()),
+ ];
+
+ $type = isset(self::EXCHANGE_TYPES[$c->getType()]) ? new ConstStub(self::EXCHANGE_TYPES[$c->getType()], $c->getType()) : $c->getType();
+
+ // Recent version of the extension already expose private properties
+ if (isset($a["\x00AMQPExchange\x00name"])) {
+ $a["\x00AMQPExchange\x00type"] = $type;
+
+ return $a;
+ }
+
+ $a += [
+ $prefix.'connection' => $c->getConnection(),
+ $prefix.'channel' => $c->getChannel(),
+ $prefix.'name' => $c->getName(),
+ $prefix.'type' => $type,
+ $prefix.'arguments' => $c->getArguments(),
+ ];
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castEnvelope(\AMQPEnvelope $c, array $a, Stub $stub, bool $isNested, int $filter = 0)
+ {
+ $prefix = Caster::PREFIX_VIRTUAL;
+
+ $deliveryMode = new ConstStub($c->getDeliveryMode().(2 === $c->getDeliveryMode() ? ' (persistent)' : ' (non-persistent)'), $c->getDeliveryMode());
+
+ // Recent version of the extension already expose private properties
+ if (isset($a["\x00AMQPEnvelope\x00body"])) {
+ $a["\0AMQPEnvelope\0delivery_mode"] = $deliveryMode;
+
+ return $a;
+ }
+
+ if (!($filter & Caster::EXCLUDE_VERBOSE)) {
+ $a += [$prefix.'body' => $c->getBody()];
+ }
+
+ $a += [
+ $prefix.'delivery_tag' => $c->getDeliveryTag(),
+ $prefix.'is_redelivery' => $c->isRedelivery(),
+ $prefix.'exchange_name' => $c->getExchangeName(),
+ $prefix.'routing_key' => $c->getRoutingKey(),
+ $prefix.'content_type' => $c->getContentType(),
+ $prefix.'content_encoding' => $c->getContentEncoding(),
+ $prefix.'headers' => $c->getHeaders(),
+ $prefix.'delivery_mode' => $deliveryMode,
+ $prefix.'priority' => $c->getPriority(),
+ $prefix.'correlation_id' => $c->getCorrelationId(),
+ $prefix.'reply_to' => $c->getReplyTo(),
+ $prefix.'expiration' => $c->getExpiration(),
+ $prefix.'message_id' => $c->getMessageId(),
+ $prefix.'timestamp' => $c->getTimeStamp(),
+ $prefix.'type' => $c->getType(),
+ $prefix.'user_id' => $c->getUserId(),
+ $prefix.'app_id' => $c->getAppId(),
+ ];
+
+ return $a;
+ }
+
+ private static function extractFlags(int $flags): ConstStub
+ {
+ $flagsArray = [];
+
+ foreach (self::FLAGS as $value => $name) {
+ if ($flags & $value) {
+ $flagsArray[] = $name;
+ }
+ }
+
+ if (!$flagsArray) {
+ $flagsArray = ['AMQP_NOPARAM'];
+ }
+
+ return new ConstStub(implode('|', $flagsArray), $flags);
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Caster/ArgsStub.php b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/ArgsStub.php
new file mode 100644
index 000000000..9dc24c1b1
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/ArgsStub.php
@@ -0,0 +1,80 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Caster;
+
+use Symfony\Component\VarDumper\Cloner\Stub;
+
+/**
+ * Represents a list of function arguments.
+ *
+ * @author Nicolas Grekas
+ */
+class ArgsStub extends EnumStub
+{
+ private static array $parameters = [];
+
+ public function __construct(array $args, string $function, ?string $class)
+ {
+ [$variadic, $params] = self::getParameters($function, $class);
+
+ $values = [];
+ foreach ($args as $k => $v) {
+ $values[$k] = !\is_scalar($v) && !$v instanceof Stub ? new CutStub($v) : $v;
+ }
+ if (null === $params) {
+ parent::__construct($values, false);
+
+ return;
+ }
+ if (\count($values) < \count($params)) {
+ $params = \array_slice($params, 0, \count($values));
+ } elseif (\count($values) > \count($params)) {
+ $values[] = new EnumStub(array_splice($values, \count($params)), false);
+ $params[] = $variadic;
+ }
+ if (['...'] === $params) {
+ $this->dumpKeys = false;
+ $this->value = $values[0]->value;
+ } else {
+ $this->value = array_combine($params, $values);
+ }
+ }
+
+ private static function getParameters(string $function, ?string $class): array
+ {
+ if (isset(self::$parameters[$k = $class.'::'.$function])) {
+ return self::$parameters[$k];
+ }
+
+ try {
+ $r = null !== $class ? new \ReflectionMethod($class, $function) : new \ReflectionFunction($function);
+ } catch (\ReflectionException) {
+ return [null, null];
+ }
+
+ $variadic = '...';
+ $params = [];
+ foreach ($r->getParameters() as $v) {
+ $k = '$'.$v->name;
+ if ($v->isPassedByReference()) {
+ $k = '&'.$k;
+ }
+ if ($v->isVariadic()) {
+ $variadic .= $k;
+ } else {
+ $params[] = $k;
+ }
+ }
+
+ return self::$parameters[$k] = [$variadic, $params];
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Caster/Caster.php b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/Caster.php
new file mode 100644
index 000000000..d9577e7ae
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/Caster.php
@@ -0,0 +1,198 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Caster;
+
+use Symfony\Component\VarDumper\Cloner\Stub;
+
+/**
+ * Helper for filtering out properties in casters.
+ *
+ * @author Nicolas Grekas
+ *
+ * @final
+ */
+class Caster
+{
+ public const EXCLUDE_VERBOSE = 1;
+ public const EXCLUDE_VIRTUAL = 2;
+ public const EXCLUDE_DYNAMIC = 4;
+ public const EXCLUDE_PUBLIC = 8;
+ public const EXCLUDE_PROTECTED = 16;
+ public const EXCLUDE_PRIVATE = 32;
+ public const EXCLUDE_NULL = 64;
+ public const EXCLUDE_EMPTY = 128;
+ public const EXCLUDE_NOT_IMPORTANT = 256;
+ public const EXCLUDE_STRICT = 512;
+ public const EXCLUDE_UNINITIALIZED = 1024;
+
+ public const PREFIX_VIRTUAL = "\0~\0";
+ public const PREFIX_DYNAMIC = "\0+\0";
+ public const PREFIX_PROTECTED = "\0*\0";
+ // usage: sprintf(Caster::PATTERN_PRIVATE, $class, $property)
+ public const PATTERN_PRIVATE = "\0%s\0%s";
+
+ private static array $classProperties = [];
+
+ /**
+ * Casts objects to arrays and adds the dynamic property prefix.
+ *
+ * @param bool $hasDebugInfo Whether the __debugInfo method exists on $obj or not
+ */
+ public static function castObject(object $obj, string $class, bool $hasDebugInfo = false, ?string $debugClass = null): array
+ {
+ if ($hasDebugInfo) {
+ try {
+ $debugInfo = $obj->__debugInfo();
+ } catch (\Throwable) {
+ // ignore failing __debugInfo()
+ $hasDebugInfo = false;
+ }
+ }
+
+ $a = $obj instanceof \Closure ? [] : (array) $obj;
+
+ if ($obj instanceof \__PHP_Incomplete_Class) {
+ return $a;
+ }
+
+ $classProperties = self::$classProperties[$class] ??= self::getClassProperties(new \ReflectionClass($class));
+ $a = array_replace($classProperties, $a);
+
+ if ($a) {
+ $debugClass ??= get_debug_type($obj);
+
+ $i = 0;
+ $prefixedKeys = [];
+ foreach ($a as $k => $v) {
+ if ("\0" !== ($k[0] ?? '')) {
+ if (!isset($classProperties[$k])) {
+ $prefixedKeys[$i] = self::PREFIX_DYNAMIC.$k;
+ }
+ } elseif ($debugClass !== $class && 1 === strpos($k, $class)) {
+ $prefixedKeys[$i] = "\0".$debugClass.strrchr($k, "\0");
+ }
+ ++$i;
+ }
+ if ($prefixedKeys) {
+ $keys = array_keys($a);
+ foreach ($prefixedKeys as $i => $k) {
+ $keys[$i] = $k;
+ }
+ $a = array_combine($keys, $a);
+ }
+ }
+
+ if ($hasDebugInfo && \is_array($debugInfo)) {
+ foreach ($debugInfo as $k => $v) {
+ if (!isset($k[0]) || "\0" !== $k[0]) {
+ if (\array_key_exists(self::PREFIX_DYNAMIC.$k, $a)) {
+ continue;
+ }
+ $k = self::PREFIX_VIRTUAL.$k;
+ }
+
+ unset($a[$k]);
+ $a[$k] = $v;
+ }
+ }
+
+ return $a;
+ }
+
+ /**
+ * Filters out the specified properties.
+ *
+ * By default, a single match in the $filter bit field filters properties out, following an "or" logic.
+ * When EXCLUDE_STRICT is set, an "and" logic is applied: all bits must match for a property to be removed.
+ *
+ * @param array $a The array containing the properties to filter
+ * @param int $filter A bit field of Caster::EXCLUDE_* constants specifying which properties to filter out
+ * @param string[] $listedProperties List of properties to exclude when Caster::EXCLUDE_VERBOSE is set, and to preserve when Caster::EXCLUDE_NOT_IMPORTANT is set
+ * @param int|null &$count Set to the number of removed properties
+ */
+ public static function filter(array $a, int $filter, array $listedProperties = [], ?int &$count = 0): array
+ {
+ $count = 0;
+
+ foreach ($a as $k => $v) {
+ $type = self::EXCLUDE_STRICT & $filter;
+
+ if (null === $v) {
+ $type |= self::EXCLUDE_NULL & $filter;
+ $type |= self::EXCLUDE_EMPTY & $filter;
+ } elseif (false === $v || '' === $v || '0' === $v || 0 === $v || 0.0 === $v || [] === $v) {
+ $type |= self::EXCLUDE_EMPTY & $filter;
+ } elseif ($v instanceof UninitializedStub) {
+ $type |= self::EXCLUDE_UNINITIALIZED & $filter;
+ }
+ if ((self::EXCLUDE_NOT_IMPORTANT & $filter) && !\in_array($k, $listedProperties, true)) {
+ $type |= self::EXCLUDE_NOT_IMPORTANT;
+ }
+ if ((self::EXCLUDE_VERBOSE & $filter) && \in_array($k, $listedProperties, true)) {
+ $type |= self::EXCLUDE_VERBOSE;
+ }
+
+ if (!isset($k[1]) || "\0" !== $k[0]) {
+ $type |= self::EXCLUDE_PUBLIC & $filter;
+ } elseif ('~' === $k[1]) {
+ $type |= self::EXCLUDE_VIRTUAL & $filter;
+ } elseif ('+' === $k[1]) {
+ $type |= self::EXCLUDE_DYNAMIC & $filter;
+ } elseif ('*' === $k[1]) {
+ $type |= self::EXCLUDE_PROTECTED & $filter;
+ } else {
+ $type |= self::EXCLUDE_PRIVATE & $filter;
+ }
+
+ if ((self::EXCLUDE_STRICT & $filter) ? $type === $filter : $type) {
+ unset($a[$k]);
+ ++$count;
+ }
+ }
+
+ return $a;
+ }
+
+ public static function castPhpIncompleteClass(\__PHP_Incomplete_Class $c, array $a, Stub $stub, bool $isNested): array
+ {
+ if (isset($a['__PHP_Incomplete_Class_Name'])) {
+ $stub->class .= '('.$a['__PHP_Incomplete_Class_Name'].')';
+ unset($a['__PHP_Incomplete_Class_Name']);
+ }
+
+ return $a;
+ }
+
+ private static function getClassProperties(\ReflectionClass $class): array
+ {
+ $classProperties = [];
+ $className = $class->name;
+
+ if ($parent = $class->getParentClass()) {
+ $classProperties += self::$classProperties[$parent->name] ??= self::getClassProperties($parent);
+ }
+
+ foreach ($class->getProperties() as $p) {
+ if ($p->isStatic()) {
+ continue;
+ }
+
+ $classProperties[match (true) {
+ $p->isPublic() => $p->name,
+ $p->isProtected() => self::PREFIX_PROTECTED.$p->name,
+ default => "\0".$className."\0".$p->name,
+ }] = new UninitializedStub($p);
+ }
+
+ return $classProperties;
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Caster/ClassStub.php b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/ClassStub.php
new file mode 100644
index 000000000..914728663
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/ClassStub.php
@@ -0,0 +1,107 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Caster;
+
+use Symfony\Component\VarDumper\Cloner\Stub;
+
+/**
+ * Represents a PHP class identifier.
+ *
+ * @author Nicolas Grekas
+ */
+class ClassStub extends ConstStub
+{
+ /**
+ * @param string $identifier A PHP identifier, e.g. a class, method, interface, etc. name
+ * @param callable $callable The callable targeted by the identifier when it is ambiguous or not a real PHP identifier
+ */
+ public function __construct(string $identifier, callable|array|string|null $callable = null)
+ {
+ $this->value = $identifier;
+
+ try {
+ if (null !== $callable) {
+ if ($callable instanceof \Closure) {
+ $r = new \ReflectionFunction($callable);
+ } elseif (\is_object($callable)) {
+ $r = [$callable, '__invoke'];
+ } elseif (\is_array($callable)) {
+ $r = $callable;
+ } elseif (false !== $i = strpos($callable, '::')) {
+ $r = [substr($callable, 0, $i), substr($callable, 2 + $i)];
+ } else {
+ $r = new \ReflectionFunction($callable);
+ }
+ } elseif (0 < $i = strpos($identifier, '::') ?: strpos($identifier, '->')) {
+ $r = [substr($identifier, 0, $i), substr($identifier, 2 + $i)];
+ } else {
+ $r = new \ReflectionClass($identifier);
+ }
+
+ if (\is_array($r)) {
+ try {
+ $r = new \ReflectionMethod($r[0], $r[1]);
+ } catch (\ReflectionException) {
+ $r = new \ReflectionClass($r[0]);
+ }
+ }
+
+ if (str_contains($identifier, "@anonymous\0")) {
+ $this->value = $identifier = preg_replace_callback('/[a-zA-Z_\x7f-\xff][\\\\a-zA-Z0-9_\x7f-\xff]*+@anonymous\x00.*?\.php(?:0x?|:[0-9]++\$)[0-9a-fA-F]++/', fn ($m) => class_exists($m[0], false) ? (get_parent_class($m[0]) ?: key(class_implements($m[0])) ?: 'class').'@anonymous' : $m[0], $identifier);
+ }
+
+ if (null !== $callable && $r instanceof \ReflectionFunctionAbstract) {
+ $s = ReflectionCaster::castFunctionAbstract($r, [], new Stub(), true, Caster::EXCLUDE_VERBOSE);
+ $s = ReflectionCaster::getSignature($s);
+
+ if (str_ends_with($identifier, '()')) {
+ $this->value = substr_replace($identifier, $s, -2);
+ } else {
+ $this->value .= $s;
+ }
+ }
+ } catch (\ReflectionException) {
+ return;
+ } finally {
+ if (0 < $i = strrpos($this->value, '\\')) {
+ $this->attr['ellipsis'] = \strlen($this->value) - $i;
+ $this->attr['ellipsis-type'] = 'class';
+ $this->attr['ellipsis-tail'] = 1;
+ }
+ }
+
+ if ($f = $r->getFileName()) {
+ $this->attr['file'] = $f;
+ $this->attr['line'] = $r->getStartLine();
+ }
+ }
+
+ /**
+ * @return mixed
+ */
+ public static function wrapCallable(mixed $callable)
+ {
+ if (\is_object($callable) || !\is_callable($callable)) {
+ return $callable;
+ }
+
+ if (!\is_array($callable)) {
+ $callable = new static($callable, $callable);
+ } elseif (\is_string($callable[0])) {
+ $callable[0] = new static($callable[0], $callable);
+ } else {
+ $callable[1] = new static($callable[1], $callable);
+ }
+
+ return $callable;
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Caster/ConstStub.php b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/ConstStub.php
new file mode 100644
index 000000000..587c6c398
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/ConstStub.php
@@ -0,0 +1,33 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Caster;
+
+use Symfony\Component\VarDumper\Cloner\Stub;
+
+/**
+ * Represents a PHP constant and its value.
+ *
+ * @author Nicolas Grekas
+ */
+class ConstStub extends Stub
+{
+ public function __construct(string $name, string|int|float|null $value = null)
+ {
+ $this->class = $name;
+ $this->value = 1 < \func_num_args() ? $value : $name;
+ }
+
+ public function __toString(): string
+ {
+ return (string) $this->value;
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Caster/CutArrayStub.php b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/CutArrayStub.php
new file mode 100644
index 000000000..0e4fb363d
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/CutArrayStub.php
@@ -0,0 +1,30 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Caster;
+
+/**
+ * Represents a cut array.
+ *
+ * @author Nicolas Grekas
+ */
+class CutArrayStub extends CutStub
+{
+ public $preservedSubset;
+
+ public function __construct(array $value, array $preservedKeys)
+ {
+ parent::__construct($value);
+
+ $this->preservedSubset = array_intersect_key($value, array_flip($preservedKeys));
+ $this->cut -= \count($this->preservedSubset);
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Caster/CutStub.php b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/CutStub.php
new file mode 100644
index 000000000..772399ef6
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/CutStub.php
@@ -0,0 +1,64 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Caster;
+
+use Symfony\Component\VarDumper\Cloner\Stub;
+
+/**
+ * Represents the main properties of a PHP variable, pre-casted by a caster.
+ *
+ * @author Nicolas Grekas
+ */
+class CutStub extends Stub
+{
+ public function __construct(mixed $value)
+ {
+ $this->value = $value;
+
+ switch (\gettype($value)) {
+ case 'object':
+ $this->type = self::TYPE_OBJECT;
+ $this->class = $value::class;
+
+ if ($value instanceof \Closure) {
+ ReflectionCaster::castClosure($value, [], $this, true, Caster::EXCLUDE_VERBOSE);
+ }
+
+ $this->cut = -1;
+ break;
+
+ case 'array':
+ $this->type = self::TYPE_ARRAY;
+ $this->class = self::ARRAY_ASSOC;
+ $this->cut = $this->value = \count($value);
+ break;
+
+ case 'resource':
+ case 'unknown type':
+ case 'resource (closed)':
+ $this->type = self::TYPE_RESOURCE;
+ $this->handle = (int) $value;
+ if ('Unknown' === $this->class = @get_resource_type($value)) {
+ $this->class = 'Closed';
+ }
+ $this->cut = -1;
+ break;
+
+ case 'string':
+ $this->type = self::TYPE_STRING;
+ $this->class = preg_match('//u', $value) ? self::STRING_UTF8 : self::STRING_BINARY;
+ $this->cut = self::STRING_BINARY === $this->class ? \strlen($value) : mb_strlen($value, 'UTF-8');
+ $this->value = '';
+ break;
+ }
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Caster/DOMCaster.php b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/DOMCaster.php
new file mode 100644
index 000000000..d2d3fc129
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/DOMCaster.php
@@ -0,0 +1,312 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Caster;
+
+use Symfony\Component\VarDumper\Cloner\Stub;
+
+/**
+ * Casts DOM related classes to array representation.
+ *
+ * @author Nicolas Grekas
+ *
+ * @final
+ */
+class DOMCaster
+{
+ private const ERROR_CODES = [
+ \DOM_PHP_ERR => 'DOM_PHP_ERR',
+ \DOM_INDEX_SIZE_ERR => 'DOM_INDEX_SIZE_ERR',
+ \DOMSTRING_SIZE_ERR => 'DOMSTRING_SIZE_ERR',
+ \DOM_HIERARCHY_REQUEST_ERR => 'DOM_HIERARCHY_REQUEST_ERR',
+ \DOM_WRONG_DOCUMENT_ERR => 'DOM_WRONG_DOCUMENT_ERR',
+ \DOM_INVALID_CHARACTER_ERR => 'DOM_INVALID_CHARACTER_ERR',
+ \DOM_NO_DATA_ALLOWED_ERR => 'DOM_NO_DATA_ALLOWED_ERR',
+ \DOM_NO_MODIFICATION_ALLOWED_ERR => 'DOM_NO_MODIFICATION_ALLOWED_ERR',
+ \DOM_NOT_FOUND_ERR => 'DOM_NOT_FOUND_ERR',
+ \DOM_NOT_SUPPORTED_ERR => 'DOM_NOT_SUPPORTED_ERR',
+ \DOM_INUSE_ATTRIBUTE_ERR => 'DOM_INUSE_ATTRIBUTE_ERR',
+ \DOM_INVALID_STATE_ERR => 'DOM_INVALID_STATE_ERR',
+ \DOM_SYNTAX_ERR => 'DOM_SYNTAX_ERR',
+ \DOM_INVALID_MODIFICATION_ERR => 'DOM_INVALID_MODIFICATION_ERR',
+ \DOM_NAMESPACE_ERR => 'DOM_NAMESPACE_ERR',
+ \DOM_INVALID_ACCESS_ERR => 'DOM_INVALID_ACCESS_ERR',
+ \DOM_VALIDATION_ERR => 'DOM_VALIDATION_ERR',
+ ];
+
+ private const NODE_TYPES = [
+ \XML_ELEMENT_NODE => 'XML_ELEMENT_NODE',
+ \XML_ATTRIBUTE_NODE => 'XML_ATTRIBUTE_NODE',
+ \XML_TEXT_NODE => 'XML_TEXT_NODE',
+ \XML_CDATA_SECTION_NODE => 'XML_CDATA_SECTION_NODE',
+ \XML_ENTITY_REF_NODE => 'XML_ENTITY_REF_NODE',
+ \XML_ENTITY_NODE => 'XML_ENTITY_NODE',
+ \XML_PI_NODE => 'XML_PI_NODE',
+ \XML_COMMENT_NODE => 'XML_COMMENT_NODE',
+ \XML_DOCUMENT_NODE => 'XML_DOCUMENT_NODE',
+ \XML_DOCUMENT_TYPE_NODE => 'XML_DOCUMENT_TYPE_NODE',
+ \XML_DOCUMENT_FRAG_NODE => 'XML_DOCUMENT_FRAG_NODE',
+ \XML_NOTATION_NODE => 'XML_NOTATION_NODE',
+ \XML_HTML_DOCUMENT_NODE => 'XML_HTML_DOCUMENT_NODE',
+ \XML_DTD_NODE => 'XML_DTD_NODE',
+ \XML_ELEMENT_DECL_NODE => 'XML_ELEMENT_DECL_NODE',
+ \XML_ATTRIBUTE_DECL_NODE => 'XML_ATTRIBUTE_DECL_NODE',
+ \XML_ENTITY_DECL_NODE => 'XML_ENTITY_DECL_NODE',
+ \XML_NAMESPACE_DECL_NODE => 'XML_NAMESPACE_DECL_NODE',
+ ];
+
+ /**
+ * @return array
+ */
+ public static function castException(\DOMException $e, array $a, Stub $stub, bool $isNested)
+ {
+ $k = Caster::PREFIX_PROTECTED.'code';
+ if (isset($a[$k], self::ERROR_CODES[$a[$k]])) {
+ $a[$k] = new ConstStub(self::ERROR_CODES[$a[$k]], $a[$k]);
+ }
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castLength($dom, array $a, Stub $stub, bool $isNested)
+ {
+ $a += [
+ 'length' => $dom->length,
+ ];
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castImplementation(\DOMImplementation $dom, array $a, Stub $stub, bool $isNested)
+ {
+ $a += [
+ Caster::PREFIX_VIRTUAL.'Core' => '1.0',
+ Caster::PREFIX_VIRTUAL.'XML' => '2.0',
+ ];
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castNode(\DOMNode $dom, array $a, Stub $stub, bool $isNested)
+ {
+ $a += [
+ 'nodeName' => $dom->nodeName,
+ 'nodeValue' => new CutStub($dom->nodeValue),
+ 'nodeType' => new ConstStub(self::NODE_TYPES[$dom->nodeType], $dom->nodeType),
+ 'parentNode' => new CutStub($dom->parentNode),
+ 'childNodes' => $dom->childNodes,
+ 'firstChild' => new CutStub($dom->firstChild),
+ 'lastChild' => new CutStub($dom->lastChild),
+ 'previousSibling' => new CutStub($dom->previousSibling),
+ 'nextSibling' => new CutStub($dom->nextSibling),
+ 'attributes' => $dom->attributes,
+ 'ownerDocument' => new CutStub($dom->ownerDocument),
+ 'namespaceURI' => $dom->namespaceURI,
+ 'prefix' => $dom->prefix,
+ 'localName' => $dom->localName,
+ 'baseURI' => $dom->baseURI ? new LinkStub($dom->baseURI) : $dom->baseURI,
+ 'textContent' => new CutStub($dom->textContent),
+ ];
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castNameSpaceNode(\DOMNameSpaceNode $dom, array $a, Stub $stub, bool $isNested)
+ {
+ $a += [
+ 'nodeName' => $dom->nodeName,
+ 'nodeValue' => new CutStub($dom->nodeValue),
+ 'nodeType' => new ConstStub(self::NODE_TYPES[$dom->nodeType], $dom->nodeType),
+ 'prefix' => $dom->prefix,
+ 'localName' => $dom->localName,
+ 'namespaceURI' => $dom->namespaceURI,
+ 'ownerDocument' => new CutStub($dom->ownerDocument),
+ 'parentNode' => new CutStub($dom->parentNode),
+ ];
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castDocument(\DOMDocument $dom, array $a, Stub $stub, bool $isNested, int $filter = 0)
+ {
+ $a += [
+ 'doctype' => $dom->doctype,
+ 'implementation' => $dom->implementation,
+ 'documentElement' => new CutStub($dom->documentElement),
+ 'actualEncoding' => $dom->actualEncoding,
+ 'encoding' => $dom->encoding,
+ 'xmlEncoding' => $dom->xmlEncoding,
+ 'standalone' => $dom->standalone,
+ 'xmlStandalone' => $dom->xmlStandalone,
+ 'version' => $dom->version,
+ 'xmlVersion' => $dom->xmlVersion,
+ 'strictErrorChecking' => $dom->strictErrorChecking,
+ 'documentURI' => $dom->documentURI ? new LinkStub($dom->documentURI) : $dom->documentURI,
+ 'config' => $dom->config,
+ 'formatOutput' => $dom->formatOutput,
+ 'validateOnParse' => $dom->validateOnParse,
+ 'resolveExternals' => $dom->resolveExternals,
+ 'preserveWhiteSpace' => $dom->preserveWhiteSpace,
+ 'recover' => $dom->recover,
+ 'substituteEntities' => $dom->substituteEntities,
+ ];
+
+ if (!($filter & Caster::EXCLUDE_VERBOSE)) {
+ $formatOutput = $dom->formatOutput;
+ $dom->formatOutput = true;
+ $a += [Caster::PREFIX_VIRTUAL.'xml' => $dom->saveXML()];
+ $dom->formatOutput = $formatOutput;
+ }
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castCharacterData(\DOMCharacterData $dom, array $a, Stub $stub, bool $isNested)
+ {
+ $a += [
+ 'data' => $dom->data,
+ 'length' => $dom->length,
+ ];
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castAttr(\DOMAttr $dom, array $a, Stub $stub, bool $isNested)
+ {
+ $a += [
+ 'name' => $dom->name,
+ 'specified' => $dom->specified,
+ 'value' => $dom->value,
+ 'ownerElement' => $dom->ownerElement,
+ 'schemaTypeInfo' => $dom->schemaTypeInfo,
+ ];
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castElement(\DOMElement $dom, array $a, Stub $stub, bool $isNested)
+ {
+ $a += [
+ 'tagName' => $dom->tagName,
+ 'schemaTypeInfo' => $dom->schemaTypeInfo,
+ ];
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castText(\DOMText $dom, array $a, Stub $stub, bool $isNested)
+ {
+ $a += [
+ 'wholeText' => $dom->wholeText,
+ ];
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castDocumentType(\DOMDocumentType $dom, array $a, Stub $stub, bool $isNested)
+ {
+ $a += [
+ 'name' => $dom->name,
+ 'entities' => $dom->entities,
+ 'notations' => $dom->notations,
+ 'publicId' => $dom->publicId,
+ 'systemId' => $dom->systemId,
+ 'internalSubset' => $dom->internalSubset,
+ ];
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castNotation(\DOMNotation $dom, array $a, Stub $stub, bool $isNested)
+ {
+ $a += [
+ 'publicId' => $dom->publicId,
+ 'systemId' => $dom->systemId,
+ ];
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castEntity(\DOMEntity $dom, array $a, Stub $stub, bool $isNested)
+ {
+ $a += [
+ 'publicId' => $dom->publicId,
+ 'systemId' => $dom->systemId,
+ 'notationName' => $dom->notationName,
+ 'actualEncoding' => $dom->actualEncoding,
+ 'encoding' => $dom->encoding,
+ 'version' => $dom->version,
+ ];
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castProcessingInstruction(\DOMProcessingInstruction $dom, array $a, Stub $stub, bool $isNested)
+ {
+ $a += [
+ 'target' => $dom->target,
+ 'data' => $dom->data,
+ ];
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castXPath(\DOMXPath $dom, array $a, Stub $stub, bool $isNested)
+ {
+ $a += [
+ 'document' => $dom->document,
+ ];
+
+ return $a;
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Caster/DateCaster.php b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/DateCaster.php
new file mode 100644
index 000000000..a0cbddb76
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/DateCaster.php
@@ -0,0 +1,139 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Caster;
+
+use Symfony\Component\VarDumper\Cloner\Stub;
+
+/**
+ * Casts DateTimeInterface related classes to array representation.
+ *
+ * @author Dany Maillard
+ *
+ * @final
+ */
+class DateCaster
+{
+ private const PERIOD_LIMIT = 3;
+
+ /**
+ * @return array
+ */
+ public static function castDateTime(\DateTimeInterface $d, array $a, Stub $stub, bool $isNested, int $filter)
+ {
+ $prefix = Caster::PREFIX_VIRTUAL;
+ $location = $d->getTimezone() ? $d->getTimezone()->getLocation() : null;
+ $fromNow = (new \DateTimeImmutable())->diff($d);
+
+ $title = $d->format('l, F j, Y')
+ ."\n".self::formatInterval($fromNow).' from now'
+ .($location ? ($d->format('I') ? "\nDST On" : "\nDST Off") : '')
+ ;
+
+ unset(
+ $a[Caster::PREFIX_DYNAMIC.'date'],
+ $a[Caster::PREFIX_DYNAMIC.'timezone'],
+ $a[Caster::PREFIX_DYNAMIC.'timezone_type']
+ );
+ $a[$prefix.'date'] = new ConstStub(self::formatDateTime($d, $location ? ' e (P)' : ' P'), $title);
+
+ $stub->class .= $d->format(' @U');
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castInterval(\DateInterval $interval, array $a, Stub $stub, bool $isNested, int $filter)
+ {
+ $now = new \DateTimeImmutable('@0', new \DateTimeZone('UTC'));
+ $numberOfSeconds = $now->add($interval)->getTimestamp() - $now->getTimestamp();
+ $title = number_format($numberOfSeconds, 0, '.', ' ').'s';
+
+ $i = [Caster::PREFIX_VIRTUAL.'interval' => new ConstStub(self::formatInterval($interval), $title)];
+
+ return $filter & Caster::EXCLUDE_VERBOSE ? $i : $i + $a;
+ }
+
+ private static function formatInterval(\DateInterval $i): string
+ {
+ $format = '%R ';
+
+ if (0 === $i->y && 0 === $i->m && ($i->h >= 24 || $i->i >= 60 || $i->s >= 60)) {
+ $d = new \DateTimeImmutable('@0', new \DateTimeZone('UTC'));
+ $i = $d->diff($d->add($i)); // recalculate carry over points
+ $format .= 0 < $i->days ? '%ad ' : '';
+ } else {
+ $format .= ($i->y ? '%yy ' : '').($i->m ? '%mm ' : '').($i->d ? '%dd ' : '');
+ }
+
+ $format .= $i->h || $i->i || $i->s || $i->f ? '%H:%I:'.self::formatSeconds($i->s, substr($i->f, 2)) : '';
+ $format = '%R ' === $format ? '0s' : $format;
+
+ return $i->format(rtrim($format));
+ }
+
+ /**
+ * @return array
+ */
+ public static function castTimeZone(\DateTimeZone $timeZone, array $a, Stub $stub, bool $isNested, int $filter)
+ {
+ $location = $timeZone->getLocation();
+ $formatted = (new \DateTimeImmutable('now', $timeZone))->format($location ? 'e (P)' : 'P');
+ $title = $location && \extension_loaded('intl') ? \Locale::getDisplayRegion('-'.$location['country_code']) : '';
+
+ $z = [Caster::PREFIX_VIRTUAL.'timezone' => new ConstStub($formatted, $title)];
+
+ return $filter & Caster::EXCLUDE_VERBOSE ? $z : $z + $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castPeriod(\DatePeriod $p, array $a, Stub $stub, bool $isNested, int $filter)
+ {
+ $dates = [];
+ foreach (clone $p as $i => $d) {
+ if (self::PERIOD_LIMIT === $i) {
+ $now = new \DateTimeImmutable('now', new \DateTimeZone('UTC'));
+ $dates[] = sprintf('%s more', ($end = $p->getEndDate())
+ ? ceil(($end->format('U.u') - $d->format('U.u')) / ((int) $now->add($p->getDateInterval())->format('U.u') - (int) $now->format('U.u')))
+ : $p->recurrences - $i
+ );
+ break;
+ }
+ $dates[] = sprintf('%s) %s', $i + 1, self::formatDateTime($d));
+ }
+
+ $period = sprintf(
+ 'every %s, from %s%s %s',
+ self::formatInterval($p->getDateInterval()),
+ $p->include_start_date ? '[' : ']',
+ self::formatDateTime($p->getStartDate()),
+ ($end = $p->getEndDate()) ? 'to '.self::formatDateTime($end).(\PHP_VERSION_ID >= 80200 && $p->include_end_date ? ']' : '[') : 'recurring '.$p->recurrences.' time/s'
+ );
+
+ $p = [Caster::PREFIX_VIRTUAL.'period' => new ConstStub($period, implode("\n", $dates))];
+
+ return $filter & Caster::EXCLUDE_VERBOSE ? $p : $p + $a;
+ }
+
+ private static function formatDateTime(\DateTimeInterface $d, string $extra = ''): string
+ {
+ return $d->format('Y-m-d H:i:'.self::formatSeconds($d->format('s'), $d->format('u')).$extra);
+ }
+
+ private static function formatSeconds(string $s, string $us): string
+ {
+ return sprintf('%02d.%s', $s, 0 === ($len = \strlen($t = rtrim($us, '0'))) ? '0' : ($len <= 3 ? str_pad($t, 3, '0') : $us));
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Caster/DoctrineCaster.php b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/DoctrineCaster.php
new file mode 100644
index 000000000..3120c3d91
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/DoctrineCaster.php
@@ -0,0 +1,71 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Caster;
+
+use Doctrine\Common\Proxy\Proxy as CommonProxy;
+use Doctrine\ORM\PersistentCollection;
+use Doctrine\ORM\Proxy\Proxy as OrmProxy;
+use Symfony\Component\VarDumper\Cloner\Stub;
+
+/**
+ * Casts Doctrine related classes to array representation.
+ *
+ * @author Nicolas Grekas
+ *
+ * @final
+ */
+class DoctrineCaster
+{
+ /**
+ * @return array
+ */
+ public static function castCommonProxy(CommonProxy $proxy, array $a, Stub $stub, bool $isNested)
+ {
+ foreach (['__cloner__', '__initializer__'] as $k) {
+ if (\array_key_exists($k, $a)) {
+ unset($a[$k]);
+ ++$stub->cut;
+ }
+ }
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castOrmProxy(OrmProxy $proxy, array $a, Stub $stub, bool $isNested)
+ {
+ foreach (['_entityPersister', '_identifier'] as $k) {
+ if (\array_key_exists($k = "\0Doctrine\\ORM\\Proxy\\Proxy\0".$k, $a)) {
+ unset($a[$k]);
+ ++$stub->cut;
+ }
+ }
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castPersistentCollection(PersistentCollection $coll, array $a, Stub $stub, bool $isNested)
+ {
+ foreach (['snapshot', 'association', 'typeClass'] as $k) {
+ if (\array_key_exists($k = "\0Doctrine\\ORM\\PersistentCollection\0".$k, $a)) {
+ $a[$k] = new CutStub($a[$k]);
+ }
+ }
+
+ return $a;
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Caster/DsCaster.php b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/DsCaster.php
new file mode 100644
index 000000000..b34b67004
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/DsCaster.php
@@ -0,0 +1,70 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Caster;
+
+use Ds\Collection;
+use Ds\Map;
+use Ds\Pair;
+use Symfony\Component\VarDumper\Cloner\Stub;
+
+/**
+ * Casts Ds extension classes to array representation.
+ *
+ * @author Jáchym Toušek
+ *
+ * @final
+ */
+class DsCaster
+{
+ public static function castCollection(Collection $c, array $a, Stub $stub, bool $isNested): array
+ {
+ $a[Caster::PREFIX_VIRTUAL.'count'] = $c->count();
+ $a[Caster::PREFIX_VIRTUAL.'capacity'] = $c->capacity();
+
+ if (!$c instanceof Map) {
+ $a += $c->toArray();
+ }
+
+ return $a;
+ }
+
+ public static function castMap(Map $c, array $a, Stub $stub, bool $isNested): array
+ {
+ foreach ($c as $k => $v) {
+ $a[] = new DsPairStub($k, $v);
+ }
+
+ return $a;
+ }
+
+ public static function castPair(Pair $c, array $a, Stub $stub, bool $isNested): array
+ {
+ foreach ($c->toArray() as $k => $v) {
+ $a[Caster::PREFIX_VIRTUAL.$k] = $v;
+ }
+
+ return $a;
+ }
+
+ public static function castPairStub(DsPairStub $c, array $a, Stub $stub, bool $isNested): array
+ {
+ if ($isNested) {
+ $stub->class = Pair::class;
+ $stub->value = null;
+ $stub->handle = 0;
+
+ $a = $c->value;
+ }
+
+ return $a;
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Caster/DsPairStub.php b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/DsPairStub.php
new file mode 100644
index 000000000..afa2727b1
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/DsPairStub.php
@@ -0,0 +1,28 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Caster;
+
+use Symfony\Component\VarDumper\Cloner\Stub;
+
+/**
+ * @author Nicolas Grekas
+ */
+class DsPairStub extends Stub
+{
+ public function __construct(mixed $key, mixed $value)
+ {
+ $this->value = [
+ Caster::PREFIX_VIRTUAL.'key' => $key,
+ Caster::PREFIX_VIRTUAL.'value' => $value,
+ ];
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Caster/EnumStub.php b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/EnumStub.php
new file mode 100644
index 000000000..7a4e98a21
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/EnumStub.php
@@ -0,0 +1,30 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Caster;
+
+use Symfony\Component\VarDumper\Cloner\Stub;
+
+/**
+ * Represents an enumeration of values.
+ *
+ * @author Nicolas Grekas
+ */
+class EnumStub extends Stub
+{
+ public $dumpKeys = true;
+
+ public function __construct(array $values, bool $dumpKeys = true)
+ {
+ $this->value = $values;
+ $this->dumpKeys = $dumpKeys;
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Caster/ExceptionCaster.php b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/ExceptionCaster.php
new file mode 100644
index 000000000..02efb1b02
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/ExceptionCaster.php
@@ -0,0 +1,419 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Caster;
+
+use Symfony\Component\ErrorHandler\Exception\FlattenException;
+use Symfony\Component\ErrorHandler\Exception\SilencedErrorContext;
+use Symfony\Component\VarDumper\Cloner\Stub;
+use Symfony\Component\VarDumper\Exception\ThrowingCasterException;
+
+/**
+ * Casts common Exception classes to array representation.
+ *
+ * @author Nicolas Grekas
+ *
+ * @final
+ */
+class ExceptionCaster
+{
+ public static int $srcContext = 1;
+ public static bool $traceArgs = true;
+ public static array $errorTypes = [
+ \E_DEPRECATED => 'E_DEPRECATED',
+ \E_USER_DEPRECATED => 'E_USER_DEPRECATED',
+ \E_RECOVERABLE_ERROR => 'E_RECOVERABLE_ERROR',
+ \E_ERROR => 'E_ERROR',
+ \E_WARNING => 'E_WARNING',
+ \E_PARSE => 'E_PARSE',
+ \E_NOTICE => 'E_NOTICE',
+ \E_CORE_ERROR => 'E_CORE_ERROR',
+ \E_CORE_WARNING => 'E_CORE_WARNING',
+ \E_COMPILE_ERROR => 'E_COMPILE_ERROR',
+ \E_COMPILE_WARNING => 'E_COMPILE_WARNING',
+ \E_USER_ERROR => 'E_USER_ERROR',
+ \E_USER_WARNING => 'E_USER_WARNING',
+ \E_USER_NOTICE => 'E_USER_NOTICE',
+ \E_STRICT => 'E_STRICT',
+ ];
+
+ private static array $framesCache = [];
+
+ /**
+ * @return array
+ */
+ public static function castError(\Error $e, array $a, Stub $stub, bool $isNested, int $filter = 0)
+ {
+ return self::filterExceptionArray($stub->class, $a, "\0Error\0", $filter);
+ }
+
+ /**
+ * @return array
+ */
+ public static function castException(\Exception $e, array $a, Stub $stub, bool $isNested, int $filter = 0)
+ {
+ return self::filterExceptionArray($stub->class, $a, "\0Exception\0", $filter);
+ }
+
+ /**
+ * @return array
+ */
+ public static function castErrorException(\ErrorException $e, array $a, Stub $stub, bool $isNested)
+ {
+ if (isset($a[$s = Caster::PREFIX_PROTECTED.'severity'], self::$errorTypes[$a[$s]])) {
+ $a[$s] = new ConstStub(self::$errorTypes[$a[$s]], $a[$s]);
+ }
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castThrowingCasterException(ThrowingCasterException $e, array $a, Stub $stub, bool $isNested)
+ {
+ $trace = Caster::PREFIX_VIRTUAL.'trace';
+ $prefix = Caster::PREFIX_PROTECTED;
+ $xPrefix = "\0Exception\0";
+
+ if (isset($a[$xPrefix.'previous'], $a[$trace]) && $a[$xPrefix.'previous'] instanceof \Exception) {
+ $b = (array) $a[$xPrefix.'previous'];
+ $class = get_debug_type($a[$xPrefix.'previous']);
+ self::traceUnshift($b[$xPrefix.'trace'], $class, $b[$prefix.'file'], $b[$prefix.'line']);
+ $a[$trace] = new TraceStub($b[$xPrefix.'trace'], false, 0, -\count($a[$trace]->value));
+ }
+
+ unset($a[$xPrefix.'previous'], $a[$prefix.'code'], $a[$prefix.'file'], $a[$prefix.'line']);
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castSilencedErrorContext(SilencedErrorContext $e, array $a, Stub $stub, bool $isNested)
+ {
+ $sPrefix = "\0".SilencedErrorContext::class."\0";
+
+ if (!isset($a[$s = $sPrefix.'severity'])) {
+ return $a;
+ }
+
+ if (isset(self::$errorTypes[$a[$s]])) {
+ $a[$s] = new ConstStub(self::$errorTypes[$a[$s]], $a[$s]);
+ }
+
+ $trace = [[
+ 'file' => $a[$sPrefix.'file'],
+ 'line' => $a[$sPrefix.'line'],
+ ]];
+
+ if (isset($a[$sPrefix.'trace'])) {
+ $trace = array_merge($trace, $a[$sPrefix.'trace']);
+ }
+
+ unset($a[$sPrefix.'file'], $a[$sPrefix.'line'], $a[$sPrefix.'trace']);
+ $a[Caster::PREFIX_VIRTUAL.'trace'] = new TraceStub($trace, self::$traceArgs);
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castTraceStub(TraceStub $trace, array $a, Stub $stub, bool $isNested)
+ {
+ if (!$isNested) {
+ return $a;
+ }
+ $stub->class = '';
+ $stub->handle = 0;
+ $frames = $trace->value;
+ $prefix = Caster::PREFIX_VIRTUAL;
+
+ $a = [];
+ $j = \count($frames);
+ if (0 > $i = $trace->sliceOffset) {
+ $i = max(0, $j + $i);
+ }
+ if (!isset($trace->value[$i])) {
+ return [];
+ }
+ $lastCall = isset($frames[$i]['function']) ? (isset($frames[$i]['class']) ? $frames[0]['class'].$frames[$i]['type'] : '').$frames[$i]['function'].'()' : '';
+ $frames[] = ['function' => ''];
+ $collapse = false;
+
+ for ($j += $trace->numberingOffset - $i++; isset($frames[$i]); ++$i, --$j) {
+ $f = $frames[$i];
+ $call = isset($f['function']) ? (isset($f['class']) ? $f['class'].$f['type'] : '').$f['function'] : '???';
+
+ $frame = new FrameStub(
+ [
+ 'object' => $f['object'] ?? null,
+ 'class' => $f['class'] ?? null,
+ 'type' => $f['type'] ?? null,
+ 'function' => $f['function'] ?? null,
+ ] + $frames[$i - 1],
+ false,
+ true
+ );
+ $f = self::castFrameStub($frame, [], $frame, true);
+ if (isset($f[$prefix.'src'])) {
+ foreach ($f[$prefix.'src']->value as $label => $frame) {
+ if (str_starts_with($label, "\0~collapse=0")) {
+ if ($collapse) {
+ $label = substr_replace($label, '1', 11, 1);
+ } else {
+ $collapse = true;
+ }
+ }
+ $label = substr_replace($label, "title=Stack level $j.&", 2, 0);
+ }
+ $f = $frames[$i - 1];
+ if ($trace->keepArgs && !empty($f['args']) && $frame instanceof EnumStub) {
+ $frame->value['arguments'] = new ArgsStub($f['args'], $f['function'] ?? null, $f['class'] ?? null);
+ }
+ } elseif ('???' !== $lastCall) {
+ $label = new ClassStub($lastCall);
+ if (isset($label->attr['ellipsis'])) {
+ $label->attr['ellipsis'] += 2;
+ $label = substr_replace($prefix, "ellipsis-type=class&ellipsis={$label->attr['ellipsis']}&ellipsis-tail=1&title=Stack level $j.", 2, 0).$label->value.'()';
+ } else {
+ $label = substr_replace($prefix, "title=Stack level $j.", 2, 0).$label->value.'()';
+ }
+ } else {
+ $label = substr_replace($prefix, "title=Stack level $j.", 2, 0).$lastCall;
+ }
+ $a[substr_replace($label, sprintf('separator=%s&', $frame instanceof EnumStub ? ' ' : ':'), 2, 0)] = $frame;
+
+ $lastCall = $call;
+ }
+ if (null !== $trace->sliceLength) {
+ $a = \array_slice($a, 0, $trace->sliceLength, true);
+ }
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castFrameStub(FrameStub $frame, array $a, Stub $stub, bool $isNested)
+ {
+ if (!$isNested) {
+ return $a;
+ }
+ $f = $frame->value;
+ $prefix = Caster::PREFIX_VIRTUAL;
+
+ if (isset($f['file'], $f['line'])) {
+ $cacheKey = $f;
+ unset($cacheKey['object'], $cacheKey['args']);
+ $cacheKey[] = self::$srcContext;
+ $cacheKey = implode('-', $cacheKey);
+
+ if (isset(self::$framesCache[$cacheKey])) {
+ $a[$prefix.'src'] = self::$framesCache[$cacheKey];
+ } else {
+ if (preg_match('/\((\d+)\)(?:\([\da-f]{32}\))? : (?:eval\(\)\'d code|runtime-created function)$/', $f['file'], $match)) {
+ $f['file'] = substr($f['file'], 0, -\strlen($match[0]));
+ $f['line'] = (int) $match[1];
+ }
+ $src = $f['line'];
+ $srcKey = $f['file'];
+ $ellipsis = new LinkStub($srcKey, 0);
+ $srcAttr = 'collapse='.(int) $ellipsis->inVendor;
+ $ellipsisTail = $ellipsis->attr['ellipsis-tail'] ?? 0;
+ $ellipsis = $ellipsis->attr['ellipsis'] ?? 0;
+
+ if (is_file($f['file']) && 0 <= self::$srcContext) {
+ if (!empty($f['class']) && (is_subclass_of($f['class'], 'Twig\Template') || is_subclass_of($f['class'], 'Twig_Template')) && method_exists($f['class'], 'getDebugInfo')) {
+ $template = null;
+ if (isset($f['object'])) {
+ $template = $f['object'];
+ } elseif ((new \ReflectionClass($f['class']))->isInstantiable()) {
+ $template = unserialize(sprintf('O:%d:"%s":0:{}', \strlen($f['class']), $f['class']));
+ }
+ if (null !== $template) {
+ $ellipsis = 0;
+ $templateSrc = method_exists($template, 'getSourceContext') ? $template->getSourceContext()->getCode() : (method_exists($template, 'getSource') ? $template->getSource() : '');
+ $templateInfo = $template->getDebugInfo();
+ if (isset($templateInfo[$f['line']])) {
+ if (!method_exists($template, 'getSourceContext') || !is_file($templatePath = $template->getSourceContext()->getPath())) {
+ $templatePath = null;
+ }
+ if ($templateSrc) {
+ $src = self::extractSource($templateSrc, $templateInfo[$f['line']], self::$srcContext, 'twig', $templatePath, $f);
+ $srcKey = ($templatePath ?: $template->getTemplateName()).':'.$templateInfo[$f['line']];
+ }
+ }
+ }
+ }
+ if ($srcKey == $f['file']) {
+ $src = self::extractSource(file_get_contents($f['file']), $f['line'], self::$srcContext, 'php', $f['file'], $f);
+ $srcKey .= ':'.$f['line'];
+ if ($ellipsis) {
+ $ellipsis += 1 + \strlen($f['line']);
+ }
+ }
+ $srcAttr .= sprintf('&separator= &file=%s&line=%d', rawurlencode($f['file']), $f['line']);
+ } else {
+ $srcAttr .= '&separator=:';
+ }
+ $srcAttr .= $ellipsis ? '&ellipsis-type=path&ellipsis='.$ellipsis.'&ellipsis-tail='.$ellipsisTail : '';
+ self::$framesCache[$cacheKey] = $a[$prefix.'src'] = new EnumStub(["\0~$srcAttr\0$srcKey" => $src]);
+ }
+ }
+
+ unset($a[$prefix.'args'], $a[$prefix.'line'], $a[$prefix.'file']);
+ if ($frame->inTraceStub) {
+ unset($a[$prefix.'class'], $a[$prefix.'type'], $a[$prefix.'function']);
+ }
+ foreach ($a as $k => $v) {
+ if (!$v) {
+ unset($a[$k]);
+ }
+ }
+ if ($frame->keepArgs && !empty($f['args'])) {
+ $a[$prefix.'arguments'] = new ArgsStub($f['args'], $f['function'], $f['class']);
+ }
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castFlattenException(FlattenException $e, array $a, Stub $stub, bool $isNested)
+ {
+ if ($isNested) {
+ $k = sprintf(Caster::PATTERN_PRIVATE, FlattenException::class, 'traceAsString');
+ $a[$k] = new CutStub($a[$k]);
+ }
+
+ return $a;
+ }
+
+ private static function filterExceptionArray(string $xClass, array $a, string $xPrefix, int $filter): array
+ {
+ if (isset($a[$xPrefix.'trace'])) {
+ $trace = $a[$xPrefix.'trace'];
+ unset($a[$xPrefix.'trace']); // Ensures the trace is always last
+ } else {
+ $trace = [];
+ }
+
+ if (!($filter & Caster::EXCLUDE_VERBOSE) && $trace) {
+ if (isset($a[Caster::PREFIX_PROTECTED.'file'], $a[Caster::PREFIX_PROTECTED.'line'])) {
+ self::traceUnshift($trace, $xClass, $a[Caster::PREFIX_PROTECTED.'file'], $a[Caster::PREFIX_PROTECTED.'line']);
+ }
+ $a[Caster::PREFIX_VIRTUAL.'trace'] = new TraceStub($trace, self::$traceArgs);
+ }
+ if (empty($a[$xPrefix.'previous'])) {
+ unset($a[$xPrefix.'previous']);
+ }
+ unset($a[$xPrefix.'string'], $a[Caster::PREFIX_DYNAMIC.'xdebug_message']);
+
+ if (isset($a[Caster::PREFIX_PROTECTED.'message']) && str_contains($a[Caster::PREFIX_PROTECTED.'message'], "@anonymous\0")) {
+ $a[Caster::PREFIX_PROTECTED.'message'] = preg_replace_callback('/[a-zA-Z_\x7f-\xff][\\\\a-zA-Z0-9_\x7f-\xff]*+@anonymous\x00.*?\.php(?:0x?|:[0-9]++\$)[0-9a-fA-F]++/', fn ($m) => class_exists($m[0], false) ? (get_parent_class($m[0]) ?: key(class_implements($m[0])) ?: 'class').'@anonymous' : $m[0], $a[Caster::PREFIX_PROTECTED.'message']);
+ }
+
+ if (isset($a[Caster::PREFIX_PROTECTED.'file'], $a[Caster::PREFIX_PROTECTED.'line'])) {
+ $a[Caster::PREFIX_PROTECTED.'file'] = new LinkStub($a[Caster::PREFIX_PROTECTED.'file'], $a[Caster::PREFIX_PROTECTED.'line']);
+ }
+
+ return $a;
+ }
+
+ private static function traceUnshift(array &$trace, ?string $class, string $file, int $line): void
+ {
+ if (isset($trace[0]['file'], $trace[0]['line']) && $trace[0]['file'] === $file && $trace[0]['line'] === $line) {
+ return;
+ }
+ array_unshift($trace, [
+ 'function' => $class ? 'new '.$class : null,
+ 'file' => $file,
+ 'line' => $line,
+ ]);
+ }
+
+ private static function extractSource(string $srcLines, int $line, int $srcContext, string $lang, ?string $file, array $frame): EnumStub
+ {
+ $srcLines = explode("\n", $srcLines);
+ $src = [];
+
+ for ($i = $line - 1 - $srcContext; $i <= $line - 1 + $srcContext; ++$i) {
+ $src[] = ($srcLines[$i] ?? '')."\n";
+ }
+
+ if ($frame['function'] ?? false) {
+ $stub = new CutStub(new \stdClass());
+ $stub->class = (isset($frame['class']) ? $frame['class'].$frame['type'] : '').$frame['function'];
+ $stub->type = Stub::TYPE_OBJECT;
+ $stub->attr['cut_hash'] = true;
+ $stub->attr['file'] = $frame['file'];
+ $stub->attr['line'] = $frame['line'];
+
+ try {
+ $caller = isset($frame['class']) ? new \ReflectionMethod($frame['class'], $frame['function']) : new \ReflectionFunction($frame['function']);
+ $stub->class .= ReflectionCaster::getSignature(ReflectionCaster::castFunctionAbstract($caller, [], $stub, true, Caster::EXCLUDE_VERBOSE));
+
+ if ($f = $caller->getFileName()) {
+ $stub->attr['file'] = $f;
+ $stub->attr['line'] = $caller->getStartLine();
+ }
+ } catch (\ReflectionException) {
+ // ignore fake class/function
+ }
+
+ $srcLines = ["\0~separator=\0" => $stub];
+ } else {
+ $stub = null;
+ $srcLines = [];
+ }
+
+ $ltrim = 0;
+ do {
+ $pad = null;
+ for ($i = $srcContext << 1; $i >= 0; --$i) {
+ if (isset($src[$i][$ltrim]) && "\r" !== ($c = $src[$i][$ltrim]) && "\n" !== $c) {
+ $pad ??= $c;
+ if ((' ' !== $c && "\t" !== $c) || $pad !== $c) {
+ break;
+ }
+ }
+ }
+ ++$ltrim;
+ } while (0 > $i && null !== $pad);
+
+ --$ltrim;
+
+ foreach ($src as $i => $c) {
+ if ($ltrim) {
+ $c = isset($c[$ltrim]) && "\r" !== $c[$ltrim] ? substr($c, $ltrim) : ltrim($c, " \t");
+ }
+ $c = substr($c, 0, -1);
+ if ($i !== $srcContext) {
+ $c = new ConstStub('default', $c);
+ } else {
+ $c = new ConstStub($c, $stub ? 'in '.$stub->class : '');
+ if (null !== $file) {
+ $c->attr['file'] = $file;
+ $c->attr['line'] = $line;
+ }
+ }
+ $c->attr['lang'] = $lang;
+ $srcLines[sprintf("\0~separator=› &%d\0", $i + $line - $srcContext)] = $c;
+ }
+
+ return new EnumStub($srcLines);
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Caster/FFICaster.php b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/FFICaster.php
new file mode 100644
index 000000000..f1984eef3
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/FFICaster.php
@@ -0,0 +1,161 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Caster;
+
+use FFI\CData;
+use FFI\CType;
+use Symfony\Component\VarDumper\Cloner\Stub;
+
+/**
+ * Casts FFI extension classes to array representation.
+ *
+ * @author Nesmeyanov Kirill
+ */
+final class FFICaster
+{
+ /**
+ * In case of "char*" contains a string, the length of which depends on
+ * some other parameter, then during the generation of the string it is
+ * possible to go beyond the allowable memory area.
+ *
+ * This restriction serves to ensure that processing does not take
+ * up the entire allowable PHP memory limit.
+ */
+ private const MAX_STRING_LENGTH = 255;
+
+ public static function castCTypeOrCData(CData|CType $data, array $args, Stub $stub): array
+ {
+ if ($data instanceof CType) {
+ $type = $data;
+ $data = null;
+ } else {
+ $type = \FFI::typeof($data);
+ }
+
+ $stub->class = sprintf('%s<%s> size %d align %d', ($data ?? $type)::class, $type->getName(), $type->getSize(), $type->getAlignment());
+
+ return match ($type->getKind()) {
+ CType::TYPE_FLOAT,
+ CType::TYPE_DOUBLE,
+ \defined('\FFI\CType::TYPE_LONGDOUBLE') ? CType::TYPE_LONGDOUBLE : -1,
+ CType::TYPE_UINT8,
+ CType::TYPE_SINT8,
+ CType::TYPE_UINT16,
+ CType::TYPE_SINT16,
+ CType::TYPE_UINT32,
+ CType::TYPE_SINT32,
+ CType::TYPE_UINT64,
+ CType::TYPE_SINT64,
+ CType::TYPE_BOOL,
+ CType::TYPE_CHAR,
+ CType::TYPE_ENUM => null !== $data ? [Caster::PREFIX_VIRTUAL.'cdata' => $data->cdata] : [],
+ CType::TYPE_POINTER => self::castFFIPointer($stub, $type, $data),
+ CType::TYPE_STRUCT => self::castFFIStructLike($type, $data),
+ CType::TYPE_FUNC => self::castFFIFunction($stub, $type),
+ default => $args,
+ };
+ }
+
+ private static function castFFIFunction(Stub $stub, CType $type): array
+ {
+ $arguments = [];
+
+ for ($i = 0, $count = $type->getFuncParameterCount(); $i < $count; ++$i) {
+ $param = $type->getFuncParameterType($i);
+
+ $arguments[] = $param->getName();
+ }
+
+ $abi = match ($type->getFuncABI()) {
+ CType::ABI_DEFAULT,
+ CType::ABI_CDECL => '[cdecl]',
+ CType::ABI_FASTCALL => '[fastcall]',
+ CType::ABI_THISCALL => '[thiscall]',
+ CType::ABI_STDCALL => '[stdcall]',
+ CType::ABI_PASCAL => '[pascal]',
+ CType::ABI_REGISTER => '[register]',
+ CType::ABI_MS => '[ms]',
+ CType::ABI_SYSV => '[sysv]',
+ CType::ABI_VECTORCALL => '[vectorcall]',
+ default => '[unknown abi]'
+ };
+
+ $returnType = $type->getFuncReturnType();
+
+ $stub->class = $abi.' callable('.implode(', ', $arguments).'): '
+ .$returnType->getName();
+
+ return [Caster::PREFIX_VIRTUAL.'returnType' => $returnType];
+ }
+
+ private static function castFFIPointer(Stub $stub, CType $type, ?CData $data = null): array
+ {
+ $ptr = $type->getPointerType();
+
+ if (null === $data) {
+ return [Caster::PREFIX_VIRTUAL.'0' => $ptr];
+ }
+
+ return match ($ptr->getKind()) {
+ CType::TYPE_CHAR => [Caster::PREFIX_VIRTUAL.'cdata' => self::castFFIStringValue($data)],
+ CType::TYPE_FUNC => self::castFFIFunction($stub, $ptr),
+ default => [Caster::PREFIX_VIRTUAL.'cdata' => $data[0]],
+ };
+ }
+
+ private static function castFFIStringValue(CData $data): string|CutStub
+ {
+ $result = [];
+
+ for ($i = 0; $i < self::MAX_STRING_LENGTH; ++$i) {
+ $result[$i] = $data[$i];
+
+ if ("\0" === $result[$i]) {
+ return implode('', $result);
+ }
+ }
+
+ $string = implode('', $result);
+ $stub = new CutStub($string);
+ $stub->cut = -1;
+ $stub->value = $string;
+
+ return $stub;
+ }
+
+ private static function castFFIStructLike(CType $type, ?CData $data = null): array
+ {
+ $isUnion = ($type->getAttributes() & CType::ATTR_UNION) === CType::ATTR_UNION;
+
+ $result = [];
+
+ foreach ($type->getStructFieldNames() as $name) {
+ $field = $type->getStructFieldType($name);
+
+ // Retrieving the value of a field from a union containing
+ // a pointer is not a safe operation, because may contain
+ // incorrect data.
+ $isUnsafe = $isUnion && CType::TYPE_POINTER === $field->getKind();
+
+ if ($isUnsafe) {
+ $result[Caster::PREFIX_VIRTUAL.$name.'?'] = $field;
+ } elseif (null === $data) {
+ $result[Caster::PREFIX_VIRTUAL.$name] = $field;
+ } else {
+ $fieldName = $data->{$name} instanceof CData ? '' : $field->getName().' ';
+ $result[Caster::PREFIX_VIRTUAL.$fieldName.$name] = $data->{$name};
+ }
+ }
+
+ return $result;
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Caster/FiberCaster.php b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/FiberCaster.php
new file mode 100644
index 000000000..b797dbd63
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/FiberCaster.php
@@ -0,0 +1,46 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Caster;
+
+use Symfony\Component\VarDumper\Cloner\Stub;
+
+/**
+ * Casts Fiber related classes to array representation.
+ *
+ * @author Grégoire Pineau
+ */
+final class FiberCaster
+{
+ /**
+ * @return array
+ */
+ public static function castFiber(\Fiber $fiber, array $a, Stub $stub, bool $isNested, int $filter = 0)
+ {
+ $prefix = Caster::PREFIX_VIRTUAL;
+
+ if ($fiber->isTerminated()) {
+ $status = 'terminated';
+ } elseif ($fiber->isRunning()) {
+ $status = 'running';
+ } elseif ($fiber->isSuspended()) {
+ $status = 'suspended';
+ } elseif ($fiber->isStarted()) {
+ $status = 'started';
+ } else {
+ $status = 'not started';
+ }
+
+ $a[$prefix.'status'] = $status;
+
+ return $a;
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Caster/FrameStub.php b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/FrameStub.php
new file mode 100644
index 000000000..878675528
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/FrameStub.php
@@ -0,0 +1,30 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Caster;
+
+/**
+ * Represents a single backtrace frame as returned by debug_backtrace() or Exception->getTrace().
+ *
+ * @author Nicolas Grekas
+ */
+class FrameStub extends EnumStub
+{
+ public $keepArgs;
+ public $inTraceStub;
+
+ public function __construct(array $frame, bool $keepArgs = true, bool $inTraceStub = false)
+ {
+ $this->value = $frame;
+ $this->keepArgs = $keepArgs;
+ $this->inTraceStub = $inTraceStub;
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Caster/GmpCaster.php b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/GmpCaster.php
new file mode 100644
index 000000000..b018cc7f8
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/GmpCaster.php
@@ -0,0 +1,32 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Caster;
+
+use Symfony\Component\VarDumper\Cloner\Stub;
+
+/**
+ * Casts GMP objects to array representation.
+ *
+ * @author Hamza Amrouche
+ * @author Nicolas Grekas
+ *
+ * @final
+ */
+class GmpCaster
+{
+ public static function castGmp(\GMP $gmp, array $a, Stub $stub, bool $isNested, int $filter): array
+ {
+ $a[Caster::PREFIX_VIRTUAL.'value'] = new ConstStub(gmp_strval($gmp), gmp_strval($gmp));
+
+ return $a;
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Caster/ImagineCaster.php b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/ImagineCaster.php
new file mode 100644
index 000000000..d1289da33
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/ImagineCaster.php
@@ -0,0 +1,37 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Caster;
+
+use Imagine\Image\ImageInterface;
+use Symfony\Component\VarDumper\Cloner\Stub;
+
+/**
+ * @author Grégoire Pineau
+ */
+final class ImagineCaster
+{
+ public static function castImage(ImageInterface $c, array $a, Stub $stub, bool $isNested): array
+ {
+ $imgData = $c->get('png');
+ if (\strlen($imgData) > 1 * 1000 * 1000) {
+ $a += [
+ Caster::PREFIX_VIRTUAL.'image' => new ConstStub($c->getSize()),
+ ];
+ } else {
+ $a += [
+ Caster::PREFIX_VIRTUAL.'image' => new ImgStub($imgData, 'image/png', $c->getSize()),
+ ];
+ }
+
+ return $a;
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Caster/ImgStub.php b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/ImgStub.php
new file mode 100644
index 000000000..a16681f73
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/ImgStub.php
@@ -0,0 +1,26 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Caster;
+
+/**
+ * @author Grégoire Pineau
+ */
+class ImgStub extends ConstStub
+{
+ public function __construct(string $data, string $contentType, string $size = '')
+ {
+ $this->value = '';
+ $this->attr['img-data'] = $data;
+ $this->attr['img-size'] = $size;
+ $this->attr['content-type'] = $contentType;
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Caster/IntlCaster.php b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/IntlCaster.php
new file mode 100644
index 000000000..a4590f4b5
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/IntlCaster.php
@@ -0,0 +1,187 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Caster;
+
+use Symfony\Component\VarDumper\Cloner\Stub;
+
+/**
+ * @author Nicolas Grekas
+ * @author Jan Schädlich
+ *
+ * @final
+ */
+class IntlCaster
+{
+ /**
+ * @return array
+ */
+ public static function castMessageFormatter(\MessageFormatter $c, array $a, Stub $stub, bool $isNested)
+ {
+ $a += [
+ Caster::PREFIX_VIRTUAL.'locale' => $c->getLocale(),
+ Caster::PREFIX_VIRTUAL.'pattern' => $c->getPattern(),
+ ];
+
+ return self::castError($c, $a);
+ }
+
+ /**
+ * @return array
+ */
+ public static function castNumberFormatter(\NumberFormatter $c, array $a, Stub $stub, bool $isNested, int $filter = 0)
+ {
+ $a += [
+ Caster::PREFIX_VIRTUAL.'locale' => $c->getLocale(),
+ Caster::PREFIX_VIRTUAL.'pattern' => $c->getPattern(),
+ ];
+
+ if ($filter & Caster::EXCLUDE_VERBOSE) {
+ $stub->cut += 3;
+
+ return self::castError($c, $a);
+ }
+
+ $a += [
+ Caster::PREFIX_VIRTUAL.'attributes' => new EnumStub(
+ [
+ 'PARSE_INT_ONLY' => $c->getAttribute(\NumberFormatter::PARSE_INT_ONLY),
+ 'GROUPING_USED' => $c->getAttribute(\NumberFormatter::GROUPING_USED),
+ 'DECIMAL_ALWAYS_SHOWN' => $c->getAttribute(\NumberFormatter::DECIMAL_ALWAYS_SHOWN),
+ 'MAX_INTEGER_DIGITS' => $c->getAttribute(\NumberFormatter::MAX_INTEGER_DIGITS),
+ 'MIN_INTEGER_DIGITS' => $c->getAttribute(\NumberFormatter::MIN_INTEGER_DIGITS),
+ 'INTEGER_DIGITS' => $c->getAttribute(\NumberFormatter::INTEGER_DIGITS),
+ 'MAX_FRACTION_DIGITS' => $c->getAttribute(\NumberFormatter::MAX_FRACTION_DIGITS),
+ 'MIN_FRACTION_DIGITS' => $c->getAttribute(\NumberFormatter::MIN_FRACTION_DIGITS),
+ 'FRACTION_DIGITS' => $c->getAttribute(\NumberFormatter::FRACTION_DIGITS),
+ 'MULTIPLIER' => $c->getAttribute(\NumberFormatter::MULTIPLIER),
+ 'GROUPING_SIZE' => $c->getAttribute(\NumberFormatter::GROUPING_SIZE),
+ 'ROUNDING_MODE' => $c->getAttribute(\NumberFormatter::ROUNDING_MODE),
+ 'ROUNDING_INCREMENT' => $c->getAttribute(\NumberFormatter::ROUNDING_INCREMENT),
+ 'FORMAT_WIDTH' => $c->getAttribute(\NumberFormatter::FORMAT_WIDTH),
+ 'PADDING_POSITION' => $c->getAttribute(\NumberFormatter::PADDING_POSITION),
+ 'SECONDARY_GROUPING_SIZE' => $c->getAttribute(\NumberFormatter::SECONDARY_GROUPING_SIZE),
+ 'SIGNIFICANT_DIGITS_USED' => $c->getAttribute(\NumberFormatter::SIGNIFICANT_DIGITS_USED),
+ 'MIN_SIGNIFICANT_DIGITS' => $c->getAttribute(\NumberFormatter::MIN_SIGNIFICANT_DIGITS),
+ 'MAX_SIGNIFICANT_DIGITS' => $c->getAttribute(\NumberFormatter::MAX_SIGNIFICANT_DIGITS),
+ 'LENIENT_PARSE' => $c->getAttribute(\NumberFormatter::LENIENT_PARSE),
+ ]
+ ),
+ Caster::PREFIX_VIRTUAL.'text_attributes' => new EnumStub(
+ [
+ 'POSITIVE_PREFIX' => $c->getTextAttribute(\NumberFormatter::POSITIVE_PREFIX),
+ 'POSITIVE_SUFFIX' => $c->getTextAttribute(\NumberFormatter::POSITIVE_SUFFIX),
+ 'NEGATIVE_PREFIX' => $c->getTextAttribute(\NumberFormatter::NEGATIVE_PREFIX),
+ 'NEGATIVE_SUFFIX' => $c->getTextAttribute(\NumberFormatter::NEGATIVE_SUFFIX),
+ 'PADDING_CHARACTER' => $c->getTextAttribute(\NumberFormatter::PADDING_CHARACTER),
+ 'CURRENCY_CODE' => $c->getTextAttribute(\NumberFormatter::CURRENCY_CODE),
+ 'DEFAULT_RULESET' => $c->getTextAttribute(\NumberFormatter::DEFAULT_RULESET),
+ 'PUBLIC_RULESETS' => $c->getTextAttribute(\NumberFormatter::PUBLIC_RULESETS),
+ ]
+ ),
+ Caster::PREFIX_VIRTUAL.'symbols' => new EnumStub(
+ [
+ 'DECIMAL_SEPARATOR_SYMBOL' => $c->getSymbol(\NumberFormatter::DECIMAL_SEPARATOR_SYMBOL),
+ 'GROUPING_SEPARATOR_SYMBOL' => $c->getSymbol(\NumberFormatter::GROUPING_SEPARATOR_SYMBOL),
+ 'PATTERN_SEPARATOR_SYMBOL' => $c->getSymbol(\NumberFormatter::PATTERN_SEPARATOR_SYMBOL),
+ 'PERCENT_SYMBOL' => $c->getSymbol(\NumberFormatter::PERCENT_SYMBOL),
+ 'ZERO_DIGIT_SYMBOL' => $c->getSymbol(\NumberFormatter::ZERO_DIGIT_SYMBOL),
+ 'DIGIT_SYMBOL' => $c->getSymbol(\NumberFormatter::DIGIT_SYMBOL),
+ 'MINUS_SIGN_SYMBOL' => $c->getSymbol(\NumberFormatter::MINUS_SIGN_SYMBOL),
+ 'PLUS_SIGN_SYMBOL' => $c->getSymbol(\NumberFormatter::PLUS_SIGN_SYMBOL),
+ 'CURRENCY_SYMBOL' => $c->getSymbol(\NumberFormatter::CURRENCY_SYMBOL),
+ 'INTL_CURRENCY_SYMBOL' => $c->getSymbol(\NumberFormatter::INTL_CURRENCY_SYMBOL),
+ 'MONETARY_SEPARATOR_SYMBOL' => $c->getSymbol(\NumberFormatter::MONETARY_SEPARATOR_SYMBOL),
+ 'EXPONENTIAL_SYMBOL' => $c->getSymbol(\NumberFormatter::EXPONENTIAL_SYMBOL),
+ 'PERMILL_SYMBOL' => $c->getSymbol(\NumberFormatter::PERMILL_SYMBOL),
+ 'PAD_ESCAPE_SYMBOL' => $c->getSymbol(\NumberFormatter::PAD_ESCAPE_SYMBOL),
+ 'INFINITY_SYMBOL' => $c->getSymbol(\NumberFormatter::INFINITY_SYMBOL),
+ 'NAN_SYMBOL' => $c->getSymbol(\NumberFormatter::NAN_SYMBOL),
+ 'SIGNIFICANT_DIGIT_SYMBOL' => $c->getSymbol(\NumberFormatter::SIGNIFICANT_DIGIT_SYMBOL),
+ 'MONETARY_GROUPING_SEPARATOR_SYMBOL' => $c->getSymbol(\NumberFormatter::MONETARY_GROUPING_SEPARATOR_SYMBOL),
+ ]
+ ),
+ ];
+
+ return self::castError($c, $a);
+ }
+
+ /**
+ * @return array
+ */
+ public static function castIntlTimeZone(\IntlTimeZone $c, array $a, Stub $stub, bool $isNested)
+ {
+ $a += [
+ Caster::PREFIX_VIRTUAL.'display_name' => $c->getDisplayName(),
+ Caster::PREFIX_VIRTUAL.'id' => $c->getID(),
+ Caster::PREFIX_VIRTUAL.'raw_offset' => $c->getRawOffset(),
+ ];
+
+ if ($c->useDaylightTime()) {
+ $a += [
+ Caster::PREFIX_VIRTUAL.'dst_savings' => $c->getDSTSavings(),
+ ];
+ }
+
+ return self::castError($c, $a);
+ }
+
+ /**
+ * @return array
+ */
+ public static function castIntlCalendar(\IntlCalendar $c, array $a, Stub $stub, bool $isNested, int $filter = 0)
+ {
+ $a += [
+ Caster::PREFIX_VIRTUAL.'type' => $c->getType(),
+ Caster::PREFIX_VIRTUAL.'first_day_of_week' => $c->getFirstDayOfWeek(),
+ Caster::PREFIX_VIRTUAL.'minimal_days_in_first_week' => $c->getMinimalDaysInFirstWeek(),
+ Caster::PREFIX_VIRTUAL.'repeated_wall_time_option' => $c->getRepeatedWallTimeOption(),
+ Caster::PREFIX_VIRTUAL.'skipped_wall_time_option' => $c->getSkippedWallTimeOption(),
+ Caster::PREFIX_VIRTUAL.'time' => $c->getTime(),
+ Caster::PREFIX_VIRTUAL.'in_daylight_time' => $c->inDaylightTime(),
+ Caster::PREFIX_VIRTUAL.'is_lenient' => $c->isLenient(),
+ Caster::PREFIX_VIRTUAL.'time_zone' => ($filter & Caster::EXCLUDE_VERBOSE) ? new CutStub($c->getTimeZone()) : $c->getTimeZone(),
+ ];
+
+ return self::castError($c, $a);
+ }
+
+ /**
+ * @return array
+ */
+ public static function castIntlDateFormatter(\IntlDateFormatter $c, array $a, Stub $stub, bool $isNested, int $filter = 0)
+ {
+ $a += [
+ Caster::PREFIX_VIRTUAL.'locale' => $c->getLocale(),
+ Caster::PREFIX_VIRTUAL.'pattern' => $c->getPattern(),
+ Caster::PREFIX_VIRTUAL.'calendar' => $c->getCalendar(),
+ Caster::PREFIX_VIRTUAL.'time_zone_id' => $c->getTimeZoneId(),
+ Caster::PREFIX_VIRTUAL.'time_type' => $c->getTimeType(),
+ Caster::PREFIX_VIRTUAL.'date_type' => $c->getDateType(),
+ Caster::PREFIX_VIRTUAL.'calendar_object' => ($filter & Caster::EXCLUDE_VERBOSE) ? new CutStub($c->getCalendarObject()) : $c->getCalendarObject(),
+ Caster::PREFIX_VIRTUAL.'time_zone' => ($filter & Caster::EXCLUDE_VERBOSE) ? new CutStub($c->getTimeZone()) : $c->getTimeZone(),
+ ];
+
+ return self::castError($c, $a);
+ }
+
+ private static function castError(object $c, array $a): array
+ {
+ if ($errorCode = $c->getErrorCode()) {
+ $a += [
+ Caster::PREFIX_VIRTUAL.'error_code' => $errorCode,
+ Caster::PREFIX_VIRTUAL.'error_message' => $c->getErrorMessage(),
+ ];
+ }
+
+ return $a;
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Caster/LinkStub.php b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/LinkStub.php
new file mode 100644
index 000000000..4930436df
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/LinkStub.php
@@ -0,0 +1,105 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Caster;
+
+/**
+ * Represents a file or a URL.
+ *
+ * @author Nicolas Grekas
+ */
+class LinkStub extends ConstStub
+{
+ public $inVendor = false;
+
+ private static array $vendorRoots;
+ private static array $composerRoots = [];
+
+ public function __construct(string $label, int $line = 0, ?string $href = null)
+ {
+ $this->value = $label;
+
+ if (!\is_string($href ??= $label)) {
+ return;
+ }
+ if (str_starts_with($href, 'file://')) {
+ if ($href === $label) {
+ $label = substr($label, 7);
+ }
+ $href = substr($href, 7);
+ } elseif (str_contains($href, '://')) {
+ $this->attr['href'] = $href;
+
+ return;
+ }
+ if (!is_file($href)) {
+ return;
+ }
+ if ($line) {
+ $this->attr['line'] = $line;
+ }
+ if ($label !== $this->attr['file'] = realpath($href) ?: $href) {
+ return;
+ }
+ if ($composerRoot = $this->getComposerRoot($href, $this->inVendor)) {
+ $this->attr['ellipsis'] = \strlen($href) - \strlen($composerRoot) + 1;
+ $this->attr['ellipsis-type'] = 'path';
+ $this->attr['ellipsis-tail'] = 1 + ($this->inVendor ? 2 + \strlen(implode('', \array_slice(explode(\DIRECTORY_SEPARATOR, substr($href, 1 - $this->attr['ellipsis'])), 0, 2))) : 0);
+ } elseif (3 < \count($ellipsis = explode(\DIRECTORY_SEPARATOR, $href))) {
+ $this->attr['ellipsis'] = 2 + \strlen(implode('', \array_slice($ellipsis, -2)));
+ $this->attr['ellipsis-type'] = 'path';
+ $this->attr['ellipsis-tail'] = 1;
+ }
+ }
+
+ private function getComposerRoot(string $file, bool &$inVendor): string|false
+ {
+ if (!isset(self::$vendorRoots)) {
+ self::$vendorRoots = [];
+
+ foreach (get_declared_classes() as $class) {
+ if ('C' === $class[0] && str_starts_with($class, 'ComposerAutoloaderInit')) {
+ $r = new \ReflectionClass($class);
+ $v = \dirname($r->getFileName(), 2);
+ if (is_file($v.'/composer/installed.json')) {
+ self::$vendorRoots[] = $v.\DIRECTORY_SEPARATOR;
+ }
+ }
+ }
+ }
+ $inVendor = false;
+
+ if (isset(self::$composerRoots[$dir = \dirname($file)])) {
+ return self::$composerRoots[$dir];
+ }
+
+ foreach (self::$vendorRoots as $root) {
+ if ($inVendor = str_starts_with($file, $root)) {
+ return $root;
+ }
+ }
+
+ $parent = $dir;
+ while (!@is_file($parent.'/composer.json')) {
+ if (!@file_exists($parent)) {
+ // open_basedir restriction in effect
+ break;
+ }
+ if ($parent === \dirname($parent)) {
+ return self::$composerRoots[$dir] = false;
+ }
+
+ $parent = \dirname($parent);
+ }
+
+ return self::$composerRoots[$dir] = $parent.\DIRECTORY_SEPARATOR;
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Caster/MemcachedCaster.php b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/MemcachedCaster.php
new file mode 100644
index 000000000..2f161e8cb
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/MemcachedCaster.php
@@ -0,0 +1,84 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Caster;
+
+use Symfony\Component\VarDumper\Cloner\Stub;
+
+/**
+ * @author Jan Schädlich
+ *
+ * @final
+ */
+class MemcachedCaster
+{
+ private static array $optionConstants;
+ private static array $defaultOptions;
+
+ /**
+ * @return array
+ */
+ public static function castMemcached(\Memcached $c, array $a, Stub $stub, bool $isNested)
+ {
+ $a += [
+ Caster::PREFIX_VIRTUAL.'servers' => $c->getServerList(),
+ Caster::PREFIX_VIRTUAL.'options' => new EnumStub(
+ self::getNonDefaultOptions($c)
+ ),
+ ];
+
+ return $a;
+ }
+
+ private static function getNonDefaultOptions(\Memcached $c): array
+ {
+ self::$defaultOptions ??= self::discoverDefaultOptions();
+ self::$optionConstants ??= self::getOptionConstants();
+
+ $nonDefaultOptions = [];
+ foreach (self::$optionConstants as $constantKey => $value) {
+ if (self::$defaultOptions[$constantKey] !== $option = $c->getOption($value)) {
+ $nonDefaultOptions[$constantKey] = $option;
+ }
+ }
+
+ return $nonDefaultOptions;
+ }
+
+ private static function discoverDefaultOptions(): array
+ {
+ $defaultMemcached = new \Memcached();
+ $defaultMemcached->addServer('127.0.0.1', 11211);
+
+ $defaultOptions = [];
+ self::$optionConstants ??= self::getOptionConstants();
+
+ foreach (self::$optionConstants as $constantKey => $value) {
+ $defaultOptions[$constantKey] = $defaultMemcached->getOption($value);
+ }
+
+ return $defaultOptions;
+ }
+
+ private static function getOptionConstants(): array
+ {
+ $reflectedMemcached = new \ReflectionClass(\Memcached::class);
+
+ $optionConstants = [];
+ foreach ($reflectedMemcached->getConstants() as $constantKey => $value) {
+ if (str_starts_with($constantKey, 'OPT_')) {
+ $optionConstants[$constantKey] = $value;
+ }
+ }
+
+ return $optionConstants;
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Caster/MysqliCaster.php b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/MysqliCaster.php
new file mode 100644
index 000000000..bfe6f0822
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/MysqliCaster.php
@@ -0,0 +1,33 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Caster;
+
+use Symfony\Component\VarDumper\Cloner\Stub;
+
+/**
+ * @author Nicolas Grekas
+ *
+ * @internal
+ */
+final class MysqliCaster
+{
+ public static function castMysqliDriver(\mysqli_driver $c, array $a, Stub $stub, bool $isNested): array
+ {
+ foreach ($a as $k => $v) {
+ if (isset($c->$k)) {
+ $a[$k] = $c->$k;
+ }
+ }
+
+ return $a;
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Caster/PdoCaster.php b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/PdoCaster.php
new file mode 100644
index 000000000..d68eae216
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/PdoCaster.php
@@ -0,0 +1,128 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Caster;
+
+use Symfony\Component\VarDumper\Cloner\Stub;
+
+/**
+ * Casts PDO related classes to array representation.
+ *
+ * @author Nicolas Grekas
+ *
+ * @final
+ */
+class PdoCaster
+{
+ private const PDO_ATTRIBUTES = [
+ 'CASE' => [
+ \PDO::CASE_LOWER => 'LOWER',
+ \PDO::CASE_NATURAL => 'NATURAL',
+ \PDO::CASE_UPPER => 'UPPER',
+ ],
+ 'ERRMODE' => [
+ \PDO::ERRMODE_SILENT => 'SILENT',
+ \PDO::ERRMODE_WARNING => 'WARNING',
+ \PDO::ERRMODE_EXCEPTION => 'EXCEPTION',
+ ],
+ 'TIMEOUT',
+ 'PREFETCH',
+ 'AUTOCOMMIT',
+ 'PERSISTENT',
+ 'DRIVER_NAME',
+ 'SERVER_INFO',
+ 'ORACLE_NULLS' => [
+ \PDO::NULL_NATURAL => 'NATURAL',
+ \PDO::NULL_EMPTY_STRING => 'EMPTY_STRING',
+ \PDO::NULL_TO_STRING => 'TO_STRING',
+ ],
+ 'CLIENT_VERSION',
+ 'SERVER_VERSION',
+ 'STATEMENT_CLASS',
+ 'EMULATE_PREPARES',
+ 'CONNECTION_STATUS',
+ 'STRINGIFY_FETCHES',
+ 'DEFAULT_FETCH_MODE' => [
+ \PDO::FETCH_ASSOC => 'ASSOC',
+ \PDO::FETCH_BOTH => 'BOTH',
+ \PDO::FETCH_LAZY => 'LAZY',
+ \PDO::FETCH_NUM => 'NUM',
+ \PDO::FETCH_OBJ => 'OBJ',
+ ],
+ ];
+
+ /**
+ * @return array
+ */
+ public static function castPdo(\PDO $c, array $a, Stub $stub, bool $isNested)
+ {
+ $attr = [];
+ $errmode = $c->getAttribute(\PDO::ATTR_ERRMODE);
+ $c->setAttribute(\PDO::ATTR_ERRMODE, \PDO::ERRMODE_EXCEPTION);
+
+ foreach (self::PDO_ATTRIBUTES as $k => $v) {
+ if (!isset($k[0])) {
+ $k = $v;
+ $v = [];
+ }
+
+ try {
+ $attr[$k] = 'ERRMODE' === $k ? $errmode : $c->getAttribute(\constant('PDO::ATTR_'.$k));
+ if ($v && isset($v[$attr[$k]])) {
+ $attr[$k] = new ConstStub($v[$attr[$k]], $attr[$k]);
+ }
+ } catch (\Exception) {
+ }
+ }
+ if (isset($attr[$k = 'STATEMENT_CLASS'][1])) {
+ if ($attr[$k][1]) {
+ $attr[$k][1] = new ArgsStub($attr[$k][1], '__construct', $attr[$k][0]);
+ }
+ $attr[$k][0] = new ClassStub($attr[$k][0]);
+ }
+
+ $prefix = Caster::PREFIX_VIRTUAL;
+ $a += [
+ $prefix.'inTransaction' => method_exists($c, 'inTransaction'),
+ $prefix.'errorInfo' => $c->errorInfo(),
+ $prefix.'attributes' => new EnumStub($attr),
+ ];
+
+ if ($a[$prefix.'inTransaction']) {
+ $a[$prefix.'inTransaction'] = $c->inTransaction();
+ } else {
+ unset($a[$prefix.'inTransaction']);
+ }
+
+ if (!isset($a[$prefix.'errorInfo'][1], $a[$prefix.'errorInfo'][2])) {
+ unset($a[$prefix.'errorInfo']);
+ }
+
+ $c->setAttribute(\PDO::ATTR_ERRMODE, $errmode);
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castPdoStatement(\PDOStatement $c, array $a, Stub $stub, bool $isNested)
+ {
+ $prefix = Caster::PREFIX_VIRTUAL;
+ $a[$prefix.'errorInfo'] = $c->errorInfo();
+
+ if (!isset($a[$prefix.'errorInfo'][1], $a[$prefix.'errorInfo'][2])) {
+ unset($a[$prefix.'errorInfo']);
+ }
+
+ return $a;
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Caster/PgSqlCaster.php b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/PgSqlCaster.php
new file mode 100644
index 000000000..0d8b3d919
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/PgSqlCaster.php
@@ -0,0 +1,165 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Caster;
+
+use Symfony\Component\VarDumper\Cloner\Stub;
+
+/**
+ * Casts pqsql resources to array representation.
+ *
+ * @author Nicolas Grekas
+ *
+ * @final
+ */
+class PgSqlCaster
+{
+ private const PARAM_CODES = [
+ 'server_encoding',
+ 'client_encoding',
+ 'is_superuser',
+ 'session_authorization',
+ 'DateStyle',
+ 'TimeZone',
+ 'IntervalStyle',
+ 'integer_datetimes',
+ 'application_name',
+ 'standard_conforming_strings',
+ ];
+
+ private const TRANSACTION_STATUS = [
+ \PGSQL_TRANSACTION_IDLE => 'PGSQL_TRANSACTION_IDLE',
+ \PGSQL_TRANSACTION_ACTIVE => 'PGSQL_TRANSACTION_ACTIVE',
+ \PGSQL_TRANSACTION_INTRANS => 'PGSQL_TRANSACTION_INTRANS',
+ \PGSQL_TRANSACTION_INERROR => 'PGSQL_TRANSACTION_INERROR',
+ \PGSQL_TRANSACTION_UNKNOWN => 'PGSQL_TRANSACTION_UNKNOWN',
+ ];
+
+ private const RESULT_STATUS = [
+ \PGSQL_EMPTY_QUERY => 'PGSQL_EMPTY_QUERY',
+ \PGSQL_COMMAND_OK => 'PGSQL_COMMAND_OK',
+ \PGSQL_TUPLES_OK => 'PGSQL_TUPLES_OK',
+ \PGSQL_COPY_OUT => 'PGSQL_COPY_OUT',
+ \PGSQL_COPY_IN => 'PGSQL_COPY_IN',
+ \PGSQL_BAD_RESPONSE => 'PGSQL_BAD_RESPONSE',
+ \PGSQL_NONFATAL_ERROR => 'PGSQL_NONFATAL_ERROR',
+ \PGSQL_FATAL_ERROR => 'PGSQL_FATAL_ERROR',
+ ];
+
+ private const DIAG_CODES = [
+ 'severity' => \PGSQL_DIAG_SEVERITY,
+ 'sqlstate' => \PGSQL_DIAG_SQLSTATE,
+ 'message' => \PGSQL_DIAG_MESSAGE_PRIMARY,
+ 'detail' => \PGSQL_DIAG_MESSAGE_DETAIL,
+ 'hint' => \PGSQL_DIAG_MESSAGE_HINT,
+ 'statement position' => \PGSQL_DIAG_STATEMENT_POSITION,
+ 'internal position' => \PGSQL_DIAG_INTERNAL_POSITION,
+ 'internal query' => \PGSQL_DIAG_INTERNAL_QUERY,
+ 'context' => \PGSQL_DIAG_CONTEXT,
+ 'file' => \PGSQL_DIAG_SOURCE_FILE,
+ 'line' => \PGSQL_DIAG_SOURCE_LINE,
+ 'function' => \PGSQL_DIAG_SOURCE_FUNCTION,
+ ];
+
+ /**
+ * @return array
+ */
+ public static function castLargeObject($lo, array $a, Stub $stub, bool $isNested)
+ {
+ $a['seek position'] = pg_lo_tell($lo);
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castLink($link, array $a, Stub $stub, bool $isNested)
+ {
+ $a['status'] = pg_connection_status($link);
+ $a['status'] = new ConstStub(\PGSQL_CONNECTION_OK === $a['status'] ? 'PGSQL_CONNECTION_OK' : 'PGSQL_CONNECTION_BAD', $a['status']);
+ $a['busy'] = pg_connection_busy($link);
+
+ $a['transaction'] = pg_transaction_status($link);
+ if (isset(self::TRANSACTION_STATUS[$a['transaction']])) {
+ $a['transaction'] = new ConstStub(self::TRANSACTION_STATUS[$a['transaction']], $a['transaction']);
+ }
+
+ $a['pid'] = pg_get_pid($link);
+ $a['last error'] = pg_last_error($link);
+ $a['last notice'] = pg_last_notice($link);
+ $a['host'] = pg_host($link);
+ $a['port'] = pg_port($link);
+ $a['dbname'] = pg_dbname($link);
+ $a['options'] = pg_options($link);
+ $a['version'] = pg_version($link);
+
+ foreach (self::PARAM_CODES as $v) {
+ if (false !== $s = pg_parameter_status($link, $v)) {
+ $a['param'][$v] = $s;
+ }
+ }
+
+ $a['param']['client_encoding'] = pg_client_encoding($link);
+ $a['param'] = new EnumStub($a['param']);
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castResult($result, array $a, Stub $stub, bool $isNested)
+ {
+ $a['num rows'] = pg_num_rows($result);
+ $a['status'] = pg_result_status($result);
+ if (isset(self::RESULT_STATUS[$a['status']])) {
+ $a['status'] = new ConstStub(self::RESULT_STATUS[$a['status']], $a['status']);
+ }
+ $a['command-completion tag'] = pg_result_status($result, \PGSQL_STATUS_STRING);
+
+ if (-1 === $a['num rows']) {
+ foreach (self::DIAG_CODES as $k => $v) {
+ $a['error'][$k] = pg_result_error_field($result, $v);
+ }
+ }
+
+ $a['affected rows'] = pg_affected_rows($result);
+ $a['last OID'] = pg_last_oid($result);
+
+ $fields = pg_num_fields($result);
+
+ for ($i = 0; $i < $fields; ++$i) {
+ $field = [
+ 'name' => pg_field_name($result, $i),
+ 'table' => sprintf('%s (OID: %s)', pg_field_table($result, $i), pg_field_table($result, $i, true)),
+ 'type' => sprintf('%s (OID: %s)', pg_field_type($result, $i), pg_field_type_oid($result, $i)),
+ 'nullable' => (bool) pg_field_is_null($result, $i),
+ 'storage' => pg_field_size($result, $i).' bytes',
+ 'display' => pg_field_prtlen($result, $i).' chars',
+ ];
+ if (' (OID: )' === $field['table']) {
+ $field['table'] = null;
+ }
+ if ('-1 bytes' === $field['storage']) {
+ $field['storage'] = 'variable size';
+ } elseif ('1 bytes' === $field['storage']) {
+ $field['storage'] = '1 byte';
+ }
+ if ('1 chars' === $field['display']) {
+ $field['display'] = '1 char';
+ }
+ $a['fields'][] = new EnumStub($field);
+ }
+
+ return $a;
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Caster/ProxyManagerCaster.php b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/ProxyManagerCaster.php
new file mode 100644
index 000000000..eb6c88db6
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/ProxyManagerCaster.php
@@ -0,0 +1,36 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Caster;
+
+use ProxyManager\Proxy\ProxyInterface;
+use Symfony\Component\VarDumper\Cloner\Stub;
+
+/**
+ * @author Nicolas Grekas
+ *
+ * @final
+ */
+class ProxyManagerCaster
+{
+ /**
+ * @return array
+ */
+ public static function castProxy(ProxyInterface $c, array $a, Stub $stub, bool $isNested)
+ {
+ if ($parent = get_parent_class($c)) {
+ $stub->class .= ' - '.$parent;
+ }
+ $stub->class .= '@proxy';
+
+ return $a;
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Caster/RdKafkaCaster.php b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/RdKafkaCaster.php
new file mode 100644
index 000000000..fcaa1b768
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/RdKafkaCaster.php
@@ -0,0 +1,222 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Caster;
+
+use RdKafka\Conf;
+use RdKafka\Exception as RdKafkaException;
+use RdKafka\KafkaConsumer;
+use RdKafka\Message;
+use RdKafka\Metadata\Broker as BrokerMetadata;
+use RdKafka\Metadata\Collection as CollectionMetadata;
+use RdKafka\Metadata\Partition as PartitionMetadata;
+use RdKafka\Metadata\Topic as TopicMetadata;
+use RdKafka\Topic;
+use RdKafka\TopicConf;
+use RdKafka\TopicPartition;
+use Symfony\Component\VarDumper\Cloner\Stub;
+
+/**
+ * Casts RdKafka related classes to array representation.
+ *
+ * @author Romain Neutron
+ */
+class RdKafkaCaster
+{
+ /**
+ * @return array
+ */
+ public static function castKafkaConsumer(KafkaConsumer $c, array $a, Stub $stub, bool $isNested)
+ {
+ $prefix = Caster::PREFIX_VIRTUAL;
+
+ try {
+ $assignment = $c->getAssignment();
+ } catch (RdKafkaException) {
+ $assignment = [];
+ }
+
+ $a += [
+ $prefix.'subscription' => $c->getSubscription(),
+ $prefix.'assignment' => $assignment,
+ ];
+
+ $a += self::extractMetadata($c);
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castTopic(Topic $c, array $a, Stub $stub, bool $isNested)
+ {
+ $prefix = Caster::PREFIX_VIRTUAL;
+
+ $a += [
+ $prefix.'name' => $c->getName(),
+ ];
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castTopicPartition(TopicPartition $c, array $a)
+ {
+ $prefix = Caster::PREFIX_VIRTUAL;
+
+ $a += [
+ $prefix.'offset' => $c->getOffset(),
+ $prefix.'partition' => $c->getPartition(),
+ $prefix.'topic' => $c->getTopic(),
+ ];
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castMessage(Message $c, array $a, Stub $stub, bool $isNested)
+ {
+ $prefix = Caster::PREFIX_VIRTUAL;
+
+ $a += [
+ $prefix.'errstr' => $c->errstr(),
+ ];
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castConf(Conf $c, array $a, Stub $stub, bool $isNested)
+ {
+ $prefix = Caster::PREFIX_VIRTUAL;
+
+ foreach ($c->dump() as $key => $value) {
+ $a[$prefix.$key] = $value;
+ }
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castTopicConf(TopicConf $c, array $a, Stub $stub, bool $isNested)
+ {
+ $prefix = Caster::PREFIX_VIRTUAL;
+
+ foreach ($c->dump() as $key => $value) {
+ $a[$prefix.$key] = $value;
+ }
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castRdKafka(\RdKafka $c, array $a, Stub $stub, bool $isNested)
+ {
+ $prefix = Caster::PREFIX_VIRTUAL;
+
+ $a += [
+ $prefix.'out_q_len' => $c->getOutQLen(),
+ ];
+
+ $a += self::extractMetadata($c);
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castCollectionMetadata(CollectionMetadata $c, array $a, Stub $stub, bool $isNested)
+ {
+ $a += iterator_to_array($c);
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castTopicMetadata(TopicMetadata $c, array $a, Stub $stub, bool $isNested)
+ {
+ $prefix = Caster::PREFIX_VIRTUAL;
+
+ $a += [
+ $prefix.'name' => $c->getTopic(),
+ $prefix.'partitions' => $c->getPartitions(),
+ ];
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castPartitionMetadata(PartitionMetadata $c, array $a, Stub $stub, bool $isNested)
+ {
+ $prefix = Caster::PREFIX_VIRTUAL;
+
+ $a += [
+ $prefix.'id' => $c->getId(),
+ $prefix.'err' => $c->getErr(),
+ $prefix.'leader' => $c->getLeader(),
+ ];
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castBrokerMetadata(BrokerMetadata $c, array $a, Stub $stub, bool $isNested)
+ {
+ $prefix = Caster::PREFIX_VIRTUAL;
+
+ $a += [
+ $prefix.'id' => $c->getId(),
+ $prefix.'host' => $c->getHost(),
+ $prefix.'port' => $c->getPort(),
+ ];
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ private static function extractMetadata(KafkaConsumer|\RdKafka $c)
+ {
+ $prefix = Caster::PREFIX_VIRTUAL;
+
+ try {
+ $m = $c->getMetadata(true, null, 500);
+ } catch (RdKafkaException) {
+ return [];
+ }
+
+ return [
+ $prefix.'orig_broker_id' => $m->getOrigBrokerId(),
+ $prefix.'orig_broker_name' => $m->getOrigBrokerName(),
+ $prefix.'brokers' => $m->getBrokers(),
+ $prefix.'topics' => $m->getTopics(),
+ ];
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Caster/RedisCaster.php b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/RedisCaster.php
new file mode 100644
index 000000000..6ff046754
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/RedisCaster.php
@@ -0,0 +1,159 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Caster;
+
+use Relay\Relay;
+use Symfony\Component\VarDumper\Cloner\Stub;
+
+/**
+ * Casts Redis class from ext-redis to array representation.
+ *
+ * @author Nicolas Grekas
+ *
+ * @final
+ */
+class RedisCaster
+{
+ private const SERIALIZERS = [
+ 0 => 'NONE', // Redis::SERIALIZER_NONE
+ 1 => 'PHP', // Redis::SERIALIZER_PHP
+ 2 => 'IGBINARY', // Optional Redis::SERIALIZER_IGBINARY
+ ];
+
+ private const MODES = [
+ 0 => 'ATOMIC', // Redis::ATOMIC
+ 1 => 'MULTI', // Redis::MULTI
+ 2 => 'PIPELINE', // Redis::PIPELINE
+ ];
+
+ private const COMPRESSION_MODES = [
+ 0 => 'NONE', // Redis::COMPRESSION_NONE
+ 1 => 'LZF', // Redis::COMPRESSION_LZF
+ ];
+
+ private const FAILOVER_OPTIONS = [
+ \RedisCluster::FAILOVER_NONE => 'NONE',
+ \RedisCluster::FAILOVER_ERROR => 'ERROR',
+ \RedisCluster::FAILOVER_DISTRIBUTE => 'DISTRIBUTE',
+ \RedisCluster::FAILOVER_DISTRIBUTE_SLAVES => 'DISTRIBUTE_SLAVES',
+ ];
+
+ /**
+ * @return array
+ */
+ public static function castRedis(\Redis|Relay $c, array $a, Stub $stub, bool $isNested)
+ {
+ $prefix = Caster::PREFIX_VIRTUAL;
+
+ if (!$connected = $c->isConnected()) {
+ return $a + [
+ $prefix.'isConnected' => $connected,
+ ];
+ }
+
+ $mode = $c->getMode();
+
+ return $a + [
+ $prefix.'isConnected' => $connected,
+ $prefix.'host' => $c->getHost(),
+ $prefix.'port' => $c->getPort(),
+ $prefix.'auth' => $c->getAuth(),
+ $prefix.'mode' => isset(self::MODES[$mode]) ? new ConstStub(self::MODES[$mode], $mode) : $mode,
+ $prefix.'dbNum' => $c->getDbNum(),
+ $prefix.'timeout' => $c->getTimeout(),
+ $prefix.'lastError' => $c->getLastError(),
+ $prefix.'persistentId' => $c->getPersistentID(),
+ $prefix.'options' => self::getRedisOptions($c),
+ ];
+ }
+
+ /**
+ * @return array
+ */
+ public static function castRedisArray(\RedisArray $c, array $a, Stub $stub, bool $isNested)
+ {
+ $prefix = Caster::PREFIX_VIRTUAL;
+
+ return $a + [
+ $prefix.'hosts' => $c->_hosts(),
+ $prefix.'function' => ClassStub::wrapCallable($c->_function()),
+ $prefix.'lastError' => $c->getLastError(),
+ $prefix.'options' => self::getRedisOptions($c),
+ ];
+ }
+
+ /**
+ * @return array
+ */
+ public static function castRedisCluster(\RedisCluster $c, array $a, Stub $stub, bool $isNested)
+ {
+ $prefix = Caster::PREFIX_VIRTUAL;
+ $failover = $c->getOption(\RedisCluster::OPT_SLAVE_FAILOVER);
+
+ $a += [
+ $prefix.'_masters' => $c->_masters(),
+ $prefix.'_redir' => $c->_redir(),
+ $prefix.'mode' => new ConstStub($c->getMode() ? 'MULTI' : 'ATOMIC', $c->getMode()),
+ $prefix.'lastError' => $c->getLastError(),
+ $prefix.'options' => self::getRedisOptions($c, [
+ 'SLAVE_FAILOVER' => isset(self::FAILOVER_OPTIONS[$failover]) ? new ConstStub(self::FAILOVER_OPTIONS[$failover], $failover) : $failover,
+ ]),
+ ];
+
+ return $a;
+ }
+
+ private static function getRedisOptions(\Redis|Relay|\RedisArray|\RedisCluster $redis, array $options = []): EnumStub
+ {
+ $serializer = $redis->getOption(\defined('Redis::OPT_SERIALIZER') ? \Redis::OPT_SERIALIZER : 1);
+ if (\is_array($serializer)) {
+ foreach ($serializer as &$v) {
+ if (isset(self::SERIALIZERS[$v])) {
+ $v = new ConstStub(self::SERIALIZERS[$v], $v);
+ }
+ }
+ } elseif (isset(self::SERIALIZERS[$serializer])) {
+ $serializer = new ConstStub(self::SERIALIZERS[$serializer], $serializer);
+ }
+
+ $compression = \defined('Redis::OPT_COMPRESSION') ? $redis->getOption(\Redis::OPT_COMPRESSION) : 0;
+ if (\is_array($compression)) {
+ foreach ($compression as &$v) {
+ if (isset(self::COMPRESSION_MODES[$v])) {
+ $v = new ConstStub(self::COMPRESSION_MODES[$v], $v);
+ }
+ }
+ } elseif (isset(self::COMPRESSION_MODES[$compression])) {
+ $compression = new ConstStub(self::COMPRESSION_MODES[$compression], $compression);
+ }
+
+ $retry = \defined('Redis::OPT_SCAN') ? $redis->getOption(\Redis::OPT_SCAN) : 0;
+ if (\is_array($retry)) {
+ foreach ($retry as &$v) {
+ $v = new ConstStub($v ? 'RETRY' : 'NORETRY', $v);
+ }
+ } else {
+ $retry = new ConstStub($retry ? 'RETRY' : 'NORETRY', $retry);
+ }
+
+ $options += [
+ 'TCP_KEEPALIVE' => \defined('Redis::OPT_TCP_KEEPALIVE') ? $redis->getOption(\Redis::OPT_TCP_KEEPALIVE) : Relay::OPT_TCP_KEEPALIVE,
+ 'READ_TIMEOUT' => $redis->getOption(\defined('Redis::OPT_READ_TIMEOUT') ? \Redis::OPT_READ_TIMEOUT : Relay::OPT_READ_TIMEOUT),
+ 'COMPRESSION' => $compression,
+ 'SERIALIZER' => $serializer,
+ 'PREFIX' => $redis->getOption(\defined('Redis::OPT_PREFIX') ? \Redis::OPT_PREFIX : Relay::OPT_PREFIX),
+ 'SCAN' => $retry,
+ ];
+
+ return new EnumStub($options);
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Caster/ReflectionCaster.php b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/ReflectionCaster.php
new file mode 100644
index 000000000..4adb9bc9f
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/ReflectionCaster.php
@@ -0,0 +1,485 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Caster;
+
+use Symfony\Component\VarDumper\Cloner\Stub;
+
+/**
+ * Casts Reflector related classes to array representation.
+ *
+ * @author Nicolas Grekas
+ *
+ * @final
+ */
+class ReflectionCaster
+{
+ public const UNSET_CLOSURE_FILE_INFO = ['Closure' => __CLASS__.'::unsetClosureFileInfo'];
+
+ private const EXTRA_MAP = [
+ 'docComment' => 'getDocComment',
+ 'extension' => 'getExtensionName',
+ 'isDisabled' => 'isDisabled',
+ 'isDeprecated' => 'isDeprecated',
+ 'isInternal' => 'isInternal',
+ 'isUserDefined' => 'isUserDefined',
+ 'isGenerator' => 'isGenerator',
+ 'isVariadic' => 'isVariadic',
+ ];
+
+ /**
+ * @return array
+ */
+ public static function castClosure(\Closure $c, array $a, Stub $stub, bool $isNested, int $filter = 0)
+ {
+ $prefix = Caster::PREFIX_VIRTUAL;
+ $c = new \ReflectionFunction($c);
+
+ $a = static::castFunctionAbstract($c, $a, $stub, $isNested, $filter);
+
+ if (!str_contains($c->name, '{closure}')) {
+ $stub->class = isset($a[$prefix.'class']) ? $a[$prefix.'class']->value.'::'.$c->name : $c->name;
+ unset($a[$prefix.'class']);
+ }
+ unset($a[$prefix.'extra']);
+
+ $stub->class .= self::getSignature($a);
+
+ if ($f = $c->getFileName()) {
+ $stub->attr['file'] = $f;
+ $stub->attr['line'] = $c->getStartLine();
+ }
+
+ unset($a[$prefix.'parameters']);
+
+ if ($filter & Caster::EXCLUDE_VERBOSE) {
+ $stub->cut += ($c->getFileName() ? 2 : 0) + \count($a);
+
+ return [];
+ }
+
+ if ($f) {
+ $a[$prefix.'file'] = new LinkStub($f, $c->getStartLine());
+ $a[$prefix.'line'] = $c->getStartLine().' to '.$c->getEndLine();
+ }
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function unsetClosureFileInfo(\Closure $c, array $a)
+ {
+ unset($a[Caster::PREFIX_VIRTUAL.'file'], $a[Caster::PREFIX_VIRTUAL.'line']);
+
+ return $a;
+ }
+
+ public static function castGenerator(\Generator $c, array $a, Stub $stub, bool $isNested): array
+ {
+ // Cannot create ReflectionGenerator based on a terminated Generator
+ try {
+ $reflectionGenerator = new \ReflectionGenerator($c);
+ } catch (\Exception) {
+ $a[Caster::PREFIX_VIRTUAL.'closed'] = true;
+
+ return $a;
+ }
+
+ return self::castReflectionGenerator($reflectionGenerator, $a, $stub, $isNested);
+ }
+
+ /**
+ * @return array
+ */
+ public static function castType(\ReflectionType $c, array $a, Stub $stub, bool $isNested)
+ {
+ $prefix = Caster::PREFIX_VIRTUAL;
+
+ if ($c instanceof \ReflectionNamedType) {
+ $a += [
+ $prefix.'name' => $c instanceof \ReflectionNamedType ? $c->getName() : (string) $c,
+ $prefix.'allowsNull' => $c->allowsNull(),
+ $prefix.'isBuiltin' => $c->isBuiltin(),
+ ];
+ } elseif ($c instanceof \ReflectionUnionType || $c instanceof \ReflectionIntersectionType) {
+ $a[$prefix.'allowsNull'] = $c->allowsNull();
+ self::addMap($a, $c, [
+ 'types' => 'getTypes',
+ ]);
+ } else {
+ $a[$prefix.'allowsNull'] = $c->allowsNull();
+ }
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castAttribute(\ReflectionAttribute $c, array $a, Stub $stub, bool $isNested)
+ {
+ self::addMap($a, $c, [
+ 'name' => 'getName',
+ 'arguments' => 'getArguments',
+ ]);
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castReflectionGenerator(\ReflectionGenerator $c, array $a, Stub $stub, bool $isNested)
+ {
+ $prefix = Caster::PREFIX_VIRTUAL;
+
+ if ($c->getThis()) {
+ $a[$prefix.'this'] = new CutStub($c->getThis());
+ }
+ $function = $c->getFunction();
+ $frame = [
+ 'class' => $function->class ?? null,
+ 'type' => isset($function->class) ? ($function->isStatic() ? '::' : '->') : null,
+ 'function' => $function->name,
+ 'file' => $c->getExecutingFile(),
+ 'line' => $c->getExecutingLine(),
+ ];
+ if ($trace = $c->getTrace(\DEBUG_BACKTRACE_IGNORE_ARGS)) {
+ $function = new \ReflectionGenerator($c->getExecutingGenerator());
+ array_unshift($trace, [
+ 'function' => 'yield',
+ 'file' => $function->getExecutingFile(),
+ 'line' => $function->getExecutingLine(),
+ ]);
+ $trace[] = $frame;
+ $a[$prefix.'trace'] = new TraceStub($trace, false, 0, -1, -1);
+ } else {
+ $function = new FrameStub($frame, false, true);
+ $function = ExceptionCaster::castFrameStub($function, [], $function, true);
+ $a[$prefix.'executing'] = $function[$prefix.'src'];
+ }
+
+ $a[Caster::PREFIX_VIRTUAL.'closed'] = false;
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castClass(\ReflectionClass $c, array $a, Stub $stub, bool $isNested, int $filter = 0)
+ {
+ $prefix = Caster::PREFIX_VIRTUAL;
+
+ if ($n = \Reflection::getModifierNames($c->getModifiers())) {
+ $a[$prefix.'modifiers'] = implode(' ', $n);
+ }
+
+ self::addMap($a, $c, [
+ 'extends' => 'getParentClass',
+ 'implements' => 'getInterfaceNames',
+ 'constants' => 'getReflectionConstants',
+ ]);
+
+ foreach ($c->getProperties() as $n) {
+ $a[$prefix.'properties'][$n->name] = $n;
+ }
+
+ foreach ($c->getMethods() as $n) {
+ $a[$prefix.'methods'][$n->name] = $n;
+ }
+
+ self::addAttributes($a, $c, $prefix);
+
+ if (!($filter & Caster::EXCLUDE_VERBOSE) && !$isNested) {
+ self::addExtra($a, $c);
+ }
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castFunctionAbstract(\ReflectionFunctionAbstract $c, array $a, Stub $stub, bool $isNested, int $filter = 0)
+ {
+ $prefix = Caster::PREFIX_VIRTUAL;
+
+ self::addMap($a, $c, [
+ 'returnsReference' => 'returnsReference',
+ 'returnType' => 'getReturnType',
+ 'class' => \PHP_VERSION_ID >= 80111 ? 'getClosureCalledClass' : 'getClosureScopeClass',
+ 'this' => 'getClosureThis',
+ ]);
+
+ if (isset($a[$prefix.'returnType'])) {
+ $v = $a[$prefix.'returnType'];
+ $v = $v instanceof \ReflectionNamedType ? $v->getName() : (string) $v;
+ $a[$prefix.'returnType'] = new ClassStub($a[$prefix.'returnType'] instanceof \ReflectionNamedType && $a[$prefix.'returnType']->allowsNull() && 'mixed' !== $v ? '?'.$v : $v, [class_exists($v, false) || interface_exists($v, false) || trait_exists($v, false) ? $v : '', '']);
+ }
+ if (isset($a[$prefix.'class'])) {
+ $a[$prefix.'class'] = new ClassStub($a[$prefix.'class']);
+ }
+ if (isset($a[$prefix.'this'])) {
+ $a[$prefix.'this'] = new CutStub($a[$prefix.'this']);
+ }
+
+ foreach ($c->getParameters() as $v) {
+ $k = '$'.$v->name;
+ if ($v->isVariadic()) {
+ $k = '...'.$k;
+ }
+ if ($v->isPassedByReference()) {
+ $k = '&'.$k;
+ }
+ $a[$prefix.'parameters'][$k] = $v;
+ }
+ if (isset($a[$prefix.'parameters'])) {
+ $a[$prefix.'parameters'] = new EnumStub($a[$prefix.'parameters']);
+ }
+
+ self::addAttributes($a, $c, $prefix);
+
+ if (!($filter & Caster::EXCLUDE_VERBOSE) && $v = $c->getStaticVariables()) {
+ foreach ($v as $k => &$v) {
+ if (\is_object($v)) {
+ $a[$prefix.'use']['$'.$k] = new CutStub($v);
+ } else {
+ $a[$prefix.'use']['$'.$k] = &$v;
+ }
+ }
+ unset($v);
+ $a[$prefix.'use'] = new EnumStub($a[$prefix.'use']);
+ }
+
+ if (!($filter & Caster::EXCLUDE_VERBOSE) && !$isNested) {
+ self::addExtra($a, $c);
+ }
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castClassConstant(\ReflectionClassConstant $c, array $a, Stub $stub, bool $isNested)
+ {
+ $a[Caster::PREFIX_VIRTUAL.'modifiers'] = implode(' ', \Reflection::getModifierNames($c->getModifiers()));
+ $a[Caster::PREFIX_VIRTUAL.'value'] = $c->getValue();
+
+ self::addAttributes($a, $c);
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castMethod(\ReflectionMethod $c, array $a, Stub $stub, bool $isNested)
+ {
+ $a[Caster::PREFIX_VIRTUAL.'modifiers'] = implode(' ', \Reflection::getModifierNames($c->getModifiers()));
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castParameter(\ReflectionParameter $c, array $a, Stub $stub, bool $isNested)
+ {
+ $prefix = Caster::PREFIX_VIRTUAL;
+
+ self::addMap($a, $c, [
+ 'position' => 'getPosition',
+ 'isVariadic' => 'isVariadic',
+ 'byReference' => 'isPassedByReference',
+ 'allowsNull' => 'allowsNull',
+ ]);
+
+ self::addAttributes($a, $c, $prefix);
+
+ if ($v = $c->getType()) {
+ $a[$prefix.'typeHint'] = $v instanceof \ReflectionNamedType ? $v->getName() : (string) $v;
+ }
+
+ if (isset($a[$prefix.'typeHint'])) {
+ $v = $a[$prefix.'typeHint'];
+ $a[$prefix.'typeHint'] = new ClassStub($v, [class_exists($v, false) || interface_exists($v, false) || trait_exists($v, false) ? $v : '', '']);
+ } else {
+ unset($a[$prefix.'allowsNull']);
+ }
+
+ if ($c->isOptional()) {
+ try {
+ $a[$prefix.'default'] = $v = $c->getDefaultValue();
+ if ($c->isDefaultValueConstant() && !\is_object($v)) {
+ $a[$prefix.'default'] = new ConstStub($c->getDefaultValueConstantName(), $v);
+ }
+ if (null === $v) {
+ unset($a[$prefix.'allowsNull']);
+ }
+ } catch (\ReflectionException) {
+ }
+ }
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castProperty(\ReflectionProperty $c, array $a, Stub $stub, bool $isNested)
+ {
+ $a[Caster::PREFIX_VIRTUAL.'modifiers'] = implode(' ', \Reflection::getModifierNames($c->getModifiers()));
+
+ self::addAttributes($a, $c);
+ self::addExtra($a, $c);
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castReference(\ReflectionReference $c, array $a, Stub $stub, bool $isNested)
+ {
+ $a[Caster::PREFIX_VIRTUAL.'id'] = $c->getId();
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castExtension(\ReflectionExtension $c, array $a, Stub $stub, bool $isNested)
+ {
+ self::addMap($a, $c, [
+ 'version' => 'getVersion',
+ 'dependencies' => 'getDependencies',
+ 'iniEntries' => 'getIniEntries',
+ 'isPersistent' => 'isPersistent',
+ 'isTemporary' => 'isTemporary',
+ 'constants' => 'getConstants',
+ 'functions' => 'getFunctions',
+ 'classes' => 'getClasses',
+ ]);
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castZendExtension(\ReflectionZendExtension $c, array $a, Stub $stub, bool $isNested)
+ {
+ self::addMap($a, $c, [
+ 'version' => 'getVersion',
+ 'author' => 'getAuthor',
+ 'copyright' => 'getCopyright',
+ 'url' => 'getURL',
+ ]);
+
+ return $a;
+ }
+
+ /**
+ * @return string
+ */
+ public static function getSignature(array $a)
+ {
+ $prefix = Caster::PREFIX_VIRTUAL;
+ $signature = '';
+
+ if (isset($a[$prefix.'parameters'])) {
+ foreach ($a[$prefix.'parameters']->value as $k => $param) {
+ $signature .= ', ';
+ if ($type = $param->getType()) {
+ if (!$type instanceof \ReflectionNamedType) {
+ $signature .= $type.' ';
+ } else {
+ if (!$param->isOptional() && $param->allowsNull() && 'mixed' !== $type->getName()) {
+ $signature .= '?';
+ }
+ $signature .= substr(strrchr('\\'.$type->getName(), '\\'), 1).' ';
+ }
+ }
+ $signature .= $k;
+
+ if (!$param->isDefaultValueAvailable()) {
+ continue;
+ }
+ $v = $param->getDefaultValue();
+ $signature .= ' = ';
+
+ if ($param->isDefaultValueConstant()) {
+ $signature .= substr(strrchr('\\'.$param->getDefaultValueConstantName(), '\\'), 1);
+ } elseif (null === $v) {
+ $signature .= 'null';
+ } elseif (\is_array($v)) {
+ $signature .= $v ? '[…'.\count($v).']' : '[]';
+ } elseif (\is_string($v)) {
+ $signature .= 10 > \strlen($v) && !str_contains($v, '\\') ? "'{$v}'" : "'…".\strlen($v)."'";
+ } elseif (\is_bool($v)) {
+ $signature .= $v ? 'true' : 'false';
+ } elseif (\is_object($v)) {
+ $signature .= 'new '.substr(strrchr('\\'.get_debug_type($v), '\\'), 1);
+ } else {
+ $signature .= $v;
+ }
+ }
+ }
+ $signature = (empty($a[$prefix.'returnsReference']) ? '' : '&').'('.substr($signature, 2).')';
+
+ if (isset($a[$prefix.'returnType'])) {
+ $signature .= ': '.substr(strrchr('\\'.$a[$prefix.'returnType'], '\\'), 1);
+ }
+
+ return $signature;
+ }
+
+ private static function addExtra(array &$a, \Reflector $c): void
+ {
+ $x = isset($a[Caster::PREFIX_VIRTUAL.'extra']) ? $a[Caster::PREFIX_VIRTUAL.'extra']->value : [];
+
+ if (method_exists($c, 'getFileName') && $m = $c->getFileName()) {
+ $x['file'] = new LinkStub($m, $c->getStartLine());
+ $x['line'] = $c->getStartLine().' to '.$c->getEndLine();
+ }
+
+ self::addMap($x, $c, self::EXTRA_MAP, '');
+
+ if ($x) {
+ $a[Caster::PREFIX_VIRTUAL.'extra'] = new EnumStub($x);
+ }
+ }
+
+ private static function addMap(array &$a, object $c, array $map, string $prefix = Caster::PREFIX_VIRTUAL): void
+ {
+ foreach ($map as $k => $m) {
+ if ('isDisabled' === $k) {
+ continue;
+ }
+
+ if (method_exists($c, $m) && false !== ($m = $c->$m()) && null !== $m) {
+ $a[$prefix.$k] = $m instanceof \Reflector ? $m->name : $m;
+ }
+ }
+ }
+
+ private static function addAttributes(array &$a, \Reflector $c, string $prefix = Caster::PREFIX_VIRTUAL): void
+ {
+ foreach ($c->getAttributes() as $n) {
+ $a[$prefix.'attributes'][] = $n;
+ }
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Caster/ResourceCaster.php b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/ResourceCaster.php
new file mode 100644
index 000000000..f3bbf3be4
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/ResourceCaster.php
@@ -0,0 +1,106 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Caster;
+
+use Symfony\Component\VarDumper\Cloner\Stub;
+
+/**
+ * Casts common resource types to array representation.
+ *
+ * @author Nicolas Grekas
+ *
+ * @final
+ */
+class ResourceCaster
+{
+ public static function castCurl(\CurlHandle $h, array $a, Stub $stub, bool $isNested): array
+ {
+ return curl_getinfo($h);
+ }
+
+ /**
+ * @return array
+ */
+ public static function castDba($dba, array $a, Stub $stub, bool $isNested)
+ {
+ $list = dba_list();
+ $a['file'] = $list[(int) $dba];
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castProcess($process, array $a, Stub $stub, bool $isNested)
+ {
+ return proc_get_status($process);
+ }
+
+ public static function castStream($stream, array $a, Stub $stub, bool $isNested): array
+ {
+ $a = stream_get_meta_data($stream) + static::castStreamContext($stream, $a, $stub, $isNested);
+ if ($a['uri'] ?? false) {
+ $a['uri'] = new LinkStub($a['uri']);
+ }
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castStreamContext($stream, array $a, Stub $stub, bool $isNested)
+ {
+ return @stream_context_get_params($stream) ?: $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castGd($gd, array $a, Stub $stub, bool $isNested)
+ {
+ $a['size'] = imagesx($gd).'x'.imagesy($gd);
+ $a['trueColor'] = imageistruecolor($gd);
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castOpensslX509($h, array $a, Stub $stub, bool $isNested)
+ {
+ $stub->cut = -1;
+ $info = openssl_x509_parse($h, false);
+
+ $pin = openssl_pkey_get_public($h);
+ $pin = openssl_pkey_get_details($pin)['key'];
+ $pin = \array_slice(explode("\n", $pin), 1, -2);
+ $pin = base64_decode(implode('', $pin));
+ $pin = base64_encode(hash('sha256', $pin, true));
+
+ $a += [
+ 'subject' => new EnumStub(array_intersect_key($info['subject'], ['organizationName' => true, 'commonName' => true])),
+ 'issuer' => new EnumStub(array_intersect_key($info['issuer'], ['organizationName' => true, 'commonName' => true])),
+ 'expiry' => new ConstStub(date(\DateTimeInterface::ISO8601, $info['validTo_time_t']), $info['validTo_time_t']),
+ 'fingerprint' => new EnumStub([
+ 'md5' => new ConstStub(wordwrap(strtoupper(openssl_x509_fingerprint($h, 'md5')), 2, ':', true)),
+ 'sha1' => new ConstStub(wordwrap(strtoupper(openssl_x509_fingerprint($h, 'sha1')), 2, ':', true)),
+ 'sha256' => new ConstStub(wordwrap(strtoupper(openssl_x509_fingerprint($h, 'sha256')), 2, ':', true)),
+ 'pin-sha256' => new ConstStub($pin),
+ ]),
+ ];
+
+ return $a;
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Caster/ScalarStub.php b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/ScalarStub.php
new file mode 100644
index 000000000..3bb1935b8
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/ScalarStub.php
@@ -0,0 +1,27 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Caster;
+
+use Symfony\Component\VarDumper\Cloner\Stub;
+
+/**
+ * Represents any arbitrary value.
+ *
+ * @author Alexandre Daubois
+ */
+class ScalarStub extends Stub
+{
+ public function __construct(mixed $value)
+ {
+ $this->value = $value;
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Caster/SplCaster.php b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/SplCaster.php
new file mode 100644
index 000000000..814d824d1
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/SplCaster.php
@@ -0,0 +1,286 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Caster;
+
+use Symfony\Component\VarDumper\Cloner\Stub;
+
+/**
+ * Casts SPL related classes to array representation.
+ *
+ * @author Nicolas Grekas
+ *
+ * @final
+ */
+class SplCaster
+{
+ private const SPL_FILE_OBJECT_FLAGS = [
+ \SplFileObject::DROP_NEW_LINE => 'DROP_NEW_LINE',
+ \SplFileObject::READ_AHEAD => 'READ_AHEAD',
+ \SplFileObject::SKIP_EMPTY => 'SKIP_EMPTY',
+ \SplFileObject::READ_CSV => 'READ_CSV',
+ ];
+
+ /**
+ * @return array
+ */
+ public static function castArrayObject(\ArrayObject $c, array $a, Stub $stub, bool $isNested)
+ {
+ return self::castSplArray($c, $a, $stub, $isNested);
+ }
+
+ /**
+ * @return array
+ */
+ public static function castArrayIterator(\ArrayIterator $c, array $a, Stub $stub, bool $isNested)
+ {
+ return self::castSplArray($c, $a, $stub, $isNested);
+ }
+
+ /**
+ * @return array
+ */
+ public static function castHeap(\Iterator $c, array $a, Stub $stub, bool $isNested)
+ {
+ $a += [
+ Caster::PREFIX_VIRTUAL.'heap' => iterator_to_array(clone $c),
+ ];
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castDoublyLinkedList(\SplDoublyLinkedList $c, array $a, Stub $stub, bool $isNested)
+ {
+ $prefix = Caster::PREFIX_VIRTUAL;
+ $mode = $c->getIteratorMode();
+ $c->setIteratorMode(\SplDoublyLinkedList::IT_MODE_KEEP | $mode & ~\SplDoublyLinkedList::IT_MODE_DELETE);
+
+ $a += [
+ $prefix.'mode' => new ConstStub((($mode & \SplDoublyLinkedList::IT_MODE_LIFO) ? 'IT_MODE_LIFO' : 'IT_MODE_FIFO').' | '.(($mode & \SplDoublyLinkedList::IT_MODE_DELETE) ? 'IT_MODE_DELETE' : 'IT_MODE_KEEP'), $mode),
+ $prefix.'dllist' => iterator_to_array($c),
+ ];
+ $c->setIteratorMode($mode);
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castFileInfo(\SplFileInfo $c, array $a, Stub $stub, bool $isNested)
+ {
+ static $map = [
+ 'path' => 'getPath',
+ 'filename' => 'getFilename',
+ 'basename' => 'getBasename',
+ 'pathname' => 'getPathname',
+ 'extension' => 'getExtension',
+ 'realPath' => 'getRealPath',
+ 'aTime' => 'getATime',
+ 'mTime' => 'getMTime',
+ 'cTime' => 'getCTime',
+ 'inode' => 'getInode',
+ 'size' => 'getSize',
+ 'perms' => 'getPerms',
+ 'owner' => 'getOwner',
+ 'group' => 'getGroup',
+ 'type' => 'getType',
+ 'writable' => 'isWritable',
+ 'readable' => 'isReadable',
+ 'executable' => 'isExecutable',
+ 'file' => 'isFile',
+ 'dir' => 'isDir',
+ 'link' => 'isLink',
+ 'linkTarget' => 'getLinkTarget',
+ ];
+
+ $prefix = Caster::PREFIX_VIRTUAL;
+ unset($a["\0SplFileInfo\0fileName"]);
+ unset($a["\0SplFileInfo\0pathName"]);
+
+ try {
+ $c->isReadable();
+ } catch (\RuntimeException $e) {
+ if ('Object not initialized' !== $e->getMessage()) {
+ throw $e;
+ }
+
+ $a[$prefix.'⚠'] = 'The parent constructor was not called: the object is in an invalid state';
+
+ return $a;
+ } catch (\Error $e) {
+ if ('Object not initialized' !== $e->getMessage()) {
+ throw $e;
+ }
+
+ $a[$prefix.'⚠'] = 'The parent constructor was not called: the object is in an invalid state';
+
+ return $a;
+ }
+
+ foreach ($map as $key => $accessor) {
+ try {
+ $a[$prefix.$key] = $c->$accessor();
+ } catch (\Exception) {
+ }
+ }
+
+ if ($a[$prefix.'realPath'] ?? false) {
+ $a[$prefix.'realPath'] = new LinkStub($a[$prefix.'realPath']);
+ }
+
+ if (isset($a[$prefix.'perms'])) {
+ $a[$prefix.'perms'] = new ConstStub(sprintf('0%o', $a[$prefix.'perms']), $a[$prefix.'perms']);
+ }
+
+ static $mapDate = ['aTime', 'mTime', 'cTime'];
+ foreach ($mapDate as $key) {
+ if (isset($a[$prefix.$key])) {
+ $a[$prefix.$key] = new ConstStub(date('Y-m-d H:i:s', $a[$prefix.$key]), $a[$prefix.$key]);
+ }
+ }
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castFileObject(\SplFileObject $c, array $a, Stub $stub, bool $isNested)
+ {
+ static $map = [
+ 'csvControl' => 'getCsvControl',
+ 'flags' => 'getFlags',
+ 'maxLineLen' => 'getMaxLineLen',
+ 'fstat' => 'fstat',
+ 'eof' => 'eof',
+ 'key' => 'key',
+ ];
+
+ $prefix = Caster::PREFIX_VIRTUAL;
+
+ foreach ($map as $key => $accessor) {
+ try {
+ $a[$prefix.$key] = $c->$accessor();
+ } catch (\Exception) {
+ }
+ }
+
+ if (isset($a[$prefix.'flags'])) {
+ $flagsArray = [];
+ foreach (self::SPL_FILE_OBJECT_FLAGS as $value => $name) {
+ if ($a[$prefix.'flags'] & $value) {
+ $flagsArray[] = $name;
+ }
+ }
+ $a[$prefix.'flags'] = new ConstStub(implode('|', $flagsArray), $a[$prefix.'flags']);
+ }
+
+ if (isset($a[$prefix.'fstat'])) {
+ $a[$prefix.'fstat'] = new CutArrayStub($a[$prefix.'fstat'], ['dev', 'ino', 'nlink', 'rdev', 'blksize', 'blocks']);
+ }
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castObjectStorage(\SplObjectStorage $c, array $a, Stub $stub, bool $isNested)
+ {
+ $storage = [];
+ unset($a[Caster::PREFIX_DYNAMIC."\0gcdata"]); // Don't hit https://bugs.php.net/65967
+ unset($a["\0SplObjectStorage\0storage"]);
+
+ $clone = clone $c;
+ foreach ($clone as $obj) {
+ $storage[] = new EnumStub([
+ 'object' => $obj,
+ 'info' => $clone->getInfo(),
+ ]);
+ }
+
+ $a += [
+ Caster::PREFIX_VIRTUAL.'storage' => $storage,
+ ];
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castOuterIterator(\OuterIterator $c, array $a, Stub $stub, bool $isNested)
+ {
+ $a[Caster::PREFIX_VIRTUAL.'innerIterator'] = $c->getInnerIterator();
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castWeakReference(\WeakReference $c, array $a, Stub $stub, bool $isNested)
+ {
+ $a[Caster::PREFIX_VIRTUAL.'object'] = $c->get();
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castWeakMap(\WeakMap $c, array $a, Stub $stub, bool $isNested)
+ {
+ $map = [];
+
+ foreach (clone $c as $obj => $data) {
+ $map[] = new EnumStub([
+ 'object' => $obj,
+ 'data' => $data,
+ ]);
+ }
+
+ $a += [
+ Caster::PREFIX_VIRTUAL.'map' => $map,
+ ];
+
+ return $a;
+ }
+
+ private static function castSplArray(\ArrayObject|\ArrayIterator $c, array $a, Stub $stub, bool $isNested): array
+ {
+ $prefix = Caster::PREFIX_VIRTUAL;
+ $flags = $c->getFlags();
+
+ if (!($flags & \ArrayObject::STD_PROP_LIST)) {
+ $c->setFlags(\ArrayObject::STD_PROP_LIST);
+ $a = Caster::castObject($c, $c::class, method_exists($c, '__debugInfo'), $stub->class);
+ $c->setFlags($flags);
+ }
+
+ unset($a["\0ArrayObject\0storage"], $a["\0ArrayIterator\0storage"]);
+
+ $a += [
+ $prefix.'storage' => $c->getArrayCopy(),
+ $prefix.'flag::STD_PROP_LIST' => (bool) ($flags & \ArrayObject::STD_PROP_LIST),
+ $prefix.'flag::ARRAY_AS_PROPS' => (bool) ($flags & \ArrayObject::ARRAY_AS_PROPS),
+ ];
+ if ($c instanceof \ArrayObject) {
+ $a[$prefix.'iteratorClass'] = new ClassStub($c->getIteratorClass());
+ }
+
+ return $a;
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Caster/StubCaster.php b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/StubCaster.php
new file mode 100644
index 000000000..4b93ff76f
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/StubCaster.php
@@ -0,0 +1,107 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Caster;
+
+use Symfony\Component\VarDumper\Cloner\Stub;
+
+/**
+ * Casts a caster's Stub.
+ *
+ * @author Nicolas Grekas
+ *
+ * @final
+ */
+class StubCaster
+{
+ /**
+ * @return array
+ */
+ public static function castStub(Stub $c, array $a, Stub $stub, bool $isNested)
+ {
+ if ($isNested) {
+ $stub->type = $c->type;
+ $stub->class = $c->class;
+ $stub->value = $c->value;
+ $stub->handle = $c->handle;
+ $stub->cut = $c->cut;
+ $stub->attr = $c->attr;
+
+ if (Stub::TYPE_REF === $c->type && !$c->class && \is_string($c->value) && !preg_match('//u', $c->value)) {
+ $stub->type = Stub::TYPE_STRING;
+ $stub->class = Stub::STRING_BINARY;
+ }
+
+ $a = [];
+ }
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castCutArray(CutArrayStub $c, array $a, Stub $stub, bool $isNested)
+ {
+ return $isNested ? $c->preservedSubset : $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function cutInternals($obj, array $a, Stub $stub, bool $isNested)
+ {
+ if ($isNested) {
+ $stub->cut += \count($a);
+
+ return [];
+ }
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castEnum(EnumStub $c, array $a, Stub $stub, bool $isNested)
+ {
+ if ($isNested) {
+ $stub->class = $c->dumpKeys ? '' : null;
+ $stub->handle = 0;
+ $stub->value = null;
+ $stub->cut = $c->cut;
+ $stub->attr = $c->attr;
+
+ $a = [];
+
+ if ($c->value) {
+ foreach (array_keys($c->value) as $k) {
+ $keys[] = !isset($k[0]) || "\0" !== $k[0] ? Caster::PREFIX_VIRTUAL.$k : $k;
+ }
+ // Preserve references with array_combine()
+ $a = array_combine($keys, $c->value);
+ }
+ }
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castScalar(ScalarStub $scalarStub, array $a, Stub $stub)
+ {
+ $stub->type = Stub::TYPE_SCALAR;
+ $stub->attr['value'] = $scalarStub->value;
+
+ return $a;
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Caster/SymfonyCaster.php b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/SymfonyCaster.php
new file mode 100644
index 000000000..ebc00f90e
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/SymfonyCaster.php
@@ -0,0 +1,139 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Caster;
+
+use Symfony\Component\HttpFoundation\Request;
+use Symfony\Component\Uid\Ulid;
+use Symfony\Component\Uid\Uuid;
+use Symfony\Component\VarDumper\Cloner\Stub;
+use Symfony\Component\VarExporter\Internal\LazyObjectState;
+
+/**
+ * @final
+ */
+class SymfonyCaster
+{
+ private const REQUEST_GETTERS = [
+ 'pathInfo' => 'getPathInfo',
+ 'requestUri' => 'getRequestUri',
+ 'baseUrl' => 'getBaseUrl',
+ 'basePath' => 'getBasePath',
+ 'method' => 'getMethod',
+ 'format' => 'getRequestFormat',
+ ];
+
+ /**
+ * @return array
+ */
+ public static function castRequest(Request $request, array $a, Stub $stub, bool $isNested)
+ {
+ $clone = null;
+
+ foreach (self::REQUEST_GETTERS as $prop => $getter) {
+ $key = Caster::PREFIX_PROTECTED.$prop;
+ if (\array_key_exists($key, $a) && null === $a[$key]) {
+ $clone ??= clone $request;
+ $a[Caster::PREFIX_VIRTUAL.$prop] = $clone->{$getter}();
+ }
+ }
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castHttpClient($client, array $a, Stub $stub, bool $isNested)
+ {
+ $multiKey = sprintf("\0%s\0multi", $client::class);
+ if (isset($a[$multiKey])) {
+ $a[$multiKey] = new CutStub($a[$multiKey]);
+ }
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castHttpClientResponse($response, array $a, Stub $stub, bool $isNested)
+ {
+ $stub->cut += \count($a);
+ $a = [];
+
+ foreach ($response->getInfo() as $k => $v) {
+ $a[Caster::PREFIX_VIRTUAL.$k] = $v;
+ }
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castLazyObjectState($state, array $a, Stub $stub, bool $isNested)
+ {
+ if (!$isNested) {
+ return $a;
+ }
+
+ $stub->cut += \count($a) - 1;
+
+ $instance = $a['realInstance'] ?? null;
+
+ $a = ['status' => new ConstStub(match ($a['status']) {
+ LazyObjectState::STATUS_INITIALIZED_FULL => 'INITIALIZED_FULL',
+ LazyObjectState::STATUS_INITIALIZED_PARTIAL => 'INITIALIZED_PARTIAL',
+ LazyObjectState::STATUS_UNINITIALIZED_FULL => 'UNINITIALIZED_FULL',
+ LazyObjectState::STATUS_UNINITIALIZED_PARTIAL => 'UNINITIALIZED_PARTIAL',
+ }, $a['status'])];
+
+ if ($instance) {
+ $a['realInstance'] = $instance;
+ --$stub->cut;
+ }
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castUuid(Uuid $uuid, array $a, Stub $stub, bool $isNested)
+ {
+ $a[Caster::PREFIX_VIRTUAL.'toBase58'] = $uuid->toBase58();
+ $a[Caster::PREFIX_VIRTUAL.'toBase32'] = $uuid->toBase32();
+
+ // symfony/uid >= 5.3
+ if (method_exists($uuid, 'getDateTime')) {
+ $a[Caster::PREFIX_VIRTUAL.'time'] = $uuid->getDateTime()->format('Y-m-d H:i:s.u \U\T\C');
+ }
+
+ return $a;
+ }
+
+ /**
+ * @return array
+ */
+ public static function castUlid(Ulid $ulid, array $a, Stub $stub, bool $isNested)
+ {
+ $a[Caster::PREFIX_VIRTUAL.'toBase58'] = $ulid->toBase58();
+ $a[Caster::PREFIX_VIRTUAL.'toRfc4122'] = $ulid->toRfc4122();
+
+ // symfony/uid >= 5.3
+ if (method_exists($ulid, 'getDateTime')) {
+ $a[Caster::PREFIX_VIRTUAL.'time'] = $ulid->getDateTime()->format('Y-m-d H:i:s.v \U\T\C');
+ }
+
+ return $a;
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Caster/TraceStub.php b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/TraceStub.php
new file mode 100644
index 000000000..d215d8db0
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/TraceStub.php
@@ -0,0 +1,36 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Caster;
+
+use Symfony\Component\VarDumper\Cloner\Stub;
+
+/**
+ * Represents a backtrace as returned by debug_backtrace() or Exception->getTrace().
+ *
+ * @author Nicolas Grekas
+ */
+class TraceStub extends Stub
+{
+ public $keepArgs;
+ public $sliceOffset;
+ public $sliceLength;
+ public $numberingOffset;
+
+ public function __construct(array $trace, bool $keepArgs = true, int $sliceOffset = 0, ?int $sliceLength = null, int $numberingOffset = 0)
+ {
+ $this->value = $trace;
+ $this->keepArgs = $keepArgs;
+ $this->sliceOffset = $sliceOffset;
+ $this->sliceLength = $sliceLength;
+ $this->numberingOffset = $numberingOffset;
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Caster/UninitializedStub.php b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/UninitializedStub.php
new file mode 100644
index 000000000..a9bdd9b81
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/UninitializedStub.php
@@ -0,0 +1,25 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Caster;
+
+/**
+ * Represents an uninitialized property.
+ *
+ * @author Nicolas Grekas
+ */
+class UninitializedStub extends ConstStub
+{
+ public function __construct(\ReflectionProperty $property)
+ {
+ parent::__construct('?'.($property->hasType() ? ' '.$property->getType() : ''), 'Uninitialized property');
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Caster/UuidCaster.php b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/UuidCaster.php
new file mode 100644
index 000000000..b10277457
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/UuidCaster.php
@@ -0,0 +1,30 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Caster;
+
+use Ramsey\Uuid\UuidInterface;
+use Symfony\Component\VarDumper\Cloner\Stub;
+
+/**
+ * @author Grégoire Pineau
+ */
+final class UuidCaster
+{
+ public static function castRamseyUuid(UuidInterface $c, array $a, Stub $stub, bool $isNested): array
+ {
+ $a += [
+ Caster::PREFIX_VIRTUAL.'uuid' => (string) $c,
+ ];
+
+ return $a;
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Caster/XmlReaderCaster.php b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/XmlReaderCaster.php
new file mode 100644
index 000000000..1cfcf4dd8
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/XmlReaderCaster.php
@@ -0,0 +1,95 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Caster;
+
+use Symfony\Component\VarDumper\Cloner\Stub;
+
+/**
+ * Casts XmlReader class to array representation.
+ *
+ * @author Baptiste Clavié
+ *
+ * @final
+ */
+class XmlReaderCaster
+{
+ private const NODE_TYPES = [
+ \XMLReader::NONE => 'NONE',
+ \XMLReader::ELEMENT => 'ELEMENT',
+ \XMLReader::ATTRIBUTE => 'ATTRIBUTE',
+ \XMLReader::TEXT => 'TEXT',
+ \XMLReader::CDATA => 'CDATA',
+ \XMLReader::ENTITY_REF => 'ENTITY_REF',
+ \XMLReader::ENTITY => 'ENTITY',
+ \XMLReader::PI => 'PI (Processing Instruction)',
+ \XMLReader::COMMENT => 'COMMENT',
+ \XMLReader::DOC => 'DOC',
+ \XMLReader::DOC_TYPE => 'DOC_TYPE',
+ \XMLReader::DOC_FRAGMENT => 'DOC_FRAGMENT',
+ \XMLReader::NOTATION => 'NOTATION',
+ \XMLReader::WHITESPACE => 'WHITESPACE',
+ \XMLReader::SIGNIFICANT_WHITESPACE => 'SIGNIFICANT_WHITESPACE',
+ \XMLReader::END_ELEMENT => 'END_ELEMENT',
+ \XMLReader::END_ENTITY => 'END_ENTITY',
+ \XMLReader::XML_DECLARATION => 'XML_DECLARATION',
+ ];
+
+ /**
+ * @return array
+ */
+ public static function castXmlReader(\XMLReader $reader, array $a, Stub $stub, bool $isNested)
+ {
+ try {
+ $properties = [
+ 'LOADDTD' => @$reader->getParserProperty(\XMLReader::LOADDTD),
+ 'DEFAULTATTRS' => @$reader->getParserProperty(\XMLReader::DEFAULTATTRS),
+ 'VALIDATE' => @$reader->getParserProperty(\XMLReader::VALIDATE),
+ 'SUBST_ENTITIES' => @$reader->getParserProperty(\XMLReader::SUBST_ENTITIES),
+ ];
+ } catch (\Error) {
+ $properties = [
+ 'LOADDTD' => false,
+ 'DEFAULTATTRS' => false,
+ 'VALIDATE' => false,
+ 'SUBST_ENTITIES' => false,
+ ];
+ }
+
+ $props = Caster::PREFIX_VIRTUAL.'parserProperties';
+ $info = [
+ 'localName' => $reader->localName,
+ 'prefix' => $reader->prefix,
+ 'nodeType' => new ConstStub(self::NODE_TYPES[$reader->nodeType], $reader->nodeType),
+ 'depth' => $reader->depth,
+ 'isDefault' => $reader->isDefault,
+ 'isEmptyElement' => \XMLReader::NONE === $reader->nodeType ? null : $reader->isEmptyElement,
+ 'xmlLang' => $reader->xmlLang,
+ 'attributeCount' => $reader->attributeCount,
+ 'value' => $reader->value,
+ 'namespaceURI' => $reader->namespaceURI,
+ 'baseURI' => $reader->baseURI ? new LinkStub($reader->baseURI) : $reader->baseURI,
+ $props => $properties,
+ ];
+
+ if ($info[$props] = Caster::filter($info[$props], Caster::EXCLUDE_EMPTY, [], $count)) {
+ $info[$props] = new EnumStub($info[$props]);
+ $info[$props]->cut = $count;
+ }
+
+ $a = Caster::filter($a, Caster::EXCLUDE_UNINITIALIZED, [], $count);
+ $info = Caster::filter($info, Caster::EXCLUDE_EMPTY, [], $count);
+ // +2 because hasValue and hasAttributes are always filtered
+ $stub->cut += $count + 2;
+
+ return $a + $info;
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Caster/XmlResourceCaster.php b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/XmlResourceCaster.php
new file mode 100644
index 000000000..0cf42584a
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Caster/XmlResourceCaster.php
@@ -0,0 +1,66 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Caster;
+
+use Symfony\Component\VarDumper\Cloner\Stub;
+
+/**
+ * Casts XML resources to array representation.
+ *
+ * @author Nicolas Grekas
+ *
+ * @final
+ */
+class XmlResourceCaster
+{
+ private const XML_ERRORS = [
+ \XML_ERROR_NONE => 'XML_ERROR_NONE',
+ \XML_ERROR_NO_MEMORY => 'XML_ERROR_NO_MEMORY',
+ \XML_ERROR_SYNTAX => 'XML_ERROR_SYNTAX',
+ \XML_ERROR_NO_ELEMENTS => 'XML_ERROR_NO_ELEMENTS',
+ \XML_ERROR_INVALID_TOKEN => 'XML_ERROR_INVALID_TOKEN',
+ \XML_ERROR_UNCLOSED_TOKEN => 'XML_ERROR_UNCLOSED_TOKEN',
+ \XML_ERROR_PARTIAL_CHAR => 'XML_ERROR_PARTIAL_CHAR',
+ \XML_ERROR_TAG_MISMATCH => 'XML_ERROR_TAG_MISMATCH',
+ \XML_ERROR_DUPLICATE_ATTRIBUTE => 'XML_ERROR_DUPLICATE_ATTRIBUTE',
+ \XML_ERROR_JUNK_AFTER_DOC_ELEMENT => 'XML_ERROR_JUNK_AFTER_DOC_ELEMENT',
+ \XML_ERROR_PARAM_ENTITY_REF => 'XML_ERROR_PARAM_ENTITY_REF',
+ \XML_ERROR_UNDEFINED_ENTITY => 'XML_ERROR_UNDEFINED_ENTITY',
+ \XML_ERROR_RECURSIVE_ENTITY_REF => 'XML_ERROR_RECURSIVE_ENTITY_REF',
+ \XML_ERROR_ASYNC_ENTITY => 'XML_ERROR_ASYNC_ENTITY',
+ \XML_ERROR_BAD_CHAR_REF => 'XML_ERROR_BAD_CHAR_REF',
+ \XML_ERROR_BINARY_ENTITY_REF => 'XML_ERROR_BINARY_ENTITY_REF',
+ \XML_ERROR_ATTRIBUTE_EXTERNAL_ENTITY_REF => 'XML_ERROR_ATTRIBUTE_EXTERNAL_ENTITY_REF',
+ \XML_ERROR_MISPLACED_XML_PI => 'XML_ERROR_MISPLACED_XML_PI',
+ \XML_ERROR_UNKNOWN_ENCODING => 'XML_ERROR_UNKNOWN_ENCODING',
+ \XML_ERROR_INCORRECT_ENCODING => 'XML_ERROR_INCORRECT_ENCODING',
+ \XML_ERROR_UNCLOSED_CDATA_SECTION => 'XML_ERROR_UNCLOSED_CDATA_SECTION',
+ \XML_ERROR_EXTERNAL_ENTITY_HANDLING => 'XML_ERROR_EXTERNAL_ENTITY_HANDLING',
+ ];
+
+ /**
+ * @return array
+ */
+ public static function castXml($h, array $a, Stub $stub, bool $isNested)
+ {
+ $a['current_byte_index'] = xml_get_current_byte_index($h);
+ $a['current_column_number'] = xml_get_current_column_number($h);
+ $a['current_line_number'] = xml_get_current_line_number($h);
+ $a['error_code'] = xml_get_error_code($h);
+
+ if (isset(self::XML_ERRORS[$a['error_code']])) {
+ $a['error_code'] = new ConstStub(self::XML_ERRORS[$a['error_code']], $a['error_code']);
+ }
+
+ return $a;
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Cloner/AbstractCloner.php b/data/web/inc/lib/vendor/symfony/var-dumper/Cloner/AbstractCloner.php
new file mode 100644
index 000000000..fc330bae2
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Cloner/AbstractCloner.php
@@ -0,0 +1,397 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Cloner;
+
+use Symfony\Component\VarDumper\Caster\Caster;
+use Symfony\Component\VarDumper\Exception\ThrowingCasterException;
+
+/**
+ * AbstractCloner implements a generic caster mechanism for objects and resources.
+ *
+ * @author Nicolas Grekas
+ */
+abstract class AbstractCloner implements ClonerInterface
+{
+ public static $defaultCasters = [
+ '__PHP_Incomplete_Class' => ['Symfony\Component\VarDumper\Caster\Caster', 'castPhpIncompleteClass'],
+
+ 'Symfony\Component\VarDumper\Caster\CutStub' => ['Symfony\Component\VarDumper\Caster\StubCaster', 'castStub'],
+ 'Symfony\Component\VarDumper\Caster\CutArrayStub' => ['Symfony\Component\VarDumper\Caster\StubCaster', 'castCutArray'],
+ 'Symfony\Component\VarDumper\Caster\ConstStub' => ['Symfony\Component\VarDumper\Caster\StubCaster', 'castStub'],
+ 'Symfony\Component\VarDumper\Caster\EnumStub' => ['Symfony\Component\VarDumper\Caster\StubCaster', 'castEnum'],
+ 'Symfony\Component\VarDumper\Caster\ScalarStub' => ['Symfony\Component\VarDumper\Caster\StubCaster', 'castScalar'],
+
+ 'Fiber' => ['Symfony\Component\VarDumper\Caster\FiberCaster', 'castFiber'],
+
+ 'Closure' => ['Symfony\Component\VarDumper\Caster\ReflectionCaster', 'castClosure'],
+ 'Generator' => ['Symfony\Component\VarDumper\Caster\ReflectionCaster', 'castGenerator'],
+ 'ReflectionType' => ['Symfony\Component\VarDumper\Caster\ReflectionCaster', 'castType'],
+ 'ReflectionAttribute' => ['Symfony\Component\VarDumper\Caster\ReflectionCaster', 'castAttribute'],
+ 'ReflectionGenerator' => ['Symfony\Component\VarDumper\Caster\ReflectionCaster', 'castReflectionGenerator'],
+ 'ReflectionClass' => ['Symfony\Component\VarDumper\Caster\ReflectionCaster', 'castClass'],
+ 'ReflectionClassConstant' => ['Symfony\Component\VarDumper\Caster\ReflectionCaster', 'castClassConstant'],
+ 'ReflectionFunctionAbstract' => ['Symfony\Component\VarDumper\Caster\ReflectionCaster', 'castFunctionAbstract'],
+ 'ReflectionMethod' => ['Symfony\Component\VarDumper\Caster\ReflectionCaster', 'castMethod'],
+ 'ReflectionParameter' => ['Symfony\Component\VarDumper\Caster\ReflectionCaster', 'castParameter'],
+ 'ReflectionProperty' => ['Symfony\Component\VarDumper\Caster\ReflectionCaster', 'castProperty'],
+ 'ReflectionReference' => ['Symfony\Component\VarDumper\Caster\ReflectionCaster', 'castReference'],
+ 'ReflectionExtension' => ['Symfony\Component\VarDumper\Caster\ReflectionCaster', 'castExtension'],
+ 'ReflectionZendExtension' => ['Symfony\Component\VarDumper\Caster\ReflectionCaster', 'castZendExtension'],
+
+ 'Doctrine\Common\Persistence\ObjectManager' => ['Symfony\Component\VarDumper\Caster\StubCaster', 'cutInternals'],
+ 'Doctrine\Common\Proxy\Proxy' => ['Symfony\Component\VarDumper\Caster\DoctrineCaster', 'castCommonProxy'],
+ 'Doctrine\ORM\Proxy\Proxy' => ['Symfony\Component\VarDumper\Caster\DoctrineCaster', 'castOrmProxy'],
+ 'Doctrine\ORM\PersistentCollection' => ['Symfony\Component\VarDumper\Caster\DoctrineCaster', 'castPersistentCollection'],
+ 'Doctrine\Persistence\ObjectManager' => ['Symfony\Component\VarDumper\Caster\StubCaster', 'cutInternals'],
+
+ 'DOMException' => ['Symfony\Component\VarDumper\Caster\DOMCaster', 'castException'],
+ 'DOMStringList' => ['Symfony\Component\VarDumper\Caster\DOMCaster', 'castLength'],
+ 'DOMNameList' => ['Symfony\Component\VarDumper\Caster\DOMCaster', 'castLength'],
+ 'DOMImplementation' => ['Symfony\Component\VarDumper\Caster\DOMCaster', 'castImplementation'],
+ 'DOMImplementationList' => ['Symfony\Component\VarDumper\Caster\DOMCaster', 'castLength'],
+ 'DOMNode' => ['Symfony\Component\VarDumper\Caster\DOMCaster', 'castNode'],
+ 'DOMNameSpaceNode' => ['Symfony\Component\VarDumper\Caster\DOMCaster', 'castNameSpaceNode'],
+ 'DOMDocument' => ['Symfony\Component\VarDumper\Caster\DOMCaster', 'castDocument'],
+ 'DOMNodeList' => ['Symfony\Component\VarDumper\Caster\DOMCaster', 'castLength'],
+ 'DOMNamedNodeMap' => ['Symfony\Component\VarDumper\Caster\DOMCaster', 'castLength'],
+ 'DOMCharacterData' => ['Symfony\Component\VarDumper\Caster\DOMCaster', 'castCharacterData'],
+ 'DOMAttr' => ['Symfony\Component\VarDumper\Caster\DOMCaster', 'castAttr'],
+ 'DOMElement' => ['Symfony\Component\VarDumper\Caster\DOMCaster', 'castElement'],
+ 'DOMText' => ['Symfony\Component\VarDumper\Caster\DOMCaster', 'castText'],
+ 'DOMDocumentType' => ['Symfony\Component\VarDumper\Caster\DOMCaster', 'castDocumentType'],
+ 'DOMNotation' => ['Symfony\Component\VarDumper\Caster\DOMCaster', 'castNotation'],
+ 'DOMEntity' => ['Symfony\Component\VarDumper\Caster\DOMCaster', 'castEntity'],
+ 'DOMProcessingInstruction' => ['Symfony\Component\VarDumper\Caster\DOMCaster', 'castProcessingInstruction'],
+ 'DOMXPath' => ['Symfony\Component\VarDumper\Caster\DOMCaster', 'castXPath'],
+
+ 'XMLReader' => ['Symfony\Component\VarDumper\Caster\XmlReaderCaster', 'castXmlReader'],
+
+ 'ErrorException' => ['Symfony\Component\VarDumper\Caster\ExceptionCaster', 'castErrorException'],
+ 'Exception' => ['Symfony\Component\VarDumper\Caster\ExceptionCaster', 'castException'],
+ 'Error' => ['Symfony\Component\VarDumper\Caster\ExceptionCaster', 'castError'],
+ 'Symfony\Bridge\Monolog\Logger' => ['Symfony\Component\VarDumper\Caster\StubCaster', 'cutInternals'],
+ 'Symfony\Component\DependencyInjection\ContainerInterface' => ['Symfony\Component\VarDumper\Caster\StubCaster', 'cutInternals'],
+ 'Symfony\Component\EventDispatcher\EventDispatcherInterface' => ['Symfony\Component\VarDumper\Caster\StubCaster', 'cutInternals'],
+ 'Symfony\Component\HttpClient\AmpHttpClient' => ['Symfony\Component\VarDumper\Caster\SymfonyCaster', 'castHttpClient'],
+ 'Symfony\Component\HttpClient\CurlHttpClient' => ['Symfony\Component\VarDumper\Caster\SymfonyCaster', 'castHttpClient'],
+ 'Symfony\Component\HttpClient\NativeHttpClient' => ['Symfony\Component\VarDumper\Caster\SymfonyCaster', 'castHttpClient'],
+ 'Symfony\Component\HttpClient\Response\AmpResponse' => ['Symfony\Component\VarDumper\Caster\SymfonyCaster', 'castHttpClientResponse'],
+ 'Symfony\Component\HttpClient\Response\CurlResponse' => ['Symfony\Component\VarDumper\Caster\SymfonyCaster', 'castHttpClientResponse'],
+ 'Symfony\Component\HttpClient\Response\NativeResponse' => ['Symfony\Component\VarDumper\Caster\SymfonyCaster', 'castHttpClientResponse'],
+ 'Symfony\Component\HttpFoundation\Request' => ['Symfony\Component\VarDumper\Caster\SymfonyCaster', 'castRequest'],
+ 'Symfony\Component\Uid\Ulid' => ['Symfony\Component\VarDumper\Caster\SymfonyCaster', 'castUlid'],
+ 'Symfony\Component\Uid\Uuid' => ['Symfony\Component\VarDumper\Caster\SymfonyCaster', 'castUuid'],
+ 'Symfony\Component\VarExporter\Internal\LazyObjectState' => ['Symfony\Component\VarDumper\Caster\SymfonyCaster', 'castLazyObjectState'],
+ 'Symfony\Component\VarDumper\Exception\ThrowingCasterException' => ['Symfony\Component\VarDumper\Caster\ExceptionCaster', 'castThrowingCasterException'],
+ 'Symfony\Component\VarDumper\Caster\TraceStub' => ['Symfony\Component\VarDumper\Caster\ExceptionCaster', 'castTraceStub'],
+ 'Symfony\Component\VarDumper\Caster\FrameStub' => ['Symfony\Component\VarDumper\Caster\ExceptionCaster', 'castFrameStub'],
+ 'Symfony\Component\VarDumper\Cloner\AbstractCloner' => ['Symfony\Component\VarDumper\Caster\StubCaster', 'cutInternals'],
+ 'Symfony\Component\ErrorHandler\Exception\FlattenException' => ['Symfony\Component\VarDumper\Caster\ExceptionCaster', 'castFlattenException'],
+ 'Symfony\Component\ErrorHandler\Exception\SilencedErrorContext' => ['Symfony\Component\VarDumper\Caster\ExceptionCaster', 'castSilencedErrorContext'],
+
+ 'Imagine\Image\ImageInterface' => ['Symfony\Component\VarDumper\Caster\ImagineCaster', 'castImage'],
+
+ 'Ramsey\Uuid\UuidInterface' => ['Symfony\Component\VarDumper\Caster\UuidCaster', 'castRamseyUuid'],
+
+ 'ProxyManager\Proxy\ProxyInterface' => ['Symfony\Component\VarDumper\Caster\ProxyManagerCaster', 'castProxy'],
+ 'PHPUnit_Framework_MockObject_MockObject' => ['Symfony\Component\VarDumper\Caster\StubCaster', 'cutInternals'],
+ 'PHPUnit\Framework\MockObject\MockObject' => ['Symfony\Component\VarDumper\Caster\StubCaster', 'cutInternals'],
+ 'PHPUnit\Framework\MockObject\Stub' => ['Symfony\Component\VarDumper\Caster\StubCaster', 'cutInternals'],
+ 'Prophecy\Prophecy\ProphecySubjectInterface' => ['Symfony\Component\VarDumper\Caster\StubCaster', 'cutInternals'],
+ 'Mockery\MockInterface' => ['Symfony\Component\VarDumper\Caster\StubCaster', 'cutInternals'],
+
+ 'PDO' => ['Symfony\Component\VarDumper\Caster\PdoCaster', 'castPdo'],
+ 'PDOStatement' => ['Symfony\Component\VarDumper\Caster\PdoCaster', 'castPdoStatement'],
+
+ 'AMQPConnection' => ['Symfony\Component\VarDumper\Caster\AmqpCaster', 'castConnection'],
+ 'AMQPChannel' => ['Symfony\Component\VarDumper\Caster\AmqpCaster', 'castChannel'],
+ 'AMQPQueue' => ['Symfony\Component\VarDumper\Caster\AmqpCaster', 'castQueue'],
+ 'AMQPExchange' => ['Symfony\Component\VarDumper\Caster\AmqpCaster', 'castExchange'],
+ 'AMQPEnvelope' => ['Symfony\Component\VarDumper\Caster\AmqpCaster', 'castEnvelope'],
+
+ 'ArrayObject' => ['Symfony\Component\VarDumper\Caster\SplCaster', 'castArrayObject'],
+ 'ArrayIterator' => ['Symfony\Component\VarDumper\Caster\SplCaster', 'castArrayIterator'],
+ 'SplDoublyLinkedList' => ['Symfony\Component\VarDumper\Caster\SplCaster', 'castDoublyLinkedList'],
+ 'SplFileInfo' => ['Symfony\Component\VarDumper\Caster\SplCaster', 'castFileInfo'],
+ 'SplFileObject' => ['Symfony\Component\VarDumper\Caster\SplCaster', 'castFileObject'],
+ 'SplHeap' => ['Symfony\Component\VarDumper\Caster\SplCaster', 'castHeap'],
+ 'SplObjectStorage' => ['Symfony\Component\VarDumper\Caster\SplCaster', 'castObjectStorage'],
+ 'SplPriorityQueue' => ['Symfony\Component\VarDumper\Caster\SplCaster', 'castHeap'],
+ 'OuterIterator' => ['Symfony\Component\VarDumper\Caster\SplCaster', 'castOuterIterator'],
+ 'WeakMap' => ['Symfony\Component\VarDumper\Caster\SplCaster', 'castWeakMap'],
+ 'WeakReference' => ['Symfony\Component\VarDumper\Caster\SplCaster', 'castWeakReference'],
+
+ 'Redis' => ['Symfony\Component\VarDumper\Caster\RedisCaster', 'castRedis'],
+ 'Relay\Relay' => ['Symfony\Component\VarDumper\Caster\RedisCaster', 'castRedis'],
+ 'RedisArray' => ['Symfony\Component\VarDumper\Caster\RedisCaster', 'castRedisArray'],
+ 'RedisCluster' => ['Symfony\Component\VarDumper\Caster\RedisCaster', 'castRedisCluster'],
+
+ 'DateTimeInterface' => ['Symfony\Component\VarDumper\Caster\DateCaster', 'castDateTime'],
+ 'DateInterval' => ['Symfony\Component\VarDumper\Caster\DateCaster', 'castInterval'],
+ 'DateTimeZone' => ['Symfony\Component\VarDumper\Caster\DateCaster', 'castTimeZone'],
+ 'DatePeriod' => ['Symfony\Component\VarDumper\Caster\DateCaster', 'castPeriod'],
+
+ 'GMP' => ['Symfony\Component\VarDumper\Caster\GmpCaster', 'castGmp'],
+
+ 'MessageFormatter' => ['Symfony\Component\VarDumper\Caster\IntlCaster', 'castMessageFormatter'],
+ 'NumberFormatter' => ['Symfony\Component\VarDumper\Caster\IntlCaster', 'castNumberFormatter'],
+ 'IntlTimeZone' => ['Symfony\Component\VarDumper\Caster\IntlCaster', 'castIntlTimeZone'],
+ 'IntlCalendar' => ['Symfony\Component\VarDumper\Caster\IntlCaster', 'castIntlCalendar'],
+ 'IntlDateFormatter' => ['Symfony\Component\VarDumper\Caster\IntlCaster', 'castIntlDateFormatter'],
+
+ 'Memcached' => ['Symfony\Component\VarDumper\Caster\MemcachedCaster', 'castMemcached'],
+
+ 'Ds\Collection' => ['Symfony\Component\VarDumper\Caster\DsCaster', 'castCollection'],
+ 'Ds\Map' => ['Symfony\Component\VarDumper\Caster\DsCaster', 'castMap'],
+ 'Ds\Pair' => ['Symfony\Component\VarDumper\Caster\DsCaster', 'castPair'],
+ 'Symfony\Component\VarDumper\Caster\DsPairStub' => ['Symfony\Component\VarDumper\Caster\DsCaster', 'castPairStub'],
+
+ 'mysqli_driver' => ['Symfony\Component\VarDumper\Caster\MysqliCaster', 'castMysqliDriver'],
+
+ 'CurlHandle' => ['Symfony\Component\VarDumper\Caster\ResourceCaster', 'castCurl'],
+
+ ':dba' => ['Symfony\Component\VarDumper\Caster\ResourceCaster', 'castDba'],
+ ':dba persistent' => ['Symfony\Component\VarDumper\Caster\ResourceCaster', 'castDba'],
+
+ 'GdImage' => ['Symfony\Component\VarDumper\Caster\ResourceCaster', 'castGd'],
+ ':gd' => ['Symfony\Component\VarDumper\Caster\ResourceCaster', 'castGd'],
+
+ ':pgsql large object' => ['Symfony\Component\VarDumper\Caster\PgSqlCaster', 'castLargeObject'],
+ ':pgsql link' => ['Symfony\Component\VarDumper\Caster\PgSqlCaster', 'castLink'],
+ ':pgsql link persistent' => ['Symfony\Component\VarDumper\Caster\PgSqlCaster', 'castLink'],
+ ':pgsql result' => ['Symfony\Component\VarDumper\Caster\PgSqlCaster', 'castResult'],
+ ':process' => ['Symfony\Component\VarDumper\Caster\ResourceCaster', 'castProcess'],
+ ':stream' => ['Symfony\Component\VarDumper\Caster\ResourceCaster', 'castStream'],
+
+ 'OpenSSLCertificate' => ['Symfony\Component\VarDumper\Caster\ResourceCaster', 'castOpensslX509'],
+ ':OpenSSL X.509' => ['Symfony\Component\VarDumper\Caster\ResourceCaster', 'castOpensslX509'],
+
+ ':persistent stream' => ['Symfony\Component\VarDumper\Caster\ResourceCaster', 'castStream'],
+ ':stream-context' => ['Symfony\Component\VarDumper\Caster\ResourceCaster', 'castStreamContext'],
+
+ 'XmlParser' => ['Symfony\Component\VarDumper\Caster\XmlResourceCaster', 'castXml'],
+ ':xml' => ['Symfony\Component\VarDumper\Caster\XmlResourceCaster', 'castXml'],
+
+ 'RdKafka' => ['Symfony\Component\VarDumper\Caster\RdKafkaCaster', 'castRdKafka'],
+ 'RdKafka\Conf' => ['Symfony\Component\VarDumper\Caster\RdKafkaCaster', 'castConf'],
+ 'RdKafka\KafkaConsumer' => ['Symfony\Component\VarDumper\Caster\RdKafkaCaster', 'castKafkaConsumer'],
+ 'RdKafka\Metadata\Broker' => ['Symfony\Component\VarDumper\Caster\RdKafkaCaster', 'castBrokerMetadata'],
+ 'RdKafka\Metadata\Collection' => ['Symfony\Component\VarDumper\Caster\RdKafkaCaster', 'castCollectionMetadata'],
+ 'RdKafka\Metadata\Partition' => ['Symfony\Component\VarDumper\Caster\RdKafkaCaster', 'castPartitionMetadata'],
+ 'RdKafka\Metadata\Topic' => ['Symfony\Component\VarDumper\Caster\RdKafkaCaster', 'castTopicMetadata'],
+ 'RdKafka\Message' => ['Symfony\Component\VarDumper\Caster\RdKafkaCaster', 'castMessage'],
+ 'RdKafka\Topic' => ['Symfony\Component\VarDumper\Caster\RdKafkaCaster', 'castTopic'],
+ 'RdKafka\TopicPartition' => ['Symfony\Component\VarDumper\Caster\RdKafkaCaster', 'castTopicPartition'],
+ 'RdKafka\TopicConf' => ['Symfony\Component\VarDumper\Caster\RdKafkaCaster', 'castTopicConf'],
+
+ 'FFI\CData' => ['Symfony\Component\VarDumper\Caster\FFICaster', 'castCTypeOrCData'],
+ 'FFI\CType' => ['Symfony\Component\VarDumper\Caster\FFICaster', 'castCTypeOrCData'],
+ ];
+
+ protected $maxItems = 2500;
+ protected $maxString = -1;
+ protected $minDepth = 1;
+
+ /**
+ * @var array>
+ */
+ private array $casters = [];
+
+ /**
+ * @var callable|null
+ */
+ private $prevErrorHandler;
+
+ private array $classInfo = [];
+ private int $filter = 0;
+
+ /**
+ * @param callable[]|null $casters A map of casters
+ *
+ * @see addCasters
+ */
+ public function __construct(?array $casters = null)
+ {
+ $this->addCasters($casters ?? static::$defaultCasters);
+ }
+
+ /**
+ * Adds casters for resources and objects.
+ *
+ * Maps resources or objects types to a callback.
+ * Types are in the key, with a callable caster for value.
+ * Resource types are to be prefixed with a `:`,
+ * see e.g. static::$defaultCasters.
+ *
+ * @param callable[] $casters A map of casters
+ *
+ * @return void
+ */
+ public function addCasters(array $casters)
+ {
+ foreach ($casters as $type => $callback) {
+ $this->casters[$type][] = $callback;
+ }
+ }
+
+ /**
+ * Sets the maximum number of items to clone past the minimum depth in nested structures.
+ *
+ * @return void
+ */
+ public function setMaxItems(int $maxItems)
+ {
+ $this->maxItems = $maxItems;
+ }
+
+ /**
+ * Sets the maximum cloned length for strings.
+ *
+ * @return void
+ */
+ public function setMaxString(int $maxString)
+ {
+ $this->maxString = $maxString;
+ }
+
+ /**
+ * Sets the minimum tree depth where we are guaranteed to clone all the items. After this
+ * depth is reached, only setMaxItems items will be cloned.
+ *
+ * @return void
+ */
+ public function setMinDepth(int $minDepth)
+ {
+ $this->minDepth = $minDepth;
+ }
+
+ /**
+ * Clones a PHP variable.
+ *
+ * @param int $filter A bit field of Caster::EXCLUDE_* constants
+ */
+ public function cloneVar(mixed $var, int $filter = 0): Data
+ {
+ $this->prevErrorHandler = set_error_handler(function ($type, $msg, $file, $line, $context = []) {
+ if (\E_RECOVERABLE_ERROR === $type || \E_USER_ERROR === $type) {
+ // Cloner never dies
+ throw new \ErrorException($msg, 0, $type, $file, $line);
+ }
+
+ if ($this->prevErrorHandler) {
+ return ($this->prevErrorHandler)($type, $msg, $file, $line, $context);
+ }
+
+ return false;
+ });
+ $this->filter = $filter;
+
+ if ($gc = gc_enabled()) {
+ gc_disable();
+ }
+ try {
+ return new Data($this->doClone($var));
+ } finally {
+ if ($gc) {
+ gc_enable();
+ }
+ restore_error_handler();
+ $this->prevErrorHandler = null;
+ }
+ }
+
+ /**
+ * Effectively clones the PHP variable.
+ */
+ abstract protected function doClone(mixed $var): array;
+
+ /**
+ * Casts an object to an array representation.
+ *
+ * @param bool $isNested True if the object is nested in the dumped structure
+ */
+ protected function castObject(Stub $stub, bool $isNested): array
+ {
+ $obj = $stub->value;
+ $class = $stub->class;
+
+ if (str_contains($class, "@anonymous\0")) {
+ $stub->class = get_debug_type($obj);
+ }
+ if (isset($this->classInfo[$class])) {
+ [$i, $parents, $hasDebugInfo, $fileInfo] = $this->classInfo[$class];
+ } else {
+ $i = 2;
+ $parents = [$class];
+ $hasDebugInfo = method_exists($class, '__debugInfo');
+
+ foreach (class_parents($class) as $p) {
+ $parents[] = $p;
+ ++$i;
+ }
+ foreach (class_implements($class) as $p) {
+ $parents[] = $p;
+ ++$i;
+ }
+ $parents[] = '*';
+
+ $r = new \ReflectionClass($class);
+ $fileInfo = $r->isInternal() || $r->isSubclassOf(Stub::class) ? [] : [
+ 'file' => $r->getFileName(),
+ 'line' => $r->getStartLine(),
+ ];
+
+ $this->classInfo[$class] = [$i, $parents, $hasDebugInfo, $fileInfo];
+ }
+
+ $stub->attr += $fileInfo;
+ $a = Caster::castObject($obj, $class, $hasDebugInfo, $stub->class);
+
+ try {
+ while ($i--) {
+ if (!empty($this->casters[$p = $parents[$i]])) {
+ foreach ($this->casters[$p] as $callback) {
+ $a = $callback($obj, $a, $stub, $isNested, $this->filter);
+ }
+ }
+ }
+ } catch (\Exception $e) {
+ $a = [(Stub::TYPE_OBJECT === $stub->type ? Caster::PREFIX_VIRTUAL : '').'⚠' => new ThrowingCasterException($e)] + $a;
+ }
+
+ return $a;
+ }
+
+ /**
+ * Casts a resource to an array representation.
+ *
+ * @param bool $isNested True if the object is nested in the dumped structure
+ */
+ protected function castResource(Stub $stub, bool $isNested): array
+ {
+ $a = [];
+ $res = $stub->value;
+ $type = $stub->class;
+
+ try {
+ if (!empty($this->casters[':'.$type])) {
+ foreach ($this->casters[':'.$type] as $callback) {
+ $a = $callback($res, $a, $stub, $isNested, $this->filter);
+ }
+ }
+ } catch (\Exception $e) {
+ $a = [(Stub::TYPE_OBJECT === $stub->type ? Caster::PREFIX_VIRTUAL : '').'⚠' => new ThrowingCasterException($e)] + $a;
+ }
+
+ return $a;
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Cloner/ClonerInterface.php b/data/web/inc/lib/vendor/symfony/var-dumper/Cloner/ClonerInterface.php
new file mode 100644
index 000000000..5a8e2e4c5
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Cloner/ClonerInterface.php
@@ -0,0 +1,23 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Cloner;
+
+/**
+ * @author Nicolas Grekas
+ */
+interface ClonerInterface
+{
+ /**
+ * Clones a PHP variable.
+ */
+ public function cloneVar(mixed $var): Data;
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Cloner/Cursor.php b/data/web/inc/lib/vendor/symfony/var-dumper/Cloner/Cursor.php
new file mode 100644
index 000000000..1fd796d67
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Cloner/Cursor.php
@@ -0,0 +1,43 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Cloner;
+
+/**
+ * Represents the current state of a dumper while dumping.
+ *
+ * @author Nicolas Grekas
+ */
+class Cursor
+{
+ public const HASH_INDEXED = Stub::ARRAY_INDEXED;
+ public const HASH_ASSOC = Stub::ARRAY_ASSOC;
+ public const HASH_OBJECT = Stub::TYPE_OBJECT;
+ public const HASH_RESOURCE = Stub::TYPE_RESOURCE;
+
+ public $depth = 0;
+ public $refIndex = 0;
+ public $softRefTo = 0;
+ public $softRefCount = 0;
+ public $softRefHandle = 0;
+ public $hardRefTo = 0;
+ public $hardRefCount = 0;
+ public $hardRefHandle = 0;
+ public $hashType;
+ public $hashKey;
+ public $hashKeyIsBinary;
+ public $hashIndex = 0;
+ public $hashLength = 0;
+ public $hashCut = 0;
+ public $stop = false;
+ public $attr = [];
+ public $skipChildren = false;
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Cloner/Data.php b/data/web/inc/lib/vendor/symfony/var-dumper/Cloner/Data.php
new file mode 100644
index 000000000..16f51b0c7
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Cloner/Data.php
@@ -0,0 +1,434 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Cloner;
+
+use Symfony\Component\VarDumper\Caster\Caster;
+use Symfony\Component\VarDumper\Dumper\ContextProvider\SourceContextProvider;
+
+/**
+ * @author Nicolas Grekas
+ */
+class Data implements \ArrayAccess, \Countable, \IteratorAggregate, \Stringable
+{
+ private array $data;
+ private int $position = 0;
+ private int|string $key = 0;
+ private int $maxDepth = 20;
+ private int $maxItemsPerDepth = -1;
+ private int $useRefHandles = -1;
+ private array $context = [];
+
+ /**
+ * @param array $data An array as returned by ClonerInterface::cloneVar()
+ */
+ public function __construct(array $data)
+ {
+ $this->data = $data;
+ }
+
+ public function getType(): ?string
+ {
+ $item = $this->data[$this->position][$this->key];
+
+ if ($item instanceof Stub && Stub::TYPE_REF === $item->type && !$item->position) {
+ $item = $item->value;
+ }
+ if (!$item instanceof Stub) {
+ return \gettype($item);
+ }
+ if (Stub::TYPE_STRING === $item->type) {
+ return 'string';
+ }
+ if (Stub::TYPE_ARRAY === $item->type) {
+ return 'array';
+ }
+ if (Stub::TYPE_OBJECT === $item->type) {
+ return $item->class;
+ }
+ if (Stub::TYPE_RESOURCE === $item->type) {
+ return $item->class.' resource';
+ }
+
+ return null;
+ }
+
+ /**
+ * Returns a native representation of the original value.
+ *
+ * @param array|bool $recursive Whether values should be resolved recursively or not
+ *
+ * @return string|int|float|bool|array|Data[]|null
+ */
+ public function getValue(array|bool $recursive = false): string|int|float|bool|array|null
+ {
+ $item = $this->data[$this->position][$this->key];
+
+ if ($item instanceof Stub && Stub::TYPE_REF === $item->type && !$item->position) {
+ $item = $item->value;
+ }
+ if (!($item = $this->getStub($item)) instanceof Stub) {
+ return $item;
+ }
+ if (Stub::TYPE_STRING === $item->type) {
+ return $item->value;
+ }
+
+ $children = $item->position ? $this->data[$item->position] : [];
+
+ foreach ($children as $k => $v) {
+ if ($recursive && !($v = $this->getStub($v)) instanceof Stub) {
+ continue;
+ }
+ $children[$k] = clone $this;
+ $children[$k]->key = $k;
+ $children[$k]->position = $item->position;
+
+ if ($recursive) {
+ if (Stub::TYPE_REF === $v->type && ($v = $this->getStub($v->value)) instanceof Stub) {
+ $recursive = (array) $recursive;
+ if (isset($recursive[$v->position])) {
+ continue;
+ }
+ $recursive[$v->position] = true;
+ }
+ $children[$k] = $children[$k]->getValue($recursive);
+ }
+ }
+
+ return $children;
+ }
+
+ public function count(): int
+ {
+ return \count($this->getValue());
+ }
+
+ public function getIterator(): \Traversable
+ {
+ if (!\is_array($value = $this->getValue())) {
+ throw new \LogicException(sprintf('"%s" object holds non-iterable type "%s".', self::class, get_debug_type($value)));
+ }
+
+ yield from $value;
+ }
+
+ /**
+ * @return mixed
+ */
+ public function __get(string $key)
+ {
+ if (null !== $data = $this->seek($key)) {
+ $item = $this->getStub($data->data[$data->position][$data->key]);
+
+ return $item instanceof Stub || [] === $item ? $data : $item;
+ }
+
+ return null;
+ }
+
+ public function __isset(string $key): bool
+ {
+ return null !== $this->seek($key);
+ }
+
+ public function offsetExists(mixed $key): bool
+ {
+ return $this->__isset($key);
+ }
+
+ public function offsetGet(mixed $key): mixed
+ {
+ return $this->__get($key);
+ }
+
+ public function offsetSet(mixed $key, mixed $value): void
+ {
+ throw new \BadMethodCallException(self::class.' objects are immutable.');
+ }
+
+ public function offsetUnset(mixed $key): void
+ {
+ throw new \BadMethodCallException(self::class.' objects are immutable.');
+ }
+
+ public function __toString(): string
+ {
+ $value = $this->getValue();
+
+ if (!\is_array($value)) {
+ return (string) $value;
+ }
+
+ return sprintf('%s (count=%d)', $this->getType(), \count($value));
+ }
+
+ /**
+ * Returns a depth limited clone of $this.
+ */
+ public function withMaxDepth(int $maxDepth): static
+ {
+ $data = clone $this;
+ $data->maxDepth = $maxDepth;
+
+ return $data;
+ }
+
+ /**
+ * Limits the number of elements per depth level.
+ */
+ public function withMaxItemsPerDepth(int $maxItemsPerDepth): static
+ {
+ $data = clone $this;
+ $data->maxItemsPerDepth = $maxItemsPerDepth;
+
+ return $data;
+ }
+
+ /**
+ * Enables/disables objects' identifiers tracking.
+ *
+ * @param bool $useRefHandles False to hide global ref. handles
+ */
+ public function withRefHandles(bool $useRefHandles): static
+ {
+ $data = clone $this;
+ $data->useRefHandles = $useRefHandles ? -1 : 0;
+
+ return $data;
+ }
+
+ public function withContext(array $context): static
+ {
+ $data = clone $this;
+ $data->context = $context;
+
+ return $data;
+ }
+
+ public function getContext(): array
+ {
+ return $this->context;
+ }
+
+ /**
+ * Seeks to a specific key in nested data structures.
+ */
+ public function seek(string|int $key): ?static
+ {
+ $item = $this->data[$this->position][$this->key];
+
+ if ($item instanceof Stub && Stub::TYPE_REF === $item->type && !$item->position) {
+ $item = $item->value;
+ }
+ if (!($item = $this->getStub($item)) instanceof Stub || !$item->position) {
+ return null;
+ }
+ $keys = [$key];
+
+ switch ($item->type) {
+ case Stub::TYPE_OBJECT:
+ $keys[] = Caster::PREFIX_DYNAMIC.$key;
+ $keys[] = Caster::PREFIX_PROTECTED.$key;
+ $keys[] = Caster::PREFIX_VIRTUAL.$key;
+ $keys[] = "\0$item->class\0$key";
+ // no break
+ case Stub::TYPE_ARRAY:
+ case Stub::TYPE_RESOURCE:
+ break;
+ default:
+ return null;
+ }
+
+ $data = null;
+ $children = $this->data[$item->position];
+
+ foreach ($keys as $key) {
+ if (isset($children[$key]) || \array_key_exists($key, $children)) {
+ $data = clone $this;
+ $data->key = $key;
+ $data->position = $item->position;
+ break;
+ }
+ }
+
+ return $data;
+ }
+
+ /**
+ * Dumps data with a DumperInterface dumper.
+ *
+ * @return void
+ */
+ public function dump(DumperInterface $dumper)
+ {
+ $refs = [0];
+ $cursor = new Cursor();
+ $cursor->hashType = -1;
+ $cursor->attr = $this->context[SourceContextProvider::class] ?? [];
+ $label = $this->context['label'] ?? '';
+
+ if ($cursor->attr || '' !== $label) {
+ $dumper->dumpScalar($cursor, 'label', $label);
+ }
+ $cursor->hashType = 0;
+ $this->dumpItem($dumper, $cursor, $refs, $this->data[$this->position][$this->key]);
+ }
+
+ /**
+ * Depth-first dumping of items.
+ *
+ * @param mixed $item A Stub object or the original value being dumped
+ */
+ private function dumpItem(DumperInterface $dumper, Cursor $cursor, array &$refs, mixed $item): void
+ {
+ $cursor->refIndex = 0;
+ $cursor->softRefTo = $cursor->softRefHandle = $cursor->softRefCount = 0;
+ $cursor->hardRefTo = $cursor->hardRefHandle = $cursor->hardRefCount = 0;
+ $firstSeen = true;
+
+ if (!$item instanceof Stub) {
+ $cursor->attr = [];
+ $type = \gettype($item);
+ if ($item && 'array' === $type) {
+ $item = $this->getStub($item);
+ }
+ } elseif (Stub::TYPE_REF === $item->type) {
+ if ($item->handle) {
+ if (!isset($refs[$r = $item->handle - (\PHP_INT_MAX >> 1)])) {
+ $cursor->refIndex = $refs[$r] = $cursor->refIndex ?: ++$refs[0];
+ } else {
+ $firstSeen = false;
+ }
+ $cursor->hardRefTo = $refs[$r];
+ $cursor->hardRefHandle = $this->useRefHandles & $item->handle;
+ $cursor->hardRefCount = 0 < $item->handle ? $item->refCount : 0;
+ }
+ $cursor->attr = $item->attr;
+ $type = $item->class ?: \gettype($item->value);
+ $item = $this->getStub($item->value);
+ }
+ if ($item instanceof Stub) {
+ if ($item->refCount) {
+ if (!isset($refs[$r = $item->handle])) {
+ $cursor->refIndex = $refs[$r] = $cursor->refIndex ?: ++$refs[0];
+ } else {
+ $firstSeen = false;
+ }
+ $cursor->softRefTo = $refs[$r];
+ }
+ $cursor->softRefHandle = $this->useRefHandles & $item->handle;
+ $cursor->softRefCount = $item->refCount;
+ $cursor->attr = $item->attr;
+ $cut = $item->cut;
+
+ if ($item->position && $firstSeen) {
+ $children = $this->data[$item->position];
+
+ if ($cursor->stop) {
+ if ($cut >= 0) {
+ $cut += \count($children);
+ }
+ $children = [];
+ }
+ } else {
+ $children = [];
+ }
+ switch ($item->type) {
+ case Stub::TYPE_STRING:
+ $dumper->dumpString($cursor, $item->value, Stub::STRING_BINARY === $item->class, $cut);
+ break;
+
+ case Stub::TYPE_ARRAY:
+ $item = clone $item;
+ $item->type = $item->class;
+ $item->class = $item->value;
+ // no break
+ case Stub::TYPE_OBJECT:
+ case Stub::TYPE_RESOURCE:
+ $withChildren = $children && $cursor->depth !== $this->maxDepth && $this->maxItemsPerDepth;
+ $dumper->enterHash($cursor, $item->type, $item->class, $withChildren);
+ if ($withChildren) {
+ if ($cursor->skipChildren) {
+ $withChildren = false;
+ $cut = -1;
+ } else {
+ $cut = $this->dumpChildren($dumper, $cursor, $refs, $children, $cut, $item->type, null !== $item->class);
+ }
+ } elseif ($children && 0 <= $cut) {
+ $cut += \count($children);
+ }
+ $cursor->skipChildren = false;
+ $dumper->leaveHash($cursor, $item->type, $item->class, $withChildren, $cut);
+ break;
+
+ case Stub::TYPE_SCALAR:
+ $dumper->dumpScalar($cursor, 'default', $item->attr['value']);
+ break;
+
+ default:
+ throw new \RuntimeException(sprintf('Unexpected Stub type: "%s".', $item->type));
+ }
+ } elseif ('array' === $type) {
+ $dumper->enterHash($cursor, Cursor::HASH_INDEXED, 0, false);
+ $dumper->leaveHash($cursor, Cursor::HASH_INDEXED, 0, false, 0);
+ } elseif ('string' === $type) {
+ $dumper->dumpString($cursor, $item, false, 0);
+ } else {
+ $dumper->dumpScalar($cursor, $type, $item);
+ }
+ }
+
+ /**
+ * Dumps children of hash structures.
+ *
+ * @return int The final number of removed items
+ */
+ private function dumpChildren(DumperInterface $dumper, Cursor $parentCursor, array &$refs, array $children, int $hashCut, int $hashType, bool $dumpKeys): int
+ {
+ $cursor = clone $parentCursor;
+ ++$cursor->depth;
+ $cursor->hashType = $hashType;
+ $cursor->hashIndex = 0;
+ $cursor->hashLength = \count($children);
+ $cursor->hashCut = $hashCut;
+ foreach ($children as $key => $child) {
+ $cursor->hashKeyIsBinary = isset($key[0]) && !preg_match('//u', $key);
+ $cursor->hashKey = $dumpKeys ? $key : null;
+ $this->dumpItem($dumper, $cursor, $refs, $child);
+ if (++$cursor->hashIndex === $this->maxItemsPerDepth || $cursor->stop) {
+ $parentCursor->stop = true;
+
+ return $hashCut >= 0 ? $hashCut + $cursor->hashLength - $cursor->hashIndex : $hashCut;
+ }
+ }
+
+ return $hashCut;
+ }
+
+ private function getStub(mixed $item): mixed
+ {
+ if (!$item || !\is_array($item)) {
+ return $item;
+ }
+
+ $stub = new Stub();
+ $stub->type = Stub::TYPE_ARRAY;
+ foreach ($item as $stub->class => $stub->position) {
+ }
+ if (isset($item[0])) {
+ $stub->cut = $item[0];
+ }
+ $stub->value = $stub->cut + ($stub->position ? \count($this->data[$stub->position]) : 0);
+
+ return $stub;
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Cloner/DumperInterface.php b/data/web/inc/lib/vendor/symfony/var-dumper/Cloner/DumperInterface.php
new file mode 100644
index 000000000..4c5b315b6
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Cloner/DumperInterface.php
@@ -0,0 +1,61 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Cloner;
+
+/**
+ * DumperInterface used by Data objects.
+ *
+ * @author Nicolas Grekas
+ */
+interface DumperInterface
+{
+ /**
+ * Dumps a scalar value.
+ *
+ * @return void
+ */
+ public function dumpScalar(Cursor $cursor, string $type, string|int|float|bool|null $value);
+
+ /**
+ * Dumps a string.
+ *
+ * @param string $str The string being dumped
+ * @param bool $bin Whether $str is UTF-8 or binary encoded
+ * @param int $cut The number of characters $str has been cut by
+ *
+ * @return void
+ */
+ public function dumpString(Cursor $cursor, string $str, bool $bin, int $cut);
+
+ /**
+ * Dumps while entering an hash.
+ *
+ * @param int $type A Cursor::HASH_* const for the type of hash
+ * @param string|int|null $class The object class, resource type or array count
+ * @param bool $hasChild When the dump of the hash has child item
+ *
+ * @return void
+ */
+ public function enterHash(Cursor $cursor, int $type, string|int|null $class, bool $hasChild);
+
+ /**
+ * Dumps while leaving an hash.
+ *
+ * @param int $type A Cursor::HASH_* const for the type of hash
+ * @param string|int|null $class The object class, resource type or array count
+ * @param bool $hasChild When the dump of the hash has child item
+ * @param int $cut The number of items the hash has been cut by
+ *
+ * @return void
+ */
+ public function leaveHash(Cursor $cursor, int $type, string|int|null $class, bool $hasChild, int $cut);
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Cloner/Stub.php b/data/web/inc/lib/vendor/symfony/var-dumper/Cloner/Stub.php
new file mode 100644
index 000000000..0c2a4b9d0
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Cloner/Stub.php
@@ -0,0 +1,68 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Cloner;
+
+/**
+ * Represents the main properties of a PHP variable.
+ *
+ * @author Nicolas Grekas
+ */
+class Stub
+{
+ public const TYPE_REF = 1;
+ public const TYPE_STRING = 2;
+ public const TYPE_ARRAY = 3;
+ public const TYPE_OBJECT = 4;
+ public const TYPE_RESOURCE = 5;
+ public const TYPE_SCALAR = 6;
+
+ public const STRING_BINARY = 1;
+ public const STRING_UTF8 = 2;
+
+ public const ARRAY_ASSOC = 1;
+ public const ARRAY_INDEXED = 2;
+
+ public $type = self::TYPE_REF;
+ public $class = '';
+ public $value;
+ public $cut = 0;
+ public $handle = 0;
+ public $refCount = 0;
+ public $position = 0;
+ public $attr = [];
+
+ private static array $defaultProperties = [];
+
+ /**
+ * @internal
+ */
+ public function __sleep(): array
+ {
+ $properties = [];
+
+ if (!isset(self::$defaultProperties[$c = static::class])) {
+ self::$defaultProperties[$c] = get_class_vars($c);
+
+ foreach ((new \ReflectionClass($c))->getStaticProperties() as $k => $v) {
+ unset(self::$defaultProperties[$c][$k]);
+ }
+ }
+
+ foreach (self::$defaultProperties[$c] as $k => $v) {
+ if ($this->$k !== $v) {
+ $properties[] = $k;
+ }
+ }
+
+ return $properties;
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Cloner/VarCloner.php b/data/web/inc/lib/vendor/symfony/var-dumper/Cloner/VarCloner.php
new file mode 100644
index 000000000..e168d0d3b
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Cloner/VarCloner.php
@@ -0,0 +1,243 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Cloner;
+
+/**
+ * @author Nicolas Grekas
+ */
+class VarCloner extends AbstractCloner
+{
+ private static array $arrayCache = [];
+
+ protected function doClone(mixed $var): array
+ {
+ $len = 1; // Length of $queue
+ $pos = 0; // Number of cloned items past the minimum depth
+ $refsCounter = 0; // Hard references counter
+ $queue = [[$var]]; // This breadth-first queue is the return value
+ $hardRefs = []; // Map of original zval ids to stub objects
+ $objRefs = []; // Map of original object handles to their stub object counterpart
+ $objects = []; // Keep a ref to objects to ensure their handle cannot be reused while cloning
+ $resRefs = []; // Map of original resource handles to their stub object counterpart
+ $values = []; // Map of stub objects' ids to original values
+ $maxItems = $this->maxItems;
+ $maxString = $this->maxString;
+ $minDepth = $this->minDepth;
+ $currentDepth = 0; // Current tree depth
+ $currentDepthFinalIndex = 0; // Final $queue index for current tree depth
+ $minimumDepthReached = 0 === $minDepth; // Becomes true when minimum tree depth has been reached
+ $cookie = (object) []; // Unique object used to detect hard references
+ $a = null; // Array cast for nested structures
+ $stub = null; // Stub capturing the main properties of an original item value
+ // or null if the original value is used directly
+
+ $arrayStub = new Stub();
+ $arrayStub->type = Stub::TYPE_ARRAY;
+ $fromObjCast = false;
+
+ for ($i = 0; $i < $len; ++$i) {
+ // Detect when we move on to the next tree depth
+ if ($i > $currentDepthFinalIndex) {
+ ++$currentDepth;
+ $currentDepthFinalIndex = $len - 1;
+ if ($currentDepth >= $minDepth) {
+ $minimumDepthReached = true;
+ }
+ }
+
+ $refs = $vals = $queue[$i];
+ foreach ($vals as $k => $v) {
+ // $v is the original value or a stub object in case of hard references
+
+ $zvalRef = ($r = \ReflectionReference::fromArrayElement($vals, $k)) ? $r->getId() : null;
+
+ if ($zvalRef) {
+ $vals[$k] = &$stub; // Break hard references to make $queue completely
+ unset($stub); // independent from the original structure
+ if (null !== $vals[$k] = $hardRefs[$zvalRef] ?? null) {
+ $v = $vals[$k];
+ if ($v->value instanceof Stub && (Stub::TYPE_OBJECT === $v->value->type || Stub::TYPE_RESOURCE === $v->value->type)) {
+ ++$v->value->refCount;
+ }
+ ++$v->refCount;
+ continue;
+ }
+ $vals[$k] = new Stub();
+ $vals[$k]->value = $v;
+ $vals[$k]->handle = ++$refsCounter;
+ $hardRefs[$zvalRef] = $vals[$k];
+ }
+ // Create $stub when the original value $v cannot be used directly
+ // If $v is a nested structure, put that structure in array $a
+ switch (true) {
+ case null === $v:
+ case \is_bool($v):
+ case \is_int($v):
+ case \is_float($v):
+ continue 2;
+ case \is_string($v):
+ if ('' === $v) {
+ continue 2;
+ }
+ if (!preg_match('//u', $v)) {
+ $stub = new Stub();
+ $stub->type = Stub::TYPE_STRING;
+ $stub->class = Stub::STRING_BINARY;
+ if (0 <= $maxString && 0 < $cut = \strlen($v) - $maxString) {
+ $stub->cut = $cut;
+ $stub->value = substr($v, 0, -$cut);
+ } else {
+ $stub->value = $v;
+ }
+ } elseif (0 <= $maxString && isset($v[1 + ($maxString >> 2)]) && 0 < $cut = mb_strlen($v, 'UTF-8') - $maxString) {
+ $stub = new Stub();
+ $stub->type = Stub::TYPE_STRING;
+ $stub->class = Stub::STRING_UTF8;
+ $stub->cut = $cut;
+ $stub->value = mb_substr($v, 0, $maxString, 'UTF-8');
+ } else {
+ continue 2;
+ }
+ $a = null;
+ break;
+
+ case \is_array($v):
+ if (!$v) {
+ continue 2;
+ }
+ $stub = $arrayStub;
+
+ $stub->class = array_is_list($v) ? Stub::ARRAY_INDEXED : Stub::ARRAY_ASSOC;
+ $a = $v;
+ break;
+
+ case \is_object($v):
+ if (empty($objRefs[$h = spl_object_id($v)])) {
+ $stub = new Stub();
+ $stub->type = Stub::TYPE_OBJECT;
+ $stub->class = $v::class;
+ $stub->value = $v;
+ $stub->handle = $h;
+ $a = $this->castObject($stub, 0 < $i);
+ if ($v !== $stub->value) {
+ if (Stub::TYPE_OBJECT !== $stub->type || null === $stub->value) {
+ break;
+ }
+ $stub->handle = $h = spl_object_id($stub->value);
+ }
+ $stub->value = null;
+ if (0 <= $maxItems && $maxItems <= $pos && $minimumDepthReached) {
+ $stub->cut = \count($a);
+ $a = null;
+ }
+ }
+ if (empty($objRefs[$h])) {
+ $objRefs[$h] = $stub;
+ $objects[] = $v;
+ } else {
+ $stub = $objRefs[$h];
+ ++$stub->refCount;
+ $a = null;
+ }
+ break;
+
+ default: // resource
+ if (empty($resRefs[$h = (int) $v])) {
+ $stub = new Stub();
+ $stub->type = Stub::TYPE_RESOURCE;
+ if ('Unknown' === $stub->class = @get_resource_type($v)) {
+ $stub->class = 'Closed';
+ }
+ $stub->value = $v;
+ $stub->handle = $h;
+ $a = $this->castResource($stub, 0 < $i);
+ $stub->value = null;
+ if (0 <= $maxItems && $maxItems <= $pos && $minimumDepthReached) {
+ $stub->cut = \count($a);
+ $a = null;
+ }
+ }
+ if (empty($resRefs[$h])) {
+ $resRefs[$h] = $stub;
+ } else {
+ $stub = $resRefs[$h];
+ ++$stub->refCount;
+ $a = null;
+ }
+ break;
+ }
+
+ if ($a) {
+ if (!$minimumDepthReached || 0 > $maxItems) {
+ $queue[$len] = $a;
+ $stub->position = $len++;
+ } elseif ($pos < $maxItems) {
+ if ($maxItems < $pos += \count($a)) {
+ $a = \array_slice($a, 0, $maxItems - $pos, true);
+ if ($stub->cut >= 0) {
+ $stub->cut += $pos - $maxItems;
+ }
+ }
+ $queue[$len] = $a;
+ $stub->position = $len++;
+ } elseif ($stub->cut >= 0) {
+ $stub->cut += \count($a);
+ $stub->position = 0;
+ }
+ }
+
+ if ($arrayStub === $stub) {
+ if ($arrayStub->cut) {
+ $stub = [$arrayStub->cut, $arrayStub->class => $arrayStub->position];
+ $arrayStub->cut = 0;
+ } elseif (isset(self::$arrayCache[$arrayStub->class][$arrayStub->position])) {
+ $stub = self::$arrayCache[$arrayStub->class][$arrayStub->position];
+ } else {
+ self::$arrayCache[$arrayStub->class][$arrayStub->position] = $stub = [$arrayStub->class => $arrayStub->position];
+ }
+ }
+
+ if (!$zvalRef) {
+ $vals[$k] = $stub;
+ } else {
+ $hardRefs[$zvalRef]->value = $stub;
+ }
+ }
+
+ if ($fromObjCast) {
+ $fromObjCast = false;
+ $refs = $vals;
+ $vals = [];
+ $j = -1;
+ foreach ($queue[$i] as $k => $v) {
+ foreach ([$k => true] as $gk => $gv) {
+ }
+ if ($gk !== $k) {
+ $vals = (object) $vals;
+ $vals->{$k} = $refs[++$j];
+ $vals = (array) $vals;
+ } else {
+ $vals[$k] = $refs[++$j];
+ }
+ }
+ }
+
+ $queue[$i] = $vals;
+ }
+
+ foreach ($values as $h => $v) {
+ $hardRefs[$h] = $v;
+ }
+
+ return $queue;
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Command/Descriptor/CliDescriptor.php b/data/web/inc/lib/vendor/symfony/var-dumper/Command/Descriptor/CliDescriptor.php
new file mode 100644
index 000000000..4450fe986
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Command/Descriptor/CliDescriptor.php
@@ -0,0 +1,79 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Command\Descriptor;
+
+use Symfony\Component\Console\Input\ArrayInput;
+use Symfony\Component\Console\Output\OutputInterface;
+use Symfony\Component\Console\Style\SymfonyStyle;
+use Symfony\Component\VarDumper\Cloner\Data;
+use Symfony\Component\VarDumper\Dumper\CliDumper;
+
+/**
+ * Describe collected data clones for cli output.
+ *
+ * @author Maxime Steinhausser
+ *
+ * @final
+ */
+class CliDescriptor implements DumpDescriptorInterface
+{
+ private CliDumper $dumper;
+ private mixed $lastIdentifier = null;
+
+ public function __construct(CliDumper $dumper)
+ {
+ $this->dumper = $dumper;
+ }
+
+ public function describe(OutputInterface $output, Data $data, array $context, int $clientId): void
+ {
+ $io = $output instanceof SymfonyStyle ? $output : new SymfonyStyle(new ArrayInput([]), $output);
+ $this->dumper->setColors($output->isDecorated());
+
+ $rows = [['date', date('r', (int) $context['timestamp'])]];
+ $lastIdentifier = $this->lastIdentifier;
+ $this->lastIdentifier = $clientId;
+
+ $section = "Received from client #$clientId";
+ if (isset($context['request'])) {
+ $request = $context['request'];
+ $this->lastIdentifier = $request['identifier'];
+ $section = sprintf('%s %s', $request['method'], $request['uri']);
+ if ($controller = $request['controller']) {
+ $rows[] = ['controller', rtrim($this->dumper->dump($controller, true), "\n")];
+ }
+ } elseif (isset($context['cli'])) {
+ $this->lastIdentifier = $context['cli']['identifier'];
+ $section = '$ '.$context['cli']['command_line'];
+ }
+
+ if ($this->lastIdentifier !== $lastIdentifier) {
+ $io->section($section);
+ }
+
+ if (isset($context['source'])) {
+ $source = $context['source'];
+ $sourceInfo = sprintf('%s on line %d', $source['name'], $source['line']);
+ if ($fileLink = $source['file_link'] ?? null) {
+ $sourceInfo = sprintf('%s', $fileLink, $sourceInfo);
+ }
+ $rows[] = ['source', $sourceInfo];
+ $file = $source['file_relative'] ?? $source['file'];
+ $rows[] = ['file', $file];
+ }
+
+ $io->table([], $rows);
+
+ $this->dumper->dump($data);
+ $io->newLine();
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Command/Descriptor/DumpDescriptorInterface.php b/data/web/inc/lib/vendor/symfony/var-dumper/Command/Descriptor/DumpDescriptorInterface.php
new file mode 100644
index 000000000..267d27bfa
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Command/Descriptor/DumpDescriptorInterface.php
@@ -0,0 +1,23 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Command\Descriptor;
+
+use Symfony\Component\Console\Output\OutputInterface;
+use Symfony\Component\VarDumper\Cloner\Data;
+
+/**
+ * @author Maxime Steinhausser
+ */
+interface DumpDescriptorInterface
+{
+ public function describe(OutputInterface $output, Data $data, array $context, int $clientId): void;
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Command/Descriptor/HtmlDescriptor.php b/data/web/inc/lib/vendor/symfony/var-dumper/Command/Descriptor/HtmlDescriptor.php
new file mode 100644
index 000000000..98f150a5e
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Command/Descriptor/HtmlDescriptor.php
@@ -0,0 +1,119 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Command\Descriptor;
+
+use Symfony\Component\Console\Output\OutputInterface;
+use Symfony\Component\VarDumper\Cloner\Data;
+use Symfony\Component\VarDumper\Dumper\HtmlDumper;
+
+/**
+ * Describe collected data clones for html output.
+ *
+ * @author Maxime Steinhausser
+ *
+ * @final
+ */
+class HtmlDescriptor implements DumpDescriptorInterface
+{
+ private HtmlDumper $dumper;
+ private bool $initialized = false;
+
+ public function __construct(HtmlDumper $dumper)
+ {
+ $this->dumper = $dumper;
+ }
+
+ public function describe(OutputInterface $output, Data $data, array $context, int $clientId): void
+ {
+ if (!$this->initialized) {
+ $styles = file_get_contents(__DIR__.'/../../Resources/css/htmlDescriptor.css');
+ $scripts = file_get_contents(__DIR__.'/../../Resources/js/htmlDescriptor.js');
+ $output->writeln("");
+ $this->initialized = true;
+ }
+
+ $title = '-';
+ if (isset($context['request'])) {
+ $request = $context['request'];
+ $controller = "{$this->dumper->dump($request['controller'], true, ['maxDepth' => 0])}";
+ $title = sprintf('%s %s', $request['method'], $uri = $request['uri'], $uri);
+ $dedupIdentifier = $request['identifier'];
+ } elseif (isset($context['cli'])) {
+ $title = '$ '.$context['cli']['command_line'];
+ $dedupIdentifier = $context['cli']['identifier'];
+ } else {
+ $dedupIdentifier = uniqid('', true);
+ }
+
+ $sourceDescription = '';
+ if (isset($context['source'])) {
+ $source = $context['source'];
+ $projectDir = $source['project_dir'] ?? null;
+ $sourceDescription = sprintf('%s on line %d', $source['name'], $source['line']);
+ if (isset($source['file_link'])) {
+ $sourceDescription = sprintf('%s', $source['file_link'], $sourceDescription);
+ }
+ }
+
+ $isoDate = $this->extractDate($context, 'c');
+ $tags = array_filter([
+ 'controller' => $controller ?? null,
+ 'project dir' => $projectDir ?? null,
+ ]);
+
+ $output->writeln(<<
+
+
+
+ $sourceDescription
+
+ {$this->dumper->dump($data, true)}
+
+
+HTML
+ );
+ }
+
+ private function extractDate(array $context, string $format = 'r'): string
+ {
+ return date($format, (int) $context['timestamp']);
+ }
+
+ private function renderTags(array $tags): string
+ {
+ if (!$tags) {
+ return '';
+ }
+
+ $renderedTags = '';
+ foreach ($tags as $key => $value) {
+ $renderedTags .= sprintf('%s%s', $key, $value);
+ }
+
+ return <<
+
+
+HTML;
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Command/ServerDumpCommand.php b/data/web/inc/lib/vendor/symfony/var-dumper/Command/ServerDumpCommand.php
new file mode 100644
index 000000000..b64a884b9
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Command/ServerDumpCommand.php
@@ -0,0 +1,112 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Command;
+
+use Symfony\Component\Console\Attribute\AsCommand;
+use Symfony\Component\Console\Command\Command;
+use Symfony\Component\Console\Completion\CompletionInput;
+use Symfony\Component\Console\Completion\CompletionSuggestions;
+use Symfony\Component\Console\Exception\InvalidArgumentException;
+use Symfony\Component\Console\Input\InputInterface;
+use Symfony\Component\Console\Input\InputOption;
+use Symfony\Component\Console\Output\OutputInterface;
+use Symfony\Component\Console\Style\SymfonyStyle;
+use Symfony\Component\VarDumper\Cloner\Data;
+use Symfony\Component\VarDumper\Command\Descriptor\CliDescriptor;
+use Symfony\Component\VarDumper\Command\Descriptor\DumpDescriptorInterface;
+use Symfony\Component\VarDumper\Command\Descriptor\HtmlDescriptor;
+use Symfony\Component\VarDumper\Dumper\CliDumper;
+use Symfony\Component\VarDumper\Dumper\HtmlDumper;
+use Symfony\Component\VarDumper\Server\DumpServer;
+
+/**
+ * Starts a dump server to collect and output dumps on a single place with multiple formats support.
+ *
+ * @author Maxime Steinhausser
+ *
+ * @final
+ */
+#[AsCommand(name: 'server:dump', description: 'Start a dump server that collects and displays dumps in a single place')]
+class ServerDumpCommand extends Command
+{
+ private DumpServer $server;
+
+ /** @var DumpDescriptorInterface[] */
+ private array $descriptors;
+
+ public function __construct(DumpServer $server, array $descriptors = [])
+ {
+ $this->server = $server;
+ $this->descriptors = $descriptors + [
+ 'cli' => new CliDescriptor(new CliDumper()),
+ 'html' => new HtmlDescriptor(new HtmlDumper()),
+ ];
+
+ parent::__construct();
+ }
+
+ protected function configure(): void
+ {
+ $this
+ ->addOption('format', null, InputOption::VALUE_REQUIRED, sprintf('The output format (%s)', implode(', ', $this->getAvailableFormats())), 'cli')
+ ->setHelp(<<<'EOF'
+%command.name% starts a dump server that collects and displays
+dumps in a single place for debugging you application:
+
+ php %command.full_name%
+
+You can consult dumped data in HTML format in your browser by providing the --format=html option
+and redirecting the output to a file:
+
+ php %command.full_name% --format="html" > dump.html
+
+EOF
+ )
+ ;
+ }
+
+ protected function execute(InputInterface $input, OutputInterface $output): int
+ {
+ $io = new SymfonyStyle($input, $output);
+ $format = $input->getOption('format');
+
+ if (!$descriptor = $this->descriptors[$format] ?? null) {
+ throw new InvalidArgumentException(sprintf('Unsupported format "%s".', $format));
+ }
+
+ $errorIo = $io->getErrorStyle();
+ $errorIo->title('Symfony Var Dumper Server');
+
+ $this->server->start();
+
+ $errorIo->success(sprintf('Server listening on %s', $this->server->getHost()));
+ $errorIo->comment('Quit the server with CONTROL-C.');
+
+ $this->server->listen(function (Data $data, array $context, int $clientId) use ($descriptor, $io) {
+ $descriptor->describe($io, $data, $context, $clientId);
+ });
+
+ return 0;
+ }
+
+ public function complete(CompletionInput $input, CompletionSuggestions $suggestions): void
+ {
+ if ($input->mustSuggestOptionValuesFor('format')) {
+ $suggestions->suggestValues($this->getAvailableFormats());
+ }
+ }
+
+ private function getAvailableFormats(): array
+ {
+ return array_keys($this->descriptors);
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Dumper/AbstractDumper.php b/data/web/inc/lib/vendor/symfony/var-dumper/Dumper/AbstractDumper.php
new file mode 100644
index 000000000..53165ba64
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Dumper/AbstractDumper.php
@@ -0,0 +1,204 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Dumper;
+
+use Symfony\Component\VarDumper\Cloner\Data;
+use Symfony\Component\VarDumper\Cloner\DumperInterface;
+
+/**
+ * Abstract mechanism for dumping a Data object.
+ *
+ * @author Nicolas Grekas
+ */
+abstract class AbstractDumper implements DataDumperInterface, DumperInterface
+{
+ public const DUMP_LIGHT_ARRAY = 1;
+ public const DUMP_STRING_LENGTH = 2;
+ public const DUMP_COMMA_SEPARATOR = 4;
+ public const DUMP_TRAILING_COMMA = 8;
+
+ /** @var callable|resource|string|null */
+ public static $defaultOutput = 'php://output';
+
+ protected $line = '';
+ /** @var callable|null */
+ protected $lineDumper;
+ /** @var resource|null */
+ protected $outputStream;
+ protected $decimalPoint = '.';
+ protected $indentPad = ' ';
+ protected $flags;
+
+ private string $charset = '';
+
+ /**
+ * @param callable|resource|string|null $output A line dumper callable, an opened stream or an output path, defaults to static::$defaultOutput
+ * @param string|null $charset The default character encoding to use for non-UTF8 strings
+ * @param int $flags A bit field of static::DUMP_* constants to fine tune dumps representation
+ */
+ public function __construct($output = null, ?string $charset = null, int $flags = 0)
+ {
+ $this->flags = $flags;
+ $this->setCharset($charset ?: \ini_get('php.output_encoding') ?: \ini_get('default_charset') ?: 'UTF-8');
+ $this->setOutput($output ?: static::$defaultOutput);
+ if (!$output && \is_string(static::$defaultOutput)) {
+ static::$defaultOutput = $this->outputStream;
+ }
+ }
+
+ /**
+ * Sets the output destination of the dumps.
+ *
+ * @param callable|resource|string|null $output A line dumper callable, an opened stream or an output path
+ *
+ * @return callable|resource|string|null The previous output destination
+ */
+ public function setOutput($output)
+ {
+ $prev = $this->outputStream ?? $this->lineDumper;
+
+ if (\is_callable($output)) {
+ $this->outputStream = null;
+ $this->lineDumper = $output;
+ } else {
+ if (\is_string($output)) {
+ $output = fopen($output, 'w');
+ }
+ $this->outputStream = $output;
+ $this->lineDumper = $this->echoLine(...);
+ }
+
+ return $prev;
+ }
+
+ /**
+ * Sets the default character encoding to use for non-UTF8 strings.
+ *
+ * @return string The previous charset
+ */
+ public function setCharset(string $charset): string
+ {
+ $prev = $this->charset;
+
+ $charset = strtoupper($charset);
+ $charset = null === $charset || 'UTF-8' === $charset || 'UTF8' === $charset ? 'CP1252' : $charset;
+
+ $this->charset = $charset;
+
+ return $prev;
+ }
+
+ /**
+ * Sets the indentation pad string.
+ *
+ * @param string $pad A string that will be prepended to dumped lines, repeated by nesting level
+ *
+ * @return string The previous indent pad
+ */
+ public function setIndentPad(string $pad): string
+ {
+ $prev = $this->indentPad;
+ $this->indentPad = $pad;
+
+ return $prev;
+ }
+
+ /**
+ * Dumps a Data object.
+ *
+ * @param callable|resource|string|true|null $output A line dumper callable, an opened stream, an output path or true to return the dump
+ *
+ * @return string|null The dump as string when $output is true
+ */
+ public function dump(Data $data, $output = null): ?string
+ {
+ if ($locale = $this->flags & (self::DUMP_COMMA_SEPARATOR | self::DUMP_TRAILING_COMMA) ? setlocale(\LC_NUMERIC, 0) : null) {
+ setlocale(\LC_NUMERIC, 'C');
+ }
+
+ if ($returnDump = true === $output) {
+ $output = fopen('php://memory', 'r+');
+ }
+ if ($output) {
+ $prevOutput = $this->setOutput($output);
+ }
+ try {
+ $data->dump($this);
+ $this->dumpLine(-1);
+
+ if ($returnDump) {
+ $result = stream_get_contents($output, -1, 0);
+ fclose($output);
+
+ return $result;
+ }
+ } finally {
+ if ($output) {
+ $this->setOutput($prevOutput);
+ }
+ if ($locale) {
+ setlocale(\LC_NUMERIC, $locale);
+ }
+ }
+
+ return null;
+ }
+
+ /**
+ * Dumps the current line.
+ *
+ * @param int $depth The recursive depth in the dumped structure for the line being dumped,
+ * or -1 to signal the end-of-dump to the line dumper callable
+ *
+ * @return void
+ */
+ protected function dumpLine(int $depth)
+ {
+ ($this->lineDumper)($this->line, $depth, $this->indentPad);
+ $this->line = '';
+ }
+
+ /**
+ * Generic line dumper callback.
+ *
+ * @return void
+ */
+ protected function echoLine(string $line, int $depth, string $indentPad)
+ {
+ if (-1 !== $depth) {
+ fwrite($this->outputStream, str_repeat($indentPad, $depth).$line."\n");
+ }
+ }
+
+ /**
+ * Converts a non-UTF-8 string to UTF-8.
+ */
+ protected function utf8Encode(?string $s): ?string
+ {
+ if (null === $s || preg_match('//u', $s)) {
+ return $s;
+ }
+
+ if (!\function_exists('iconv')) {
+ throw new \RuntimeException('Unable to convert a non-UTF-8 string to UTF-8: required function iconv() does not exist. You should install ext-iconv or symfony/polyfill-iconv.');
+ }
+
+ if (false !== $c = @iconv($this->charset, 'UTF-8', $s)) {
+ return $c;
+ }
+ if ('CP1252' !== $this->charset && false !== $c = @iconv('CP1252', 'UTF-8', $s)) {
+ return $c;
+ }
+
+ return iconv('CP850', 'UTF-8', $s);
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Dumper/CliDumper.php b/data/web/inc/lib/vendor/symfony/var-dumper/Dumper/CliDumper.php
new file mode 100644
index 000000000..af9637072
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Dumper/CliDumper.php
@@ -0,0 +1,677 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Dumper;
+
+use Symfony\Component\VarDumper\Cloner\Cursor;
+use Symfony\Component\VarDumper\Cloner\Stub;
+
+/**
+ * CliDumper dumps variables for command line output.
+ *
+ * @author Nicolas Grekas
+ */
+class CliDumper extends AbstractDumper
+{
+ public static $defaultColors;
+ /** @var callable|resource|string|null */
+ public static $defaultOutput = 'php://stdout';
+
+ protected $colors;
+ protected $maxStringWidth = 0;
+ protected $styles = [
+ // See http://en.wikipedia.org/wiki/ANSI_escape_code#graphics
+ 'default' => '0;38;5;208',
+ 'num' => '1;38;5;38',
+ 'const' => '1;38;5;208',
+ 'str' => '1;38;5;113',
+ 'note' => '38;5;38',
+ 'ref' => '38;5;247',
+ 'public' => '',
+ 'protected' => '',
+ 'private' => '',
+ 'meta' => '38;5;170',
+ 'key' => '38;5;113',
+ 'index' => '38;5;38',
+ ];
+
+ protected static $controlCharsRx = '/[\x00-\x1F\x7F]+/';
+ protected static $controlCharsMap = [
+ "\t" => '\t',
+ "\n" => '\n',
+ "\v" => '\v',
+ "\f" => '\f',
+ "\r" => '\r',
+ "\033" => '\e',
+ ];
+ protected static $unicodeCharsRx = "/[\u{00A0}\u{00AD}\u{034F}\u{061C}\u{115F}\u{1160}\u{17B4}\u{17B5}\u{180E}\u{2000}-\u{200F}\u{202F}\u{205F}\u{2060}-\u{2064}\u{206A}-\u{206F}\u{3000}\u{2800}\u{3164}\u{FEFF}\u{FFA0}\u{1D159}\u{1D173}-\u{1D17A}]/u";
+
+ protected $collapseNextHash = false;
+ protected $expandNextHash = false;
+
+ private array $displayOptions = [
+ 'fileLinkFormat' => null,
+ ];
+
+ private bool $handlesHrefGracefully;
+
+ public function __construct($output = null, ?string $charset = null, int $flags = 0)
+ {
+ parent::__construct($output, $charset, $flags);
+
+ if ('\\' === \DIRECTORY_SEPARATOR && !$this->isWindowsTrueColor()) {
+ // Use only the base 16 xterm colors when using ANSICON or standard Windows 10 CLI
+ $this->setStyles([
+ 'default' => '31',
+ 'num' => '1;34',
+ 'const' => '1;31',
+ 'str' => '1;32',
+ 'note' => '34',
+ 'ref' => '1;30',
+ 'meta' => '35',
+ 'key' => '32',
+ 'index' => '34',
+ ]);
+ }
+
+ $this->displayOptions['fileLinkFormat'] = \ini_get('xdebug.file_link_format') ?: get_cfg_var('xdebug.file_link_format') ?: 'file://%f#L%l';
+ }
+
+ /**
+ * Enables/disables colored output.
+ *
+ * @return void
+ */
+ public function setColors(bool $colors)
+ {
+ $this->colors = $colors;
+ }
+
+ /**
+ * Sets the maximum number of characters per line for dumped strings.
+ *
+ * @return void
+ */
+ public function setMaxStringWidth(int $maxStringWidth)
+ {
+ $this->maxStringWidth = $maxStringWidth;
+ }
+
+ /**
+ * Configures styles.
+ *
+ * @param array $styles A map of style names to style definitions
+ *
+ * @return void
+ */
+ public function setStyles(array $styles)
+ {
+ $this->styles = $styles + $this->styles;
+ }
+
+ /**
+ * Configures display options.
+ *
+ * @param array $displayOptions A map of display options to customize the behavior
+ *
+ * @return void
+ */
+ public function setDisplayOptions(array $displayOptions)
+ {
+ $this->displayOptions = $displayOptions + $this->displayOptions;
+ }
+
+ /**
+ * @return void
+ */
+ public function dumpScalar(Cursor $cursor, string $type, string|int|float|bool|null $value)
+ {
+ $this->dumpKey($cursor);
+ $this->collapseNextHash = $this->expandNextHash = false;
+
+ $style = 'const';
+ $attr = $cursor->attr;
+
+ switch ($type) {
+ case 'default':
+ $style = 'default';
+ break;
+
+ case 'label':
+ $this->styles += ['label' => $this->styles['default']];
+ $style = 'label';
+ break;
+
+ case 'integer':
+ $style = 'num';
+
+ if (isset($this->styles['integer'])) {
+ $style = 'integer';
+ }
+
+ break;
+
+ case 'double':
+ $style = 'num';
+
+ if (isset($this->styles['float'])) {
+ $style = 'float';
+ }
+
+ $value = match (true) {
+ \INF === $value => 'INF',
+ -\INF === $value => '-INF',
+ is_nan($value) => 'NAN',
+ default => !str_contains($value = (string) $value, $this->decimalPoint) ? $value .= $this->decimalPoint.'0' : $value,
+ };
+ break;
+
+ case 'NULL':
+ $value = 'null';
+ break;
+
+ case 'boolean':
+ $value = $value ? 'true' : 'false';
+ break;
+
+ default:
+ $attr += ['value' => $this->utf8Encode($value)];
+ $value = $this->utf8Encode($type);
+ break;
+ }
+
+ $this->line .= $this->style($style, $value, $attr);
+
+ $this->endValue($cursor);
+ }
+
+ /**
+ * @return void
+ */
+ public function dumpString(Cursor $cursor, string $str, bool $bin, int $cut)
+ {
+ $this->dumpKey($cursor);
+ $this->collapseNextHash = $this->expandNextHash = false;
+ $attr = $cursor->attr;
+
+ if ($bin) {
+ $str = $this->utf8Encode($str);
+ }
+ if ('' === $str) {
+ $this->line .= '""';
+ if ($cut) {
+ $this->line .= '…'.$cut;
+ }
+ $this->endValue($cursor);
+ } else {
+ $attr += [
+ 'length' => 0 <= $cut ? mb_strlen($str, 'UTF-8') + $cut : 0,
+ 'binary' => $bin,
+ ];
+ $str = $bin && str_contains($str, "\0") ? [$str] : explode("\n", $str);
+ if (isset($str[1]) && !isset($str[2]) && !isset($str[1][0])) {
+ unset($str[1]);
+ $str[0] .= "\n";
+ }
+ $m = \count($str) - 1;
+ $i = $lineCut = 0;
+
+ if (self::DUMP_STRING_LENGTH & $this->flags) {
+ $this->line .= '('.$attr['length'].') ';
+ }
+ if ($bin) {
+ $this->line .= 'b';
+ }
+
+ if ($m) {
+ $this->line .= '"""';
+ $this->dumpLine($cursor->depth);
+ } else {
+ $this->line .= '"';
+ }
+
+ foreach ($str as $str) {
+ if ($i < $m) {
+ $str .= "\n";
+ }
+ if (0 < $this->maxStringWidth && $this->maxStringWidth < $len = mb_strlen($str, 'UTF-8')) {
+ $str = mb_substr($str, 0, $this->maxStringWidth, 'UTF-8');
+ $lineCut = $len - $this->maxStringWidth;
+ }
+ if ($m && 0 < $cursor->depth) {
+ $this->line .= $this->indentPad;
+ }
+ if ('' !== $str) {
+ $this->line .= $this->style('str', $str, $attr);
+ }
+ if ($i++ == $m) {
+ if ($m) {
+ if ('' !== $str) {
+ $this->dumpLine($cursor->depth);
+ if (0 < $cursor->depth) {
+ $this->line .= $this->indentPad;
+ }
+ }
+ $this->line .= '"""';
+ } else {
+ $this->line .= '"';
+ }
+ if ($cut < 0) {
+ $this->line .= '…';
+ $lineCut = 0;
+ } elseif ($cut) {
+ $lineCut += $cut;
+ }
+ }
+ if ($lineCut) {
+ $this->line .= '…'.$lineCut;
+ $lineCut = 0;
+ }
+
+ if ($i > $m) {
+ $this->endValue($cursor);
+ } else {
+ $this->dumpLine($cursor->depth);
+ }
+ }
+ }
+ }
+
+ /**
+ * @return void
+ */
+ public function enterHash(Cursor $cursor, int $type, string|int|null $class, bool $hasChild)
+ {
+ $this->colors ??= $this->supportsColors();
+
+ $this->dumpKey($cursor);
+ $this->expandNextHash = false;
+ $attr = $cursor->attr;
+
+ if ($this->collapseNextHash) {
+ $cursor->skipChildren = true;
+ $this->collapseNextHash = $hasChild = false;
+ }
+
+ $class = $this->utf8Encode($class);
+ if (Cursor::HASH_OBJECT === $type) {
+ $prefix = $class && 'stdClass' !== $class ? $this->style('note', $class, $attr).(empty($attr['cut_hash']) ? ' {' : '') : '{';
+ } elseif (Cursor::HASH_RESOURCE === $type) {
+ $prefix = $this->style('note', $class.' resource', $attr).($hasChild ? ' {' : ' ');
+ } else {
+ $prefix = $class && !(self::DUMP_LIGHT_ARRAY & $this->flags) ? $this->style('note', 'array:'.$class).' [' : '[';
+ }
+
+ if (($cursor->softRefCount || 0 < $cursor->softRefHandle) && empty($attr['cut_hash'])) {
+ $prefix .= $this->style('ref', (Cursor::HASH_RESOURCE === $type ? '@' : '#').(0 < $cursor->softRefHandle ? $cursor->softRefHandle : $cursor->softRefTo), ['count' => $cursor->softRefCount]);
+ } elseif ($cursor->hardRefTo && !$cursor->refIndex && $class) {
+ $prefix .= $this->style('ref', '&'.$cursor->hardRefTo, ['count' => $cursor->hardRefCount]);
+ } elseif (!$hasChild && Cursor::HASH_RESOURCE === $type) {
+ $prefix = substr($prefix, 0, -1);
+ }
+
+ $this->line .= $prefix;
+
+ if ($hasChild) {
+ $this->dumpLine($cursor->depth);
+ }
+ }
+
+ /**
+ * @return void
+ */
+ public function leaveHash(Cursor $cursor, int $type, string|int|null $class, bool $hasChild, int $cut)
+ {
+ if (empty($cursor->attr['cut_hash'])) {
+ $this->dumpEllipsis($cursor, $hasChild, $cut);
+ $this->line .= Cursor::HASH_OBJECT === $type ? '}' : (Cursor::HASH_RESOURCE !== $type ? ']' : ($hasChild ? '}' : ''));
+ }
+
+ $this->endValue($cursor);
+ }
+
+ /**
+ * Dumps an ellipsis for cut children.
+ *
+ * @param bool $hasChild When the dump of the hash has child item
+ * @param int $cut The number of items the hash has been cut by
+ *
+ * @return void
+ */
+ protected function dumpEllipsis(Cursor $cursor, bool $hasChild, int $cut)
+ {
+ if ($cut) {
+ $this->line .= ' …';
+ if (0 < $cut) {
+ $this->line .= $cut;
+ }
+ if ($hasChild) {
+ $this->dumpLine($cursor->depth + 1);
+ }
+ }
+ }
+
+ /**
+ * Dumps a key in a hash structure.
+ *
+ * @return void
+ */
+ protected function dumpKey(Cursor $cursor)
+ {
+ if (null !== $key = $cursor->hashKey) {
+ if ($cursor->hashKeyIsBinary) {
+ $key = $this->utf8Encode($key);
+ }
+ $attr = ['binary' => $cursor->hashKeyIsBinary];
+ $bin = $cursor->hashKeyIsBinary ? 'b' : '';
+ $style = 'key';
+ switch ($cursor->hashType) {
+ default:
+ case Cursor::HASH_INDEXED:
+ if (self::DUMP_LIGHT_ARRAY & $this->flags) {
+ break;
+ }
+ $style = 'index';
+ // no break
+ case Cursor::HASH_ASSOC:
+ if (\is_int($key)) {
+ $this->line .= $this->style($style, $key).' => ';
+ } else {
+ $this->line .= $bin.'"'.$this->style($style, $key).'" => ';
+ }
+ break;
+
+ case Cursor::HASH_RESOURCE:
+ $key = "\0~\0".$key;
+ // no break
+ case Cursor::HASH_OBJECT:
+ if (!isset($key[0]) || "\0" !== $key[0]) {
+ $this->line .= '+'.$bin.$this->style('public', $key).': ';
+ } elseif (0 < strpos($key, "\0", 1)) {
+ $key = explode("\0", substr($key, 1), 2);
+
+ switch ($key[0][0]) {
+ case '+': // User inserted keys
+ $attr['dynamic'] = true;
+ $this->line .= '+'.$bin.'"'.$this->style('public', $key[1], $attr).'": ';
+ break 2;
+ case '~':
+ $style = 'meta';
+ if (isset($key[0][1])) {
+ parse_str(substr($key[0], 1), $attr);
+ $attr += ['binary' => $cursor->hashKeyIsBinary];
+ }
+ break;
+ case '*':
+ $style = 'protected';
+ $bin = '#'.$bin;
+ break;
+ default:
+ $attr['class'] = $key[0];
+ $style = 'private';
+ $bin = '-'.$bin;
+ break;
+ }
+
+ if (isset($attr['collapse'])) {
+ if ($attr['collapse']) {
+ $this->collapseNextHash = true;
+ } else {
+ $this->expandNextHash = true;
+ }
+ }
+
+ $this->line .= $bin.$this->style($style, $key[1], $attr).($attr['separator'] ?? ': ');
+ } else {
+ // This case should not happen
+ $this->line .= '-'.$bin.'"'.$this->style('private', $key, ['class' => '']).'": ';
+ }
+ break;
+ }
+
+ if ($cursor->hardRefTo) {
+ $this->line .= $this->style('ref', '&'.($cursor->hardRefCount ? $cursor->hardRefTo : ''), ['count' => $cursor->hardRefCount]).' ';
+ }
+ }
+ }
+
+ /**
+ * Decorates a value with some style.
+ *
+ * @param string $style The type of style being applied
+ * @param string $value The value being styled
+ * @param array $attr Optional context information
+ */
+ protected function style(string $style, string $value, array $attr = []): string
+ {
+ $this->colors ??= $this->supportsColors();
+
+ $this->handlesHrefGracefully ??= 'JetBrains-JediTerm' !== getenv('TERMINAL_EMULATOR')
+ && (!getenv('KONSOLE_VERSION') || (int) getenv('KONSOLE_VERSION') > 201100)
+ && !isset($_SERVER['IDEA_INITIAL_DIRECTORY']);
+
+ if (isset($attr['ellipsis'], $attr['ellipsis-type'])) {
+ $prefix = substr($value, 0, -$attr['ellipsis']);
+ if ('cli' === \PHP_SAPI && 'path' === $attr['ellipsis-type'] && isset($_SERVER[$pwd = '\\' === \DIRECTORY_SEPARATOR ? 'CD' : 'PWD']) && str_starts_with($prefix, $_SERVER[$pwd])) {
+ $prefix = '.'.substr($prefix, \strlen($_SERVER[$pwd]));
+ }
+ if (!empty($attr['ellipsis-tail'])) {
+ $prefix .= substr($value, -$attr['ellipsis'], $attr['ellipsis-tail']);
+ $value = substr($value, -$attr['ellipsis'] + $attr['ellipsis-tail']);
+ } else {
+ $value = substr($value, -$attr['ellipsis']);
+ }
+
+ $value = $this->style('default', $prefix).$this->style($style, $value);
+
+ goto href;
+ }
+
+ $map = static::$controlCharsMap;
+ $startCchr = $this->colors ? "\033[m\033[{$this->styles['default']}m" : '';
+ $endCchr = $this->colors ? "\033[m\033[{$this->styles[$style]}m" : '';
+ $value = preg_replace_callback(static::$controlCharsRx, function ($c) use ($map, $startCchr, $endCchr) {
+ $s = $startCchr;
+ $c = $c[$i = 0];
+ do {
+ $s .= $map[$c[$i]] ?? sprintf('\x%02X', \ord($c[$i]));
+ } while (isset($c[++$i]));
+
+ return $s.$endCchr;
+ }, $value, -1, $cchrCount);
+
+ if (!($attr['binary'] ?? false)) {
+ $value = preg_replace_callback(static::$unicodeCharsRx, function ($c) use (&$cchrCount, $startCchr, $endCchr) {
+ ++$cchrCount;
+
+ return $startCchr.'\u{'.strtoupper(dechex(mb_ord($c[0]))).'}'.$endCchr;
+ }, $value);
+ }
+
+ if ($this->colors && '' !== $value) {
+ if ($cchrCount && "\033" === $value[0]) {
+ $value = substr($value, \strlen($startCchr));
+ } else {
+ $value = "\033[{$this->styles[$style]}m".$value;
+ }
+ if ($cchrCount && str_ends_with($value, $endCchr)) {
+ $value = substr($value, 0, -\strlen($endCchr));
+ } else {
+ $value .= "\033[{$this->styles['default']}m";
+ }
+ }
+
+ href:
+ if ($this->colors && $this->handlesHrefGracefully) {
+ if (isset($attr['file']) && $href = $this->getSourceLink($attr['file'], $attr['line'] ?? 0)) {
+ if ('note' === $style) {
+ $value .= "\033]8;;{$href}\033\\^\033]8;;\033\\";
+ } else {
+ $attr['href'] = $href;
+ }
+ }
+ if (isset($attr['href'])) {
+ if ('label' === $style) {
+ $value .= '^';
+ }
+ $value = "\033]8;;{$attr['href']}\033\\{$value}\033]8;;\033\\";
+ }
+ }
+
+ if ('label' === $style && '' !== $value) {
+ $value .= ' ';
+ }
+
+ return $value;
+ }
+
+ protected function supportsColors(): bool
+ {
+ if ($this->outputStream !== static::$defaultOutput) {
+ return $this->hasColorSupport($this->outputStream);
+ }
+ if (isset(static::$defaultColors)) {
+ return static::$defaultColors;
+ }
+ if (isset($_SERVER['argv'][1])) {
+ $colors = $_SERVER['argv'];
+ $i = \count($colors);
+ while (--$i > 0) {
+ if (isset($colors[$i][5])) {
+ switch ($colors[$i]) {
+ case '--ansi':
+ case '--color':
+ case '--color=yes':
+ case '--color=force':
+ case '--color=always':
+ case '--colors=always':
+ return static::$defaultColors = true;
+
+ case '--no-ansi':
+ case '--color=no':
+ case '--color=none':
+ case '--color=never':
+ case '--colors=never':
+ return static::$defaultColors = false;
+ }
+ }
+ }
+ }
+
+ $h = stream_get_meta_data($this->outputStream) + ['wrapper_type' => null];
+ $h = 'Output' === $h['stream_type'] && 'PHP' === $h['wrapper_type'] ? fopen('php://stdout', 'w') : $this->outputStream;
+
+ return static::$defaultColors = $this->hasColorSupport($h);
+ }
+
+ /**
+ * @return void
+ */
+ protected function dumpLine(int $depth, bool $endOfValue = false)
+ {
+ if (null === $this->colors) {
+ $this->colors = $this->supportsColors();
+ }
+
+ if ($this->colors) {
+ $this->line = sprintf("\033[%sm%s\033[m", $this->styles['default'], $this->line);
+ }
+ parent::dumpLine($depth);
+ }
+
+ /**
+ * @return void
+ */
+ protected function endValue(Cursor $cursor)
+ {
+ if (-1 === $cursor->hashType) {
+ return;
+ }
+
+ if (Stub::ARRAY_INDEXED === $cursor->hashType || Stub::ARRAY_ASSOC === $cursor->hashType) {
+ if (self::DUMP_TRAILING_COMMA & $this->flags && 0 < $cursor->depth) {
+ $this->line .= ',';
+ } elseif (self::DUMP_COMMA_SEPARATOR & $this->flags && 1 < $cursor->hashLength - $cursor->hashIndex) {
+ $this->line .= ',';
+ }
+ }
+
+ $this->dumpLine($cursor->depth, true);
+ }
+
+ /**
+ * Returns true if the stream supports colorization.
+ *
+ * Reference: Composer\XdebugHandler\Process::supportsColor
+ * https://github.com/composer/xdebug-handler
+ */
+ private function hasColorSupport(mixed $stream): bool
+ {
+ if (!\is_resource($stream) || 'stream' !== get_resource_type($stream)) {
+ return false;
+ }
+
+ // Follow https://no-color.org/
+ if (isset($_SERVER['NO_COLOR']) || false !== getenv('NO_COLOR')) {
+ return false;
+ }
+
+ if ('Hyper' === getenv('TERM_PROGRAM')) {
+ return true;
+ }
+
+ if (\DIRECTORY_SEPARATOR === '\\') {
+ return (\function_exists('sapi_windows_vt100_support')
+ && @sapi_windows_vt100_support($stream))
+ || false !== getenv('ANSICON')
+ || 'ON' === getenv('ConEmuANSI')
+ || 'xterm' === getenv('TERM');
+ }
+
+ return stream_isatty($stream);
+ }
+
+ /**
+ * Returns true if the Windows terminal supports true color.
+ *
+ * Note that this does not check an output stream, but relies on environment
+ * variables from known implementations, or a PHP and Windows version that
+ * supports true color.
+ */
+ private function isWindowsTrueColor(): bool
+ {
+ $result = 183 <= getenv('ANSICON_VER')
+ || 'ON' === getenv('ConEmuANSI')
+ || 'xterm' === getenv('TERM')
+ || 'Hyper' === getenv('TERM_PROGRAM');
+
+ if (!$result) {
+ $version = sprintf(
+ '%s.%s.%s',
+ PHP_WINDOWS_VERSION_MAJOR,
+ PHP_WINDOWS_VERSION_MINOR,
+ PHP_WINDOWS_VERSION_BUILD
+ );
+ $result = $version >= '10.0.15063';
+ }
+
+ return $result;
+ }
+
+ private function getSourceLink(string $file, int $line): string|false
+ {
+ if ($fmt = $this->displayOptions['fileLinkFormat']) {
+ return \is_string($fmt) ? strtr($fmt, ['%f' => $file, '%l' => $line]) : ($fmt->format($file, $line) ?: 'file://'.$file.'#L'.$line);
+ }
+
+ return false;
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Dumper/ContextProvider/CliContextProvider.php b/data/web/inc/lib/vendor/symfony/var-dumper/Dumper/ContextProvider/CliContextProvider.php
new file mode 100644
index 000000000..38f878971
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Dumper/ContextProvider/CliContextProvider.php
@@ -0,0 +1,32 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Dumper\ContextProvider;
+
+/**
+ * Tries to provide context on CLI.
+ *
+ * @author Maxime Steinhausser
+ */
+final class CliContextProvider implements ContextProviderInterface
+{
+ public function getContext(): ?array
+ {
+ if ('cli' !== \PHP_SAPI) {
+ return null;
+ }
+
+ return [
+ 'command_line' => $commandLine = implode(' ', $_SERVER['argv'] ?? []),
+ 'identifier' => hash('crc32b', $commandLine.$_SERVER['REQUEST_TIME_FLOAT']),
+ ];
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Dumper/ContextProvider/ContextProviderInterface.php b/data/web/inc/lib/vendor/symfony/var-dumper/Dumper/ContextProvider/ContextProviderInterface.php
new file mode 100644
index 000000000..532aa0f96
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Dumper/ContextProvider/ContextProviderInterface.php
@@ -0,0 +1,22 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Dumper\ContextProvider;
+
+/**
+ * Interface to provide contextual data about dump data clones sent to a server.
+ *
+ * @author Maxime Steinhausser
+ */
+interface ContextProviderInterface
+{
+ public function getContext(): ?array;
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Dumper/ContextProvider/RequestContextProvider.php b/data/web/inc/lib/vendor/symfony/var-dumper/Dumper/ContextProvider/RequestContextProvider.php
new file mode 100644
index 000000000..69dff067b
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Dumper/ContextProvider/RequestContextProvider.php
@@ -0,0 +1,51 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Dumper\ContextProvider;
+
+use Symfony\Component\HttpFoundation\RequestStack;
+use Symfony\Component\VarDumper\Caster\ReflectionCaster;
+use Symfony\Component\VarDumper\Cloner\VarCloner;
+
+/**
+ * Tries to provide context from a request.
+ *
+ * @author Maxime Steinhausser
+ */
+final class RequestContextProvider implements ContextProviderInterface
+{
+ private RequestStack $requestStack;
+ private VarCloner $cloner;
+
+ public function __construct(RequestStack $requestStack)
+ {
+ $this->requestStack = $requestStack;
+ $this->cloner = new VarCloner();
+ $this->cloner->setMaxItems(0);
+ $this->cloner->addCasters(ReflectionCaster::UNSET_CLOSURE_FILE_INFO);
+ }
+
+ public function getContext(): ?array
+ {
+ if (null === $request = $this->requestStack->getCurrentRequest()) {
+ return null;
+ }
+
+ $controller = $request->attributes->get('_controller');
+
+ return [
+ 'uri' => $request->getUri(),
+ 'method' => $request->getMethod(),
+ 'controller' => $controller ? $this->cloner->cloneVar($controller) : $controller,
+ 'identifier' => spl_object_hash($request),
+ ];
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Dumper/ContextProvider/SourceContextProvider.php b/data/web/inc/lib/vendor/symfony/var-dumper/Dumper/ContextProvider/SourceContextProvider.php
new file mode 100644
index 000000000..cadddfac4
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Dumper/ContextProvider/SourceContextProvider.php
@@ -0,0 +1,127 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Dumper\ContextProvider;
+
+use Symfony\Component\ErrorHandler\ErrorRenderer\FileLinkFormatter;
+use Symfony\Component\HttpKernel\Debug\FileLinkFormatter as LegacyFileLinkFormatter;
+use Symfony\Component\VarDumper\Cloner\VarCloner;
+use Symfony\Component\VarDumper\Dumper\HtmlDumper;
+use Symfony\Component\VarDumper\VarDumper;
+use Twig\Template;
+
+/**
+ * Tries to provide context from sources (class name, file, line, code excerpt, ...).
+ *
+ * @author Nicolas Grekas
+ * @author Maxime Steinhausser
+ */
+final class SourceContextProvider implements ContextProviderInterface
+{
+ private int $limit;
+ private ?string $charset;
+ private ?string $projectDir;
+ private FileLinkFormatter|LegacyFileLinkFormatter|null $fileLinkFormatter;
+
+ public function __construct(?string $charset = null, ?string $projectDir = null, FileLinkFormatter|LegacyFileLinkFormatter|null $fileLinkFormatter = null, int $limit = 9)
+ {
+ $this->charset = $charset;
+ $this->projectDir = $projectDir;
+ $this->fileLinkFormatter = $fileLinkFormatter;
+ $this->limit = $limit;
+ }
+
+ public function getContext(): ?array
+ {
+ $trace = debug_backtrace(\DEBUG_BACKTRACE_PROVIDE_OBJECT | \DEBUG_BACKTRACE_IGNORE_ARGS, $this->limit);
+
+ $file = $trace[1]['file'];
+ $line = $trace[1]['line'];
+ $name = '-' === $file || 'Standard input code' === $file ? 'Standard input code' : false;
+ $fileExcerpt = false;
+
+ for ($i = 2; $i < $this->limit; ++$i) {
+ if (isset($trace[$i]['class'], $trace[$i]['function'])
+ && 'dump' === $trace[$i]['function']
+ && VarDumper::class === $trace[$i]['class']
+ ) {
+ $file = $trace[$i]['file'] ?? $file;
+ $line = $trace[$i]['line'] ?? $line;
+
+ while (++$i < $this->limit) {
+ if (isset($trace[$i]['function'], $trace[$i]['file']) && empty($trace[$i]['class']) && !str_starts_with($trace[$i]['function'], 'call_user_func')) {
+ $file = $trace[$i]['file'];
+ $line = $trace[$i]['line'];
+
+ break;
+ } elseif (isset($trace[$i]['object']) && $trace[$i]['object'] instanceof Template) {
+ $template = $trace[$i]['object'];
+ $name = $template->getTemplateName();
+ $src = method_exists($template, 'getSourceContext') ? $template->getSourceContext()->getCode() : (method_exists($template, 'getSource') ? $template->getSource() : false);
+ $info = $template->getDebugInfo();
+ if (isset($info[$trace[$i - 1]['line']])) {
+ $line = $info[$trace[$i - 1]['line']];
+ $file = method_exists($template, 'getSourceContext') ? $template->getSourceContext()->getPath() : null;
+
+ if ($src) {
+ $src = explode("\n", $src);
+ $fileExcerpt = [];
+
+ for ($i = max($line - 3, 1), $max = min($line + 3, \count($src)); $i <= $max; ++$i) {
+ $fileExcerpt[] = ''.$this->htmlEncode($src[$i - 1]).'';
+ }
+
+ $fileExcerpt = ''.implode("\n", $fileExcerpt).'
';
+ }
+ }
+ break;
+ }
+ }
+ break;
+ }
+ }
+
+ if (false === $name) {
+ $name = str_replace('\\', '/', $file);
+ $name = substr($name, strrpos($name, '/') + 1);
+ }
+
+ $context = ['name' => $name, 'file' => $file, 'line' => $line];
+ $context['file_excerpt'] = $fileExcerpt;
+
+ if (null !== $this->projectDir) {
+ $context['project_dir'] = $this->projectDir;
+ if (str_starts_with($file, $this->projectDir)) {
+ $context['file_relative'] = ltrim(substr($file, \strlen($this->projectDir)), \DIRECTORY_SEPARATOR);
+ }
+ }
+
+ if ($this->fileLinkFormatter && $fileLink = $this->fileLinkFormatter->format($context['file'], $context['line'])) {
+ $context['file_link'] = $fileLink;
+ }
+
+ return $context;
+ }
+
+ private function htmlEncode(string $s): string
+ {
+ $html = '';
+
+ $dumper = new HtmlDumper(function ($line) use (&$html) { $html .= $line; }, $this->charset);
+ $dumper->setDumpHeader('');
+ $dumper->setDumpBoundaries('', '');
+
+ $cloner = new VarCloner();
+ $dumper->dump($cloner->cloneVar($s));
+
+ return substr(strip_tags($html), 1, -1);
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Dumper/ContextualizedDumper.php b/data/web/inc/lib/vendor/symfony/var-dumper/Dumper/ContextualizedDumper.php
new file mode 100644
index 000000000..84cfb4259
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Dumper/ContextualizedDumper.php
@@ -0,0 +1,46 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Dumper;
+
+use Symfony\Component\VarDumper\Cloner\Data;
+use Symfony\Component\VarDumper\Dumper\ContextProvider\ContextProviderInterface;
+
+/**
+ * @author Kévin Thérage
+ */
+class ContextualizedDumper implements DataDumperInterface
+{
+ private DataDumperInterface $wrappedDumper;
+ private array $contextProviders;
+
+ /**
+ * @param ContextProviderInterface[] $contextProviders
+ */
+ public function __construct(DataDumperInterface $wrappedDumper, array $contextProviders)
+ {
+ $this->wrappedDumper = $wrappedDumper;
+ $this->contextProviders = $contextProviders;
+ }
+
+ /**
+ * @return string|null
+ */
+ public function dump(Data $data)
+ {
+ $context = $data->getContext();
+ foreach ($this->contextProviders as $contextProvider) {
+ $context[$contextProvider::class] = $contextProvider->getContext();
+ }
+
+ return $this->wrappedDumper->dump($data->withContext($context));
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Dumper/DataDumperInterface.php b/data/web/inc/lib/vendor/symfony/var-dumper/Dumper/DataDumperInterface.php
new file mode 100644
index 000000000..df05b6af5
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Dumper/DataDumperInterface.php
@@ -0,0 +1,27 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Dumper;
+
+use Symfony\Component\VarDumper\Cloner\Data;
+
+/**
+ * DataDumperInterface for dumping Data objects.
+ *
+ * @author Nicolas Grekas
+ */
+interface DataDumperInterface
+{
+ /**
+ * @return string|null
+ */
+ public function dump(Data $data);
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Dumper/HtmlDumper.php b/data/web/inc/lib/vendor/symfony/var-dumper/Dumper/HtmlDumper.php
new file mode 100644
index 000000000..ea09e6819
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Dumper/HtmlDumper.php
@@ -0,0 +1,998 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Dumper;
+
+use Symfony\Component\VarDumper\Cloner\Cursor;
+use Symfony\Component\VarDumper\Cloner\Data;
+
+/**
+ * HtmlDumper dumps variables as HTML.
+ *
+ * @author Nicolas Grekas
+ */
+class HtmlDumper extends CliDumper
+{
+ /** @var callable|resource|string|null */
+ public static $defaultOutput = 'php://output';
+
+ protected static $themes = [
+ 'dark' => [
+ 'default' => 'background-color:#18171B; color:#FF8400; line-height:1.2em; font:12px Menlo, Monaco, Consolas, monospace; word-wrap: break-word; white-space: pre-wrap; position:relative; z-index:99999; word-break: break-all',
+ 'num' => 'font-weight:bold; color:#1299DA',
+ 'const' => 'font-weight:bold',
+ 'str' => 'font-weight:bold; color:#56DB3A',
+ 'note' => 'color:#1299DA',
+ 'ref' => 'color:#A0A0A0',
+ 'public' => 'color:#FFFFFF',
+ 'protected' => 'color:#FFFFFF',
+ 'private' => 'color:#FFFFFF',
+ 'meta' => 'color:#B729D9',
+ 'key' => 'color:#56DB3A',
+ 'index' => 'color:#1299DA',
+ 'ellipsis' => 'color:#FF8400',
+ 'ns' => 'user-select:none;',
+ ],
+ 'light' => [
+ 'default' => 'background:none; color:#CC7832; line-height:1.2em; font:12px Menlo, Monaco, Consolas, monospace; word-wrap: break-word; white-space: pre-wrap; position:relative; z-index:99999; word-break: break-all',
+ 'num' => 'font-weight:bold; color:#1299DA',
+ 'const' => 'font-weight:bold',
+ 'str' => 'font-weight:bold; color:#629755;',
+ 'note' => 'color:#6897BB',
+ 'ref' => 'color:#6E6E6E',
+ 'public' => 'color:#262626',
+ 'protected' => 'color:#262626',
+ 'private' => 'color:#262626',
+ 'meta' => 'color:#B729D9',
+ 'key' => 'color:#789339',
+ 'index' => 'color:#1299DA',
+ 'ellipsis' => 'color:#CC7832',
+ 'ns' => 'user-select:none;',
+ ],
+ ];
+
+ protected $dumpHeader;
+ protected $dumpPrefix = '';
+ protected $dumpSuffix = '
';
+ protected $dumpId = 'sf-dump';
+ protected $colors = true;
+ protected $headerIsDumped = false;
+ protected $lastDepth = -1;
+ protected $styles;
+
+ private array $displayOptions = [
+ 'maxDepth' => 1,
+ 'maxStringLength' => 160,
+ 'fileLinkFormat' => null,
+ ];
+ private array $extraDisplayOptions = [];
+
+ public function __construct($output = null, ?string $charset = null, int $flags = 0)
+ {
+ AbstractDumper::__construct($output, $charset, $flags);
+ $this->dumpId = 'sf-dump-'.mt_rand();
+ $this->displayOptions['fileLinkFormat'] = \ini_get('xdebug.file_link_format') ?: get_cfg_var('xdebug.file_link_format');
+ $this->styles = static::$themes['dark'] ?? self::$themes['dark'];
+ }
+
+ /**
+ * @return void
+ */
+ public function setStyles(array $styles)
+ {
+ $this->headerIsDumped = false;
+ $this->styles = $styles + $this->styles;
+ }
+
+ /**
+ * @return void
+ */
+ public function setTheme(string $themeName)
+ {
+ if (!isset(static::$themes[$themeName])) {
+ throw new \InvalidArgumentException(sprintf('Theme "%s" does not exist in class "%s".', $themeName, static::class));
+ }
+
+ $this->setStyles(static::$themes[$themeName]);
+ }
+
+ /**
+ * Configures display options.
+ *
+ * @param array $displayOptions A map of display options to customize the behavior
+ *
+ * @return void
+ */
+ public function setDisplayOptions(array $displayOptions)
+ {
+ $this->headerIsDumped = false;
+ $this->displayOptions = $displayOptions + $this->displayOptions;
+ }
+
+ /**
+ * Sets an HTML header that will be dumped once in the output stream.
+ *
+ * @return void
+ */
+ public function setDumpHeader(?string $header)
+ {
+ $this->dumpHeader = $header;
+ }
+
+ /**
+ * Sets an HTML prefix and suffix that will encapse every single dump.
+ *
+ * @return void
+ */
+ public function setDumpBoundaries(string $prefix, string $suffix)
+ {
+ $this->dumpPrefix = $prefix;
+ $this->dumpSuffix = $suffix;
+ }
+
+ public function dump(Data $data, $output = null, array $extraDisplayOptions = []): ?string
+ {
+ $this->extraDisplayOptions = $extraDisplayOptions;
+ $result = parent::dump($data, $output);
+ $this->dumpId = 'sf-dump-'.mt_rand();
+
+ return $result;
+ }
+
+ /**
+ * Dumps the HTML header.
+ *
+ * @return string
+ */
+ protected function getDumpHeader()
+ {
+ $this->headerIsDumped = $this->outputStream ?? $this->lineDumper;
+
+ if (null !== $this->dumpHeader) {
+ return $this->dumpHeader;
+ }
+
+ $line = str_replace('{$options}', json_encode($this->displayOptions, \JSON_FORCE_OBJECT), <<<'EOHTML'
+'.$this->dumpHeader;
+ }
+
+ /**
+ * @return void
+ */
+ public function dumpString(Cursor $cursor, string $str, bool $bin, int $cut)
+ {
+ if ('' === $str && isset($cursor->attr['img-data'], $cursor->attr['content-type'])) {
+ $this->dumpKey($cursor);
+ $this->line .= $this->style('default', $cursor->attr['img-size'] ?? '', []);
+ $this->line .= $cursor->depth >= $this->displayOptions['maxDepth'] ? ' ' : ' ';
+ $this->endValue($cursor);
+ $this->line .= $this->indentPad;
+ $this->line .= sprintf('
', $cursor->attr['content-type'], base64_encode($cursor->attr['img-data']));
+ $this->endValue($cursor);
+ } else {
+ parent::dumpString($cursor, $str, $bin, $cut);
+ }
+ }
+
+ /**
+ * @return void
+ */
+ public function enterHash(Cursor $cursor, int $type, string|int|null $class, bool $hasChild)
+ {
+ if (Cursor::HASH_OBJECT === $type) {
+ $cursor->attr['depth'] = $cursor->depth;
+ }
+ parent::enterHash($cursor, $type, $class, false);
+
+ if ($cursor->skipChildren || $cursor->depth >= $this->displayOptions['maxDepth']) {
+ $cursor->skipChildren = false;
+ $eol = ' class=sf-dump-compact>';
+ } else {
+ $this->expandNextHash = false;
+ $eol = ' class=sf-dump-expanded>';
+ }
+
+ if ($hasChild) {
+ $this->line .= 'dumpId, $r);
+ }
+ $this->line .= $eol;
+ $this->dumpLine($cursor->depth);
+ }
+ }
+
+ /**
+ * @return void
+ */
+ public function leaveHash(Cursor $cursor, int $type, string|int|null $class, bool $hasChild, int $cut)
+ {
+ $this->dumpEllipsis($cursor, $hasChild, $cut);
+ if ($hasChild) {
+ $this->line .= '';
+ }
+ parent::leaveHash($cursor, $type, $class, $hasChild, 0);
+ }
+
+ protected function style(string $style, string $value, array $attr = []): string
+ {
+ if ('' === $value && ('label' !== $style || !isset($attr['file']) && !isset($attr['href']))) {
+ return '';
+ }
+
+ $v = esc($value);
+
+ if ('ref' === $style) {
+ if (empty($attr['count'])) {
+ return sprintf('%s', $v);
+ }
+ $r = ('#' !== $v[0] ? 1 - ('@' !== $v[0]) : 2).substr($value, 1);
+
+ return sprintf('%s', $this->dumpId, $r, 1 + $attr['count'], $v);
+ }
+
+ if ('const' === $style && isset($attr['value'])) {
+ $style .= sprintf(' title="%s"', esc(\is_scalar($attr['value']) ? $attr['value'] : json_encode($attr['value'])));
+ } elseif ('public' === $style) {
+ $style .= sprintf(' title="%s"', empty($attr['dynamic']) ? 'Public property' : 'Runtime added dynamic property');
+ } elseif ('str' === $style && 1 < $attr['length']) {
+ $style .= sprintf(' title="%d%s characters"', $attr['length'], $attr['binary'] ? ' binary or non-UTF-8' : '');
+ } elseif ('note' === $style && 0 < ($attr['depth'] ?? 0) && false !== $c = strrpos($value, '\\')) {
+ $style .= ' title=""';
+ $attr += [
+ 'ellipsis' => \strlen($value) - $c,
+ 'ellipsis-type' => 'note',
+ 'ellipsis-tail' => 1,
+ ];
+ } elseif ('protected' === $style) {
+ $style .= ' title="Protected property"';
+ } elseif ('meta' === $style && isset($attr['title'])) {
+ $style .= sprintf(' title="%s"', esc($this->utf8Encode($attr['title'])));
+ } elseif ('private' === $style) {
+ $style .= sprintf(' title="Private property defined in class:
`%s`"', esc($this->utf8Encode($attr['class'])));
+ }
+
+ if (isset($attr['ellipsis'])) {
+ $class = 'sf-dump-ellipsis';
+ if (isset($attr['ellipsis-type'])) {
+ $class = sprintf('"%s sf-dump-ellipsis-%s"', $class, $attr['ellipsis-type']);
+ }
+ $label = esc(substr($value, -$attr['ellipsis']));
+ $style = str_replace(' title="', " title=\"$v\n", $style);
+ $v = sprintf('%s', $class, substr($v, 0, -\strlen($label)));
+
+ if (!empty($attr['ellipsis-tail'])) {
+ $tail = \strlen(esc(substr($value, -$attr['ellipsis'], $attr['ellipsis-tail'])));
+ $v .= sprintf('%s%s', $class, substr($label, 0, $tail), substr($label, $tail));
+ } else {
+ $v .= $label;
+ }
+ }
+
+ $map = static::$controlCharsMap;
+ $v = "".preg_replace_callback(static::$controlCharsRx, function ($c) use ($map) {
+ $s = $b = '';
+ }, $v).'';
+
+ if (!($attr['binary'] ?? false)) {
+ $v = preg_replace_callback(static::$unicodeCharsRx, function ($c) {
+ return '\u{'.strtoupper(dechex(mb_ord($c[0]))).'}';
+ }, $v);
+ }
+
+ if (isset($attr['file']) && $href = $this->getSourceLink($attr['file'], $attr['line'] ?? 0)) {
+ $attr['href'] = $href;
+ }
+ if (isset($attr['href'])) {
+ if ('label' === $style) {
+ $v .= '^';
+ }
+ $target = isset($attr['file']) ? '' : ' target="_blank"';
+ $v = sprintf('%s', esc($this->utf8Encode($attr['href'])), $target, $v);
+ }
+ if (isset($attr['lang'])) {
+ $v = sprintf('%s', esc($attr['lang']), $v);
+ }
+ if ('label' === $style) {
+ $v .= ' ';
+ }
+
+ return $v;
+ }
+
+ /**
+ * @return void
+ */
+ protected function dumpLine(int $depth, bool $endOfValue = false)
+ {
+ if (-1 === $this->lastDepth) {
+ $this->line = sprintf($this->dumpPrefix, $this->dumpId, $this->indentPad).$this->line;
+ }
+ if ($this->headerIsDumped !== ($this->outputStream ?? $this->lineDumper)) {
+ $this->line = $this->getDumpHeader().$this->line;
+ }
+
+ if (-1 === $depth) {
+ $args = ['"'.$this->dumpId.'"'];
+ if ($this->extraDisplayOptions) {
+ $args[] = json_encode($this->extraDisplayOptions, \JSON_FORCE_OBJECT);
+ }
+ // Replace is for BC
+ $this->line .= sprintf(str_replace('"%s"', '%s', $this->dumpSuffix), implode(', ', $args));
+ }
+ $this->lastDepth = $depth;
+
+ $this->line = mb_encode_numericentity($this->line, [0x80, 0x10FFFF, 0, 0x1FFFFF], 'UTF-8');
+
+ if (-1 === $depth) {
+ AbstractDumper::dumpLine(0);
+ }
+ AbstractDumper::dumpLine($depth);
+ }
+
+ private function getSourceLink(string $file, int $line): string|false
+ {
+ $options = $this->extraDisplayOptions + $this->displayOptions;
+
+ if ($fmt = $options['fileLinkFormat']) {
+ return \is_string($fmt) ? strtr($fmt, ['%f' => $file, '%l' => $line]) : $fmt->format($file, $line);
+ }
+
+ return false;
+ }
+}
+
+function esc(string $str): string
+{
+ return htmlspecialchars($str, \ENT_QUOTES, 'UTF-8');
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Dumper/ServerDumper.php b/data/web/inc/lib/vendor/symfony/var-dumper/Dumper/ServerDumper.php
new file mode 100644
index 000000000..60fdd7ac3
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Dumper/ServerDumper.php
@@ -0,0 +1,55 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Dumper;
+
+use Symfony\Component\VarDumper\Cloner\Data;
+use Symfony\Component\VarDumper\Dumper\ContextProvider\ContextProviderInterface;
+use Symfony\Component\VarDumper\Server\Connection;
+
+/**
+ * ServerDumper forwards serialized Data clones to a server.
+ *
+ * @author Maxime Steinhausser
+ */
+class ServerDumper implements DataDumperInterface
+{
+ private Connection $connection;
+ private ?DataDumperInterface $wrappedDumper;
+
+ /**
+ * @param string $host The server host
+ * @param DataDumperInterface|null $wrappedDumper A wrapped instance used whenever we failed contacting the server
+ * @param ContextProviderInterface[] $contextProviders Context providers indexed by context name
+ */
+ public function __construct(string $host, ?DataDumperInterface $wrappedDumper = null, array $contextProviders = [])
+ {
+ $this->connection = new Connection($host, $contextProviders);
+ $this->wrappedDumper = $wrappedDumper;
+ }
+
+ public function getContextProviders(): array
+ {
+ return $this->connection->getContextProviders();
+ }
+
+ /**
+ * @return string|null
+ */
+ public function dump(Data $data)
+ {
+ if (!$this->connection->write($data) && $this->wrappedDumper) {
+ return $this->wrappedDumper->dump($data);
+ }
+
+ return null;
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Exception/ThrowingCasterException.php b/data/web/inc/lib/vendor/symfony/var-dumper/Exception/ThrowingCasterException.php
new file mode 100644
index 000000000..fd8eca9f1
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Exception/ThrowingCasterException.php
@@ -0,0 +1,26 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Exception;
+
+/**
+ * @author Nicolas Grekas
+ */
+class ThrowingCasterException extends \Exception
+{
+ /**
+ * @param \Throwable $prev The exception thrown from the caster
+ */
+ public function __construct(\Throwable $prev)
+ {
+ parent::__construct('Unexpected '.$prev::class.' thrown from a caster: '.$prev->getMessage(), 0, $prev);
+ }
+}
diff --git a/data/web/inc/lib/vendor/illuminate/collections/LICENSE.md b/data/web/inc/lib/vendor/symfony/var-dumper/LICENSE
similarity index 83%
rename from data/web/inc/lib/vendor/illuminate/collections/LICENSE.md
rename to data/web/inc/lib/vendor/symfony/var-dumper/LICENSE
index 79810c848..29f72d5e9 100644
--- a/data/web/inc/lib/vendor/illuminate/collections/LICENSE.md
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/LICENSE
@@ -1,16 +1,14 @@
-The MIT License (MIT)
-
-Copyright (c) Taylor Otwell
+Copyright (c) 2014-present Fabien Potencier
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
+copies of the Software, and to permit persons to whom the Software is furnished
+to do so, subject to the following conditions:
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/README.md b/data/web/inc/lib/vendor/symfony/var-dumper/README.md
new file mode 100644
index 000000000..a0da8c9ab
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/README.md
@@ -0,0 +1,15 @@
+VarDumper Component
+===================
+
+The VarDumper component provides mechanisms for walking through any arbitrary
+PHP variable. It provides a better `dump()` function that you can use instead
+of `var_dump()`.
+
+Resources
+---------
+
+ * [Documentation](https://symfony.com/doc/current/components/var_dumper/introduction.html)
+ * [Contributing](https://symfony.com/doc/current/contributing/index.html)
+ * [Report issues](https://github.com/symfony/symfony/issues) and
+ [send Pull Requests](https://github.com/symfony/symfony/pulls)
+ in the [main Symfony repository](https://github.com/symfony/symfony)
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Resources/bin/var-dump-server b/data/web/inc/lib/vendor/symfony/var-dumper/Resources/bin/var-dump-server
new file mode 100755
index 000000000..f398fcef7
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Resources/bin/var-dump-server
@@ -0,0 +1,67 @@
+#!/usr/bin/env php
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+if ('cli' !== PHP_SAPI) {
+ throw new Exception('This script must be run from the command line.');
+}
+
+/**
+ * Starts a dump server to collect and output dumps on a single place with multiple formats support.
+ *
+ * @author Maxime Steinhausser
+ */
+
+use Psr\Log\LoggerInterface;
+use Symfony\Component\Console\Application;
+use Symfony\Component\Console\Input\ArgvInput;
+use Symfony\Component\Console\Input\InputOption;
+use Symfony\Component\Console\Logger\ConsoleLogger;
+use Symfony\Component\Console\Output\ConsoleOutput;
+use Symfony\Component\VarDumper\Command\ServerDumpCommand;
+use Symfony\Component\VarDumper\Server\DumpServer;
+
+function includeIfExists(string $file): bool
+{
+ return file_exists($file) && include $file;
+}
+
+if (
+ !includeIfExists(__DIR__ . '/../../../../autoload.php') &&
+ !includeIfExists(__DIR__ . '/../../vendor/autoload.php') &&
+ !includeIfExists(__DIR__ . '/../../../../../../vendor/autoload.php')
+) {
+ fwrite(STDERR, 'Install dependencies using Composer.'.PHP_EOL);
+ exit(1);
+}
+
+if (!class_exists(Application::class)) {
+ fwrite(STDERR, 'You need the "symfony/console" component in order to run the VarDumper server.'.PHP_EOL);
+ exit(1);
+}
+
+$input = new ArgvInput();
+$output = new ConsoleOutput();
+$defaultHost = '127.0.0.1:9912';
+$host = $input->getParameterOption(['--host'], $_SERVER['VAR_DUMPER_SERVER'] ?? $defaultHost, true);
+$logger = interface_exists(LoggerInterface::class) ? new ConsoleLogger($output->getErrorOutput()) : null;
+
+$app = new Application();
+
+$app->getDefinition()->addOption(
+ new InputOption('--host', null, InputOption::VALUE_REQUIRED, 'The address the server should listen to', $defaultHost)
+);
+
+$app->add($command = new ServerDumpCommand(new DumpServer($host, $logger)))
+ ->getApplication()
+ ->setDefaultCommand($command->getName(), true)
+ ->run($input, $output)
+;
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Resources/css/htmlDescriptor.css b/data/web/inc/lib/vendor/symfony/var-dumper/Resources/css/htmlDescriptor.css
new file mode 100644
index 000000000..8f706d640
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Resources/css/htmlDescriptor.css
@@ -0,0 +1,130 @@
+body {
+ display: flex;
+ flex-direction: column-reverse;
+ justify-content: flex-end;
+ max-width: 1140px;
+ margin: auto;
+ padding: 15px;
+ word-wrap: break-word;
+ background-color: #F9F9F9;
+ color: #222;
+ font-family: Helvetica, Arial, sans-serif;
+ font-size: 14px;
+ line-height: 1.4;
+}
+p {
+ margin: 0;
+}
+a {
+ color: #218BC3;
+ text-decoration: none;
+}
+a:hover {
+ text-decoration: underline;
+}
+.text-small {
+ font-size: 12px !important;
+}
+article {
+ margin: 5px;
+ margin-bottom: 10px;
+}
+article > header > .row {
+ display: flex;
+ flex-direction: row;
+ align-items: baseline;
+ margin-bottom: 10px;
+}
+article > header > .row > .col {
+ flex: 1;
+ display: flex;
+ align-items: baseline;
+}
+article > header > .row > h2 {
+ font-size: 14px;
+ color: #222;
+ font-weight: normal;
+ font-family: "Lucida Console", monospace, sans-serif;
+ word-break: break-all;
+ margin: 20px 5px 0 0;
+ user-select: all;
+}
+article > header > .row > h2 > code {
+ white-space: nowrap;
+ user-select: none;
+ color: #cc2255;
+ background-color: #f7f7f9;
+ border: 1px solid #e1e1e8;
+ border-radius: 3px;
+ margin-right: 5px;
+ padding: 0 3px;
+}
+article > header > .row > time.col {
+ flex: 0;
+ text-align: right;
+ white-space: nowrap;
+ color: #999;
+ font-style: italic;
+}
+article > header ul.tags {
+ list-style: none;
+ padding: 0;
+ margin: 0;
+ font-size: 12px;
+}
+article > header ul.tags > li {
+ user-select: all;
+ margin-bottom: 2px;
+}
+article > header ul.tags > li > span.badge {
+ display: inline-block;
+ padding: .25em .4em;
+ margin-right: 5px;
+ border-radius: 4px;
+ background-color: #6c757d3b;
+ color: #524d4d;
+ font-size: 12px;
+ text-align: center;
+ font-weight: 700;
+ line-height: 1;
+ white-space: nowrap;
+ vertical-align: baseline;
+ user-select: none;
+}
+article > section.body {
+ border: 1px solid #d8d8d8;
+ background: #FFF;
+ padding: 10px;
+ border-radius: 3px;
+}
+pre.sf-dump {
+ border-radius: 3px;
+ margin-bottom: 0;
+}
+.hidden {
+ display: none !important;
+}
+.dumped-tag > .sf-dump {
+ display: inline-block;
+ margin: 0;
+ padding: 1px 5px;
+ line-height: 1.4;
+ vertical-align: top;
+ background-color: transparent;
+ user-select: auto;
+}
+.dumped-tag > pre.sf-dump,
+.dumped-tag > .sf-dump-default {
+ color: #CC7832;
+ background: none;
+}
+.dumped-tag > .sf-dump .sf-dump-str { color: #629755; }
+.dumped-tag > .sf-dump .sf-dump-private,
+.dumped-tag > .sf-dump .sf-dump-protected,
+.dumped-tag > .sf-dump .sf-dump-public { color: #262626; }
+.dumped-tag > .sf-dump .sf-dump-note { color: #6897BB; }
+.dumped-tag > .sf-dump .sf-dump-key { color: #789339; }
+.dumped-tag > .sf-dump .sf-dump-ref { color: #6E6E6E; }
+.dumped-tag > .sf-dump .sf-dump-ellipsis { color: #CC7832; max-width: 100em; }
+.dumped-tag > .sf-dump .sf-dump-ellipsis-path { max-width: 5em; }
+.dumped-tag > .sf-dump .sf-dump-ns { user-select: none; }
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Resources/functions/dump.php b/data/web/inc/lib/vendor/symfony/var-dumper/Resources/functions/dump.php
new file mode 100644
index 000000000..f2ff74c0c
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Resources/functions/dump.php
@@ -0,0 +1,62 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+use Symfony\Component\VarDumper\Caster\ScalarStub;
+use Symfony\Component\VarDumper\VarDumper;
+
+if (!function_exists('dump')) {
+ /**
+ * @author Nicolas Grekas
+ * @author Alexandre Daubois
+ */
+ function dump(mixed ...$vars): mixed
+ {
+ if (!$vars) {
+ VarDumper::dump(new ScalarStub('🐛'));
+
+ return null;
+ }
+
+ if (array_key_exists(0, $vars) && 1 === count($vars)) {
+ VarDumper::dump($vars[0]);
+ $k = 0;
+ } else {
+ foreach ($vars as $k => $v) {
+ VarDumper::dump($v, is_int($k) ? 1 + $k : $k);
+ }
+ }
+
+ if (1 < count($vars)) {
+ return $vars;
+ }
+
+ return $vars[$k];
+ }
+}
+
+if (!function_exists('dd')) {
+ function dd(mixed ...$vars): never
+ {
+ if (!\in_array(\PHP_SAPI, ['cli', 'phpdbg', 'embed'], true) && !headers_sent()) {
+ header('HTTP/1.1 500 Internal Server Error');
+ }
+
+ if (array_key_exists(0, $vars) && 1 === count($vars)) {
+ VarDumper::dump($vars[0]);
+ } else {
+ foreach ($vars as $k => $v) {
+ VarDumper::dump($v, is_int($k) ? 1 + $k : $k);
+ }
+ }
+
+ exit(1);
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Resources/js/htmlDescriptor.js b/data/web/inc/lib/vendor/symfony/var-dumper/Resources/js/htmlDescriptor.js
new file mode 100644
index 000000000..63101e57c
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Resources/js/htmlDescriptor.js
@@ -0,0 +1,10 @@
+document.addEventListener('DOMContentLoaded', function() {
+ let prev = null;
+ Array.from(document.getElementsByTagName('article')).reverse().forEach(function (article) {
+ const dedupId = article.dataset.dedupId;
+ if (dedupId === prev) {
+ article.getElementsByTagName('header')[0].classList.add('hidden');
+ }
+ prev = dedupId;
+ });
+});
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Server/Connection.php b/data/web/inc/lib/vendor/symfony/var-dumper/Server/Connection.php
new file mode 100644
index 000000000..4383278c9
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Server/Connection.php
@@ -0,0 +1,97 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Server;
+
+use Symfony\Component\VarDumper\Cloner\Data;
+use Symfony\Component\VarDumper\Dumper\ContextProvider\ContextProviderInterface;
+
+/**
+ * Forwards serialized Data clones to a server.
+ *
+ * @author Maxime Steinhausser
+ */
+class Connection
+{
+ private string $host;
+ private array $contextProviders;
+
+ /**
+ * @var resource|null
+ */
+ private $socket;
+
+ /**
+ * @param string $host The server host
+ * @param ContextProviderInterface[] $contextProviders Context providers indexed by context name
+ */
+ public function __construct(string $host, array $contextProviders = [])
+ {
+ if (!str_contains($host, '://')) {
+ $host = 'tcp://'.$host;
+ }
+
+ $this->host = $host;
+ $this->contextProviders = $contextProviders;
+ }
+
+ public function getContextProviders(): array
+ {
+ return $this->contextProviders;
+ }
+
+ public function write(Data $data): bool
+ {
+ $socketIsFresh = !$this->socket;
+ if (!$this->socket = $this->socket ?: $this->createSocket()) {
+ return false;
+ }
+
+ $context = ['timestamp' => microtime(true)];
+ foreach ($this->contextProviders as $name => $provider) {
+ $context[$name] = $provider->getContext();
+ }
+ $context = array_filter($context);
+ $encodedPayload = base64_encode(serialize([$data, $context]))."\n";
+
+ set_error_handler(static fn () => null);
+ try {
+ if (-1 !== stream_socket_sendto($this->socket, $encodedPayload)) {
+ return true;
+ }
+ if (!$socketIsFresh) {
+ stream_socket_shutdown($this->socket, \STREAM_SHUT_RDWR);
+ fclose($this->socket);
+ $this->socket = $this->createSocket();
+ }
+ if (-1 !== stream_socket_sendto($this->socket, $encodedPayload)) {
+ return true;
+ }
+ } finally {
+ restore_error_handler();
+ }
+
+ return false;
+ }
+
+ /**
+ * @return resource|null
+ */
+ private function createSocket()
+ {
+ set_error_handler(static fn () => null);
+ try {
+ return stream_socket_client($this->host, $errno, $errstr, 3) ?: null;
+ } finally {
+ restore_error_handler();
+ }
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Server/DumpServer.php b/data/web/inc/lib/vendor/symfony/var-dumper/Server/DumpServer.php
new file mode 100644
index 000000000..a9228a2ef
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Server/DumpServer.php
@@ -0,0 +1,109 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Server;
+
+use Psr\Log\LoggerInterface;
+use Symfony\Component\VarDumper\Cloner\Data;
+use Symfony\Component\VarDumper\Cloner\Stub;
+
+/**
+ * A server collecting Data clones sent by a ServerDumper.
+ *
+ * @author Maxime Steinhausser
+ *
+ * @final
+ */
+class DumpServer
+{
+ private string $host;
+ private ?LoggerInterface $logger;
+
+ /**
+ * @var resource|null
+ */
+ private $socket;
+
+ public function __construct(string $host, ?LoggerInterface $logger = null)
+ {
+ if (!str_contains($host, '://')) {
+ $host = 'tcp://'.$host;
+ }
+
+ $this->host = $host;
+ $this->logger = $logger;
+ }
+
+ public function start(): void
+ {
+ if (!$this->socket = stream_socket_server($this->host, $errno, $errstr)) {
+ throw new \RuntimeException(sprintf('Server start failed on "%s": ', $this->host).$errstr.' '.$errno);
+ }
+ }
+
+ public function listen(callable $callback): void
+ {
+ if (null === $this->socket) {
+ $this->start();
+ }
+
+ foreach ($this->getMessages() as $clientId => $message) {
+ $this->logger?->info('Received a payload from client {clientId}', ['clientId' => $clientId]);
+
+ $payload = @unserialize(base64_decode($message), ['allowed_classes' => [Data::class, Stub::class]]);
+
+ // Impossible to decode the message, give up.
+ if (false === $payload) {
+ $this->logger?->warning('Unable to decode a message from {clientId} client.', ['clientId' => $clientId]);
+
+ continue;
+ }
+
+ if (!\is_array($payload) || \count($payload) < 2 || !$payload[0] instanceof Data || !\is_array($payload[1])) {
+ $this->logger?->warning('Invalid payload from {clientId} client. Expected an array of two elements (Data $data, array $context)', ['clientId' => $clientId]);
+
+ continue;
+ }
+
+ [$data, $context] = $payload;
+
+ $callback($data, $context, $clientId);
+ }
+ }
+
+ public function getHost(): string
+ {
+ return $this->host;
+ }
+
+ private function getMessages(): iterable
+ {
+ $sockets = [(int) $this->socket => $this->socket];
+ $write = [];
+
+ while (true) {
+ $read = $sockets;
+ stream_select($read, $write, $write, null);
+
+ foreach ($read as $stream) {
+ if ($this->socket === $stream) {
+ $stream = stream_socket_accept($this->socket);
+ $sockets[(int) $stream] = $stream;
+ } elseif (feof($stream)) {
+ unset($sockets[(int) $stream]);
+ fclose($stream);
+ } else {
+ yield (int) $stream => fgets($stream);
+ }
+ }
+ }
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/Test/VarDumperTestTrait.php b/data/web/inc/lib/vendor/symfony/var-dumper/Test/VarDumperTestTrait.php
new file mode 100644
index 000000000..4475efd12
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/Test/VarDumperTestTrait.php
@@ -0,0 +1,84 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Test;
+
+use Symfony\Component\VarDumper\Cloner\VarCloner;
+use Symfony\Component\VarDumper\Dumper\CliDumper;
+
+/**
+ * @author Nicolas Grekas
+ */
+trait VarDumperTestTrait
+{
+ /**
+ * @internal
+ */
+ private array $varDumperConfig = [
+ 'casters' => [],
+ 'flags' => null,
+ ];
+
+ protected function setUpVarDumper(array $casters, ?int $flags = null): void
+ {
+ $this->varDumperConfig['casters'] = $casters;
+ $this->varDumperConfig['flags'] = $flags;
+ }
+
+ /**
+ * @after
+ */
+ protected function tearDownVarDumper(): void
+ {
+ $this->varDumperConfig['casters'] = [];
+ $this->varDumperConfig['flags'] = null;
+ }
+
+ public function assertDumpEquals(mixed $expected, mixed $data, int $filter = 0, string $message = '')
+ {
+ $this->assertSame($this->prepareExpectation($expected, $filter), $this->getDump($data, null, $filter), $message);
+ }
+
+ public function assertDumpMatchesFormat(mixed $expected, mixed $data, int $filter = 0, string $message = '')
+ {
+ $this->assertStringMatchesFormat($this->prepareExpectation($expected, $filter), $this->getDump($data, null, $filter), $message);
+ }
+
+ protected function getDump(mixed $data, string|int|null $key = null, int $filter = 0): ?string
+ {
+ if (null === $flags = $this->varDumperConfig['flags']) {
+ $flags = getenv('DUMP_LIGHT_ARRAY') ? CliDumper::DUMP_LIGHT_ARRAY : 0;
+ $flags |= getenv('DUMP_STRING_LENGTH') ? CliDumper::DUMP_STRING_LENGTH : 0;
+ $flags |= getenv('DUMP_COMMA_SEPARATOR') ? CliDumper::DUMP_COMMA_SEPARATOR : 0;
+ }
+
+ $cloner = new VarCloner();
+ $cloner->addCasters($this->varDumperConfig['casters']);
+ $cloner->setMaxItems(-1);
+ $dumper = new CliDumper(null, null, $flags);
+ $dumper->setColors(false);
+ $data = $cloner->cloneVar($data, $filter)->withRefHandles(false);
+ if (null !== $key && null === $data = $data->seek($key)) {
+ return null;
+ }
+
+ return rtrim($dumper->dump($data, true));
+ }
+
+ private function prepareExpectation(mixed $expected, int $filter): string
+ {
+ if (!\is_string($expected)) {
+ $expected = $this->getDump($expected, null, $filter);
+ }
+
+ return rtrim($expected);
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/VarDumper.php b/data/web/inc/lib/vendor/symfony/var-dumper/VarDumper.php
new file mode 100644
index 000000000..e1400f150
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/VarDumper.php
@@ -0,0 +1,127 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper;
+
+use Symfony\Component\ErrorHandler\ErrorRenderer\FileLinkFormatter;
+use Symfony\Component\HttpFoundation\Request;
+use Symfony\Component\HttpFoundation\RequestStack;
+use Symfony\Component\VarDumper\Caster\ReflectionCaster;
+use Symfony\Component\VarDumper\Cloner\VarCloner;
+use Symfony\Component\VarDumper\Dumper\CliDumper;
+use Symfony\Component\VarDumper\Dumper\ContextProvider\CliContextProvider;
+use Symfony\Component\VarDumper\Dumper\ContextProvider\RequestContextProvider;
+use Symfony\Component\VarDumper\Dumper\ContextProvider\SourceContextProvider;
+use Symfony\Component\VarDumper\Dumper\ContextualizedDumper;
+use Symfony\Component\VarDumper\Dumper\HtmlDumper;
+use Symfony\Component\VarDumper\Dumper\ServerDumper;
+
+// Load the global dump() function
+require_once __DIR__.'/Resources/functions/dump.php';
+
+/**
+ * @author Nicolas Grekas
+ */
+class VarDumper
+{
+ /**
+ * @var callable|null
+ */
+ private static $handler;
+
+ /**
+ * @param string|null $label
+ *
+ * @return mixed
+ */
+ public static function dump(mixed $var/* , string $label = null */)
+ {
+ $label = 2 <= \func_num_args() ? func_get_arg(1) : null;
+ if (null === self::$handler) {
+ self::register();
+ }
+
+ return (self::$handler)($var, $label);
+ }
+
+ public static function setHandler(?callable $callable = null): ?callable
+ {
+ if (1 > \func_num_args()) {
+ trigger_deprecation('symfony/var-dumper', '6.2', 'Calling "%s()" without any arguments is deprecated, pass null explicitly instead.', __METHOD__);
+ }
+ $prevHandler = self::$handler;
+
+ // Prevent replacing the handler with expected format as soon as the env var was set:
+ if (isset($_SERVER['VAR_DUMPER_FORMAT'])) {
+ return $prevHandler;
+ }
+
+ self::$handler = $callable;
+
+ return $prevHandler;
+ }
+
+ private static function register(): void
+ {
+ $cloner = new VarCloner();
+ $cloner->addCasters(ReflectionCaster::UNSET_CLOSURE_FILE_INFO);
+
+ $format = $_SERVER['VAR_DUMPER_FORMAT'] ?? null;
+ switch (true) {
+ case 'html' === $format:
+ $dumper = new HtmlDumper();
+ break;
+ case 'cli' === $format:
+ $dumper = new CliDumper();
+ break;
+ case 'server' === $format:
+ case $format && 'tcp' === parse_url($format, \PHP_URL_SCHEME):
+ $host = 'server' === $format ? $_SERVER['VAR_DUMPER_SERVER'] ?? '127.0.0.1:9912' : $format;
+ $dumper = \in_array(\PHP_SAPI, ['cli', 'phpdbg', 'embed'], true) ? new CliDumper() : new HtmlDumper();
+ $dumper = new ServerDumper($host, $dumper, self::getDefaultContextProviders());
+ break;
+ default:
+ $dumper = \in_array(\PHP_SAPI, ['cli', 'phpdbg', 'embed'], true) ? new CliDumper() : new HtmlDumper();
+ }
+
+ if (!$dumper instanceof ServerDumper) {
+ $dumper = new ContextualizedDumper($dumper, [new SourceContextProvider()]);
+ }
+
+ self::$handler = function ($var, ?string $label = null) use ($cloner, $dumper) {
+ $var = $cloner->cloneVar($var);
+
+ if (null !== $label) {
+ $var = $var->withContext(['label' => $label]);
+ }
+
+ $dumper->dump($var);
+ };
+ }
+
+ private static function getDefaultContextProviders(): array
+ {
+ $contextProviders = [];
+
+ if (!\in_array(\PHP_SAPI, ['cli', 'phpdbg', 'embed'], true) && class_exists(Request::class)) {
+ $requestStack = new RequestStack();
+ $requestStack->push(Request::createFromGlobals());
+ $contextProviders['request'] = new RequestContextProvider($requestStack);
+ }
+
+ $fileLinkFormatter = class_exists(FileLinkFormatter::class) ? new FileLinkFormatter(null, $requestStack ?? null) : null;
+
+ return $contextProviders + [
+ 'cli' => new CliContextProvider(),
+ 'source' => new SourceContextProvider(null, null, $fileLinkFormatter),
+ ];
+ }
+}
diff --git a/data/web/inc/lib/vendor/symfony/var-dumper/composer.json b/data/web/inc/lib/vendor/symfony/var-dumper/composer.json
new file mode 100644
index 000000000..e6166f86d
--- /dev/null
+++ b/data/web/inc/lib/vendor/symfony/var-dumper/composer.json
@@ -0,0 +1,46 @@
+{
+ "name": "symfony/var-dumper",
+ "type": "library",
+ "description": "Provides mechanisms for walking through any arbitrary PHP variable",
+ "keywords": ["dump", "debug"],
+ "homepage": "https://symfony.com",
+ "license": "MIT",
+ "authors": [
+ {
+ "name": "Nicolas Grekas",
+ "email": "p@tchwork.com"
+ },
+ {
+ "name": "Symfony Community",
+ "homepage": "https://symfony.com/contributors"
+ }
+ ],
+ "require": {
+ "php": ">=8.1",
+ "symfony/deprecation-contracts": "^2.5|^3",
+ "symfony/polyfill-mbstring": "~1.0"
+ },
+ "require-dev": {
+ "ext-iconv": "*",
+ "symfony/console": "^5.4|^6.0|^7.0",
+ "symfony/error-handler": "^6.3|^7.0",
+ "symfony/http-kernel": "^5.4|^6.0|^7.0",
+ "symfony/process": "^5.4|^6.0|^7.0",
+ "symfony/uid": "^5.4|^6.0|^7.0",
+ "twig/twig": "^2.13|^3.0.4"
+ },
+ "conflict": {
+ "symfony/console": "<5.4"
+ },
+ "autoload": {
+ "files": [ "Resources/functions/dump.php" ],
+ "psr-4": { "Symfony\\Component\\VarDumper\\": "" },
+ "exclude-from-classmap": [
+ "/Tests/"
+ ]
+ },
+ "bin": [
+ "Resources/bin/var-dump-server"
+ ],
+ "minimum-stability": "dev"
+}
diff --git a/data/web/inc/lib/vendor/tightenco/collect/.github/workflows/run-tests.yml b/data/web/inc/lib/vendor/tightenco/collect/.github/workflows/run-tests.yml
new file mode 100644
index 000000000..406c40049
--- /dev/null
+++ b/data/web/inc/lib/vendor/tightenco/collect/.github/workflows/run-tests.yml
@@ -0,0 +1,41 @@
+name: Run tests
+
+on:
+ push:
+ branches: [laravel-9-ongoing, laravel-8-ongoing]
+ pull_request:
+
+jobs:
+ tests:
+ strategy:
+ matrix:
+ os: [Ubuntu, macOS]
+ php: [8.0, 8.1, 8.2]
+
+ include:
+ - os: Ubuntu
+ os-version: ubuntu-latest
+
+ - os: macOS
+ os-version: macos-latest
+
+ name: ${{ matrix.os }} - PHP ${{ matrix.php }}
+
+ runs-on: ${{ matrix.os-version }}
+
+ steps:
+ - name: Checkout code
+ uses: actions/checkout@v1
+
+ - name: Setup PHP
+ uses: shivammathur/setup-php@v2
+ with:
+ php-version: ${{ matrix.php }}
+ extensions: posix, dom, curl, libxml, mbstring, zip, pcntl, pdo, sqlite, pdo_sqlite, bcmath, soap, intl, gd, exif, iconv, imagick
+ coverage: none
+
+ - name: Install dependencies
+ run: composer update --prefer-stable --prefer-dist --no-interaction
+
+ - name: Run tests
+ run: bash upgrade.sh
diff --git a/data/web/inc/lib/vendor/tightenco/collect/branch-commit-push.sh b/data/web/inc/lib/vendor/tightenco/collect/branch-commit-push.sh
new file mode 100755
index 000000000..124e58331
--- /dev/null
+++ b/data/web/inc/lib/vendor/tightenco/collect/branch-commit-push.sh
@@ -0,0 +1,67 @@
+#!/bin/bash
+
+
+GREEN='\033[0;32m'
+RED='\033[0;31m'
+WHITE='\033[0;37m'
+RESET='\033[0m'
+
+function validateVersion()
+{
+ echo ""
+ passedVersion=$1
+ echo -e "${WHITE}-- Validating tag '$passedVersion'...${RESET}"
+
+ # Todo: validate the version here using a regex; if fail, just exit
+ # ... expect 8.75.0, with no v in front of it
+
+ if [[ $passedVersion == '' ]]; then
+ echo -e "\n-- Invalid tag. Tags should be structured without v; e.g. 8.57.0"
+ exit
+ fi
+
+ echo -e "${WHITE}-- Tag valid.${RESET}"
+ echo ""
+}
+
+# Exit script if any command fails (e.g. phpunit)
+set -e
+
+
+# Require confirmation it's set up corrctly
+echo
+echo -e "${WHITE}-- This script is meant to be run after running upgrade.sh, BEFORE committing to Git.${RESET}"
+
+while true; do
+ echo -e "${GREEN}-- Is that the current state of your local project?${RESET}"
+ read -p "-- (y/n) " yn
+ case $yn in
+ [Yy]* ) break;;
+ [Nn]* ) exit;;
+ * ) echo "Please answer y or n.";;
+ esac
+done
+
+# Get the version and exit if not valid
+validateVersion $1
+
+# Create official v prefaced version
+version="v$1"
+
+# Run tests (and bail if they fail)
+phpunit
+echo -e "\n${WHITE}-- Tests succeeded.${RESET}"
+
+# Branch
+echo -e "\n${WHITE}-- Creating a Git branch '$version-changes'...${RESET}\n"
+git checkout -b $version-changes
+
+# Add and commit, with "v8.57.0 changes" as the commit name
+git add -A
+git commit -m "$version changes"
+
+echo
+echo -e "${WHITE}-- Git committed.${RESET}"
+
+# Push
+git push -u origin $version-changes
diff --git a/data/web/inc/lib/vendor/tightenco/collect/composer.json b/data/web/inc/lib/vendor/tightenco/collect/composer.json
new file mode 100644
index 000000000..949635dcd
--- /dev/null
+++ b/data/web/inc/lib/vendor/tightenco/collect/composer.json
@@ -0,0 +1,50 @@
+{
+ "name": "tightenco/collect",
+ "description": "Collect - Illuminate Collections as a separate package.",
+ "keywords": ["laravel", "collection"],
+ "license": "MIT",
+ "authors": [
+ {
+ "name": "Taylor Otwell",
+ "email": "taylorotwell@gmail.com"
+ }
+ ],
+ "require": {
+ "php": "^8.0",
+ "symfony/var-dumper": "^3.4 || ^4.0 || ^5.0 || ^6.0"
+ },
+ "require-dev": {
+ "mockery/mockery": "^1.0",
+ "phpunit/phpunit": "^8.3",
+ "nesbot/carbon": "^2.23.0"
+ },
+ "autoload": {
+ "files": [
+ "src/Collect/Support/helpers.php",
+ "src/Collect/Support/alias.php"
+ ],
+ "psr-4": {
+ "Tightenco\\Collect\\": "src/Collect"
+ }
+ },
+ "autoload-dev": {
+ "files": [
+ "tests/files/Support/Carbon.php",
+ "tests/files/Support/HtmlString.php",
+ "tests/files/Support/HigherOrderTapProxy.php",
+ "tests/files/Support/Str.php",
+ "tests/files/Support/Stringable.php",
+ "tests/files/Support/ItemNotFoundException.php",
+ "tests/files/Support/MultipleItemsFoundException.php",
+ "tests/Support/Concerns/CountsEnumerations.php"
+ ]
+ },
+ "scripts": {
+ "test": [
+ "@composer install",
+ "phpunit"
+ ]
+ },
+ "minimum-stability": "dev",
+ "prefer-stable": true
+}
diff --git a/data/conf/acme/.gitkeep b/data/web/inc/lib/vendor/tightenco/collect/framework-.zip
similarity index 100%
rename from data/conf/acme/.gitkeep
rename to data/web/inc/lib/vendor/tightenco/collect/framework-.zip
diff --git a/data/web/inc/lib/vendor/illuminate/conditionable/HigherOrderWhenProxy.php b/data/web/inc/lib/vendor/tightenco/collect/src/Collect/Conditionable/HigherOrderWhenProxy.php
similarity index 98%
rename from data/web/inc/lib/vendor/illuminate/conditionable/HigherOrderWhenProxy.php
rename to data/web/inc/lib/vendor/tightenco/collect/src/Collect/Conditionable/HigherOrderWhenProxy.php
index 579114cf1..eaf24812b 100644
--- a/data/web/inc/lib/vendor/illuminate/conditionable/HigherOrderWhenProxy.php
+++ b/data/web/inc/lib/vendor/tightenco/collect/src/Collect/Conditionable/HigherOrderWhenProxy.php
@@ -1,6 +1,6 @@
+ */
+ public function toArray();
+}
diff --git a/data/web/inc/lib/vendor/tightenco/collect/src/Collect/Contracts/Support/CanBeEscapedWhenCastToString.php b/data/web/inc/lib/vendor/tightenco/collect/src/Collect/Contracts/Support/CanBeEscapedWhenCastToString.php
new file mode 100644
index 000000000..6f3ba0025
--- /dev/null
+++ b/data/web/inc/lib/vendor/tightenco/collect/src/Collect/Contracts/Support/CanBeEscapedWhenCastToString.php
@@ -0,0 +1,14 @@
+ $value) {
@@ -216,7 +214,7 @@ class Arr
* @param mixed $default
* @return mixed
*/
- public static function last($array, ?callable $callback = null, $default = null)
+ public static function last($array, callable $callback = null, $default = null)
{
if (is_null($callback)) {
return empty($array) ? value($default) : end($array);
@@ -225,22 +223,6 @@ class Arr
return static::first(array_reverse($array, true), $callback, $default);
}
- /**
- * Take the first or last {$limit} items from an array.
- *
- * @param array $array
- * @param int $limit
- * @return array
- */
- public static function take($array, $limit)
- {
- if ($limit < 0) {
- return array_slice($array, $limit, abs($limit));
- }
-
- return array_slice($array, 0, $limit);
- }
-
/**
* Flatten a multi-dimensional array into a single level.
*
@@ -428,7 +410,9 @@ class Arr
*/
public static function isAssoc(array $array)
{
- return ! array_is_list($array);
+ $keys = array_keys($array);
+
+ return array_keys($keys) !== $keys;
}
/**
@@ -441,7 +425,7 @@ class Arr
*/
public static function isList($array)
{
- return array_is_list($array);
+ return ! self::isAssoc($array);
}
/**
@@ -492,7 +476,9 @@ class Arr
*/
public static function prependKeysWith($array, $prependWith)
{
- return static::mapWithKeys($array, fn ($item, $key) => [$prependWith.$key => $item]);
+ return Collection::make($array)->mapWithKeys(function ($item, $key) use ($prependWith) {
+ return [$prependWith.$key => $item];
+ })->all();
}
/**
@@ -507,32 +493,6 @@ class Arr
return array_intersect_key($array, array_flip((array) $keys));
}
- /**
- * Select an array of values from an array.
- *
- * @param array $array
- * @param array|string $keys
- * @return array
- */
- public static function select($array, $keys)
- {
- $keys = static::wrap($keys);
-
- return static::map($array, function ($item) use ($keys) {
- $result = [];
-
- foreach ($keys as $key) {
- if (Arr::accessible($item) && Arr::exists($item, $key)) {
- $result[$key] = $item[$key];
- } elseif (is_object($item) && isset($item->{$key})) {
- $result[$key] = $item->{$key};
- }
- }
-
- return $result;
- });
- }
-
/**
* Pluck an array of values from an array.
*
@@ -605,35 +565,6 @@ class Arr
return array_combine($keys, $items);
}
- /**
- * Run an associative map over each of the items.
- *
- * The callback should return an associative array with a single key/value pair.
- *
- * @template TKey
- * @template TValue
- * @template TMapWithKeysKey of array-key
- * @template TMapWithKeysValue
- *
- * @param array $array
- * @param callable(TValue, TKey): array $callback
- * @return array
- */
- public static function mapWithKeys(array $array, callable $callback)
- {
- $result = [];
-
- foreach ($array as $key => $value) {
- $assoc = $callback($value, $key);
-
- foreach ($assoc as $mapKey => $mapValue) {
- $result[$mapKey] = $mapValue;
- }
- }
-
- return $result;
- }
-
/**
* Push an item onto the beginning of an array.
*
@@ -828,7 +759,7 @@ class Arr
}
}
- if (! array_is_list($array)) {
+ if (static::isAssoc($array)) {
$descending
? krsort($array, $options)
: ksort($array, $options);
@@ -841,18 +772,6 @@ class Arr
return $array;
}
- /**
- * Recursively sort an array by keys and values in descending order.
- *
- * @param array $array
- * @param int $options
- * @return array
- */
- public static function sortRecursiveDesc($array, $options = SORT_REGULAR)
- {
- return static::sortRecursive($array, $options, true);
- }
-
/**
* Conditionally compile classes from an array into a CSS class list.
*
diff --git a/data/web/inc/lib/vendor/illuminate/collections/Collection.php b/data/web/inc/lib/vendor/tightenco/collect/src/Collect/Support/Collection.php
similarity index 86%
rename from data/web/inc/lib/vendor/illuminate/collections/Collection.php
rename to data/web/inc/lib/vendor/tightenco/collect/src/Collect/Support/Collection.php
index 2f0c768f1..e705ee0d0 100644
--- a/data/web/inc/lib/vendor/illuminate/collections/Collection.php
+++ b/data/web/inc/lib/vendor/tightenco/collect/src/Collect/Support/Collection.php
@@ -1,28 +1,26 @@
- * @implements \Illuminate\Support\Enumerable
+ * @implements \Tightenco\Collect\Support\Enumerable
*/
class Collection implements ArrayAccess, CanBeEscapedWhenCastToString, Enumerable
{
/**
- * @use \Illuminate\Support\Traits\EnumeratesValues
+ * @use \Tightenco\Collect\Support\Traits\EnumeratesValues
*/
use EnumeratesValues, Macroable;
@@ -36,7 +34,7 @@ class Collection implements ArrayAccess, CanBeEscapedWhenCastToString, Enumerabl
/**
* Create a new collection.
*
- * @param \Illuminate\Contracts\Support\Arrayable|iterable|null $items
+ * @param \Tightenco\Collect\Contracts\Support\Arrayable|iterable|null $items
* @return void
*/
public function __construct($items = [])
@@ -69,7 +67,7 @@ class Collection implements ArrayAccess, CanBeEscapedWhenCastToString, Enumerabl
/**
* Get a lazy collection for the items in this collection.
*
- * @return \Illuminate\Support\LazyCollection
+ * @return \Tightenco\Collect\Support\LazyCollection
*/
public function lazy()
{
@@ -222,7 +220,7 @@ class Collection implements ArrayAccess, CanBeEscapedWhenCastToString, Enumerabl
* @template TCrossJoinKey
* @template TCrossJoinValue
*
- * @param \Illuminate\Contracts\Support\Arrayable|iterable ...$lists
+ * @param \Tightenco\Collect\Contracts\Support\Arrayable|iterable ...$lists
* @return static>
*/
public function crossJoin(...$lists)
@@ -235,7 +233,7 @@ class Collection implements ArrayAccess, CanBeEscapedWhenCastToString, Enumerabl
/**
* Get the items in the collection that are not present in the given items.
*
- * @param \Illuminate\Contracts\Support\Arrayable|iterable $items
+ * @param \Tightenco\Collect\Contracts\Support\Arrayable|iterable $items
* @return static
*/
public function diff($items)
@@ -246,7 +244,7 @@ class Collection implements ArrayAccess, CanBeEscapedWhenCastToString, Enumerabl
/**
* Get the items in the collection that are not present in the given items, using the callback.
*
- * @param \Illuminate\Contracts\Support\Arrayable|iterable $items
+ * @param \Tightenco\Collect\Contracts\Support\Arrayable|iterable $items
* @param callable(TValue, TValue): int $callback
* @return static
*/
@@ -258,7 +256,7 @@ class Collection implements ArrayAccess, CanBeEscapedWhenCastToString, Enumerabl
/**
* Get the items in the collection whose keys and values are not present in the given items.
*
- * @param \Illuminate\Contracts\Support\Arrayable|iterable $items
+ * @param \Tightenco\Collect\Contracts\Support\Arrayable|iterable $items
* @return static
*/
public function diffAssoc($items)
@@ -269,7 +267,7 @@ class Collection implements ArrayAccess, CanBeEscapedWhenCastToString, Enumerabl
/**
* Get the items in the collection whose keys and values are not present in the given items, using the callback.
*
- * @param \Illuminate\Contracts\Support\Arrayable|iterable $items
+ * @param \Tightenco\Collect\Contracts\Support\Arrayable|iterable $items
* @param callable(TKey, TKey): int $callback
* @return static
*/
@@ -281,7 +279,7 @@ class Collection implements ArrayAccess, CanBeEscapedWhenCastToString, Enumerabl
/**
* Get the items in the collection whose keys are not present in the given items.
*
- * @param \Illuminate\Contracts\Support\Arrayable|iterable $items
+ * @param \Tightenco\Collect\Contracts\Support\Arrayable|iterable $items
* @return static
*/
public function diffKeys($items)
@@ -292,7 +290,7 @@ class Collection implements ArrayAccess, CanBeEscapedWhenCastToString, Enumerabl
/**
* Get the items in the collection whose keys are not present in the given items, using the callback.
*
- * @param \Illuminate\Contracts\Support\Arrayable|iterable $items
+ * @param \Tightenco\Collect\Contracts\Support\Arrayable|iterable $items
* @param callable(TKey, TKey): int $callback
* @return static
*/
@@ -358,15 +356,11 @@ class Collection implements ArrayAccess, CanBeEscapedWhenCastToString, Enumerabl
/**
* Get all items except for those with the specified keys.
*
- * @param \Illuminate\Support\Enumerable|array|string $keys
+ * @param \Tightenco\Collect\Support\Enumerable|array $keys
* @return static
*/
public function except($keys)
{
- if (is_null($keys)) {
- return new static($this->items);
- }
-
if ($keys instanceof Enumerable) {
$keys = $keys->all();
} elseif (! is_array($keys)) {
@@ -379,10 +373,10 @@ class Collection implements ArrayAccess, CanBeEscapedWhenCastToString, Enumerabl
/**
* Run a filter over each of the items.
*
- * @param (callable(TValue, TKey): bool)|null $callback
+ * @param (callable(TValue, TKey): bool)|null $callback
* @return static
*/
- public function filter(?callable $callback = null)
+ public function filter(callable $callback = null)
{
if ($callback) {
return new static(Arr::where($this->items, $callback));
@@ -400,7 +394,7 @@ class Collection implements ArrayAccess, CanBeEscapedWhenCastToString, Enumerabl
* @param TFirstDefault|(\Closure(): TFirstDefault) $default
* @return TValue|TFirstDefault
*/
- public function first(?callable $callback = null, $default = null)
+ public function first(callable $callback = null, $default = null)
{
return Arr::first($this->items, $callback, $default);
}
@@ -429,13 +423,12 @@ class Collection implements ArrayAccess, CanBeEscapedWhenCastToString, Enumerabl
/**
* Remove an item from the collection by key.
*
- * \Illuminate\Contracts\Support\Arrayable|iterable|TKey $keys
- *
+ * @param TKey|array $keys
* @return $this
*/
public function forget($keys)
{
- foreach ($this->getArrayableItems($keys) as $key) {
+ foreach ((array) $keys as $key) {
$this->offsetUnset($key);
}
@@ -463,11 +456,9 @@ class Collection implements ArrayAccess, CanBeEscapedWhenCastToString, Enumerabl
/**
* Get an item from the collection by key or add it to collection if it does not exist.
*
- * @template TGetOrPutValue
- *
* @param mixed $key
- * @param TGetOrPutValue|(\Closure(): TGetOrPutValue) $value
- * @return TValue|TGetOrPutValue
+ * @param mixed $value
+ * @return mixed
*/
public function getOrPut($key, $value)
{
@@ -509,7 +500,6 @@ class Collection implements ArrayAccess, CanBeEscapedWhenCastToString, Enumerabl
foreach ($groupKeys as $groupKey) {
$groupKey = match (true) {
is_bool($groupKey) => (int) $groupKey,
- $groupKey instanceof \BackedEnum => $groupKey->value,
$groupKey instanceof \Stringable => (string) $groupKey,
default => $groupKey,
};
@@ -613,7 +603,7 @@ class Collection implements ArrayAccess, CanBeEscapedWhenCastToString, Enumerabl
$first = $this->first();
- if (is_array($first) || (is_object($first) && ! $first instanceof Stringable)) {
+ if (is_array($first) || (is_object($first) && ! $first instanceof \Illuminate\Support\Stringable)) {
return implode($glue ?? '', $this->pluck($value)->all());
}
@@ -623,7 +613,7 @@ class Collection implements ArrayAccess, CanBeEscapedWhenCastToString, Enumerabl
/**
* Intersect the collection with the given items.
*
- * @param \Illuminate\Contracts\Support\Arrayable|iterable $items
+ * @param \Tightenco\Collect\Contracts\Support\Arrayable|iterable $items
* @return static
*/
public function intersect($items)
@@ -634,7 +624,7 @@ class Collection implements ArrayAccess, CanBeEscapedWhenCastToString, Enumerabl
/**
* Intersect the collection with the given items, using the callback.
*
- * @param \Illuminate\Contracts\Support\Arrayable|iterable $items
+ * @param \Tightenco\Collect\Contracts\Support\Arrayable|iterable $items
* @param callable(TValue, TValue): int $callback
* @return static
*/
@@ -646,7 +636,7 @@ class Collection implements ArrayAccess, CanBeEscapedWhenCastToString, Enumerabl
/**
* Intersect the collection with the given items with additional index check.
*
- * @param \Illuminate\Contracts\Support\Arrayable|iterable $items
+ * @param \Tightenco\Collect\Contracts\Support\Arrayable|iterable $items
* @return static
*/
public function intersectAssoc($items)
@@ -657,7 +647,7 @@ class Collection implements ArrayAccess, CanBeEscapedWhenCastToString, Enumerabl
/**
* Intersect the collection with the given items with additional index check, using the callback.
*
- * @param \Illuminate\Contracts\Support\Arrayable|iterable $items
+ * @param \Tightenco\Collect\Contracts\Support\Arrayable|iterable $items
* @param callable(TValue, TValue): int $callback
* @return static
*/
@@ -669,7 +659,7 @@ class Collection implements ArrayAccess, CanBeEscapedWhenCastToString, Enumerabl
/**
* Intersect the collection with the given items by key.
*
- * @param \Illuminate\Contracts\Support\Arrayable|iterable $items
+ * @param \Tightenco\Collect\Contracts\Support\Arrayable|iterable $items
* @return static
*/
public function intersectByKeys($items)
@@ -748,7 +738,7 @@ class Collection implements ArrayAccess, CanBeEscapedWhenCastToString, Enumerabl
* @param TLastDefault|(\Closure(): TLastDefault) $default
* @return TValue|TLastDefault
*/
- public function last(?callable $callback = null, $default = null)
+ public function last(callable $callback = null, $default = null)
{
return Arr::last($this->items, $callback, $default);
}
@@ -823,13 +813,23 @@ class Collection implements ArrayAccess, CanBeEscapedWhenCastToString, Enumerabl
*/
public function mapWithKeys(callable $callback)
{
- return new static(Arr::mapWithKeys($this->items, $callback));
+ $result = [];
+
+ foreach ($this->items as $key => $value) {
+ $assoc = $callback($value, $key);
+
+ foreach ($assoc as $mapKey => $mapValue) {
+ $result[$mapKey] = $mapValue;
+ }
+ }
+
+ return new static($result);
}
/**
* Merge the collection with the given items.
*
- * @param \Illuminate\Contracts\Support\Arrayable|iterable $items
+ * @param \Tightenco\Collect\Contracts\Support\Arrayable|iterable $items
* @return static
*/
public function merge($items)
@@ -842,7 +842,7 @@ class Collection implements ArrayAccess, CanBeEscapedWhenCastToString, Enumerabl
*
* @template TMergeRecursiveValue
*
- * @param \Illuminate\Contracts\Support\Arrayable|iterable $items
+ * @param \Tightenco\Collect\Contracts\Support\Arrayable|iterable $items
* @return static
*/
public function mergeRecursive($items)
@@ -855,7 +855,7 @@ class Collection implements ArrayAccess, CanBeEscapedWhenCastToString, Enumerabl
*
* @template TCombineValue
*
- * @param \Illuminate\Contracts\Support\Arrayable|iterable $values
+ * @param \Tightenco\Collect\Contracts\Support\Arrayable|iterable $values
* @return static
*/
public function combine($values)
@@ -866,7 +866,7 @@ class Collection implements ArrayAccess, CanBeEscapedWhenCastToString, Enumerabl
/**
* Union the collection with the given items.
*
- * @param \Illuminate\Contracts\Support\Arrayable|iterable $items
+ * @param \Tightenco\Collect\Contracts\Support\Arrayable|iterable $items
* @return static
*/
public function union($items)
@@ -901,7 +901,7 @@ class Collection implements ArrayAccess, CanBeEscapedWhenCastToString, Enumerabl
/**
* Get the items with the specified keys.
*
- * @param \Illuminate\Support\Enumerable|array|string|null $keys
+ * @param \Tightenco\Collect\Support\Enumerable|array|string|null $keys
* @return static
*/
public function only($keys)
@@ -919,27 +919,6 @@ class Collection implements ArrayAccess, CanBeEscapedWhenCastToString, Enumerabl
return new static(Arr::only($this->items, $keys));
}
- /**
- * Select specific values from the items within the collection.
- *
- * @param \Illuminate\Support\Enumerable|array|string|null $keys
- * @return static
- */
- public function select($keys)
- {
- if (is_null($keys)) {
- return new static($this->items);
- }
-
- if ($keys instanceof Enumerable) {
- $keys = $keys->all();
- }
-
- $keys = is_array($keys) ? $keys : func_get_args();
-
- return new static(Arr::select($this->items, $keys));
- }
-
/**
* Get and remove the last N items from the collection.
*
@@ -999,11 +978,8 @@ class Collection implements ArrayAccess, CanBeEscapedWhenCastToString, Enumerabl
/**
* Push all of the given items onto the collection.
*
- * @template TConcatKey of array-key
- * @template TConcatValue
- *
- * @param iterable $source
- * @return static
+ * @param iterable $source
+ * @return static
*/
public function concat($source)
{
@@ -1048,28 +1024,27 @@ class Collection implements ArrayAccess, CanBeEscapedWhenCastToString, Enumerabl
* Get one or a specified number of items randomly from the collection.
*
* @param (callable(self): int)|int|null $number
- * @param bool $preserveKeys
* @return static|TValue
*
* @throws \InvalidArgumentException
*/
- public function random($number = null, $preserveKeys = false)
+ public function random($number = null)
{
if (is_null($number)) {
return Arr::random($this->items);
}
if (is_callable($number)) {
- return new static(Arr::random($this->items, $number($this), $preserveKeys));
+ return new static(Arr::random($this->items, $number($this)));
}
- return new static(Arr::random($this->items, $number, $preserveKeys));
+ return new static(Arr::random($this->items, $number));
}
/**
* Replace the collection items with the given items.
*
- * @param \Illuminate\Contracts\Support\Arrayable|iterable $items
+ * @param \Tightenco\Collect\Contracts\Support\Arrayable|iterable $items
* @return static
*/
public function replace($items)
@@ -1080,7 +1055,7 @@ class Collection implements ArrayAccess, CanBeEscapedWhenCastToString, Enumerabl
/**
* Recursively replace the collection items with the given items.
*
- * @param \Illuminate\Contracts\Support\Arrayable|iterable $items
+ * @param \Tightenco\Collect\Contracts\Support\Arrayable|iterable $items
* @return static
*/
public function replaceRecursive($items)
@@ -1103,7 +1078,7 @@ class Collection implements ArrayAccess, CanBeEscapedWhenCastToString, Enumerabl
*
* @param TValue|(callable(TValue,TKey): bool) $value
* @param bool $strict
- * @return TKey|false
+ * @return TKey|bool
*/
public function search($value, $strict = false)
{
@@ -1125,27 +1100,17 @@ class Collection implements ArrayAccess, CanBeEscapedWhenCastToString, Enumerabl
*
* @param int $count
* @return static|TValue|null
- *
- * @throws \InvalidArgumentException
*/
public function shift($count = 1)
{
- if ($count < 0) {
- throw new InvalidArgumentException('Number of shifted items may not be less than zero.');
+ if ($count === 1) {
+ return array_shift($this->items);
}
if ($this->isEmpty()) {
- return null;
- }
-
- if ($count === 0) {
return new static;
}
- if ($count === 1) {
- return array_shift($this->items);
- }
-
$results = [];
$collectionCount = $this->count();
@@ -1179,7 +1144,9 @@ class Collection implements ArrayAccess, CanBeEscapedWhenCastToString, Enumerabl
{
$chunks = floor(($this->count() - $size) / $step) + 1;
- return static::times($chunks, fn ($number) => $this->slice(($number - 1) * $step, $size));
+ return static::times($chunks, function ($number) use ($size, $step) {
+ return $this->slice(($number - 1) * $step, $size);
+ });
}
/**
@@ -1283,8 +1250,8 @@ class Collection implements ArrayAccess, CanBeEscapedWhenCastToString, Enumerabl
* @param mixed $value
* @return TValue
*
- * @throws \Illuminate\Support\ItemNotFoundException
- * @throws \Illuminate\Support\MultipleItemsFoundException
+ * @throws \Tightenco\Collect\Support\ItemNotFoundException
+ * @throws \Tightenco\Collect\Support\MultipleItemsFoundException
*/
public function sole($key = null, $operator = null, $value = null)
{
@@ -1315,7 +1282,7 @@ class Collection implements ArrayAccess, CanBeEscapedWhenCastToString, Enumerabl
* @param mixed $value
* @return TValue
*
- * @throws \Illuminate\Support\ItemNotFoundException
+ * @throws \Tightenco\Collect\Support\ItemNotFoundException
*/
public function firstOrFail($key = null, $operator = null, $value = null)
{
@@ -1411,7 +1378,7 @@ class Collection implements ArrayAccess, CanBeEscapedWhenCastToString, Enumerabl
public function sortBy($callback, $options = SORT_REGULAR, $descending = false)
{
if (is_array($callback) && ! is_callable($callback)) {
- return $this->sortByMany($callback, $options);
+ return $this->sortByMany($callback);
}
$results = [];
@@ -1442,14 +1409,13 @@ class Collection implements ArrayAccess, CanBeEscapedWhenCastToString, Enumerabl
* Sort the collection using multiple comparisons.
*
* @param array $comparisons
- * @param int $options
* @return static
*/
- protected function sortByMany(array $comparisons = [], int $options = SORT_REGULAR)
+ protected function sortByMany(array $comparisons = [])
{
$items = $this->items;
- uasort($items, function ($a, $b) use ($comparisons, $options) {
+ uasort($items, function ($a, $b) use ($comparisons) {
foreach ($comparisons as $comparison) {
$comparison = Arr::wrap($comparison);
@@ -1467,21 +1433,7 @@ class Collection implements ArrayAccess, CanBeEscapedWhenCastToString, Enumerabl
$values = array_reverse($values);
}
- if (($options & SORT_FLAG_CASE) === SORT_FLAG_CASE) {
- if (($options & SORT_NATURAL) === SORT_NATURAL) {
- $result = strnatcasecmp($values[0], $values[1]);
- } else {
- $result = strcasecmp($values[0], $values[1]);
- }
- } else {
- $result = match ($options) {
- SORT_NUMERIC => intval($values[0]) <=> intval($values[1]),
- SORT_STRING => strcmp($values[0], $values[1]),
- SORT_NATURAL => strnatcmp($values[0], $values[1]),
- SORT_LOCALE_STRING => strcoll($values[0], $values[1]),
- default => $values[0] <=> $values[1],
- };
- }
+ $result = $values[0] <=> $values[1];
}
if ($result === 0) {
@@ -1504,16 +1456,6 @@ class Collection implements ArrayAccess, CanBeEscapedWhenCastToString, Enumerabl
*/
public function sortByDesc($callback, $options = SORT_REGULAR)
{
- if (is_array($callback) && ! is_callable($callback)) {
- foreach ($callback as $index => $key) {
- $comparison = Arr::wrap($key);
-
- $comparison[1] = 'desc';
-
- $callback[$index] = $comparison;
- }
- }
-
return $this->sortBy($callback, $options, true);
}
@@ -1626,16 +1568,6 @@ class Collection implements ArrayAccess, CanBeEscapedWhenCastToString, Enumerabl
return $this;
}
- /**
- * Flatten a multi-dimensional associative array with dots.
- *
- * @return static
- */
- public function dot()
- {
- return new static(Arr::dot($this->all()));
- }
-
/**
* Convert a flatten "dot" notation array into an expanded array.
*
@@ -1690,7 +1622,7 @@ class Collection implements ArrayAccess, CanBeEscapedWhenCastToString, Enumerabl
*
* @template TZipValue
*
- * @param \Illuminate\Contracts\Support\Arrayable|iterable ...$items
+ * @param \Tightenco\Collect\Contracts\Support\Arrayable|iterable ...$items
* @return static>
*/
public function zip($items)
@@ -1763,7 +1695,7 @@ class Collection implements ArrayAccess, CanBeEscapedWhenCastToString, Enumerabl
/**
* Get a base Support collection instance from this collection.
*
- * @return \Illuminate\Support\Collection
+ * @return \Tightenco\Collect\Support\Collection
*/
public function toBase()
{
diff --git a/data/web/inc/lib/vendor/illuminate/collections/Enumerable.php b/data/web/inc/lib/vendor/tightenco/collect/src/Collect/Support/Enumerable.php
similarity index 88%
rename from data/web/inc/lib/vendor/illuminate/collections/Enumerable.php
rename to data/web/inc/lib/vendor/tightenco/collect/src/Collect/Support/Enumerable.php
index 806a6923f..1f0db03ae 100644
--- a/data/web/inc/lib/vendor/illuminate/collections/Enumerable.php
+++ b/data/web/inc/lib/vendor/tightenco/collect/src/Collect/Support/Enumerable.php
@@ -1,21 +1,20 @@
+ * @extends \Tightenco\Collect\Contracts\Support\Arrayable
* @extends \IteratorAggregate
*/
interface Enumerable extends Arrayable, Countable, IteratorAggregate, Jsonable, JsonSerializable
@@ -26,7 +25,7 @@ interface Enumerable extends Arrayable, Countable, IteratorAggregate, Jsonable,
* @template TMakeKey of array-key
* @template TMakeValue
*
- * @param \Illuminate\Contracts\Support\Arrayable|iterable|null $items
+ * @param \Tightenco\Collect\Contracts\Support\Arrayable|iterable|null $items
* @return static
*/
public static function make($items = []);
@@ -38,7 +37,7 @@ interface Enumerable extends Arrayable, Countable, IteratorAggregate, Jsonable,
* @param callable|null $callback
* @return static
*/
- public static function times($number, ?callable $callback = null);
+ public static function times($number, callable $callback = null);
/**
* Create a collection with the given range.
@@ -168,7 +167,7 @@ interface Enumerable extends Arrayable, Countable, IteratorAggregate, Jsonable,
* @template TCrossJoinKey
* @template TCrossJoinValue
*
- * @param \Illuminate\Contracts\Support\Arrayable|iterable ...$lists
+ * @param \Tightenco\Collect\Contracts\Support\Arrayable
### 50$/Month Sponsors