« xml_parser_create_ns
xml_parser_get_option »

xml_parser_free

(PHP 4, PHP 5, PHP 7, PHP 8)

xml_parser_free — XML パーサーを解放する

警告

この関数は PHP 8.5.0 で 非推奨になります。この関数に頼らないことを強く推奨します。

説明

#[\Deprecated(
    since: '8.5',
    message: "as it has no effect since PHP 8.0",
)]

function xml_parser_free(XMLParser $parser): bool

注意:

この関数を実行しても何も起こりません。PHP 8.0.0 より前のバージョンでは、この関数はリソースを閉じるのに使われていました。

指定した XML パーサー parser を解放します。

警告

パースが終了した際、 xml_parser_free() 関数を呼び出すのに加えて、 PHP 8.0.0 より前のバージョンでは オブジェクトがパーサーのリソースを参照している場合に、 メモリリークを避けるために parser の参照を 明示的に unset することも必要になっています。

パラメータ

parser

解放したい XML パーサーへのリファレンス。

戻り値

成功した場合に true を、失敗した場合に false を返します。

変更履歴

バージョン 説明
8.5.0 この関数は、推奨されなくなりました。
8.0.0 引数 parser は、 XMLParser インスタンスを期待するようになりました。 これより前のバージョンでは、有効な xml resource が期待されていました。
関連キーワード:
parser   パーサー   解放   free   推奨   since   XMLParser   リソース   期待   create   option   非推奨   Deprecated   message   effect   パース   メモリ   リーク   明示   unset   リファレンス   成功   履歴   インスタンス   resource
関連する関数・ページ:
function.xml-parser-get-option   function.xml-parser-set-option   function.xml-parser-create   function.xml-set-object   function.xml-parser-create-ns   function.xml-parse