A simple PHP Web Scraper

Installs: 2 352 515

Dependents: 117

Stars: 3 326

Watchers: 228

Forks: 453

Open Issues: 36

Language: PHP

v3.1.1 2015-08-29 16:16 UTC


Goutte is a screen scraping and web crawling library for PHP.

Goutte provides a nice API to crawl websites and extract data from the HTML/XML responses.


Goutte depends on PHP 5.5+ and Guzzle 6+.


If you need support for PHP 5.4 or Guzzle 4-5, use Goutte 2.x (latest phar).

If you need support for PHP 5.3 or Guzzle 3, use Goutte 1.x (latest phar).


Add fabpot/goutte as a require dependency in your composer.json file:

composer require fabpot/goutte


Create a Goutte Client instance (which extends Symfony\Component\BrowserKit\Client):

use Goutte\Client;

$client = new Client();

Make requests with the request() method:

// Go to the symfony.com website
$crawler = $client->request('GET', 'http://www.symfony.com/blog/');

The method returns a Crawler object (Symfony\Component\DomCrawler\Crawler).

Fine-tune cURL options:

$client->getClient()->setDefaultOption('config/curl/'.CURLOPT_TIMEOUT, 60);

Click on links:

// Click on the "Security Advisories" link
$link = $crawler->selectLink('Security Advisories')->link();
$crawler = $client->click($link);

Extract data:

// Get the latest post in this category and display the titles
$crawler->filter('h2 > a')->each(function ($node) {
    print $node->text()."\n";

Submit forms:

$crawler = $client->request('GET', 'http://github.com/');
$crawler = $client->click($crawler->selectLink('Sign in')->link());
$form = $crawler->selectButton('Sign in')->form();
$crawler = $client->submit($form, array('login' => 'fabpot', 'password' => 'xxxxxx'));
$crawler->filter('.flash-error')->each(function ($node) {
    print $node->text()."\n";

More Information

Read the documentation of the BrowserKit and DomCrawler Symfony Components for more information about what you can do with Goutte.


Goutte is pronounced goot i.e. it rhymes with boot and not out.

Technical Information

Goutte is a thin wrapper around the following fine PHP libraries:

  • Symfony Components: BrowserKit, CssSelector and DomCrawler;
  • Guzzle HTTP Component.


Goutte is licensed under the MIT license.