Download the PHP package mathsgod/p-query without Composer

Introduction

PQuery is a PHP library that lets you parse and manipulate HTML strings using a jQuery-like API. It is built on top of PHP's native DOM extension and uses Symfony's CSS Selector component for selector support.

Requirements

• PHP ^8.3
• ext-dom
• Composer

Installation

Quick Start

PQuery Supported Methods

• size() / count() — number of matched elements
• first() / last() — get the first or last matched element
• html() — get or set inner HTML
• text() — get or set text content
• append() / prepend() — insert content to each element
• appendTo() / prependTo() — insert elements into target
• after() / before() — insert content adjacent to elements
• remove() — remove elements from the document
• find() — search descendants by CSS selector
• closest() / parent() / children() / contents() — traverse the DOM
• attr() / removeAttr() — get or set attributes
• addClass() / removeClass() / toggleClass() / hasClass() — class manipulation
• css() — get or set inline styles
• data() — get or set data attributes
• val() — get or set form values
• filter() — reduce the matched set
• each() — iterate over matched elements
• replaceWith() / wrap() / wrapInner() — replace or wrap elements
• prev() / next() / index() — sibling and position helpers
• on() / trigger() — event listener helpers

CSS Selector Support

Use any valid CSS selector with find() and filter():

Working with HTML Elements

Create and style elements directly:

Append an element

Append text

Append an element and text

Parse HTML from a File

Events

Attach and trigger event listeners on elements:

Running Tests

Tests are run automatically on GitHub Actions against PHP 8.3, 8.4, and 8.5.

License

MIT

Created by Raymond Chong