(PHP 8 >= 8.4.0)
此屬性用於標記已棄用的功能。使用已棄用的功能將會發出 E_USER_DEPRECATED
錯誤。
一個可選的訊息,說明棄用原因和可能的替代功能。將包含在發出的棄用訊息中。
一個可選的字串,指示功能自何時起被棄用。內容不會被 PHP 驗證,可以包含版本號、日期或任何其他被認為合適的值。將包含在發出的棄用訊息中。
PHP 內建的功能將使用 主版本號.次版本號 作為 since 值,例如 '8.4'
。
<?php
#[\Deprecated(message: "請改用 safe_replacement()", since: "1.5")]
function unsafe_function()
{
echo "這是不安全的", PHP_EOL;
}
unsafe_function();
?>
以上範例在 PHP 8.4 中的輸出類似於
Deprecated: Function unsafe_function() is deprecated since 1.5, use safe_replacement() instead in example.php on line 9 This is unsafe