[Phpxd-commits] CVS: phpXD.www/data/en readme.xml,1.1,1.2 releases.xml,1.1,1.2
Status: Beta
Brought to you by:
growbal
|
From: Thomas D. <th...@us...> - 2002-02-14 13:17:17
|
Update of /cvsroot/phpxd/phpXD.www/data/en
In directory usw-pr-cvs1:/tmp/cvs-serv12373/data/en
Modified Files:
readme.xml releases.xml
Log Message:
Index: readme.xml
===================================================================
RCS file: /cvsroot/phpxd/phpXD.www/data/en/readme.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -C2 -r1.1 -r1.2
*** readme.xml 28 Jan 2002 19:37:26 -0000 1.1
--- readme.xml 14 Feb 2002 13:17:14 -0000 1.2
***************
*** 7,19 ****
<h1>ReadMe</h1>
<h2>Preface</h2>
! <p>This file relates to phpXD release 0.21.</p>
<h2>What is phpXMLDOM?</h2>
! <p>phpXMLDOM is a XML DOM-Implementation for PHP4 written in PHP. It offers
! methods for accessing the nodes of a XML document using the W3C
! Document Object Model Level 2 Core (DOM). </p>
! <p>The differences to the PHP DOM XML functions (only available if
! PHP was configured with --with-dom=[DIR]) are that phpXMLDOM
! implements the official W3C DOM (see http://www.w3.org/DOM/) and that
! you do not need to recompile PHP to use phpXMLDOM. </p>
<h2>Requirements</h2>
--- 7,19 ----
<h1>ReadMe</h1>
<h2>Preface</h2>
! <p>This file relates to phpXD release 0.3.</p>
!
<h2>What is phpXMLDOM?</h2>
! <p>
! phpXMLDOM (phpXD) is an XML DOM-Implementation for PHP written in PHP.
! It offers methods for accessing the nodes of an XML document
! using the W3C Document Object Model Level 2 Core
! (DOM). phpXMLDOM does not require the PHP DOM XML extension.
! </p>
<h2>Requirements</h2>
***************
*** 22,66 ****
<li>PHP XML extension (configure PHP using --with-xml)</li>
</ul>
!
! <h2>Features</h2>
! <p>Currently phpXMLDOM supports nearly all interfaces of DOM Level 2. Not
! supported are:</p>
<ul>
! <li>Entity</li>
! <li>EntityReference</li>
</ul>
! <p>DocumentType is still bad implemented, because the DTD of a XML
! file is not
! parsed. Only name, publicID, systemID and the internalSubset attribute
! are supported. If you load a XML file with a internal DTD and
! change the node
! tree, phpXMLDOM keeps the original DTD if you will save the file.</p>
! <p>Because PHP4 doesn't support exceptions, the DOMException interface is
not really implemented. Instead of this, ExceptionCodes are
defined. The functions which normally would like to raise a exception,
! returns an ExceptionCode.</p>
!
<h2>Using phpXMLDOM</h2>
! <p>First, create a phpXD object:</p>
! <pre>$dom = new phpXD();</pre>
! <p>If you specify a XML file as the first parameter of the constructor,
! the file will be parsed and the DOM tree created:</p>
! <pre>$dom = new phpXD("sample.xml");</pre>
! <p>You can load a XML file with</p>
! <pre>$dom->loadFile("sample.xml");</pre>
! <p>To access the DOM tree, use the document attribute, e.g.:</p>
! <pre>$list =& $dom->document->getElementsByTagName("hello");</pre>
! <p>You can get the root node with</p>
! <pre>$root =& $dom->document->getDocumentElement();</pre>
! <p>Be sure, that you use "=&", if a function returns a DOM object,
! because PHP copies all objects with "=", while the "=&"
! operator saves
! a reference. Because the DOM tree is a list of references, only one
! "=" could destroy the hierarchy of the tree.</p>
! <p>For more informations about the DOM interfaces see:
! http://www.w3.org/DOM/</p>
! <p>Last but not least, you can save the DOM tree:</p>
! <pre>$dom->saveFile("new.xml");</pre>
</content>
</page>
--- 22,102 ----
<li>PHP XML extension (configure PHP using --with-xml)</li>
</ul>
!
! <h2>Installation</h2>
<ul>
! <li>Unpack the files with
! <pre>
! tar -xzf phpxd_x.xx.tar.gz
! </pre></li>
! <li>Change variable $path in phpXD.php to the home directory of
! phpXMLDOM, for example:
! <pre>
! $path = "/home/thomi/phpXD";
! </pre></li>
</ul>
!
! <h2>Features</h2>
! <p>
! phpXMLDOM supports all interfaces of DOM Level 2 Core.
! </p>
! <p>
! Because PHP4 doesn't support exceptions, the DOMException interface is
not really implemented. Instead of this, ExceptionCodes are
defined. The functions which normally would like to raise a exception,
! returns an ExceptionCode.
! </p>
!
<h2>Using phpXMLDOM</h2>
! <p>
! To read an XML file, create a DOMParser object:
! </p>
! <pre>
! $parser = new DOMParser();
! </pre>
!
! <p>
! You can parse an XML file and create the DOM tree with
! </p>
! <pre>
! $document =& $parser->parseFile("sample.xml");
! </pre>
!
! <p>
! or an XML string with
! </p>
! <pre>
! $document =& $parser->parse("<hello>1</hello>");
! </pre>
!
! <p>
! Both functions have an optional second parameter. You can set it
! "true" if you want to parse the DTD of your XML.
! </p>
!
! <p>
! If the document was succesfully parsed, $document contains the
! implementation of the DOM interface Document.
! </p>
! <p>
! You can get the root node with
! </p>
! <pre>
! $root =& $document->getDocumentElement();
! </pre>
!
! <p>
! Be sure, that you use "=&" if a function returns a DOM object,
! because PHP copies all objects with "=", while the "=&"
! operator saves a reference. Because the DOM tree is a list of
! references, only one "=" could destroy the hierarchy of the tree.
! </p>
!
! <p>
! For more informations about the DOM interfaces see
! <a href="http://www.w3.org/DOM/">http://www.w3.org/DOM/</a> or
! the <a href="$URL$doc/index.html">phpXMLDOM API documentation</a>.
! </p>
!
</content>
</page>
Index: releases.xml
===================================================================
RCS file: /cvsroot/phpxd/phpXD.www/data/en/releases.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -C2 -r1.1 -r1.2
*** releases.xml 28 Jan 2002 19:37:26 -0000 1.1
--- releases.xml 14 Feb 2002 13:17:14 -0000 1.2
***************
*** 6,10 ****
<content>
<h1>Releases</h1>
! <h2>Current Release: phpXD 0.21</h2>
<h3>Release Notes</h3>
<ul>
--- 6,105 ----
<content>
<h1>Releases</h1>
! <h2>Current Release: phpXD 0.3</h2>
! <h3>Files</h3>
! <p>
! <a href="http://prdownloads.sf.net/phpxd/phpxd_0.3.tar.gz">
! phpxd_0.3.tar.gz
! </a> (Size: 60568 Bytes)
! </p>
!
! <h3>Release Notes</h3>
! <h4>Fixed Bugs</h4>
! <ul>
! <li>NodeList::removeNode did not decrease the length of the nodeList</li>
! <li>Node::normalize did not remove Text Nodes, whose data has been
! appended to a previous sibling during "normalization"</li>
! <li>bug in several functions handling XML Namespaces in Element.php
! and Document.php - the localname was not set correctly</li>
! </ul>
! <h4>New Directory/Files:</h4>
! <ul>
! <li>samples moved to /samples</li>
! <li>DOM classes moved to /include/dom</li>
! <li>Parser classes moved to /include/parser</li>
! <li>new DTD classes in /include/parser (DTDParser) and /include/dtd</li>
! <li>filenames have now the same spelling as classnames</li>
! </ul>
!
! <h4>New interface</h4>
! <ul>
! <li>class phpXD no longer exists</li>
! <li>to parse an XML file or string, use the functions
! DOMParser::parseFile and DOMParser::parse, for example:
! <pre>
! <?php
! $parser = new DOMParser();
! $document = $parser->parse("<hello>world</hello>");
! // $document is an instance of class Document!
! // echo documentElement
! echo $document->getDocumentElement();
! ?>
! </pre></li>
! <li>there is no longer a function to save XML; there are two
! new samples writer1 and writer2, which show how to output or
! save XML</li>
! </ul>
!
! <h4>Simple DTD parser</h4>
! <ul>
! <li>new class DTDParser to parse a DTD</li>
! <li>it is still experimental!</li>
! <li>DTDParser could be used from DOMParser, simply set the
! second parameter of DOMParser::parseFile or DOMParser:parse to
! true:
! <pre>
! <?php
! $parser = new DOMParser();
! // now the DTD is parsed
! $document = $parser->parse("<hello>world</hello>", true);
! // ...
! ?>
! </pre></li>
! <li>to use DTDParser without DOMParser use functions
! DTDParser::parse($str, $dtdonly) or DTDParser::parseFile($filename,
! $dtdonly); set $dtdonly to true, if $str or $filename is a single dtd
! without any XML markup, or to false, if the dtd is part of an XML
! document</li>
! </ul>
!
! <h4>Support for interfaces Entity, EntityReference and
! Notation added</h4>
! <ul>
! <li>DOM interfaces Entity, EntityReference and Notation are
! supported now</li>
! <li>to use them, the DTD must be parsed within DOMParser
! (see above section)</li>
! <li>EntityReferences are not expanded</li>
! <li>there is synchronization between Entities and
! EntityReferences; thus if you're looking within one of the
! EntityReference's children and the Entity changes, you won't
! be informed; instead you will continue to access the same
! object (in fact there is no valid way to change an Entity)</li>
! <li>also default attributes and the flag Attr::specified are
! supported now</li>
! <li>the behaviour of Attr::specified is a little different from DOM
! specification; it is set to false, if a default attribute is not set
! and if a attribute is set to the default value (because the
! XML parser makes no difference between this two cases)</li>
! </ul>
!
! <h2>Last Release: phpXD 0.21</h2>
! <h3>Files</h3>
! <p>
! <a href="http://prdownloads.sf.net/phpxd/phpxd_0.21.tar.gz">
! phpxd_0.21.tar.gz
! </a> (Size: 51620 Bytes)
! </p>
!
<h3>Release Notes</h3>
<ul>
***************
*** 19,28 ****
<li>Some litte bugs fixed...</li>
</ul>
- <h3>Files</h3>
- <p>
- <a href="http://prdownloads.sf.net/phpxd/phpxd_0.21.tar.gz">
- phpxd_0.21.tar.gz
- </a> (Size: 51620 Bytes)
- </p>
</content>
</page>
--- 114,117 ----
|