PHP code example of hamaadraza / php-impersonate

    
        
<?php
require_once('vendor/autoload.php');

/* Start to develop here. Best regards https://php-download.com/ */

    

hamaadraza / php-impersonate example snippets

Raza\PHPImpersonate\PHPImpersonate;

// Simple GET request
$response = PHPImpersonate::get('https://example.com');
echo $response->body();

// POST request with data
$response = PHPImpersonate::post('https://example.com/api', [
    'username' => 'johndoe',
    'email' => '[email protected]'
]);

// Check the response
if ($response->isSuccess()) {
    $data = $response->json();
    echo "User created with ID: " . $data['id'];
} else {
    echo "Error: " . $response->status();
}

// GET request with optional headers and timeout
PHPImpersonate::get(string $url, array $headers = [], int $timeout = 30): Response

// POST request with optional data, headers and timeout
PHPImpersonate::post(string $url, ?array $data = null, array $headers = [], int $timeout = 30): Response

// PUT request with optional data, headers and timeout
PHPImpersonate::put(string $url, ?array $data = null, array $headers = [], int $timeout = 30): Response

// PATCH request with optional data, headers and timeout 
PHPImpersonate::patch(string $url, ?array $data = null, array $headers = [], int $timeout = 30): Response

// DELETE request with optional headers and timeout
PHPImpersonate::delete(string $url, array $headers = [], int $timeout = 30): Response

// HEAD request with optional headers and timeout
PHPImpersonate::head(string $url, array $headers = [], int $timeout = 30): Response

// Create a client with specific browser and timeout
$client = new PHPImpersonate('chrome107', 30);

// Instance methods
$client->sendGet(string $url, array $headers = []): Response
$client->sendPost(string $url, ?array $data = null, array $headers = []): Response
$client->sendPut(string $url, ?array $data = null, array $headers = []): Response
$client->sendPatch(string $url, ?array $data = null, array $headers = []): Response
$client->sendDelete(string $url, array $headers = []): Response
$client->sendHead(string $url, array $headers = []): Response

// Generic send method
$client->send(Request $request): Response

// Get the HTTP status code
$response->status(): int

// Get the response body as string
$response->body(): string

// Check if the response was successful (status code 200-299)
$response->isSuccess(): bool

// Parse the response body as JSON (throws \JsonException on failure)
$response->json(bool $associative = true, int $depth = 512, int $flags = 0): mixed

// Check whether a header is present (case-insensitive)
$response->hasHeader(string $name): bool

// Get the first value of a header (case-insensitive), or $default when absent
$response->header(string $name, ?string $default = null): ?string

// Get ALL values of a header — use this for Set-Cookie and other repeatable headers
$response->headerAll(string $name): string[]

// Get all headers as a map of name → list of values
$response->headers(): array<string, string[]>

// Serialise to a plain array
$response->toArray(): array

// Dump response details to a string (for logging)
$response->dump(): string

// Print response details and return self (for debugging)
$response->debug(): Response

$contentType = $response->header('Content-Type');         // 'application/json'
$etag        = $response->header('ETag', 'none');         // fallback to 'none'

if ($response->hasHeader('X-Rate-Limit-Remaining')) {
    $remaining = $response->header('X-Rate-Limit-Remaining');
}

$cookies = $response->headerAll('Set-Cookie');
// ['sessionid=abc; Path=/; HttpOnly', 'csrftoken=xyz; Path=/; SameSite=Lax']

foreach ($cookies as $cookie) {
    echo $cookie . "\n";
}

$allHeaders = $response->headers();
// [
//     'Content-Type' => ['application/json'],
//     'Set-Cookie'   => ['sessionid=abc; Path=/; HttpOnly', 'csrftoken=xyz; Path=/'],
//     'Cache-Control'=> ['no-cache, no-store'],
// ]

foreach ($response->headers() as $name => $values) {
    // $values is always an array, even for single-value headers
    foreach ($values as $value) {
        echo "$name: $value\n";
    }
}

// Create a client that mimics Firefox
$client = new PHPImpersonate('firefox135');
$response = $client->sendGet('https://example.com');

// Set a 5-second timeout for this request
$response = PHPImpersonate::get('https://example.com', [], 5);

// Or when creating a client instance
$client = new PHPImpersonate('chrome107', 10); // 10-second timeout

use Raza\PHPImpersonate\PHPImpersonate;

$client = new PHPImpersonate(
    browser: 'chrome136',
    timeout: 30,
    curlOptions: [
        'proxy' => 'http://127.0.0.1:8080',  // HTTP proxy
        'proxy-user' => 'user:password',    // optional authentication
    ]
);

$response = $client->sendGet('https://api.ipify.org?format=json');

echo $response->body();

$client = new PHPImpersonate(
    browser: 'chrome136',
    timeout: 30,
    curlOptions: [
        'proxy' => 'socks5://127.0.0.1:1080',    // SOCKS5 proxy
    ]
);

$client = new PHPImpersonate(
    browser: 'chrome136',
    timeout: 30,
    curlOptions: [
        'proxy' => 'http://proxy.example.com:8080',
        'proxy-user' => 'user:pass',
    ]
);

// GET request through proxy
$response = $client->sendGet('https://example.com');

// POST request through proxy
$response = $client->sendPost('https://example.com/api', [
    'key' => 'value'
]);

// Data will be automatically converted to JSON with correct Content-Type
$data = [
    'title' => 'New Post',
    'body' => 'This is the content',
    'userId' => 1
];

$response = PHPImpersonate::post(
    'https://jsonplaceholder.typicode.com/posts',
    $data,
    ['Content-Type' => 'application/json']
);

$post = $response->json();
echo "Created post with ID: {$post['id']}\n";

try {
    $response = PHPImpersonate::get('https://example.com/nonexistent', [], 5);
    
    if (!$response->isSuccess()) {
        echo "Error: HTTP {$response->status()}\n";
        echo $response->body();
    }
} catch (\Raza\PHPImpersonate\Exception\RequestException $e) {
    echo "Request failed: " . $e->getMessage();
}

// This will be sent as form data
$response = PHPImpersonate::post('https://example.com/api', [
    'username' => 'johndoe',
    'email' => '[email protected]'
]);

// Explicitly specify form data
$response = PHPImpersonate::post('https://example.com/api',
    [
        'username' => 'johndoe',
        'email' => '[email protected]'
    ],
    ['Content-Type' => 'application/x-www-form-urlencoded']
);

// Send data as JSON
$response = PHPImpersonate::post('https://example.com/api',
    [
        'username' => 'johndoe',
        'email' => '[email protected]'
    ],
    ['Content-Type' => 'application/json']
);

bash
composer