Changeset 57337 for trunk/src/wp-includes/compat.php

Timestamp:

01/23/2024 01:32:34 PM (17 months ago)

Author:

swissspidy

Message:

I18N: Introduce a more performant localization library.

This introduces a more lightweight library for loading .mo translation files which offers increased speed and lower memory usage.
It also supports loading multiple locales at the same time, which makes locale switching faster too.

For plugins interacting with the $l10n global variable in core, a shim is added to retain backward compatibility with the existing pomo library.

In addition to that, this library supports translations contained in PHP files, avoiding a binary file format and leveraging OPCache if available.
If an .mo translation file has a corresponding .l10n.php file, the latter will be loaded instead.
This behavior can be adjusted using the new translation_file_format and load_translation_file filters.

PHP translation files will be typically created by downloading language packs, but can also be generated by plugins.
See ​https://make.wordpress.org/core/2023/11/08/merging-performant-translations-into-core/ for more context.

Props dd32, swissspidy, flixos90, joemcgill, westonruter, akirk, SergeyBiryukov.
Fixes #59656.

File:

• trunk/src/wp-includes/compat.php (modified) (1 diff)

trunk/src/wp-includes/compat.php

@@ -421 +421 @@
 }
 
+if ( ! function_exists( 'array_is_list' ) ) {
+    /**
+     * Polyfill for `array_is_list()` function added in PHP 8.1.
+     *
+     * Determines if the given array is a list.
+     *
+     * An array is considered a list if its keys consist of consecutive numbers from 0 to count($array)-1.
+     *
+     * @see https://github.com/symfony/polyfill-php81/tree/main
+     *
+     * @since 6.5.0
+     *
+     * @param array<mixed> $arr The array being evaluated.
+     * @return bool True if array is a list, false otherwise.
+     */
+    function array_is_list( $arr ) {
+        if ( ( array() === $arr ) || ( array_values( $arr ) === $arr ) ) {
+            return true;
+        }
+
+        $next_key = -1;
+
+        foreach ( $arr as $k => $v ) {
+            if ( ++$next_key !== $k ) {
+                return false;
+            }
+        }
+
+        return true;
+    }
+}
+
 if ( ! function_exists( 'str_contains' ) ) {
     /**