PHP Conference Nagoya 2025

xml_set_start_namespace_decl_handler

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

xml_set_start_namespace_decl_handler Configura manipulador de declaração de namespace inicial

Descrição

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

Define um manipulador a ser chamado quando um namespace for declarado. As declarações de namespace ocorrem dentro de tags iniciais. Mas o manipulador inicial de declaração de namespace é chamado antes do manipulador de tag inicial para cada namespace declarado nessa tag inicial.

Parâmetros

parser

O analisador XML.

handler

Se null for passado, o manipulador é redefinido para seu estado padrão.

Aviso

Uma string vazia também redefine o manipulador, entretanto isto foi descontinuado a partir do PHP 8.4.0.

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 objeto definido com xml_set_object().

Aviso

Isto foi descontinuado a partir do PHP 8.4.0.

Aviso

A partir do PHP 8.4.0, a função de retorno é verificada quanto à validade ao configurar o manipulador, e não quando é chamada. Isto significa que xml_set_object() precisa ser chamada antes de configurar uma string de método como a função de retorno. Entretando, como este comportamento também foi descontinuado a partir do PHP 8.4.0, usar um callable adequado para o método é recomendado.

A assinatura do manipulador deve ser:

handler(XMLParser $parser, string|false $prefix, string $uri): void
parser
O analisador XML que chama o manipulador.
prefix
O prefixo é uma string usada para referenciar o namespace dentro de um objeto XML. false se nenhum prefixo existir.
uri
Uniform Resource Identifier (URI) do namespace.

Valor Retornado

Sempre retorna true.

Registro de Alterações

Versão Descrição
8.4.0 Passar uma string não-callable no parâmetro handler foi descontinuado, use um chamável apropriado para métodos, ou null para redefinir o manipulador.
8.4.0 A validade do manipulador handler como um tipo callable agora é verificada ao configurar o manipulador ao invés de verificar na chamada.
8.0.0 O parâmetro parser agora espera uma instância de XMLParser; anteriormente, um resource xml válido era esperado.

Veja Também

adicione uma nota

Notas Enviadas por Usuários (em inglês)

Não há notas de usuários para esta página.
To Top