[PHP 8.5] Add array_first and array_last

Ayesh · nicolas-grekas · Ayesh · commit d4e5fcd4ab3d · 2025-06-23T21:42:55.000+05:30
Adds polyfills for the PHP 8.5's `array_first` and `array_last` functions. The polyfills would have been a bit cleaner if we used the `array_key_first` and `array_key_last` functions, but they were added in PHP 7.3, and are not available on PHP 7.2. This adds the same tests from php-src patch. - [RFC: `array_first()` and `array_last()`](https://wiki.php.net/rfc/array_first_last) - [php-src commit](php/php-src@168343d) - [PHP.Watch polyfill for PHP 8.0+](https://php.watch/versions/8.5/array_first-array_last) Co-authored-by: Nicolas Grekas <nicolas.grekas@gmail.com>
diff --git a/Php85.php b/Php85.php
@@ -33,4 +33,18 @@ public static function get_exception_handler(): ?callable
 
         return $handler;
     }
+
+    public static function array_first(array $array)
+    {
+        foreach ($array as $value) {
+            return $value;
+        }
+
+        return null;
+    }
+
+    public static function array_last(array $array)
+    {
+        return $array ? current(array_slice($array, -1)) : null;
+    }
 }
diff --git a/README.md b/README.md
@@ -5,6 +5,7 @@ This component provides features added to PHP 8.5 core:
 
 - [`get_error_handler` and `get_exception_handler`](https://wiki.php.net/rfc/get-error-exception-handler)
 - [`NoDiscard`](https://wiki.php.net/rfc/marking_return_value_as_important)
+- [`array_first` and `array_last`](https://wiki.php.net/rfc/array_first_last)
 
 More information can be found in the
 [main Polyfill README](https://github.com/symfony/polyfill/blob/main/README.md).
diff --git a/bootstrap.php b/bootstrap.php
@@ -22,3 +22,11 @@ function get_error_handler(): ?callable { return p\Php85::get_error_handler(); }
 if (!function_exists('get_exception_handler')) {
     function get_exception_handler(): ?callable { return p\Php85::get_exception_handler(); }
 }
+
+if (!function_exists('array_first')) {
+    function array_first(array $array) { return p\Php85::array_first($array); }
+}
+
+if (!function_exists('array_last')) {
+    function array_last(array $array) { return p\Php85::array_last($array); }
+}
