Skip to content


Subversion checkout URL

You can clone with
Download ZIP
QueryPath is a PHP library for manipulating XML and HTML. It is designed to work not only with local files, but also with web services and database resources.
PHP Other
Latest commit af0a5e6 @technosophos Updated release notes.
Failed to load latest commit information.
bin Minor XML fix.
examples Issue #132: Removed deprecated :root pseudoclass.
patches Cleaing up get tree.
phar Fixed a bug in the phar builder (Issue #43).
src Merge pull request #169 from Zemistr/master
test Add ns() method
tutorials Addressed bug in my implementation of :contains(), added contains-exa…
API Updated release notes.
COPYING-MIT.txt Updates for issue #145; updated copyright.
Makefile Integrating the new DOMTraverser with DOMQuery. Updates for issue #145; updated copyright.
RELEASE Updated release notes.
build.xml Updated build.xml to point to current pyrus.
composer.json Initial support for HTML5 via HTML5-PHP.
config.doxy Fixed version number in doxy config.
package.xml Fixed build system for template-based PEAR builds with Pyrus.
package_compatible.xml Fixed a bug in the phar builder (Issue #43).
pear-summary.txt Added a file that contains PEAR summary text. Added QuickStart guide.

QueryPath: Find your way.

Authors: Matt Butcher (lead), Emily Brand, and many others

Website | API Docs | VCS and Issue Tracking | Support List | Developer List | Pear channel |

This package is licensed under an MIT license (COPYING-MIT.txt).

At A Glance

QueryPath is a jQuery-like library for working with XML and HTML documents in PHP. It now contains support for HTML5 via the HTML5-PHP project.

Gettings Started

Assuming you have successfully installed QueryPath via Composer, you can parse documents like this:

require_once "vendor/autoload.php";

// HTML5 (new)
$qp = html5qp("path/to/file.html");

// Legacy HTML via libxml
$qp = htmlqp("path/to/file.html");

$qp = qp("path/to/file.html");

// All of the above can take string markup instead of a file name:
$qp = qp("<?xml version='1.0'?><hello><world/></hello>")

But the real power comes from chaining. Check out the example below.

Example Usage

Say we have a document like this:

<?xml version="1.0"?>
  <tr id="row1">
  <tr id="row2">

And say that the above is stored in the variable $xml. Now we can use QueryPath like this:

// Add the attribute "foo=bar" to every "td" element.
qp($xml, 'td')->attr('foo', 'bar');

// Print the contents of the third TD in the second row:
print qp($xml, '#row2>td:nth(3)')->text();

// Append another row to the XML and then write the
// result to standard output:
qp($xml, 'tr:last')->after('<tr><td/><td/><td/></tr>')->writeXML();


(This example is in examples/at-a-glance.php.)

With over 60 functions and robust support for chaining, you can accomplish sophisticated XML and HTML processing using QueryPath.

QueryPath Installers

The preferred method of installing QueryPath is via Composer.

You can also download the package from GitHub.

Composer (Preferred)

To add QueryPath as a library in your project, add this to the 'require' section of your composer.json:

  "require": {
    "querypath/QueryPath": ">=3.0.0"

The run php composer.phar install in that directory.

To stay up to date on stable code, you can use dev-master instead of >=3.0.0.

Manual Install

You can either download a stable release from the GitHub Tags page or you can use git to clone this repository and work from the code.

Including QueryPath

As of QueryPath 3.x, QueryPath uses the Composer autoloader if you installed with composer:

require 'vendor/autoload.php';

Without Composer, you can include QueryPath like this:

require 'QueryPath/src/qp.php';

QueryPath can also be compiled into a Phar and then included like this:

require 'QueryPath.phar';

From there, the main functions you will want to use are qp() (alias of QueryPath::with()) and htmlqp() (alias of QueryPath::withHTML()). Start with the API docs.

Something went wrong with that request. Please try again.