1<?php
2/**
3 * Conditionally declares a `readonly()` function, which was renamed
4 * to `wp_readonly()` in WordPress 5.9.0.
5 *
6 * In order to avoid PHP parser errors, this function was extracted
7 * to this separate file and is only included conditionally on PHP < 8.1.
8 *
9 * Including this file on PHP >= 8.1 results in a fatal error.
10 *
11 * @package WordPress
12 * @since 5.9.0
13 */
14
15/**
16 * Outputs the HTML readonly attribute.
17 *
18 * Compares the first two arguments and if identical marks as readonly.
19 *
20 * This function is deprecated, and cannot be used on PHP >= 8.1.
21 *
22 * @since 4.9.0
23 * @deprecated 5.9.0 Use wp_readonly() introduced in 5.9.0.
24 *
25 * @see wp_readonly()
26 *
27 * @param mixed $readonly_value One of the values to compare.
28 * @param mixed $current Optional. The other value to compare if not just true.
29 * Default true.
30 * @param bool $display Optional. Whether to echo or just return the string.
31 * Default true.
32 * @return string HTML attribute or empty string.
33 */
34function readonly( $readonly_value, $current = true, $display = true ) {
35 _deprecated_function( __FUNCTION__, '5.9.0', 'wp_readonly()' );
36 return wp_readonly( $readonly_value, $current, $display );
37}
38