DOMDocument
在线手册：中文 英文
PHP手册

DOMDocument::createComment

(PHP 5)

DOMDocument::createComment — Create new comment node

说明

DOMComment DOMDocument::createComment ( string $data )

This function creates a new instance of class DOMComment. 此节点出现在文档中，除非是用诸如 DOMNode->appendChild() 等函数来将其插入。

参数

data

The content of the comment.

返回值

The new DOMComment or FALSE if an error occured.

参见

DOMDocument
在线手册：中文 英文
PHP手册
PHP手册 - N: Create new comment node

用户评论:

php dot sirlancelot at spamgourmet dot com (25-Nov-2009 08:10)

To prevent a parser error when the comment string would contain the character sequence "--", do this:

<?php

$CommentString = 'This contains -- some weird -- characters.';

$CommentNode = $DomDocument->createComment(
        str_replace('--', '-'.chr(194).chr(173).'-', $CommentString)
);
?>

This will insert a Soft Hyphen in between the two hyphens which will not cause the parser to error out.

capps at solareclipse dot net (29-Mar-2007 11:55)

Use caution: this function does NOT escape, encode, or otherwise change the contents of the string.

This means that if your string contains two hyphens in a row (--), that will *end* the comment, which can easily create invalid XML when the document is serialized.