Comment utiliser les proxys dans Laravel : tutoriel 2026

Maîtrisez l’utilisation des proxys dans Laravel, de la configuration simple à l’authentification et la rotation d’IP, pour un scraping web sans blocage et un accès géo.
4 min de lecture
Laravel Proxies blog image

À la fin de ce guide d’intégration de proxy Laravel, vous comprendrez :

  • Ce que sont les proxys et comment ils fonctionnent dans Laravel
  • Quand et pourquoi vous pourriez en avoir besoin
  • Comment configurer un proxy dans votre projet Laravel
  • Comment gérer l’authentification proxy, les problèmes de certificat SSL et la rotation d’IP dans Laravel
  • Comment intégrer un proxy dans le composant HttpClient de Symfony

Plongeons-y !

Qu’est-ce qu’un proxy Laravel ?

Un proxy Laravel agit comme intermédiaire entre votre backend Laravel et un serveur externe. Il vous permet d’acheminer par programmation le trafic de votre serveur via un serveur proxy pour masquer votre adresse IP.

Voici comment un proxy fonctionne dans Laravel :

  1. Laravel envoie une requête HTTP via une bibliothèque de client HTTP avec un proxy configuré.
  2. La requête passe par le serveur proxy.
  3. Le proxy la transmet au serveur de destination.
  4. Le serveur de destination répond au proxy.
  5. Le proxy renvoie ensuite la réponse à Laravel.

En conséquence, le serveur de destination voit la requête provenir de l’IP du proxy, et non de celle de votre serveur Laravel. Ce mécanisme aide à contourner les restrictions géographiques, améliorer l’anonymat et gérer les limites de débit.

Cas d’usage des proxys dans Laravel

Les proxys dans Laravel sont utiles dans de nombreux scénarios, mais ces trois sont les plus courants :

  • Scraping web : Utilisez des proxys pour éviter les bannissements d’IP, les limites de débit ou autres blocages lors de la création d’une API de scraping web. Pour en savoir plus, lisez notre tutoriel sur le scraping web avec Laravel.
  • Contournement des limites de débit sur les API tierces : Faites tourner les IP proxy pour rester dans les quotas d’utilisation des API et éviter la limitation.
  • Accès au contenu géo-restreint : Sélectionnez des serveurs proxy dans des régions spécifiques pour accéder à des services disponibles uniquement dans certains pays.

Pour plus d’exemples, consultez notre guide sur les cas d’usage des données web et des proxys.

Utiliser un proxy dans Laravel : guide étape par étape

Dans cette section, nous montrerons comment intégrer un proxy dans Laravel en utilisant le client HTTP par défaut. Si vous êtes utilisateur du HttpClient de Symfony, ne vous inquiétez pas—nous couvrirons l’intégration de proxy avec cette bibliothèque plus loin dans l’article.

Remarque : Le client HTTP de Laravel est construit sur Guzzle, vous voudrez peut-être consulter notre guide d’intégration de proxy Guzzle.

Pour démontrer l’intégration, nous allons créer un endpoint GET /api/v1/get-ip qui :

  1. Envoie une requête GET à https://httpbin.io/ip en utilisant le proxy configuré.
  2. Récupère l’adresse IP de sortie depuis la réponse.
  3. Renvoie cette IP au client appelant l’endpoint Laravel.

Si tout est configuré correctement, l’IP renvoyée par cette API correspondra à l’IP du proxy.

Commençons !

Étape 1 : Configuration du projet

Si vous avez déjà une application Laravel configurée, vous pouvez ignorer cette étape et passer à l’étape 2.

Sinon, suivez les instructions ci-dessous pour créer un nouveau projet Laravel. Ouvrez votre terminal et exécutez la commande Composer create-command suivante pour initialiser un nouveau projet Laravel :

composer create-project laravel/laravel laravel-proxies-application

Cette commande générera un nouveau projet Laravel dans un dossier nommé laravel-proxies-application. Ouvrez ce dossier dans votre IDE PHP préféré.

À ce stade, le dossier ci-dessus devrait contenir la structure de fichiers Laravel par défaut :

La structure du projet Laravel

Parfait ! Vous avez maintenant un projet Laravel en place.

Étape 2 : Définir l’endpoint API de test

Dans le répertoire du projet, exécutez la commande Artisan suivante pour générer un nouveau contrôleur :

php artisan make:controller IPController

Cela créera un fichier nommé IPController.php dans le répertoire /app/Http/Controllers avec ce contenu par défaut :

<?php

namespace AppHttpControllers;

use IlluminateHttpRequest;

class IPController extends Controller
{
    //
}

Maintenant, ajoutez la méthode getIP() ci-dessous à IPController.php :

public function getIP(): JsonResponse
{
    // envoie une requête GET à l'endpoint "/ip" pour obtenir l'IP du serveur
    $response = Http::get('https://httpbin.io/ip'); 

    // récupère les données de la réponse
    $responseData = $response->json();

    // renvoie les données de la réponse 
    return response()->json($responseData);
}

Cette méthode utilise le client Http de Laravel pour récupérer votre adresse IP depuis https://httpbin.io/ip et la renvoie en JSON.

N’oubliez pas ces deux imports :

use IlluminateHttpJsonResponse;
use IlluminateSupportFacadesHttp;

Puisque vous souhaitez que votre application Laravel offre des API sans état, activez le routage API en utilisant la commande Artisan install:api :

php artisan install:api

Pour exposer cette méthode via un endpoint API, ajoutez la route suivante au fichier routes/api.php :

use AppHttpControllersIPController;

Route::get('/v1/get-ip', [IPController::class, 'getIP']);

Votre nouvel endpoint API sera accessible à :

/api/v1/get-ip

Remarque : Gardez à l’esprit que chaque API Laravel est disponible sous le chemin /api par défaut.

Il est temps de tester l’endpoint /api/v1/get-ip !

Démarrez le serveur de développement Laravel en exécutant :

php artisan serve

Votre serveur devrait maintenant écouter localement sur le port 8000.

Faites une requête GET à l’endpoint /api/v1/get-ip en utilisant cURL :

curl -X GET 'http://localhost:8000/api/v1/get-ip' 

Remarque : Sur Windows, remplacez curl par curl.exe. En savoir plus dans notre guide sur comment envoyer des requêtes GET avec cURL.

Vous devriez obtenir une réponse similaire à :

{
  "origin": "45.89.222.18"
}

La réponse ci-dessus est exactement la même produite par l’endpoint /ip de HttpBin, ce qui confirme que votre API Laravel fonctionne parfaitement. En particulier, l’adresse IP affichée est l’IP publique de votre machine. Ensuite, intégrons un proxy pour masquer cette IP !

Étape 3 : Récupérer un proxy

Pour utiliser un proxy dans votre application Laravel, vous devez d’abord avoir accès à un serveur proxy fonctionnel.

Bien que de nombreux sites web proposent des URL de proxy gratuites, il est important d’être prudent—maintenir une infrastructure de proxy coûte cher. Si un service fournit des proxys gratuitement, demandez-vous comment il les finance. Souvent, la réponse implique des pratiques douteuses comme la collecte de données ou le détournement de trafic.

Remarque : Les proxys gratuits doivent être utilisés strictement à des fins de test ou éducatives—jamais en production.

Si vous avez besoin de proxys fiables, optez pour des fournisseurs réputés qui offrent des essais gratuits ou des plans gratuits limités.

Maintenant, une URL de proxy typique ressemble à ceci :

<protocol>://<host>:<port>

Où :

  • protocol est le protocole requis pour se connecter au serveur proxy (par exemple, http, https, socks5)
  • host est l’adresse IP ou le domaine du serveur proxy
  • port est le port utilisé pour acheminer le trafic

Dans cet exemple, supposons que votre URL de proxy est :

http://66.29.154.103:3128

Stockez-la dans une variable à l’intérieur de la méthode getIP() :

$proxyUrl = 'http://66.29.154.103:3128';

Il est temps de voir comment utiliser un proxy avec Http dans Laravel !

Étape 4 : Intégrer le proxy dans Http

Intégrer un proxy dans Laravel en utilisant le client Http ne nécessite qu’une petite configuration supplémentaire :

$proxyUrl = 'http://66.29.154.103:3128';

$response = Http::withOptions([
    'proxy' => $proxyUrl
])->get('https://httpbin.io/ip');

$responseData = $response->json();

Comme vous pouvez le voir, il vous suffit de passer l’URL du proxy comme option en utilisant la méthode withOptions(). Cela indique au client HTTP de Laravel d’acheminer la requête via le serveur proxy spécifié, en utilisant l’option proxy de Guzzle.

Incroyable ! Intégration du proxy Laravel terminée.

Étape 5 : Assembler le tout

Votre logique API Laravel finale avec l’intégration du proxy devrait maintenant ressembler à ceci :

<?php

namespace AppHttpControllers;

use IlluminateHttpRequest;
use IlluminateHttpJsonResponse;
use IlluminateSupportFacadesHttp;

class IPController extends Controller
{

    public function getIP(): JsonResponse
    {
        // l'URL du serveur proxy
        $proxyUrl = 'http://66.29.154.103:3128'; // remplacez par votre URL de proxy

        // envoie une requête GET à l'endpoint /ip via le serveur proxy
        $response = Http::withOptions([
            'proxy' => $proxyUrl
        ])->get('https://httpbin.io/ip');

        // récupère les données de la réponse
        $responseData = $response->json();

        // renvoie les données de la réponse
        return response()->json($responseData);
    }
}

Testez-le en exécutant Laravel localement :

php artisan serve

Et connectez-vous à nouveau à l’endpoint /api/v1/get-ip :

curl -X GET 'http://localhost:8000/api/v1/get-ip' 

Cette fois, la sortie devrait ressembler à :

{
  "origin": "66.29.154.103"
}

Le champ "origin" affiche l’adresse IP du serveur proxy, confirmant que votre IP réelle est maintenant masquée derrière le proxy.

Avertissement : Les serveurs proxy gratuits sont souvent instables ou éphémères. Au moment où vous essaierez ceci, le proxy d’exemple pourrait ne plus fonctionner. Si nécessaire, remplacez $proxyUrl par un proxy actuellement actif avant de tester.

Remarque : Si vous rencontrez des erreurs SSL lors de la requête, consultez les conseils de dépannage fournis dans la section des cas d’usage avancés ci-dessous.

Cas d’usage avancés

Vous venez d’apprendre les bases de l’intégration de proxy avec Laravel, mais il existe d’autres scénarios plus avancés à considérer.

Authentification proxy

Les proxys premium nécessitent souvent une authentification afin que seuls les utilisateurs autorisés puissent y accéder. Dans ce cas, si vous ne spécifiez pas les bons identifiants, vous obtiendrez cette erreur :

cURL error 56: CONNECT tunnel failed, response 407

L’URL d’un proxy authentifié suit généralement ce format :

<protocol>://<username>:<password>@<host>:<port>

Où username et password sont vos identifiants d’authentification.

La classe Http de Laravel (basée sur Guzzle en interne) prend entièrement en charge les proxys authentifiés. Donc, vous n’avez pas besoin de changer grand-chose. Incluez simplement les identifiants d’authentification directement dans l’URL du proxy :

$proxyUrl = '<protocol>://<username>:<password>@<host>:<port>';

Par exemple :

// proxy authentifié avec nom d'utilisateur et mot de passe
$proxyUrl = 'http://<username>:<password>@<host>:<port>';

$response = Http::withOptions([
    'proxy' => $proxyUrl
])->get('https://httpbin.io/ip');

Remplacez la valeur de $proxyUrl par une URL de proxy authentifié valide.

Http acheminera désormais le trafic vers le serveur proxy authentifié configuré !

Éviter les problèmes de certificat SSL

Lors de la configuration d’un proxy à l’aide du client Http de Laravel, vos requêtes peuvent échouer en raison d’erreurs de vérification de certificat SSL comme :

cURL error 60: SSL certificate problem: self-signed certificate in certificate chain

Cela se produit généralement lorsque le serveur proxy utilise un certificat SSL auto-signé.

Si vous faites confiance au serveur proxy et que vous testez uniquement localement ou dans un environnement sûr, vous pouvez désactiver la vérification SSL comme ceci :

$response = Http::withOptions([
    'proxy' => $proxyUrl,
    'verify' => false, // désactive la vérification du certificat SSL
])->get('https://httpbin.io/ip');

Avertissement : Désactiver la vérification SSL vous expose à des attaques de type man-in-the-middle. Utilisez donc cette option uniquement dans des environnements de confiance.

Sinon, si vous avez le fichier de certificat du serveur proxy (par exemple, proxy-ca.crt), vous pouvez l’utiliser pour la vérification SSL comme ceci :

$response = Http::withOptions([
    'proxy' => $proxyUrl,
    'verify' => storage_path('certs/proxy-ca.crt'), // Chemin vers le bundle CA
])->get('https://httpbin.io/ip');

Assurez-vous que le fichier proxy-ca.crt est stocké dans un répertoire sécurisé et accessible (par exemple, storage/certs/), et que Laravel dispose de l’autorisation de le lire.

Avec l’une ou l’autre méthode en place, l’erreur de vérification SSL causée par le proxy devrait disparaître.

Rotation des proxys

Si vous continuez à utiliser le même serveur proxy de manière répétée, le site web cible est susceptible de finir par détecter et bloquer l’adresse IP de ce proxy. Pour éviter cela, vous pouvez faire tourner vos serveurs proxy—en utilisant un proxy différent pour chaque requête.

Voici les étapes pour faire tourner les proxys dans Laravel :

  1. Créez un tableau contenant plusieurs URL de proxy
  2. Sélectionnez-en un au hasard avant chaque requête
  3. Définissez le proxy sélectionné dans la configuration du client HTTP

Implémentez cela avec ce code :

<?php

namespace AppHttpControllers;

use IlluminateHttpRequest;
use IlluminateHttpJsonResponse;
use IlluminateSupportFacadesHttp;

function getRandomProxyUrl(): string
{
    // une liste d'URL de proxy valides (remplacez par vos URL de proxy)
    $proxies = [
        '<protocol_1>://<proxy_host_1>:<port_1>', 
        // ...
        '<protocol_n>://<proxy_host_n>:<port_n>',
    ];

    // renvoie une URL de proxy choisie aléatoirement dans la liste
    return $proxies[array_rand($proxies)];
}

class IPController extends Controller
{
    public function getIP(): JsonResponse
    {
        // l'URL du serveur proxy
        $proxyUrl = getRandomProxyUrl();
        // envoie une requête GET à l'endpoint /ip via le serveur proxy
        $response = Http::withOptions([
            'proxy' => $proxyUrl
        ])->get('https://httpbin.io/ip');

        // récupère les données de la réponse
        $responseData = $response->json();

        // renvoie les données de la réponse
        return response()->json($responseData);
    }
}

L’extrait ci-dessus montre comment sélectionner aléatoirement un proxy dans une liste pour simuler la rotation de proxy. Bien que cette approche fonctionne, elle présente certains inconvénients :

  1. Vous devez maintenir un pool de serveurs proxy fiables, ce qui a souvent un coût.
  2. Pour une rotation efficace, le pool de proxys doit être suffisamment grand. Sans un grand pool, les mêmes proxys seront utilisés à plusieurs reprises, ce qui peut entraîner la détection et le blocage.

Pour contourner ces limitations, envisagez de profiter du réseau de proxy rotatif de Bright Data. Cette infrastructure fait automatiquement tourner les adresses IP pour vous et vous donne accès à :

  • Plus de 1500 millions d’IP dans 195 pays
  • Un temps de disponibilité élevé et un taux de réussite de 99,9 %

Dans la section suivante, nous vous montrerons comment utiliser les proxys rotatifs de Bright Data avec Laravel.

Utiliser un proxy Bright Data dans Laravel

Bright Data exploite l’un des plus grands réseaux de proxy au monde, soutenant des entreprises du Fortune 500 et 50,000+ clients. Leur réseau de proxy comprend :

Suivez les étapes ci-dessous pour utiliser les proxys résidentiels de Bright Data avec Laravel.

Si vous n’avez pas encore de compte, allez-y et inscrivez-vous à Bright Data. Si vous en avez déjà un, connectez-vous pour accéder à votre tableau de bord utilisateur :

Le tableau de bord Bright Data

Une fois connecté, cliquez sur le bouton “Get proxy products” pour continuer :

Cliquer sur le bouton

Vous serez redirigé vers la page “Proxies & Scraping Infrastructure” :

La page

Dans le tableau, trouvez la ligne “Residential” et cliquez dessus :

Cliquer sur la ligne

Vous serez dirigé vers la page de proxy résidentiel :

La page

Si c’est votre première fois, suivez l’assistant pour configurer le service de proxy selon vos besoins. Pour plus d’assistance, n’hésitez pas à contacter le support 24/7.

Dans l’onglet “Overview”, trouvez l’hôte, le port, le nom d’utilisateur et le mot de passe de votre proxy :

Les identifiants du proxy

Utilisez ces détails pour construire votre URL de proxy :

$proxyUrl = 'http://<brightdata_proxy_username>:<brightdata_proxy_password>@<brightdata_proxy_host>:<brightdata_proxy_port>';

Remplacez les espaces réservés (<brightdata_proxy_username>, <brightdata_proxy_password>, <brightdata_proxy_host>, <brightdata_proxy_port>) par vos identifiants de proxy réels.

Assurez-vous de basculer le paramètre “Off” pour activer le produit proxy, et suivez le reste des instructions pour terminer la configuration :

Cliquer sur le bouton d'activation

Avec votre URL de proxy configurée, vous pouvez maintenant l’intégrer dans Laravel en utilisant le client Http. Voici la logique pour envoyer une requête via le proxy résidentiel rotatif de Bright Data dans Laravel :

public function getIp()
{
    // TODO: remplacez les espaces réservés par les infos de votre proxy Bright Data
    $proxyUrl = 'http://<brightdata_proxy_username>:<brightdata_proxy_password>@<brightdata_proxy_host>:<brightdata_proxy_port>';

    // envoie une requête GET à "/ip" via le proxy
    $response = Http::withOptions([
        'proxy' => $proxyUrl,
    ])->get('https://httpbin.org/ip');

    // récupère les données de la réponse
    $responseData = $response->json();

    return response()->json($responseData);
}

Chaque fois que vous exécutez le script ci-dessus, vous verrez une IP de sortie différente.

La rotation de proxy Laravel n’a jamais été aussi simple avec les proxys à rotation automatique de Bright Data !

[Bonus] Intégration de proxy avec HttpClient de Symfony

Supposons que vous préfériez le composant HttpClient de Symfony au client HTTP par défaut de Laravel, Http.

Suivez les instructions ci-dessous pour implémenter l’intégration de proxy dans HttpClient avec Laravel.

Tout d’abord, vous devez installer le package client HTTP de Symfony via Composer :

composer require symfony/http-client

Ensuite, vous pouvez utiliser le HttpClient de Symfony avec un proxy comme suit :

<?php

namespace AppHttpControllers;

use SymfonyContractsHttpClientHttpClientInterface;
use IlluminateHttpJsonResponse;

class IpController extends Controller
{
    // où stocker l'instance HttpClient
    private $client;

    public function __construct(HttpClientInterface $client)
    {
        // initialise l'instance privée HttpClient
        $this->client = $client;
    }

    public function getIp(): JsonResponse
    {
          // votre URL de proxy
          $proxyUrl = 'http://66.29.154.103:3128'; // remplacez par votre URL de proxy

          // envoie une requête GET à l'endpoint "/ip" via le proxy
          $response = $this->client->request('GET', 'https://httpbin.io/ip', [
              'proxy' => $proxyUrl,
          ]);

          // analyse la réponse JSON et la renvoie
          $responseData = $response->toArray();
          return response()->json($responseData);
    }
}

Cette configuration vous permet d’utiliser le HttpClient de Symfony pour envoyer des requêtes via un proxy.

Conclusion

Dans ce tutoriel d’intégration de proxy, vous avez appris pourquoi les proxys sont importants et comment les utiliser dans Laravel. Nous avons couvert comment configurer facilement des proxys dans Laravel, avec à la fois le client HTTP par défaut de Laravel et le HttpClient de Symfony.

Vous avez également vu pourquoi les services de proxy gratuits peuvent être peu fiables et même risqués. Pour une performance stable, la sécurité et l’évolutivité, vous devez choisir un fournisseur de proxy de confiance. Économisez du temps et de l’énergie et allez directement au meilleur fournisseur de proxy du marché, Bright Data.

Créez un compte et commencez à tester nos proxys dès aujourd’hui !