summaryrefslogtreecommitdiffstats
path: root/wp-includes/php-compat/readonly.php
diff options
context:
space:
mode:
Diffstat (limited to 'wp-includes/php-compat/readonly.php')
-rw-r--r--wp-includes/php-compat/readonly.php37
1 files changed, 37 insertions, 0 deletions
diff --git a/wp-includes/php-compat/readonly.php b/wp-includes/php-compat/readonly.php
new file mode 100644
index 0000000..1c7fd9d
--- /dev/null
+++ b/wp-includes/php-compat/readonly.php
@@ -0,0 +1,37 @@
+<?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 is only included conditionally on PHP 8.1.
+ *
+ * Including this file on PHP >= 8.1 results in a fatal error.
+ *
+ * @package WordPress
+ * @since 5.9.0
+ */
+
+/**
+ * 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.
+ *
+ * @since 4.9.0
+ * @deprecated 5.9.0 Use wp_readonly() introduced in 5.9.0.
+ *
+ * @see wp_readonly()
+ *
+ * @param mixed $readonly_value One of the values to compare.
+ * @param mixed $current Optional. The other value to compare if not just true.
+ * Default true.
+ * @param bool $display Optional. Whether to echo or just return the string.
+ * Default true.
+ * @return string HTML attribute or empty string.
+ */
+function readonly( $readonly_value, $current = true, $display = true ) {
+ _deprecated_function( __FUNCTION__, '5.9.0', 'wp_readonly()' );
+ return wp_readonly( $readonly_value, $current, $display );
+}