Ticket #53858: 53858-3.patch

src/wp-includes/general-template.php

@@ -4814 +4814 @@
  * Compares the first two arguments and if identical marks as readonly
  *
  * @since 4.9.0
+ * @since 5.9.0 This function was renamed from `readonly`.
  *
  * @param mixed $readonly One of the values to compare
  * @param mixed $current  (true) The other value to compare if not just true
  * @param bool  $echo     Whether to echo or just return the string
  * @return string HTML attribute or empty string
  */
-function readonly( $readonly, $current = true, $echo = true ) {
+function wp_readonly( $readonly, $current = true, $echo = true ) {
         return __checked_selected_helper( $readonly, $current, $echo, 'readonly' );
 }
 
+/**
+ * Include a compat `readonly` function on PHP < 8.1. Since PHP 8.1,
+ * `readonly` is a reserved keyword, and it is not possible to use
+ * it as a function name. In order to maintain compatibility with
+ * existing functions, this function was extracted to a separate file,
+ * and included on PHP < 8.1.
+ */
+if (PHP_VERSION_ID < 80100) {
+        require_once __DIR__ . '/php-compat/readonly.php';
+}
+
 /**
  * Private helper function for checked, selected, disabled and readonly.
  *

new file src/wp-includes/php-compat/readonly.php

@@ +1 @@
+<?php
+
+/**
+ * Conditionally declares a `readonly` function, which was renamed to
+ * `wp_readonly` in WordPress 5.9.0.
+ *
+ * In order to avoid PHP parser errors, this function was extracted to
+ * this separate file, and only included conditionally on PHP 8.1.
+ *
+ * Including this file on PHP >= 8.1 results in a fatal error.
+ *
+ * @package WordPress
+ */
+
+/**
+ * Outputs the HTML readonly attribute.
+ *
+ * Compares the first two arguments and if identical marks as readonly
+ *
+ * This function is deprecated, and cannot be used on PHP >= 8.1.
+ * @see wp_readonly
+ *
+ * @since 4.9.0
+ * @deprecated 5.9.0 Use `wp_readonly` introduced in 5.9.0.
+ *
+ * @param mixed $readonly One of the values to compare
+ * @param mixed $current  (true) The other value to compare if not just true
+ * @param bool  $echo     Whether to echo or just return the string
+ * @return string HTML attribute or empty string
+ */
+function readonly( $readonly, $current = true, $echo = true ) {
+        _deprecated_function( __FUNCTION__, '5.9.0' );
+        return wp_readonly( $readonly, $current, $echo );
+}