feat: add ArrayHelper::dotKeyExists()

system/Helpers/Array/ArrayHelper.php

@@ -11,6 +11,8 @@
 
 namespace CodeIgniter\Helpers\Array;
 
+use InvalidArgumentException;
+
 /**
  * @interal This is internal implementation for the framework.
  *
@@ -27,9 +29,21 @@ final class ArrayHelper
  *
  * @used-by dot_array_search()
  *
+ * @param string $index The index as dot array syntax.
+ *
  * @return array|bool|int|object|string|null
  */
  public static function dotSearch(string $index, array $array)
+ {
+ return self::arraySearchDot(self::convertToArray($index), $array);
+ }
+
+ /**
+ * @param string $index The index as dot array syntax.
+ *
+ * @return list<string> The index as an array.
+ */
+ private static function convertToArray(string $index): array
  {
  // See https://regex101.com/r/44Ipql/1
  $segments = preg_split(
@@ -39,9 +53,10 @@ public static function dotSearch(string $index, array $array)
  PREG_SPLIT_NO_EMPTY
  );
 
- $segments = array_map(static fn ($key) => str_replace('\.', '.', $key), $segments);
-
- return self::arraySearchDot($segments, $array);
+ return array_map(
+ static fn ($key) => str_replace('\.', '.', $key),
+ $segments
+ );
  }
 
  /**
@@ -106,6 +121,59 @@ private static function arraySearchDot(array $indexes, array $array)
  return null;
  }
 
+ /**
+ * array_key_exists() with dot array syntax.
+ *
+ * If wildcard `*` is used, all items for the key after it must have the key.
+ */
+ public static function dotKeyExists(string $index, array $array): bool
+ {
+ if (str_ends_with($index, '*') || str_contains($index, '*.*')) {
+ throw new InvalidArgumentException(
+ 'You must set key right after "*". Invalid index: "' . $index . '"'
+ );
+ }
+
+ $indexes = self::convertToArray($index);
+
+ // If indexes is empty, returns false.
+ if ($indexes === []) {
+ return false;
+ }
+
+ $currentArray = $array;
+
+ // Grab the current index
+ while ($currentIndex = array_shift($indexes)) {
+ if ($currentIndex === '*') {
+ $currentIndex = array_shift($indexes);
+
+ foreach ($currentArray as $item) {
+ if (! array_key_exists($currentIndex, $item)) {
+ return false;
+ }
+ }
+
+ // If indexes is empty, all elements are checked.
+ if ($indexes === []) {
+ return true;
+ }
+
+ $currentArray = self::dotSearch('*.' . $currentIndex, $currentArray);
+
+ continue;
+ }
+
+ if (! array_key_exists($currentIndex, $currentArray)) {
+ return false;
+ }
+
+ $currentArray = $currentArray[$currentIndex];
+ }
+
+ return true;
+ }
+
  /**
  * Groups all rows by their index values. Result's depth equals number of indexes
  *

tests/system/Helpers/Array/ArrayHelperDotKeyExistsTest.php

@@ -0,0 +1,72 @@
+<?php
+
+/**
+ * This file is part of CodeIgniter 4 framework.
+ *
+ * (c) CodeIgniter Foundation <admin@codeigniter.com>
+ *
+ * For the full copyright and license information, please view
+ * the LICENSE file that was distributed with this source code.
+ */
+
+namespace CodeIgniter\Helpers\Array;
+
+use CodeIgniter\Test\CIUnitTestCase;
+use InvalidArgumentException;
+
+/**
+ * @group Others
+ *
+ * @internal
+ */
+final class ArrayHelperDotKeyExistsTest extends CIUnitTestCase
+{
+ private array $array = [
+ 'contacts' => [
+ 'friends' => [
+ ['name' => 'Fred Flinstone', 'age' => 20],
+ ['age' => 21], // 'name' key does not exist
+ ],
+ ],
+ ];
+
+ public function testDotKeyExists(): void
+ {
+ $this->assertFalse(ArrayHelper::dotKeyExists('', $this->array));
+ $this->assertTrue(ArrayHelper::dotKeyExists('contacts', $this->array));
+ $this->assertFalse(ArrayHelper::dotKeyExists('not', $this->array));
+ $this->assertTrue(ArrayHelper::dotKeyExists('contacts.friends', $this->array));
+ $this->assertFalse(ArrayHelper::dotKeyExists('not.friends', $this->array));
+ $this->assertTrue(ArrayHelper::dotKeyExists('contacts.friends.0.name', $this->array));
+ $this->assertFalse(ArrayHelper::dotKeyExists('contacts.friends.1.name', $this->array));
+ }
+
+ public function testDotKeyExistsWithEndingWildCard(): void
+ {
+ $this->expectException(InvalidArgumentException::class);
+ $this->expectExceptionMessage('You must set key right after "*". Invalid index: "contacts.*"');
+
+ $this->assertTrue(ArrayHelper::dotKeyExists('contacts.*', $this->array));
+ }
+
+ public function testDotKeyExistsWithDoubleWildCard(): void
+ {
+ $this->expectException(InvalidArgumentException::class);
+ $this->expectExceptionMessage('You must set key right after "*". Invalid index: "contacts.*.*.age"');
+
+ $this->assertTrue(ArrayHelper::dotKeyExists('contacts.*.*.age', $this->array));
+ }
+
+ public function testDotKeyExistsWithWildCard(): void
+ {
+ $this->assertTrue(ArrayHelper::dotKeyExists('*.friends', $this->array));
+ $this->assertTrue(ArrayHelper::dotKeyExists('contacts.friends.*.age', $this->array));
+ $this->assertFalse(ArrayHelper::dotKeyExists('contacts.friends.*.name', $this->array));
+ $this->assertTrue(ArrayHelper::dotKeyExists('*.friends.*.age', $this->array));
+ $this->assertFalse(ArrayHelper::dotKeyExists('*.friends.*.name', $this->array));
+ $this->assertTrue(ArrayHelper::dotKeyExists('contacts.*.0.age', $this->array));
+ $this->assertTrue(ArrayHelper::dotKeyExists('contacts.*.1.age', $this->array));
+ $this->assertTrue(ArrayHelper::dotKeyExists('contacts.*.0.name', $this->array));
+ $this->assertFalse(ArrayHelper::dotKeyExists('contacts.*.1.name', $this->array));
+ }
+}