Documentación offline PHP master

DOMNode::C14N

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

DOMNode::C14N

Canoniza nodos en una cadena

Descripción#

public DOMNode::C14N([bool $exclusive], [bool $withComments], [array $xpath], [array $nsPrefixes]): string
```php

Canoniza nodos en una cadena de caracteres.

## Parámetros

`exclusive`  
Activa el análisis de los únicos nodos correspondientes al XPath o a los prefijos de espacio de nombres proporcionados.

`withComments`  
Conserva los comentarios en la salida.

`xpath`  
Un array de XPaths para filtrar los nodos. Cada entrada en este array es un array asociativo con:

- Una clave `query` requerida que contiene la expresión XPath como cadena de caracteres.

- Una clave `namespaces` opcional que contiene un array que mapea los prefijos del espacio de nombres (claves) a los URI del espacio de nombres (valores).

`nsPrefixes`  
Un array de prefijos de espacios de nombres utilizados para filtrar los nodos.

## Valores devueltos

Devuelve los nodos canonizados, en forma de una `string` o `false` si ocurre un error

## Ejemplos

Ejemplo con una consulta XPath

Este ejemplo demuestra un uso avanzado mediante la canonicalización y el filtrado de nodos a través de una consulta XPath.
loadXML(<< Pomme Orange Poire Laitue XML); echo $dom->C14N(true, false, [ "query" => ".//f:fruit|.//f:fruit/text()", "namespaces" => ["f" => "urn:food"], ]); ?>

```php

El ejemplo anterior mostrará:

<food:fruit>Pomme</food:fruit><food:fruit>Orange</food:fruit><food:fruit>Poire</food:fruit>

Véase también#

DOMNode::C14NFile