xml_set_start_namespace_decl_handler

(PHP 4 >= 4.0.5, PHP 5, PHP 7, PHP 8)

xml_set_start_namespace_decl_handler — 設定起始命名空間宣告處理器

xml_set_start_namespace_decl_handler(XMLParser $parser, 可呼叫|字串|null $handler): true

設定一個在宣告命名空間時會被呼叫的處理器。命名空間宣告發生在開始標籤內。但對於在該開始標籤中宣告的每個命名空間，命名空間宣告開始處理器會在開始標籤處理器之前被呼叫。

parser

XML 解析器。

handler

如果傳入 null，則處理器會被重置為其預設狀態。

警告

空字串也會重置處理器，但從 PHP 8.4.0 起已棄用。

如果 handler 是一個可呼叫的，則該可呼叫物件會被設定為處理器。

如果 handler 是一個字串，它可以是使用 xml_set_object() 設定的物件之方法名稱。

警告

從 PHP 8.4.0 起已棄用。

警告

從 PHP 8.4.0 開始，會在設定處理器時檢查可呼叫物件是否有效，而不是在呼叫它時檢查。這表示必須在將方法字串設定為回呼之前呼叫 xml_set_object()。然而，由於此行為也從 PHP 8.4.0 起被棄用，因此建議改用適當的可呼叫物件作為方法。

處理器的簽章必須是

handler(XMLParser $parser, 字串|false $prefix, 字串 $uri): void

永遠返回 true。

版本	說明
8.4.0	將非可呼叫的字串傳遞給 `handler` 現已棄用，請使用方法的正確可呼叫物件，或使用 `null` 重置處理器。
8.4.0	`handler` 作為可呼叫物件的有效性現在會在設定處理器時檢查，而不是在呼叫它時檢查。
8.0.0	`parser` 現在需要一個 XMLParser 實例；先前需要一個有效的 `xml` 資源。

此頁面沒有使用者提供的註解。