À 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
HttpClientde 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 :
- Laravel envoie une requête HTTP via une bibliothèque de client HTTP avec un proxy configuré.
- La requête passe par le serveur proxy.
- Le proxy la transmet au serveur de destination.
- Le serveur de destination répond au proxy.
- 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 :
- Envoie une requête
GETàhttps://httpbin.io/ipen utilisant le proxy configuré. - Récupère l’adresse IP de sortie depuis la réponse.
- 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 :

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ù :
protocolest le protocole requis pour se connecter au serveur proxy (par exemple,http,https,socks5)hostest l’adresse IP ou le domaine du serveur proxyportest 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 :
- Créez un tableau contenant plusieurs URL de proxy
- Sélectionnez-en un au hasard avant chaque requête
- 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 :
- Vous devez maintenir un pool de serveurs proxy fiables, ce qui a souvent un coût.
- 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 :
- Proxys de centre de données – 1,300,000+ IP de centre de données.
- Proxys résidentiels – 400M+ IP résidentielles dans plus de 195 pays.
- Proxys ISP – 1,300,000+ IP ISP.
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 :

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

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

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

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

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 :

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 :

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 !