phprivoxy / proxy
Core library for HTTP/HTTPS proxy building.
Requires
- php: >=8.1
- phprivoxy/core: ^0.9.11
- phprivoxy/x509: >=0.8.2
- psr/http-message: >=2.0
- psr/http-server-handler: >=1.0
- workerman/psr7: >=2.0
Requires (Dev)
- guzzlehttp/guzzle: ^7.8
- phprivoxy/relay: >=2.1.5
README
Core library for HTTP/HTTPS proxy building.
This PHP package based on Workerman framework (https://github.com/walkor/workerman) and will be useful for custom proxy servers creation.
Requirements
- PHP >= 8.1
Installation
Using composer (recommended)
composer create phprivoxy/proxy
Simple transparent proxy sample
$handler = new PHPrivoxy\Proxy\Transparent(); new PHPrivoxy\Core\Server($handler);// By default, it listen all connections on 8080 port.
Configure your browser to work through a proxy server with the IP address 127.0.0.1 and port 8080.
Try to open any site on HTTP or HTTPS protocols. As sample, try to open https://php.net, https://google.com, https://microsoft.com.
This sample you also may find at "tests" directory.
Just run it:
php tests/transparent.php start
Simple SSL MITM (Man In The Middle) proxy sample
use Psr\Http\Server\MiddlewareInterface; use Psr\Http\Server\RequestHandlerInterface; use Psr\Http\Message\ServerRequestInterface; use Psr\Http\Message\ResponseInterface; class HttpClientMiddleware implements MiddlewareInterface { public function process(ServerRequestInterface $request, RequestHandlerInterface $handler): ResponseInterface { $client = new GuzzleHttp\Client(); try { $response = $client->send($request, ['allow_redirects' => false]); } catch (GuzzleHttp\Exception\ConnectException $e) { // Do something } catch (GuzzleHttp\Exception\BadResponseException $e) { return $e->getResponse(); } return $response; } } $httpClientMiddleware = new HttpClientMiddleware(); $queue = [$httpClientMiddleware]; $psr15handler = new Relay\Relay($queue); $tcpHandler = new PHPrivoxy\Proxy\MITM($psr15handler); $processes = 6; // Default 1. new PHPrivoxy\Core\Server($tcpHandler, $processes);// By default, it listen all connections on 8080 port.
This sample you also may find at "tests" directory.
Just run it:
php tests/mitm.php start
On first run it create a self-signed SSL root certificate in CA subdirectory. Add this self-signed CA certificate in your browser trusted certificates!
For each site PHPrivoxy\Proxy\MITM will generate self-signed certificate in "certificates" subdirectory.
In this sample, we use simple PSR-15 compatible HttpClientMiddleware for site downloading. You also may add your own PSR-15 compatible Middlewares in queue for PSR-15 handler (modified Relay\Relay in this sample).
License
MIT License See LICENSE