PHP - xmlwriter_start_dtd_entity() 函式

定義和用法

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

xmlwriter_start_dtd_entity() 函式接受 XMLWriter 類的物件、表示實體名稱的字串值和布林值作為引數，並建立一個 DTD 實體開始標籤。

語法

xmlwriter_start_dtd_entity($writer, $name, $isParam);

引數

返回值

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

PHP 版本

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

示例

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

<?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, "    ");

   //Creating a DTD entity start tag
   xmlwriter_start_dtd_entity($writer, 'test_entity', TRUE);

   //Ending the DTD entity end tag
   xmlwriter_end_dtd_entity($writer);
   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"?>
<!ENTITY % test_entity>
<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("    ");

   //Creating a DTD entity start tag
   $writer->startDtdEntity('test_entity', TRUE);

   //Ending the DTD entity end tag
   $writer->endDtdEntity();

   //Starting an element
   $writer->startElement('Tutorial');
   $writer->startElement('name');
   
   //Adding text to the element
   $writer->text('JavaFX');  
   $writer->endElement();
   $writer->startElement('Author');
   
   //Adding text to the element
   $writer->text('Krishna');  
   $writer->endElement();

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

這將生成以下 XML 文件：

<?xml version="1.0"?>
<!ENTITY % test_entity>
<Tutorial>
   <name>JavaFX</name>
   <Author>Krishna</Author>
</Tutorial>