phpQuery blog

New release - phpQuery 0.9.5 RC2

noreply@blogger.com (Tobiasz Cudnik) — Wed, 15 Apr 2009 12:28:00 +0000

Second Release Candidate is available for download. There are couple of reasons for not marking it as stable, although this version is really a candidate and will hopefully became stable without any modifications.

Besides many bugfixes, there are also some new features in this release, but those are only significant ones.

Noteworthy

Mutation events New DOMNodeInserted and DOMNodeRemoved, part of W3C standards, are now available and automatically triggered.
getJSON method This really important method (from mashup point of view) is now available and supports JSONP datasources.
data() methods Internal datastore per node allows easier manipulation and data exchange.
Charset conversion for HTML jbondc commited a patch to convert charset during document load (using mbstring). Right now it works only for HTML, other cases are scheduled for v1.1.

PEAR server

PEAR installation is finally available. It's the fastest and most comfortable method to install phpQuery system-wide. Just type those 2 commands as privileged user:

pear channel-discover phpquery-pear.appspot.com
pear install phpquery/phpQuery

After that only thing you need to do is:

require "phpQuery.php";

Linux packages

Both DEB and RPM packagages are now available. Those packages doesn't interfere with PEAR package.

Donations

As project almost reached it's first stable release and it's quite feature-complete, i've decided to open it for donations. If you're using it in your own project, maybe planning to do it with next one, waiting for one of many planned features or just like the idea of more JavaScript-like server-side, please consider 10$ donation to support phpQuery development. All amounts are appreciated!

Twitter

Since some time you can follow phpQuery development on Twitter. Posted messages contain such informations as new commits (with log), new issues, comments on issues and also this blog posts. All of them are directly linked to proper URL.

Full Changelog

added data() and removeData()
fixed hardcoded charsets in contentTypes
fixed $context as array in find()
fixed PHP 5.3 closure compatibility in filter()
fixed filter callback result interpretation
fixed queries when stack was XML root
fixed sibling methods for textnodes
fixed attr() with empty stack
fixed redundant phpQuery::$documents bindings
fixed phpQuery::callbackRun() in PHP 5.3
filter() detects instances of Callback class
fix for proper query roots
small fix in google_login script
improved dumpTree()
fixed loading HTML with nested xml namespace declaration
fixed parseJSON() encoding issues
added getJSON() with JSONP support
added WebBrowser per event callback support
added phpQuery::extend
added __callStatic for phpQuery class static plugins namespace (PHP 5.3)
fixed document references in phpQuery::getDocumentID
fixed DOMNode as first parameter in pq();
added DOMNodeInserted and DOMNodeRemoved mutation events
not() fixed for set of elements
fixed trigger() static call error
added named callbacks
fixed val() for selects
newInstance() supports raw markup
new calback types
added HTML load-time charset convertion (patch from jbondc)

Get newest version from download page.

QueryTemplates - templating engine using phpQuery

noreply@blogger.com (Tobiasz Cudnik) — Thu, 11 Dec 2008 13:54:00 +0000

Introducing QueryTemplates, a completely new templating engine based on phpQuery.

Quote from project page:

PHP based templating engine creating reusable native templates in various languages.

As for today, supported are following sources: HTML, XML, XHTML, PHP and PHP callbacks which can be processed into PHP or JavaScript template file.

Library uses popular web 2.0 pattern load-traverse-modify thou jQuery like chainable API and provides developer several rapid template filling methods.

Using QueryTemplates developer is independent from designer. He loads pure markup HTML/XML file(s), traverses using CSS selectors and modifies it, injecting data and logic.

Example code:

template('output')
->sourceCollect('input.html')
->parse()
  ->source('input.html')->returnReplace()
  ->find('.my-div')
    ->ifVar('showMyDiv')
    ->find('ul > li')
      ->loopOne('data', 'row')
        ->varsToSelector('row', $rowFields)
;

Library uses advanced phpQuery features like

inheritance
callbacks
plugins

There are many working examples of such templates on official project page.

New release - phpQuery 0.9.5 Beta4

noreply@blogger.com (Tobiasz Cudnik) — Tue, 18 Nov 2008 19:48:00 +0000

The fourth beta is mostly bugfix release and hopefully it's the last one before RC. Two most noticeable fixes are multibyte characters support (for queries and DOM structure) and fixed zip release package, which couldn't be extracted on case-insensitive filesystems.

The is also new release package type - All-in-One. It's for those who prefer one consistent file. Very important thing to notice - this package doesn't include Zend Framework, used for HTTP Client. It means You have to have one on you own to use Ajax.

Release is also available as RPM package - normal and All-in-One version.

Changelog

• fixed filename collision (win & macos)
• fixed "> .class" selector
• fixed :not(selector) pseudoclass when selector is a pseudoclass
• fixed attribute matching in filter()
• fixed Ajax lowercased request method
• fixed selector filter in nextAll() and prevAll()
• added mbstring extension compatibility
• added context guessing when passing DOMNode to pq() as only param
• added downloadTo() method for WebBrowser
• added dash "-" as allowed tag character
• added phpQuery::$defaultDoctype
• added contentsUnwrap()
• added switchWith()
• get() now use callbacks for each returned element separately
• fixed foreach iteration
• fixed parents() with $selector
• fixed parents() for documentFragment
• fixed val() with $val == array
• fixed val() for select
• fixed val(0)
• fixed unloadDocuments()
• added fix_webroot script
• fixed change event triggering
• added change event for textarea
• fixed isHTML()
• fixed filter() and not() with multiply selectors and pseudoclasses

Get phpQuery-0.9.5 Beta4 from Download section.

Basic example - demo.php

noreply@blogger.com (Tobiasz Cudnik) — Tue, 21 Oct 2008 19:00:00 +0000

This example shows how to use basic functionality of phpQuery, such as:

Document intialization
Querying document
Filling with markup
Manipulating DOM
Selecting documents
Iterating with foreach
Printing output

Example file can also be found in all release packages.

require('phpQuery/phpQuery.php');

// INITIALIZE IT
// $doc = phpQuery::newDocumentHTML($markup);
// $doc = phpQuery::newDocumentXML();
// $doc = phpQuery::newDocumentFileXHTML('test.html');
// $doc = phpQuery::newDocumentFilePHP('test.php');
// $doc = phpQuery::newDocument('test.xml', 'application/rss+xml');
// this one defaults to text/html in utf8
$doc = phpQuery::newDocument('<div>');

// FILL IT
// array syntax works like ->find() here
$doc['div']->append('<ul></ul>');
// array set changes inner html
$doc['div ul'] = '<li>1</li><li>2</li><li>3</li>';

// MANIPULATE IT
// almost everything can be a chain
$li;
$doc['ul > li']
->addClass('my-new-class')
->filter(':last')
    ->addClass('last-li')
// save it anywhere in the chain
    ->toReference($li);

// SELECT IT
// pq(); is using selected document as default
phpQuery::selectDocument($doc);
// documents are selected when created, iterated or by above method
// query all unordered lists in last selected document
pq('ul')->insertAfter('div');

// INTERATE IT
// all LIs from last selected DOM
foreach(pq('li') as $li) {
// iteration returns PLAIN dom nodes, NOT phpQuery objects
$tagName = $li->tagName;
$childNodes = $li->childNodes;
// so you NEED to wrap it within phpQuery, using pq();
pq($li)->addClass('my-second-new-class');
}

// PRINT OUTPUT
// 1st way
print phpQuery::getDocument($doc->getDocumentID());
// 2nd way
print phpQuery::getDocument(pq('div')->getDocumentID());
// 3rd way
print pq('div')->getDocument();
// 4th way
print $doc->htmlOuter();
// 5th way
print $doc;
// another...
print $doc['ul'];
</div>

phpQuery 0.9.5 Beta2 released

noreply@blogger.com (Tobiasz Cudnik) — Fri, 17 Oct 2008 08:22:00 +0000

New major version is out! After much of rewriting old DOMDocument releated code, public release is avaible for download. New code parts fixes many previous problems, but not only bugfixes cames with this version.

Noteworthy

New callback system More flexible callbacks allows you to control passed parameter order / values and also there is CallbackReference, which passes callback parameter straight to reference. You can read more about callbacks in almost-up-to-date wiki page or see some code in action here.
Console (CLI) interface One of my favorite features, allowing web scraping right from console. You can see some examples here. There is also RPM package available.
XML, XHTML and PHP files support There are dedicated methods for loading all type of documents (HTML, XHTML, XML) and one for autodetected content. Everything basses on content-type header. For PHP files there is newDocumentPHP(), which works like newDocument() (it needs content-type when auto-detection isn't possible) and converts PHP tags to <php>, which later can be exported using $pq->php(), just like html() method :)
New Scripts plugin This plugin simplifies writing short code scripts which can be easily reused (chained). In latest release package there are 2 scripts: google_login and safe_print. More about the plugin in this post.

Full changelog

added extended callback support in ALL methods (yay!)
added CLI interface
added Scripts plugin
added bootstrap file support
DOMDocument wrapper introduced (alpha)
- fixed inserts/appends
- added XML/XHTML compatibility
- contentType support
phpQuery
- ::newDocument($markup, $contentType = null) // new document from markup, type
- autodetected
- ::newDocumentHTML($html) // new document, type HTML
- ::newDocumentXML($xml) // new document, type XML
- ::newDocumentXHTML($xml) // new document, type XHTML
- ::newDocumentPHP($markup, $contentType)
- ::newDocumentFile($file)
- ::newDocumentFileHTML($file)
- ::newDocumentFileXML($file)
- ::newDocumentFileXHTML($file)
- ::newDocumentFilePHP($file)
$pq
- ->isXML()
- ->isXHTML()
- ->isHTML()
- ->html()
- ->xml()
- ->htmlOuter()
- ->xmlOuter()
new test documents
class reorganization
jQueryServer
- config file
- allowed referers list
- using Json straight from phpQuery
fixed ajaxAllowURL
XHTML fixes
fixed notice for DOMTextNode
added callbacks in text()
added callbacks in htmlOuter()
fixed text($text)
added getDocument()
fixed html() with text node at beggining
fixed zend framework selection in releases (missing some cookie dependencies)
fixed returns in phpQuery::$plugins
fixed $callback in .submit()
added phpQuery::plugin() and $pq->plugin() methods
fixed many minor issues in WebBrowser plugin
fixed :pseudoclass:pseudoclass selector
added CallbackReference
fixed include paths on win32
fixed some events triggers

Get latest release from project's Download Page and report bugs to Issue Tracker.

Wiki has documentation

noreply@blogger.com (Tobiasz Cudnik) — Tue, 23 Sep 2008 09:24:00 +0000

Project's Wiki has been created and now contains all method names from jQuery Documentation Site. Whole process has been automated using docs-import script, which fetches data from this XML, an effect of query-api-browser project (thx guys). Here's some example snippet - Selectors section.

$categories = $pq->find('cat[value=Selectors] subcat');
$content = array();
      foreach($categories as $subcat) {
          $content[] = '===='.pq($subcat)->attr('value')."====";
          foreach(pq($subcat)->find('selector') as $selector)
              $content[] = ' * *`'.pq('sample', $selector)->text().'`* '.pq('> desc', $selector)->text();
      }

As you can see Wiki markup is automatically applied and whole task is quite easy using jQuery-like interface. Wiki documentation can be usefull due to official documentation going offline quite often lately. There is also great CHM version to download which i recommend.

Besides coping documentation ;) there are some pure phpQuery-specific pages like PHPSupport or Callbacks. More will come.

phpQuery 0.9.4 RC1

noreply@blogger.com (Tobiasz Cudnik) — Mon, 22 Sep 2008 23:22:00 +0000

Almost week passed since first 0.9.4 beta2 release and today we have a Release Candidate 1 and I hope the last one ;) Couple of important improvements have appeared since last version, but most important is fixing nasty bug which causes infinitive loop for elements with detached one of the parents. Thanks to Nicolas for feedback. Also the siblings() fix was a serious issue.

There were some works on WebBrowser, which now supports clicking submits and can be called by just one line (without plugin load and host authorization). As you can see at the end of this post, many new (old) selectors have been implemented. This issue was too long on the wait list. The callback system at latest starting to be usable, thanks to to ParamStructures, which simply allows to control parameters order and values. Events now appears in anyones phpQuery by auto triggered 'change' event for form elements. More auto-events will came in time. Feel free to make suggestions. Issue Tracker already have some interesting ideas, take a look there sometime.

Thats all for now, just get the newest version, better via subversion to get easy code updates. Before next release I will to find time try to write DOMDocument wrapper which should open easy doors for certain issues, like XML and charset stuff.

Changelog

missing CSS3 selectors
- :header
- :last-child
- :first-child
- :only-child
- :nth-child(index/even/odd/equation)
- :input
- :text
- :password
- :radio
- :checkbox
- :submit
- :image
- :reset
- :button
- :file
- :hidden
- :empty
new callback handling
- support paramStructure to controll passed params
- applied to ::each(), ::map(), .each(), .map()
fixed siblings(), which doesnt return ANY of previous siblings
WebBrowser
- meta refresh supported
- fixed double callback
- click on submit now submits form
- added browserPost()
- added browser()
- support for callback's paramStructure
- added shortcuts in main phpQuery namespace
- automatic ajax host authorization
added basic XML compatibility
fixed passing DOMNode as query $context in pq();
added phpQuery::ajaxAllowHost($host)
added auto 'change' event triggering for form elements
fixed Issue 38 with infinitive loop (thx Nicolas!)

Download phpQuery 0.9.4 RC1.

phpQuery 0.9.4 released for testing

noreply@blogger.com (Tobiasz Cudnik) — Wed, 17 Sep 2008 17:54:00 +0000

UPDATE - phpQuery 0.9.4 RC1 has been released

I proudly announce a public release of phpQuery 0.9.4 (beta2 right now). There were many many changes since 0.9.1, and here's the highlights.

Ajax

You can do requests like in jQuery, but cross-domain. Everything works on stable Zend HTTP Client.
Example:

phpQuery::newDocument('<html><body></body></html>')
  ->load('http://somesite.com/form #result', array(
    'postParam1' => 'value1',
    'postParam2' => 'value2',
  ))
  ->find('#result')
    ->before('<h1>This is a result of requested form</h1>');

Events

This could seem odd for someone, but server-side DOM events are now implemented and work quite like those in a browser - you can bind to node's event, you can trigger them and they bubble up thru DOM.
Example:

phpQuery::newDocumentFile('myfile.html')
  ->find('.my-elements')
  ->parent()
    ->bind('awaitedEvent', 'handlerCallback')->end()
  ->trigger('awaitedEvent');
function handlerCallback($event) {
  $target = $event->target;
  $node = $event->currentTarget;
}

WebBrowser plugin

Now here's the most intresting part - combine AJAX and events, bind some defaults behaviors, add .location property, cookies was already there and here we have - WebBrowser mimics on every PHP5 server ! Just look at quering google:

phpQuery::$plugins->browserGet('http://google.com/', 'success1');
function success1($browser) {
  $browser
    ->WebBrowser('success2')
    ->find('input[name=q]')
      ->val('phpQuery')
      ->parents('form')
        ->submit() ;
}
function success2($html) {
  print $html;
}

It's still needs some polishing (and testing mainly), eg meta-refreshes are missing (gmail login fails), no submit after click and probably others, but it works and is so nice!

jQueryServer

It's a subproject existing from some time in repo, but today it pops-up to the light. First - it's a jQuery plugin, kind of RPC thing, so you can request actions on phpQuery straight from browser and fetch only a result.
Example:

$.server({url: 'http://somesite.com'})
  .find('.my-class')
  .client(function(response){
    $('.destination').html(response);
});

Full changelog:

AJAX (Zend Framework's HTTP Client used as backend)
Events (server-side...)
WebBrowser plugin (yey!)
jQueryServer plugin for jQuery
Countable interface implementation
redesigned class structure (less namespace collisions)
enhanced plugin implementation (API changed)
added toReference($var)
fixed get(index)
fixed importing nodes via pq()
fixed multiplie selectors in filter()
fixed not() to support phpQuery objects and DOMNodes
ArrayAccess interface implementation
- eg $pqDocument['.my-class']->addClass('my-second-class');
- eg $pqDocument['.my-class'] = 'new outherHtml for .my-class';
fixed HTML entities (utf8 only for today)
added filterCallback()
added phpQuery::toJSON()
added phpQuery::parseJSON()
added phpQuery::getDocumentID()
added phpQuery::getDOMDocument()
global events
Zend Framework added as svn:externals
ported functions from Utilities section
- phpQuery::each()
- ::grep()
- ::makeArray()
- ::map()
- ::inArray()
- ::unique()
length avaible as attribute
fixed .map()
fixed .clone()

Just grab it here - phpQuery-0.9.4-beta2.zip or visit phpQuery project homepage for alternative ways. Don't forget to post bugs to Issue Tracker ;)

Blog starts

noreply@blogger.com (Tobiasz Cudnik) — Wed, 17 Sep 2008 17:41:00 +0000

Finally, we have a blog for phpQuery project. All major release notes will be posted here. For now it's all in Blogspot's default state, but this should change in some time. So subscribe to RSS channel if you want to be informed about official releases.