Home » XML » XML_XPath

The PEAR::XML_XPath class provided an XPath/DOM XML manipulation, maneuvering and query interface.

This package is unmaintained.

Download latest release 1.2.4 (archived versions might be outdated)

License: PHP License

Description

The PEAR::XML_XPath class provided an XPath/DOM XML manipulation, maneuvering and
query interface.
The class allows for easy manipulation, maneuvering and querying of a domxml tree using
both xpath queries and DOM walk functions. It uses an internal pointer for all
methods on which the action is performed. Results from an dom/xpath query are returned
as an XPath_Result object, which contains an internal array of DOM nodes and which extends
the common DOM class and hence contains all the DOM functions from the main object to run
on each of the elements in the internal array. This class tries to hold as close as possible to the DOM Recommendation. You MUST have the domxml extension to use this class.
The XML_XPath class was inspired by a class maintained by Nigel Swinson called phpxpath.
The phpxpath class does not rely on PHP xmldom functions and is therefore a sibling to
this class: http://sourceforge.net/projects/phpxpath

Maintainers

• Dan Allen (dallen) — lead, active

Dependencies

Required

• PHP (>= 4.2.1, <= 5.0.0, exclude 5.0.0)
• PEAR Installer (>= 1.4.0b1)
• domxml (extension)

Releases

• 1.2.4 (stable, 2007-08-04)
  Release notes

  License: PHP License

  QA release: Fix E_NOTICE when returning result in evaluate()

• 1.2.3 (stable, 2005-10-18)
  Release notes

  License: PHP License

  There is now a dependency on PHP4 since PHP5 has out-of-the-box for XPath in both DOM and SimpleXML.

• 1.2.2 (stable, 2005-10-12)
• 1.2.1 (devel, 2004-01-29)
  Release notes

  License: PHP License

  * fixed a long standing bug where the get_class() failed due to a case problem, causing all load() operations to fail in newer releases of PHP
  * changed state to devel

• 1.2 (beta, 2002-06-07)
  Release notes

  License: PHP License

  * Very important to note that the DOM step functions do not take an optional xpath query. The
  reason I designed it this way is because the outcome would be too difficult to deal with, since
  one of 4 different scenarios could take place. Plus, it just doesn't make any sense.
  * Significant speed enhancements (almost 100% faster)
  Major changes:
  * getAttribute('foo', true) now puts you on the attribute, not the element node
  * cleaned up the XML_XPath_result initialization (no longer create an StdClass when calling class)
  * fixed sorting for childNodes() and getElementsByTagName() generated result objects
  * cleaned up sorting in result object, and added comments (so I don't forget again how I did it)
  * major speed enhancements (calling user defined functions methods is slow, so tried to trim that down)
  * don't create a result object in the _quick_evaluate function since we don't need it anyway
  * enabled relative xpath queries differently, in_xpathQuery = array(query, node) for relative...
  * added relative xpath queries for the _quick_evaluate feature

• 1.1 (beta, 2002-06-07)
  Release notes

  License: PHP License

  This version brings major enhancements to the API
  * childNode(), siblingNode() removed and features are relocated
  * added childNodes() which returns an XML_XPath_result object of all children
  * added getElementByTagName which returns an XML_XPath_result object of all matching tags
  * step functions in result object are now next(), end(), rewind() and nextByNode(Name|Type)
  * calling next() after rewind() in the result object counts the first object again, so a regular
  while loop can be used
  * relative XPath queries are now enabled (getNodePath() provides this functionality)
  * better error reports generated and will continue to improve with the domxml extension
  * setNodeIndex() in result object removed

• 1.0 (beta, 2002-05-24)
  Release notes

  License: PHP License

  This is the initial independent PEAR release.

Bugs