DOMImplementation::createDocumentType

(PHP 5, PHP 7, PHP 8)

DOMImplementation::createDocumentType — Crea un objeto DOMDocumentType vacío

Descripción

public DOMImplementation::createDocumentType(string $qualifiedName, string $publicId = "", string $systemId = ""): DOMDocumentType|false

Crea un objeto DOMDocumentType vacío. Las declaraciones y notaciones de entidades no están disponibles. Las expansiones de referencias de entidades y los añadidos de atributos por omisión no se efectúan tampoco.

Parámetros

qualifiedName: El nombre cualificado del tipo de documento a crear.
publicId: El identificador público externo del subconjunto.
systemId: El identificador de sistema externo del subconjunto.

Valores devueltos

Un nuevo nodo DOMDocumentType con su ownerDocument definido a null o false en caso de error.

Errores/Excepciones

DOM_NAMESPACE_ERR: Se lanza si hay un error con el espacio de nombres, determinado por qualifiedName.

Historial de cambios

Versión	Descripción
8.0.0	Llamar a esta función de manera estática lanzará ahora una Error. Anteriormente, se generaba un error `E_DEPRECATED`.

Ejemplos

Ejemplo #1 Creación de un documento con una DTD adjunta

<?php

// Creación de una instancia de la clase DOMImplementation
$imp = new DOMImplementation;

// Creación de una instancia DOMDocumentType
$dtd = $imp->createDocumentType('graph', '', 'graph.dtd');

// Creación de una instancia DOMDocument
$dom = $imp->createDocument("", "", $dtd);

// Definición de otras propiedades
$dom->encoding = 'UTF-8';
$dom->standalone = false;

// Creación de un elemento vacío
$element = $dom->createElement('graph');

// Adición del elemento
$dom->appendChild($element);

// Recupera y muestra el documento
echo $dom->saveXML();

?>

El resultado del ejemplo sería:

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE graph SYSTEM "graph.dtd">
<graph/>

Ver también

DOMImplementation::createDocument() - Crea un objeto DOM Document del tipo especificado con sus elementos

Found A Problem?

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

＋add a note

User Contributed Notes 1 note

down

until-all-bytes-are-free at example dot org ¶

13 years ago

I had problems to use a DTD from a file. It needed to be resolved relatively and it contained characters that made DomDocument failed to resolve the file.

Encoding and an absolute filename did not help much. So I used the data:// streamwrapper ( http://php.net/manual/en/wrappers.data.php ) as a work-around:

<?php

// relative or absolute filename
$path = '...';

// convert file contents into a filename
$data = file_get_contents($path);
$systemId = 'data://text/plain;base64,'.base64_encode($data);

// ...

// Creates a DOMDocumentType instance
$dtd = $aImp->createDocumentType('qualified name', '', $systemId);

?>

Works like a charm.

＋add a note