2024 年日本 PHP 研討會

已棄用屬性

(PHP 8 >= 8.4.0)

簡介

此屬性用於標記已棄用的功能。使用已棄用的功能將會發出 E_USER_DEPRECATED 錯誤。

類別概要

final class Deprecated {
/* 屬性 */
public readonly ?string $message;
public readonly ?string $since;
/* 方法 */
公開 __construct(?字串 $message = null, ?字串 $since = null)
}

屬性

message

一個可選的訊息,說明棄用原因和可能的替代功能。將包含在發出的棄用訊息中。

since

一個可選的字串,指示功能自何時起被棄用。內容不會被 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

目錄

新增註記

使用者貢獻的註記

此頁面沒有使用者貢獻的註記。
To Top