Update function names to array_path_get and array_path_exists

carlos-granados · carlos-granados · commit b3f706569570 · 2026-04-18T07:42:17.000+02:00
diff --git a/ext/standard/array.c b/ext/standard/array.c
@@ -6967,7 +6967,7 @@ static zval* array_get_nested(HashTable *ht, HashTable *path)
 /* }}} */
 
 /* {{{ Retrieves a value from a deeply nested array using an array path */
-PHP_FUNCTION(array_get_path)
+PHP_FUNCTION(array_path_get)
 {
 	zval *array;
 	zval *path;
@@ -6998,7 +6998,7 @@ PHP_FUNCTION(array_get_path)
 /* }}} */
 
 /* {{{ Checks whether a given item exists in an array using an array path */
-PHP_FUNCTION(array_has_path)
+PHP_FUNCTION(array_path_exists)
 {
 	zval *array;
 	zval *path;
diff --git a/ext/standard/basic_functions.stub.php b/ext/standard/basic_functions.stub.php
@@ -1906,12 +1906,12 @@ function key_exists($key, array $array): bool {}
 /**
  * @compile-time-eval
  */
-function array_get_path(array $array, array $path, mixed $default = null): mixed {}
+function array_path_get(array $array, array $path, mixed $default = null): mixed {}
 
 /**
  * @compile-time-eval
  */
-function array_has_path(array $array, array $path): bool {}
+function array_path_exists(array $array, array $path): bool {}
 
 /**
  * @compile-time-eval
diff --git a/ext/standard/basic_functions_arginfo.h b/ext/standard/basic_functions_arginfo.h
diff --git a/ext/standard/basic_functions_decl.h b/ext/standard/basic_functions_decl.h
diff --git a/ext/standard/tests/array/array_path_exists.phpt b/ext/standard/tests/array/array_path_exists.phpt
@@ -1,58 +1,58 @@
 --TEST--
-Test array_has_path() function
+Test array_path_exists() function
 --FILE--
 <?php
-echo "*** Testing array_has_path() ***\n";
+echo "*** Testing array_path_exists() ***\n";
 
 // Basic array
 $array = ['product' => ['name' => 'Desk', 'price' => 100]];
 
 // Test nested key exists with array path
-var_dump(array_has_path($array, ['product', 'name']));
+var_dump(array_path_exists($array, ['product', 'name']));
 
 // Test nested key doesn't exist
-var_dump(array_has_path($array, ['product', 'color']));
+var_dump(array_path_exists($array, ['product', 'color']));
 
 // Test intermediate key doesn't exist
-var_dump(array_has_path($array, ['category', 'name']));
+var_dump(array_path_exists($array, ['category', 'name']));
 
 // Test simple path with single level
 $simple = ['name' => 'John', 'age' => 30];
-var_dump(array_has_path($simple, ['name']));
-var_dump(array_has_path($simple, ['missing']));
+var_dump(array_path_exists($simple, ['name']));
+var_dump(array_path_exists($simple, ['missing']));
 
 // Test with integer key in path
 $users = ['users' => [['name' => 'Alice'], ['name' => 'Bob']]];
-var_dump(array_has_path($users, ['users', 0, 'name']));
-var_dump(array_has_path($users, ['users', 1, 'name']));
-var_dump(array_has_path($users, ['users', 2, 'name']));
+var_dump(array_path_exists($users, ['users', 0, 'name']));
+var_dump(array_path_exists($users, ['users', 1, 'name']));
+var_dump(array_path_exists($users, ['users', 2, 'name']));
 
 // Test with value that is null (key exists, but value is null)
 $withNull = ['key' => null];
-var_dump(array_has_path($withNull, ['key']));
+var_dump(array_path_exists($withNull, ['key']));
 
 // Test with invalid segment type in array path
 try {
-	var_dump(array_has_path($array, ['product', new stdClass()]));
+	var_dump(array_path_exists($array, ['product', new stdClass()]));
 } catch (TypeError $e) {
 	echo $e->getMessage() . "\n";
 }
 
 // Test with reference to an array in the path
 $array2 = ['world'];
 $array_with_ref = ['hello' => &$array2];
-var_dump(array_has_path($array_with_ref, ['hello', 0]));
+var_dump(array_path_exists($array_with_ref, ['hello', 0]));
 
 // Test with path segment that is a reference
 $key1 = 'product';
 $key2 = 'name';
 $path_with_refs = [&$key1, &$key2];
-var_dump(array_has_path($array, $path_with_refs));
+var_dump(array_path_exists($array, $path_with_refs));
 
 echo "Done";
 ?>
 --EXPECT--
-*** Testing array_has_path() ***
+*** Testing array_path_exists() ***
 bool(true)
 bool(false)
 bool(false)
diff --git a/ext/standard/tests/array/array_path_get.phpt b/ext/standard/tests/array/array_path_get.phpt
@@ -1,72 +1,72 @@
 --TEST--
-Test array_get_path() function
+Test array_path_get() function
 --FILE--
 <?php
-echo "*** Testing array_get_path() ***\n";
+echo "*** Testing array_path_get() ***\n";
 
 // Basic nested array access
 $array = ['products' => ['desk' => ['price' => 100]]];
 
 // Test nested access with array path
-var_dump(array_get_path($array, ['products', 'desk', 'price']));
+var_dump(array_path_get($array, ['products', 'desk', 'price']));
 
 // Test with default value when path doesn't exist
-var_dump(array_get_path($array, ['products', 'desk', 'discount'], 5));
+var_dump(array_path_get($array, ['products', 'desk', 'discount'], 5));
 
 // Test simple path with single level
 $simple = ['name' => 'John', 'age' => 30];
-var_dump(array_get_path($simple, ['name']));
-var_dump(array_get_path($simple, ['missing'], 'default'));
+var_dump(array_path_get($simple, ['name']));
+var_dump(array_path_get($simple, ['missing'], 'default'));
 
 // Test single level key that doesn't exist
-var_dump(array_get_path($array, ['missing']));
+var_dump(array_path_get($array, ['missing']));
 
 // Test with integer key in path
 $users = ['users' => [['name' => 'Alice'], ['name' => 'Bob']]];
-var_dump(array_get_path($users, ['users', 0, 'name']));
-var_dump(array_get_path($users, ['users', 1, 'name']));
+var_dump(array_path_get($users, ['users', 0, 'name']));
+var_dump(array_path_get($users, ['users', 1, 'name']));
 
 // Test nested with missing intermediate key
-var_dump(array_get_path($array, ['products', 'chair', 'price'], 75));
+var_dump(array_path_get($array, ['products', 'chair', 'price'], 75));
 
 // Test with invalid segment type in array path
 try {
-	var_dump(array_get_path($array, ['products', new stdClass(), 'price'], 'invalid'));
+	var_dump(array_path_get($array, ['products', new stdClass(), 'price'], 'invalid'));
 } catch (TypeError $e) {
 	echo $e->getMessage() . "\n";
 }
 
 // Test with references - ensure returned value is a copy, not a reference
 $ref_array = ['data' => ['value' => 'original']];
 $ref =& $ref_array['data']['value'];
-$result = array_get_path($ref_array, ['data', 'value']);
+$result = array_path_get($ref_array, ['data', 'value']);
 var_dump($result);
 $ref = 'modified';
 var_dump($result); // Should still be 'original' (not affected by reference change)
 
 // Test with default value being a reference
 $default_value = 'default';
 $default_ref =& $default_value;
-$result_with_ref_default = array_get_path($ref_array, ['missing', 'key'], $default_ref);
+$result_with_ref_default = array_path_get($ref_array, ['missing', 'key'], $default_ref);
 var_dump($result_with_ref_default);
 $default_value = 'changed';
 var_dump($result_with_ref_default); // Should still be 'default' (not affected by reference change)
 
 // Test with reference to an array in the path
 $array2 = ['world'];
 $array_with_ref = ['hello' => &$array2];
-var_dump(array_get_path($array_with_ref, ['hello', 0]));
+var_dump(array_path_get($array_with_ref, ['hello', 0]));
 
 // Test with path segment that is a reference
 $key1 = 'products';
 $key2 = 'desk';
 $path_with_refs = [&$key1, &$key2, 'price'];
-var_dump(array_get_path($array, $path_with_refs));
+var_dump(array_path_get($array, $path_with_refs));
 
 echo "Done";
 ?>
 --EXPECT--
-*** Testing array_get_path() ***
+*** Testing array_path_get() ***
 int(100)
 int(5)
 string(4) "John"
