Changeset 60672

Timestamp:

08/26/2025 09:29:47 PM (2 months ago)

Author:

jorbin

Message:

General: Add polyfills for new PHP 8.5 array functions: array_first and array_last.

This power couple of function is coming in PHP 8.5: array_first and array_last.

For more information on these functions, check out the PHP RFC at ​https://wiki.php.net/rfc/array_first_last.

Props tusharbharti, jorbin, peterwilsoncc, mukesh27, johnbillion.
Fixes #63853. See #63061.

Location:

trunk

Files:

• src/wp-includes/compat.php (modified) (1 diff)
• tests/phpunit/tests/compat/arrayFirst.php (added)
• tests/phpunit/tests/compat/arrayLast.php (added)

trunk/src/wp-includes/compat.php

@@ -540 +540 @@
 }
 
+if ( ! function_exists( 'array_first' ) ) {
+    /**
+     * Polyfill for `array_first()` function added in PHP 8.5.
+     *
+     * Returns the first element of an array.
+     *
+     * @since 6.9.0
+     *
+     * @param array $array The array to get the first element from.
+     * @return mixed|null The first element of the array, or null if the array is empty.
+     */
+    function array_first( array $array ) { // phpcs:ignore Universal.NamingConventions.NoReservedKeywordParameterNames.arrayFound
+        if ( empty( $array ) ) {
+            return null;
+        }
+
+        foreach ( $array as $value ) {
+            return $value;
+        }
+    }
+}
+
+if ( ! function_exists( 'array_last' ) ) {
+    /**
+     * Polyfill for `array_last()` function added in PHP 8.5.
+     *
+     * Returns the last element of an array.
+     *
+     * @since 6.9.0
+     *
+     * @param array $array The array to get the last element from.
+     * @return mixed|null The last element of the array, or null if the array is empty.
+     */
+    function array_last( array $array ) { // phpcs:ignore Universal.NamingConventions.NoReservedKeywordParameterNames.arrayFound
+        if ( empty( $array ) ) {
+            return null;
+        }
+
+        return $array[ array_key_last( $array ) ];
+    }
+}
+
 // IMAGETYPE_AVIF constant is only defined in PHP 8.x or later.
 if ( ! defined( 'IMAGETYPE_AVIF' ) ) {