Установка обработчика выхода за пределы пространства имён

# xml_set_end_namespace_decl_handler

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

xml_set_end_namespace_decl_handler — Установка обработчика выхода за пределы пространства имён

### Описание

function xml_set_end_namespace_decl_handler(XMLParser `$parser`, callable|string|null `$handler`): true

Задаёт обработчик, который вызывается при выходе за пределы объявления пространства имён. Этот обработчик будет вызываться для каждого объявления пространства имён после того как отработает обработчик окончания элемента, в котором это пространство имён было объявлено.

Предостережение

Это событие не поддерживается LibXML, поэтому зарегистрированный обработчик не будет называться.

### Список параметров

`parser`
  XML-парсер.
`handler`

  При передаче значения `null` обработчик возвращается в состояние по умолчанию.

  Внимание

  Пустая строка тоже сбросит обработчик, однако начиная с PHP 8.4.0 передача в параметр пустой строки устарела.

  Функция установит как обработчик функцию, на которую указывает callable-выражение, если в параметр `handler` передали значение, которое вызывается как функция.

  Параметр `handler` принимает строку (string) с названием метода объекта, который установили функцией xml_set_object().

  Внимание

  Начиная с PHP 8.4.0 передача в параметр строки с названием метода устарела.

  Внимание

  Начиная с PHP 8.4.0 корректность callable-выражения проверяется при установке, а не при вызове обработчика. Поэтому вызвать функцию xml_set_object() потребуется до установки строки с названием метода, который вызывается как callback-функция. Однако, поскольку такое поведение тоже устарело с PHP 8.4.0, вместо передачи строки с названием метода рекомендуют указывать метод в правильном callable-выражении.

  Сигнатура обработчика должна быть:

  function handler(XMLParser `$parser`, string|false `$prefix`)
  `parser`
    XML-парсер, которым вызывается обработчик.
  `prefix`
    Префикс - строка, используемая как ссылка на пространство имён в пределах XML объекта. `false`, если префикс не существует.

### Возвращаемые значения

Функция возвращает логическое значение `true`.

### Список изменений

Версия | Описание
--- | ---
8.4.0 | Передача в параметр `handler` строки (string), которую невозможно вызывать как callable-выражение, устарела; теперь рекомендуют передавать в параметр правильное callable-выражение для установки метода или `null` для сброса обработчика.
8.4.0 | Корректность обработчика `handler` как callable-выражения теперь проверяется при установке обработчика, а не при вызове.
8.0.0 | Параметр `parser` ожидает экземпляр класса XMLParser; раньше параметр ждал корректный `xml`-ресурс (resource).

### Смотрите также

- xml_set_start_namespace_decl_handler() - Устанавливает обработчик входа в пределы пространства имён

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open