# Goutte

PHP

[Goutte](https://github.com/FriendsOfPHP/goutte) is a screen scraping and web crawling library for PHP. Integrating Blackfire with Goutte lets you **profile programmatically** your websites, HTTP APIs, or web services.

## Installation

First, add [Blackfire PHP SDK](sdk#php-sdk-installation) as a dependency on your project and be sure to require Goutte as well:

```bash
composer require fabpot/goutte
```

## Profiling

To profile with Goutte, add the `X-Blackfire-Query` HTTP header before doing any HTTP request you want to profile with Blackfire:

```php
use Goutte\Client as GoutteClient;
use Blackfire\Client as BlackfireClient;

$blackfire = new BlackfireClient();

$client = new GoutteClient();

// as we want to profile the next request, add the Blackfire header
$profileRequest = $blackfire->createRequest('Blog Home');
$client->setHeader('X-Blackfire-Query', $profileRequest->getToken());

$crawler = $client->request('GET', 'https://www.symfony.com/blog/');

// get the profile for the request
$profile = $blackfire->getProfile($profileRequest->getUuid());

$link = $crawler->selectLink('Security Advisories')->link();

// also works before clicking on a link or submitting a form
$client->setHeader('X-Blackfire-Query', $blackfire->createRequest('Security Advisories')->getToken());
$crawler = $client->click($link);
```

> **Caution**
>
> Never re-use a token for different HTTP requests.

If you execute this script, two profiles will be created on your Blackfire account (tests defined in `.blackfire.yaml` will be executed as well if any).

Learn more about [profiling configuration settings](sdk#php-sdk-profile-configuration) in the PHP SDK documentation.