xparse/parser

Parser client

Parser

, _(*1)

Parser client, _(*2)

Install

Via Composer, _(*3)

``` bash $ composer require xparse/parser, <sub>(*4)</sub>

## Usage

``` php
  $parser = new \Xparse\Parser\Parser();
  $title = $parser->get('http://funivan.com')->content('//*[@class="entry-title"]/a');
  print_r($title);

Using with custom Middleware

If you are using custom Guzzle Middleware and it doesn't send real requests, in order to get last effective url you need to set it to response X-GUZZLE-EFFECTIVE-URL header manually., <sub>(*5)</sub>

Here is an example of __invoke() method in your custom Middleware, <sub>(*6)</sub>

``` php public function __invoke(callable $handler) : \Closure { return function (RequestInterface $request, array $options) use ($handler) {, <sub>(*7)</sub>

  # some code

  return $handler($request, $options)->then(function (ResponseInterface $response) use ($request) {

    $response = $response->withHeader('X-GUZZLE-EFFECTIVE-URL', $request->getUri());

    # some code

    return $response;
  });
};

}, <sub>(*8)</sub>

# Recursive Parser

Recursive Parser allows you to parse website pages recursively.
You need to pass link from where to start and set next page expression (xPath, css, etc).

## Basic Usage

Try to find all links to the repositories on github. Our query will be `xparse`.
With recursive pagination we can traverse all pagination links and process each resulting page to fetch repositories links.

```php
  use Xparse\Parser\Parser;
  use Xparse\Parser\RecursiveParser;

  # init Parser
  $parser = new Parser();

  # set expression to pagination links and initial page url
  $pages = new RecursiveParser(
       $parser,
       ["//*[@class='pagination']//a/@href"],
       ['https://github.com/search?q=xparse']
  );

  $allLinks = [];
  foreach($pages as $page){
    # set expression to fetch repository links
    $adsList = $page->value("//*[@class='repo-list-name']//a/@href")->all();
    # merge and remove duplicates
    $allLinks = array_values(array_unique(array_merge($allLinks, $adsList)));
  }
  print_r($allLinks);

Testing

bash ./vendor/bin/phpunit, <sub>(*9)</sub>

Contributing

Please see CONTRIBUTING for details., <sub>(*10)</sub>

Credits

• funivan
• All Contributors

License

The MIT License (MIT). Please see License File for more information., <sub>(*11)</sub>