wp/wp-includes/php-compat/readonly.php
changeset 19 3d72ae0968f4
child 21 48c4eec2b7e6
equal deleted inserted replaced
18:be944660c56a 19:3d72ae0968f4
       
     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 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  $echo     Optional. Whether to echo or just return the string.
       
    31  *                        Default true.
       
    32  * @return string HTML attribute or empty string.
       
    33  */
       
    34 function readonly( $readonly, $current = true, $echo = true ) {
       
    35 	_deprecated_function( __FUNCTION__, '5.9.0', 'wp_readonly()' );
       
    36 	return wp_readonly( $readonly, $current, $echo );
       
    37 }