suralc / raq

Raq

Raq (Request and Query) aims to be a small convenience wrapper above guzzle and the symfony dom crawler to retrieve content from remote sites. It utilizes guzzles async functionality.

Notes

Nothing here is finished. Only the html query builder is partly implemented. Look at the tests for real usage examples. HHVM is currently unsupported as their generator implementation is not compatible with php.

Examples

Simple use:

// use function Raq\fetch; // uncomment on PHP 5.6+
// $responseHandle wraps a Guzzle promise
$responseHandle = \Raq\fetch('http://my.url');
// the promise will not be resolved until you call the query method on wrapper
$result = $responseHandle->query(function(QueryFactory $q) {
	// retrieve all a tags that are children of div tags
	return $q->createHtmlQuery()->select('div > a');
});

Call multiple targets at once:

$urls = [
	'http://foo.bar/user1',
    'http://foo.bar/user2',
    'http://foo.bar/user3',
];
$responseGen = \Raq\fetchAll($urls)->queryAll(function(QueryFactory $q) {
	return $q->createXmlQuery()->nodes()->each(function(ResponseInterface $r, DomElement $e) {
    	if($e->tagName !== 'fooBar') return $e->tagName;
        return null;
    });
});
// no promise is resolved yet.
foreach($responseGen as $queryResult) {
	// only the promise that is currently accessed is resolved.
    // if the loop is broken out prematurely no search is performed on yet
    // unprocessed values. The promises will be free to be cleaned as $responseGen goes out of scope
    var_dump($queryResult);
}