readonly.php 1.2 KB

12345678910111213141516171819202122232425262728293031323334353637
  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. * Outputs the HTML readonly attribute.
  16. *
  17. * Compares the first two arguments and if identical marks as readonly.
  18. *
  19. * This function is deprecated, and cannot be used on PHP >= 8.1.
  20. *
  21. * @since 4.9.0
  22. * @deprecated 5.9.0 Use wp_readonly() introduced in 5.9.0.
  23. *
  24. * @see wp_readonly()
  25. *
  26. * @param mixed $readonly One of the values to compare.
  27. * @param mixed $current Optional. The other value to compare if not just true.
  28. * Default true.
  29. * @param bool $echo Optional. Whether to echo or just return the string.
  30. * Default true.
  31. * @return string HTML attribute or empty string.
  32. */
  33. function readonly( $readonly, $current = true, $echo = true ) {
  34. _deprecated_function( __FUNCTION__, '5.9.0', 'wp_readonly()' );
  35. return wp_readonly( $readonly, $current, $echo );
  36. }