Add comprehensive PHP proxy examples

proxymeshai · proxymeshai · commit 79923cd6acab · 2026-03-01T15:44:39.000Z
Adds examples for 6 PHP HTTP libraries:
- cURL (native)
- Guzzle
- Symfony HttpClient
- Buzz
- PHP Streams
- Amp HTTP

Includes composer.json, test runner, and updated README with documentation.

Made-with: Cursor
diff --git a/README.md b/README.md
@@ -4,6 +4,7 @@ Example code for using proxy servers in different programming languages. Current
 
 * Python
 * Ruby
+* PHP
 
 ## Python Proxy Examples
 
@@ -71,7 +72,76 @@ python python/run_tests.py requests-proxy-headers httpx-proxy-headers
 
 ## Ruby Proxy Examples
 
-* [requests_proxy.rb](ruby/requests_proxy.rb) - Ruby HTTP with proxy, from [rpolley](https://github.com/rpolley)
+**Installation:**
+
+```bash
+cd ruby
+bundle install
+```
+
+**Running Examples:**
+
+```bash
+# Required: Set your proxy URL
+export PROXY_URL='http://user:pass@proxy.example.com:8080'
+
+# Run a single example
+ruby ruby/faraday_proxy.rb
+
+# Run all examples as tests
+ruby ruby/run_tests.rb
+```
+
+**Examples:**
+
+| Library | Example | Description |
+|---------|---------|-------------|
+| [Net::HTTP](https://ruby-doc.org/stdlib/libdoc/net/http/rdoc/Net/HTTP.html) | [net_http_proxy.rb](ruby/net_http_proxy.rb) | Ruby standard library HTTP client |
+| [Faraday](https://lostisland.github.io/faraday/) | [faraday_proxy.rb](ruby/faraday_proxy.rb) | HTTP client with middleware support |
+| [HTTParty](https://github.com/jnunemaker/httparty) | [httparty_proxy.rb](ruby/httparty_proxy.rb) | Makes HTTP fun again |
+| [RestClient](https://github.com/rest-client/rest-client) | [rest_client_proxy.rb](ruby/rest_client_proxy.rb) | Simple REST client |
+| [Typhoeus](https://typhoeus.github.io/) | [typhoeus_proxy.rb](ruby/typhoeus_proxy.rb) | Fast HTTP client (libcurl wrapper) |
+| [HTTP.rb](https://github.com/httprb/http) | [http_rb_proxy.rb](ruby/http_rb_proxy.rb) | Simple Ruby DSL for HTTP |
+| [Excon](https://github.com/excon/excon) | [excon_proxy.rb](ruby/excon_proxy.rb) | Fast, simple HTTP(S) client |
+| [HTTPClient](https://github.com/nahi/httpclient) | [httpclient_proxy.rb](ruby/httpclient_proxy.rb) | LWP-like HTTP client |
+| [Mechanize](https://github.com/sparklemotion/mechanize) | [mechanize_proxy.rb](ruby/mechanize_proxy.rb) | Web automation library |
+
+> **Note:** See [ruby-proxy-headers](https://github.com/proxymeshai/ruby-proxy-headers) for extensions that add custom proxy header support.
+
+## PHP Proxy Examples
+
+**Installation:**
+
+```bash
+cd php
+composer install
+```
+
+**Running Examples:**
+
+```bash
+# Required: Set your proxy URL
+export PROXY_URL='http://user:pass@proxy.example.com:8080'
+
+# Run a single example
+php php/guzzle_proxy.php
+
+# Run all examples as tests
+php php/run_tests.php
+```
+
+**Examples:**
+
+| Library | Example | Description |
+|---------|---------|-------------|
+| [cURL](https://www.php.net/manual/en/book.curl.php) | [curl_proxy.php](php/curl_proxy.php) | PHP's built-in HTTP client (libcurl) |
+| [Guzzle](https://docs.guzzlephp.org/) | [guzzle_proxy.php](php/guzzle_proxy.php) | Most popular PHP HTTP client |
+| [Symfony HttpClient](https://symfony.com/doc/current/http_client.html) | [symfony_http_client_proxy.php](php/symfony_http_client_proxy.php) | Modern PSR-18 HTTP client |
+| [Buzz](https://github.com/kriswallsmith/Buzz) | [buzz_proxy.php](php/buzz_proxy.php) | Simple PSR-18 HTTP client |
+| [PHP Streams](https://www.php.net/manual/en/book.stream.php) | [streams_proxy.php](php/streams_proxy.php) | Built-in PHP streams (file_get_contents) |
+| [Amp HTTP](https://amphp.org/http-client) | [amphp_proxy.php](php/amphp_proxy.php) | Async HTTP client |
+
+> **Note:** See [php-proxy-headers](https://github.com/proxymeshai/php-proxy-headers) for extensions that add custom proxy header support.
 
 ## Documentation
 
diff --git a/php/amphp_proxy.php b/php/amphp_proxy.php
@@ -0,0 +1,50 @@
+#!/usr/bin/env php
+<?php
+/**
+ * Amp HTTP Client with proxy example.
+ *
+ * Configuration via environment variables:
+ *   PROXY_URL  - Proxy URL (required), e.g., http://user:pass@proxy:8080
+ *   TEST_URL   - URL to request (default: https://api.ipify.org?format=json)
+ *
+ * Amp HTTP Client is an async HTTP client for PHP. It supports proxies
+ * but does NOT support custom CONNECT headers or reading proxy response headers.
+ */
+
+require_once __DIR__ . '/vendor/autoload.php';
+
+use Amp\Http\Client\HttpClientBuilder;
+use Amp\Http\Client\Request;
+use Amp\Http\Tunnel\Http1TunnelConnector;
+use Amp\Socket\SocketAddress;
+
+$proxyUrl = getenv('PROXY_URL') ?: getenv('HTTPS_PROXY');
+if (!$proxyUrl) {
+    fwrite(STDERR, "Error: Set PROXY_URL environment variable\n");
+    exit(1);
+}
+
+$testUrl = getenv('TEST_URL') ?: 'https://api.ipify.org?format=json';
+
+$parsedProxy = parse_url($proxyUrl);
+$proxyHost = $parsedProxy['host'];
+$proxyPort = $parsedProxy['port'] ?? 8080;
+
+try {
+    $connector = new Http1TunnelConnector(
+        new SocketAddress($proxyHost, $proxyPort)
+    );
+
+    $client = (new HttpClientBuilder())
+        ->usingPool($connector)
+        ->build();
+
+    $request = new Request($testUrl);
+    $response = $client->request($request);
+
+    echo "Status: " . $response->getStatus() . "\n";
+    echo "Body: " . $response->getBody()->buffer() . "\n";
+} catch (Exception $e) {
+    fwrite(STDERR, "Error: " . $e->getMessage() . "\n");
+    exit(1);
+}
diff --git a/php/buzz_proxy.php b/php/buzz_proxy.php
@@ -0,0 +1,44 @@
+#!/usr/bin/env php
+<?php
+/**
+ * Buzz with proxy example.
+ *
+ * Configuration via environment variables:
+ *   PROXY_URL  - Proxy URL (required), e.g., http://user:pass@proxy:8080
+ *   TEST_URL   - URL to request (default: https://api.ipify.org?format=json)
+ *
+ * Buzz is a simple PSR-18 HTTP client. It supports proxies but does NOT
+ * support custom CONNECT headers or reading proxy response headers.
+ */
+
+require_once __DIR__ . '/vendor/autoload.php';
+
+use Buzz\Browser;
+use Buzz\Client\Curl;
+use Nyholm\Psr7\Factory\Psr17Factory;
+
+$proxyUrl = getenv('PROXY_URL') ?: getenv('HTTPS_PROXY');
+if (!$proxyUrl) {
+    fwrite(STDERR, "Error: Set PROXY_URL environment variable\n");
+    exit(1);
+}
+
+$testUrl = getenv('TEST_URL') ?: 'https://api.ipify.org?format=json';
+
+try {
+    $psr17Factory = new Psr17Factory();
+    
+    $client = new Curl($psr17Factory, [
+        'proxy' => $proxyUrl,
+        'timeout' => 30,
+    ]);
+    
+    $browser = new Browser($client, $psr17Factory);
+    $response = $browser->get($testUrl);
+
+    echo "Status: " . $response->getStatusCode() . "\n";
+    echo "Body: " . $response->getBody() . "\n";
+} catch (Exception $e) {
+    fwrite(STDERR, "Error: " . $e->getMessage() . "\n");
+    exit(1);
+}
diff --git a/php/composer.json b/php/composer.json
@@ -0,0 +1,23 @@
+{
+    "name": "proxymesh/proxy-examples-php",
+    "description": "PHP proxy usage examples",
+    "type": "project",
+    "license": "MIT",
+    "require": {
+        "php": ">=8.1",
+        "guzzlehttp/guzzle": "^7.8",
+        "symfony/http-client": "^7.0",
+        "php-http/guzzle7-adapter": "^1.0",
+        "nyholm/psr7": "^1.8",
+        "kriswallsmith/buzz": "^1.2",
+        "amphp/http-client": "^5.0"
+    },
+    "autoload": {
+        "psr-4": {
+            "ProxyExamples\\": "src/"
+        }
+    },
+    "scripts": {
+        "test": "php run_tests.php"
+    }
+}
diff --git a/php/curl_proxy.php b/php/curl_proxy.php
@@ -0,0 +1,46 @@
+#!/usr/bin/env php
+<?php
+/**
+ * cURL with proxy example.
+ *
+ * Configuration via environment variables:
+ *   PROXY_URL  - Proxy URL (required), e.g., http://user:pass@proxy:8080
+ *   TEST_URL   - URL to request (default: https://api.ipify.org?format=json)
+ *
+ * cURL is PHP's built-in HTTP client. It supports proxies and has the BEST
+ * potential for custom proxy headers via CURLOPT_PROXYHEADER (PHP 7.0.7+).
+ * However, reading proxy CONNECT response headers is still limited.
+ */
+
+$proxyUrl = getenv('PROXY_URL') ?: getenv('HTTPS_PROXY');
+if (!$proxyUrl) {
+    fwrite(STDERR, "Error: Set PROXY_URL environment variable\n");
+    exit(1);
+}
+
+$testUrl = getenv('TEST_URL') ?: 'https://api.ipify.org?format=json';
+
+$ch = curl_init();
+
+curl_setopt_array($ch, [
+    CURLOPT_URL => $testUrl,
+    CURLOPT_PROXY => $proxyUrl,
+    CURLOPT_RETURNTRANSFER => true,
+    CURLOPT_FOLLOWLOCATION => true,
+    CURLOPT_SSL_VERIFYPEER => true,
+    CURLOPT_TIMEOUT => 30,
+]);
+
+$response = curl_exec($ch);
+
+if (curl_errno($ch)) {
+    fwrite(STDERR, "Error: " . curl_error($ch) . "\n");
+    curl_close($ch);
+    exit(1);
+}
+
+$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
+curl_close($ch);
+
+echo "Status: {$httpCode}\n";
+echo "Body: {$response}\n";
diff --git a/php/guzzle_proxy.php b/php/guzzle_proxy.php
@@ -0,0 +1,39 @@
+#!/usr/bin/env php
+<?php
+/**
+ * Guzzle with proxy example.
+ *
+ * Configuration via environment variables:
+ *   PROXY_URL  - Proxy URL (required), e.g., http://user:pass@proxy:8080
+ *   TEST_URL   - URL to request (default: https://api.ipify.org?format=json)
+ *
+ * Guzzle is the most popular PHP HTTP client. It supports proxies but does NOT
+ * support sending custom headers during HTTPS CONNECT or reading proxy response headers.
+ */
+
+require_once __DIR__ . '/vendor/autoload.php';
+
+use GuzzleHttp\Client;
+
+$proxyUrl = getenv('PROXY_URL') ?: getenv('HTTPS_PROXY');
+if (!$proxyUrl) {
+    fwrite(STDERR, "Error: Set PROXY_URL environment variable\n");
+    exit(1);
+}
+
+$testUrl = getenv('TEST_URL') ?: 'https://api.ipify.org?format=json';
+
+try {
+    $client = new Client([
+        'proxy' => $proxyUrl,
+        'timeout' => 30,
+    ]);
+
+    $response = $client->get($testUrl);
+
+    echo "Status: " . $response->getStatusCode() . "\n";
+    echo "Body: " . $response->getBody() . "\n";
+} catch (Exception $e) {
+    fwrite(STDERR, "Error: " . $e->getMessage() . "\n");
+    exit(1);
+}
diff --git a/php/run_tests.php b/php/run_tests.php
diff --git a/php/streams_proxy.php b/php/streams_proxy.php
diff --git a/php/symfony_http_client_proxy.php b/php/symfony_http_client_proxy.php
