summaryrefslogtreecommitdiffstats
path: root/wp-includes/compat.php
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-09-19 04:51:18 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-09-19 04:51:18 +0000
commit0e41b5d52fdc6af6442816b5f465c9db9f84e126 (patch)
treee139a90049b158d4eed892d1662ee7f5c358fa31 /wp-includes/compat.php
parentAdding upstream version 6.5.5+dfsg1. (diff)
downloadwordpress-0e41b5d52fdc6af6442816b5f465c9db9f84e126.tar.xz
wordpress-0e41b5d52fdc6af6442816b5f465c9db9f84e126.zip
Adding upstream version 6.6.1+dfsg1.upstream/6.6.1+dfsg1upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'wp-includes/compat.php')
-rw-r--r--wp-includes/compat.php68
1 files changed, 39 insertions, 29 deletions
diff --git a/wp-includes/compat.php b/wp-includes/compat.php
index 95c4af4..900a799 100644
--- a/wp-includes/compat.php
+++ b/wp-includes/compat.php
@@ -40,6 +40,43 @@ function _wp_can_use_pcre_u( $set = null ) {
return $utf8_pcre;
}
+/**
+ * Indicates if a given slug for a character set represents the UTF-8 text encoding.
+ *
+ * A charset is considered to represent UTF-8 if it is a case-insensitive match
+ * of "UTF-8" with or without the hyphen.
+ *
+ * Example:
+ *
+ * true === _is_utf8_charset( 'UTF-8' );
+ * true === _is_utf8_charset( 'utf8' );
+ * false === _is_utf8_charset( 'latin1' );
+ * false === _is_utf8_charset( 'UTF 8' );
+ *
+ * // Only strings match.
+ * false === _is_utf8_charset( [ 'charset' => 'utf-8' ] );
+ *
+ * `is_utf8_charset` should be used outside of this file.
+ *
+ * @ignore
+ * @since 6.6.1
+ *
+ * @param string $charset_slug Slug representing a text character encoding, or "charset".
+ * E.g. "UTF-8", "Windows-1252", "ISO-8859-1", "SJIS".
+ *
+ * @return bool Whether the slug represents the UTF-8 encoding.
+ */
+function _is_utf8_charset( $charset_slug ) {
+ if ( ! is_string( $charset_slug ) ) {
+ return false;
+ }
+
+ return (
+ 0 === strcasecmp( 'UTF-8', $charset_slug ) ||
+ 0 === strcasecmp( 'UTF8', $charset_slug )
+ );
+}
+
if ( ! function_exists( 'mb_substr' ) ) :
/**
* Compat function to mimic mb_substr().
@@ -91,7 +128,7 @@ function _mb_substr( $str, $start, $length = null, $encoding = null ) {
* The solution below works only for UTF-8, so in case of a different
* charset just use built-in substr().
*/
- if ( ! in_array( $encoding, array( 'utf8', 'utf-8', 'UTF8', 'UTF-8' ), true ) ) {
+ if ( ! _is_utf8_charset( $encoding ) ) {
return is_null( $length ) ? substr( $str, $start ) : substr( $str, $start, $length );
}
@@ -176,7 +213,7 @@ function _mb_strlen( $str, $encoding = null ) {
* The solution below works only for UTF-8, so in case of a different charset
* just use built-in strlen().
*/
- if ( ! in_array( $encoding, array( 'utf8', 'utf-8', 'UTF8', 'UTF-8' ), true ) ) {
+ if ( ! _is_utf8_charset( $encoding ) ) {
return strlen( $str );
}
@@ -359,23 +396,6 @@ if ( ! function_exists( 'is_countable' ) ) {
}
}
-if ( ! function_exists( 'is_iterable' ) ) {
- /**
- * Polyfill for is_iterable() function added in PHP 7.1.
- *
- * Verify that the content of a variable is an array or an object
- * implementing the Traversable interface.
- *
- * @since 4.9.6
- *
- * @param mixed $value The value to check.
- * @return bool True if `$value` is iterable, false otherwise.
- */
- function is_iterable( $value ) {
- return ( is_array( $value ) || $value instanceof Traversable );
- }
-}
-
if ( ! function_exists( 'array_key_first' ) ) {
/**
* Polyfill for array_key_first() function added in PHP 7.3.
@@ -520,16 +540,6 @@ if ( ! function_exists( 'str_ends_with' ) ) {
}
}
-// IMAGETYPE_WEBP constant is only defined in PHP 7.1 or later.
-if ( ! defined( 'IMAGETYPE_WEBP' ) ) {
- define( 'IMAGETYPE_WEBP', 18 );
-}
-
-// IMG_WEBP constant is only defined in PHP 7.0.10 or later.
-if ( ! defined( 'IMG_WEBP' ) ) {
- define( 'IMG_WEBP', IMAGETYPE_WEBP );
-}
-
// IMAGETYPE_AVIF constant is only defined in PHP 8.x or later.
if ( ! defined( 'IMAGETYPE_AVIF' ) ) {
define( 'IMAGETYPE_AVIF', 19 );