Changeset 52039

Timestamp:

11/08/2021 02:02:54 PM (5 years ago)

Author:

hellofromTonya

Message:

General: Introduce polyfill for str_contains() added in PHP 8.0.

PHP 8.0 introduced a new function: str_contains(). It performs a case-sensitive check indicating if given substring (needle) is contained in the string to search in (haystack).

This polyfill makes this function available for use in Core.

Ref:

• PHP RFC ​https://wiki.php.net/rfc/str_contains
• PHP manual ​https://www.php.net/manual/en/function.str-contains.php

Props ayeshrajans, costdev, desrosj, hellofromTonya, knutsp, pbearne.
Fixes #49652.

Location:

trunk

Files:

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

trunk/src/wp-includes/compat.php

@@ -418 +418 @@
 }
 
+if ( ! function_exists( 'str_contains' ) ) {
+        /**
+         * Polyfill for `str_contains()` function added in PHP 8.0.
+         *
+         * Performs a case-sensitive check indicating if needle is
+         * contained in haystack.
+         *
+         * @since 5.9.0
+         *
+         * @param string $haystack The string to search in.
+         * @param string $needle   The substring to search for in the haystack.
+         * @return bool True if `$needle` is in `$haystack`, otherwise false.
+         */
+        function str_contains( $haystack, $needle ) {
+                return ( '' === $needle || false !== strpos( $haystack, $needle ) );
+        }
+}
+
 // IMAGETYPE_WEBP constant is only defined in PHP 7.1 or later.
 if ( ! defined( 'IMAGETYPE_WEBP' ) ) {