PHP - xmlwriter_write_dtd() 函式

定義和用法

XML 是一種用於在網路上共享資料的標記語言，XML 既可供人類閱讀，也可供機器閱讀。XMLWriter 擴充套件內部使用 libxml xmlWriter API，用於寫入/建立 XML 文件的內容。由此生成的 XML 文件是非快取的，並且是單向的。

xmlwriter_write_dtd() 函式用於建立/寫入完整的 DTD 標記。

語法

xmlwriter_start_dtd($writer, $name, $public_id, $system_id, $subset);

引數

序號	引數 & 描述
1	writer（必填）這是 XMLWriter 類的物件，表示您想要修改/建立的 XML 文件。
2	name（必填）這是表示文件型別限定名稱的字串值。
3	public_id（可選）這是表示外部子集公共識別符號的字串值。
4	system_id（可選）這是表示外部子集系統識別符號的字串值。
5	subset（可選）這是表示 DTD 標記內容的字串值。

返回值

此函式返回一個布林值，成功時為 TRUE，失敗時為 FALSE。

PHP 版本

此函式首次引入於 PHP 5 版本，並在所有後續版本中有效。

示例

以下示例演示了 xmlwriter_start_dtd() 函式的用法：

<?php
   //Opening a writer
   $uri = "result.xml";
   $writer = xmlwriter_open_uri($uri);

   //Starting the document
   xmlwriter_start_document($writer);

   //Setting the indentation
   xmlwriter_set_indent($writer, TRUE);
   xmlwriter_set_indent_string($writer, "    ");

   $dtd = "<!DOCTYPE address [
      <!ELEMENT address (name,company,phone)>
      <!ELEMENT name (#PCDATA)>
      <!ELEMENT company (#PCDATA)>
      <!ELEMENT phone (#PCDATA)>
   ]>";

   //Creating a DTD tag
   xmlwriter_write_dtd($writer, 'test_dtd', 'pub_1001', 'sys_1001' , $dtd);

   //Starting an element
   xmlwriter_start_element($writer, 'address');

   //Starting a element tag
   xmlwriter_start_element($writer, 'name');
   
   //Adding text to the element
   xmlwriter_text($writer, 'Tanmay Patil');  
   xmlwriter_end_element($writer);
   xmlwriter_start_element($writer, 'company');
   
   //Adding text to the element
   xmlwriter_text($writer, 'TutorialsPoint');  
   xmlwriter_end_element($writer);
   xmlwriter_start_element($writer, 'phone');
   
   //Adding text to the element
   xmlwriter_text($writer, '(011) 123-4567');  
   xmlwriter_end_element($writer);

   //Ending the element
   xmlwriter_end_element($writer);

   //Ending the document
   xmlwriter_end_document($writer);
?>

這將生成以下 XML 文件：

<?xml version="1.0"?>
<!DOCTYPE test_dtd
PUBLIC "pub_1001" "sys_1001" [<!DOCTYPE address [
   <!ELEMENT address (name,company,phone)>
   <!ELEMENT name (#PCDATA)>
   <!ELEMENT company (#PCDATA)>
   <!ELEMENT phone (#PCDATA)>
]>]>
<address>
   <name>Tanmay Patil</name>
   <company>TutorialsPoint</company>
   <phone>(011) 123-4567</phone>
</address>

示例

以下是此函式在面向物件風格中的示例：

<?php
   //Creating an XMLWriter
   $writer = new XMLWriter();

   //Opening a writer
   $uri = "result.xml";
   $writer->openUri($uri);

   //Starting the document
   $writer->startDocument();

   //Setting the indentation on
   $writer->setIndent(TRUE);
   
   //Setting the indentation
   $writer->setIndentString("    ");
   $dtd = "<!DOCTYPE address [
      <!ELEMENT address (name,company,phone)>
      <!ELEMENT name (#PCDATA)>
      <!ELEMENT company (#PCDATA)>
      <!ELEMENT phone (#PCDATA)>
   ]>";

   //Creating a DTD tag
   $writer->writeDtd('test_dtd', 'pub_1001', 'sys_1001' , $dtd);

   //Starting an element
   $writer->startElement(address);
   $writer->startElement('name');
   
   //Adding text to the element
   $writer->text('Tanmay Patil');  
   $writer->endElement();
   $writer->startElement('company');
   
   //Adding text to the element
   $writer->text('TutorialsPoint');  
   $writer->endElement();
   $writer->startElement('phone');
   
   //Adding text to the element
   $writer->text('(011) 123-4567');  
   $writer->endElement();

   //Ending the element
   $writer->endElement();
   
   //Ending the document
   $writer->endDocument();
?>

這將生成以下 XML 文件：

<?xml version="1.0"?>
<!DOCTYPE test_dtd
PUBLIC "pub_1001" "sys_1001" [<!DOCTYPE address [
   <!ELEMENT address (name,company,phone)>
   <!ELEMENT name (#PCDATA)>
   <!ELEMENT company (#PCDATA)>
   <!ELEMENT phone (#PCDATA)>
]>]>
<address>
   <name>Tanmay Patil</name>
   <company>TutorialsPoint</company>
   <phone>(011) 123-4567</phone>
</address>

php_function_reference.htm

列印頁面