xml_set_start_namespace_decl_handler

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

    xml_set_start_namespace_decl_handler — Set up start namespace declaration handler

    Опис

    xml_set_start_namespace_decl_handler(XMLParser $parser, callable|string|null $handler): true

    Set a handler to be called when a namespace is declared. Namespace declarations occur inside start tags. But the namespace declaration start handler is called before the start tag handler for each namespace declared in that start tag.

    Параметри

    parser

    XML-парсер.

    handler

    Якщо задано null, обробник буде скинуто до його початкового стану.

    Увага

    Якщо задано порожній рядок, обробник також буде скинуто, проте така дія застаріла, починаючи з PHP 8.4.0.

    Якщо параметр handler має тип callable, то обробником стане функція/метод, що має таку назву виклику.

    Параметр handler може мати тип string, якщо це назва метода об'єкта, встановленого функцією xml_set_object().

    Увага

    Це є застарілим, починаючи з PHP 8.4.0.

    Увага

    Починаючи з PHP 8.4.0, назва виклику перевіряється на правильність під час встановлення обробника, а не під час його виклику. Це означає, що функцію xml_set_object() потрібно викликати перед встановленням назви метода, як зворотнього виклику. Однак, оскільки ця поведінка також є застарілою, починаючи з PHP 8.4.0, рекомендується використовувати правильну назву виклику (callable) методу.

    The signature of the handler must be:

    handler(XMLParser $parser, string|false $prefix, string $uri): void
    parser
    XML-парсер, що викликає обробника.
    prefix
    The prefix is a string used to reference the namespace within an XML object. false if no prefix exists.
    uri
    Uniform Resource Identifier (URI) of namespace.

    Значення, що повертаються

    Завжди повертає true.

    Журнал змін

    Версія Опис
    8.4.0 Використання не-callable рядків (string) як параметра handler тепер є застарілим. Необхідно задавати правильну назву виклику методів або null для скидання обробника.
    8.4.0 Правильність параметра handler, як назви виклику (callable) тепер перевіряється на правильність під час встановлення обробника, а не під час його виклику.
    8.0.0 Тепер параметр parser має бути примірником XMLParser. Раніше очікувався xml-resource.

    Прогляньте також

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes

    There are no user contributed notes for this page.
    To Top