xml_set_processing_instruction_handler

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

xml_set_processing_instruction_handler — Configura manipulador de instruções de processamento (PI)

Descrição

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

Define a função do manipulador de instruções de processamento (PI) para o analisador XML parser.

Uma instrução de processamento tem o seguinte formato:

<?target
data
?>

Caution

O código PHP é delimitado pela instrução de processamento <?php. Como tal, é possível ter código PHP dentro de um documento XML. No entanto, a tag final PI (?>) não deve fazer parte dos dados. Se uma tag final PI existir como parte do código PHP incorporado, o restante do código PHP e a tag final PI "real" serão tratados como dados de caracteres.

Parâmetros

parser

O analisador XML.

handler

Se null ou uma string vazia for passada, o manipulador será redefinido para seu estado padrão.

Se handler for um callable, o callable será definido como o manipulador.

Se handler for uma string, ela pode ser o nome de um método de um objet definido com xml_set_object().

A assinatura do manipulador deve ser:

handler(XMLParser $parser, string $target, string $data): void

parser: O analisador XML que chama o manipulador.
target: O alvo da instrução de processamento.
data: Os dados da instrução de processamento.

Valor Retornado

Sempre retorna true.

Registro de Alterações

Versão	Descrição
8.0.0	O parâmetro `parser` agora espera uma instância de XMLParser; anteriormente, um resource `xml` válido era esperado.