xml_set_default_handler

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

    xml_set_default_handler — Set up default handler

    Опис

    xml_set_default_handler(XMLParser $parser, callable $handler): true

    Sets the default handler function for the XML parser parser.

    Параметри

    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 $data): void
    parser
    XML-парсер, що викликає обробника.
    data
    data contains the character data. This may be the XML declaration, document type declaration, entities or other data for which no other handler exists.

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

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

    Журнал змін

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

    Improve This Page

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

    User Contributed Notes 3 notes

    up
    0
    jp dot amarok at email dot cz
    6 months ago
    For anyone who was also wondering what kind of events this function actually handles:

    it's used in cases when an XML comment is found or an additional declaration like an xml-stylesheet. In such cases the data argument contains the whole string as it is, for example:

    <!-- this is a comment -->
    <?xml-stylesheet title="mystyle" type="text/xsl" href="style.xsl" ?>
    up
    -2
    phillip
    19 years ago
    it seems to me that in PHP5 the function defined as default-handler (using xml_set_default_handler()) doesen't get passed the cdata anymore:

    i.e.:
    xml_set_element_handler($this->parser, 'parseSTART', 'parseEND');
    xml_set_default_handler($this->parser, 'parseDEFAULT');
    function parseSTART() { ... }
    function parseEND() { ... }
    function parseDEFAULT() { ... }

    under PHP5, parseDEFAULT will NOT get passed any cdata, but unter PHP4 it will. at least that's my take on the strange stuff (not) happening after migrating to PHP5.

    my solution was to add a xml_set_character_data_handler($parser, 'parseDEFAULT'). it worked for me.
    up
    -3
    anoril at anoril dot com
    18 years ago
    I have the same issue using two installation of PHP5: on accepts to use the default handler while the other only uses the character_data one.

    Maybe a configuration problem...

    ;) Nonor.
    ＋add a note
    To Top