[Summary view] [Print] [Text view]

   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  }