PHPackages                             kelvinzer0/curl-impersonate-php - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [HTTP & Networking](/categories/http)
4. /
5. kelvinzer0/curl-impersonate-php

ActiveLibrary[HTTP & Networking](/categories/http)

kelvinzer0/curl-impersonate-php
===============================

PHP wrapper for curl-impersonate — mimic real browser TLS fingerprints to bypass anti-bot detection

v3.2(2y ago)2555.9k↓46.8%8[3 issues](https://github.com/kelvinzer0/curl-impersonate-php/issues)[2 PRs](https://github.com/kelvinzer0/curl-impersonate-php/pulls)1MITPHPPHP >=5.4.0CI passing

Since Jul 26Pushed 2mo ago3 watchersCompare

[ Source](https://github.com/kelvinzer0/curl-impersonate-php)[ Packagist](https://packagist.org/packages/kelvinzer0/curl-impersonate-php)[ Docs](https://github.com/kelvinzer0/curl-impersonate-php)[ RSS](/packages/kelvinzer0-curl-impersonate-php/feed)WikiDiscussions main Synced 2d ago

READMEChangelog (5)DependenciesVersions (8)Used By (1)

curl-impersonate-php
====================

[](#curl-impersonate-php)

**Stop getting blocked. Start impersonating real browsers.**

[![Latest Version](https://camo.githubusercontent.com/b7b1359cec4493c1e95e2dce4655027e66af67410fa96988d05a789521e50954/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f6b656c76696e7a6572302f6375726c2d696d706572736f6e6174652d7068703f7374796c653d666c61742d73717561726526636f6c6f723d626c7565)](https://github.com/kelvinzer0/curl-impersonate-php/releases)[![CI](https://camo.githubusercontent.com/1231435c3d5ee093a5ed1e14e95b0d8001b192f5e8c1ce97afd795f1de1b1923/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6b656c76696e7a6572302f6375726c2d696d706572736f6e6174652d7068702f63692e796d6c3f7374796c653d666c61742d737175617265266c6162656c3d6275696c64)](https://github.com/kelvinzer0/curl-impersonate-php/actions)[![PHP Version](https://camo.githubusercontent.com/f265e4d6593dbc6590fa3fe11928b5330e90111394e0e4918b3badb07923ddc9/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253345253344372e342d3838393242463f7374796c653d666c61742d737175617265266c6f676f3d706870266c6f676f436f6c6f723d7768697465)](https://php.net)[![License](https://camo.githubusercontent.com/a92c83eac8f613c8ef1e2165b254d0dfab3a2dde78f75bb194dd25331732089f/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6b656c76696e7a6572302f6375726c2d696d706572736f6e6174652d7068703f7374796c653d666c61742d737175617265)](LICENSE)[![Downloads](https://camo.githubusercontent.com/6e37b9b05fe434de4062baad5fd857ac86eb95c5b1af1f7fb57c2a7f3863a569/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6b656c76696e7a6572302f6375726c2d696d706572736f6e6174652d7068703f7374796c653d666c61742d73717561726526636f6c6f723d677265656e)](https://packagist.org/packages/kelvinzer0/curl-impersonate-php)[![Stars](https://camo.githubusercontent.com/d964a1cc47fbb3a4b27b94c7ef00814e3c7c7d25072697c82050a12014cd551b/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f6b656c76696e7a6572302f6375726c2d696d706572736f6e6174652d7068703f7374796c653d736f6369616c)](https://github.com/kelvinzer0/curl-impersonate-php)

PHP wrapper for [curl-impersonate](https://github.com/lwthiker/curl-impersonate) — execute HTTP requests that **mimic real browser TLS fingerprints**, bypassing Cloudflare, Akamai, Datadome, and other anti-bot systems.

[Installation](#installation) · [Quick Start](#quick-start) · [Browser Presets](#browser-presets) · [API](#api) · [FAQ](#faq)

---

Why This Exists
---------------

[](#why-this-exists)

Regular `curl` has a distinct TLS fingerprint. Anti-bot systems detect it instantly.

**curl-impersonate** uses a patched libcurl that produces the **exact same TLS ClientHello** as Chrome, Firefox, or Safari. Your requests become indistinguishable from a real browser.

This library wraps it in a clean PHP API — no shell scripting required.

```
Regular curl    →  TLS fingerprint = "bot"     →  🚫 403 Blocked
curl-impersonate →  TLS fingerprint = "Chrome"  →  ✅ 200 OK

```

Installation
------------

[](#installation)

```
composer require kelvinzer0/curl-impersonate-php
```

### Install curl-impersonate binary

[](#install-curl-impersonate-binary)

```
# Linux x86_64 (v0.6.1)
curl -L https://github.com/lwthiker/curl-impersonate/releases/download/v0.6.1/curl-impersonate-v0.6.1.x86_64-linux-gnu.tar.gz | tar xz
export LD_LIBRARY_PATH="$PWD:$LD_LIBRARY_PATH"

# macOS (Homebrew)
brew install curl-impersonate
```

See [curl-impersonate releases](https://github.com/lwthiker/curl-impersonate/releases) for all builds.

Quick Start
-----------

[](#quick-start)

```