https://github.com/jenssegers/php-proxy

A PHP proxy script with https and post support
https://github.com/jenssegers/php-proxy

Last synced: 13 days ago
JSON representation

A PHP proxy script with https and post support

• Host: GitHub
• URL: https://github.com/jenssegers/php-proxy
• Owner: jenssegers
• Created: 2012-11-12T09:01:22.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2024-02-16T05:14:56.000Z (4 months ago)
• Last Synced: 2024-06-05T21:57:20.591Z (19 days ago)
• Language: PHP
• Homepage: https://jenssegers.com
• Size: 117 KB
• Stars: 929
• Watchers: 41
• Forks: 263
• Open Issues: 27
• Metadata Files:
  • Readme: README.md

Lists

• awesome-stars - php-proxy
• awesome-stars - php-proxy - A PHP proxy script with https and post support (PHP)

README

        
# PHP Proxy

[![Build Status](http://img.shields.io/travis/jenssegers/php-proxy.svg)](https://travis-ci.org/jenssegers/php-proxy) [![Coverage Status](http://img.shields.io/coveralls/jenssegers/php-proxy.svg)](https://coveralls.io/r/jenssegers/php-proxy?branch=master)

This is a HTTP/HTTPS proxy script that forwards requests to a different server and returns the response. The Proxy class uses PSR7 request/response objects as input/output, and uses Guzzle to do the actual HTTP request.

## Installation

Install using composer:

```

composer require jenssegers/proxy

```

## Example

The following example creates a request object, based on the current browser request, and forwards it to `example.com`. The `RemoveEncodingFilter` removes the encoding headers from the original response so that the current webserver can set these correctly.

```php

use Proxy\Proxy;

use Proxy\Adapter\Guzzle\GuzzleAdapter;

use Proxy\Filter\RemoveEncodingFilter;

use Laminas\Diactoros\ServerRequestFactory;

// Create a PSR7 request based on the current browser request.

$request = ServerRequestFactory::fromGlobals();

// Create a guzzle client

$guzzle = new GuzzleHttp\Client();

// Create the proxy instance

$proxy = new Proxy(new GuzzleAdapter($guzzle));

// Add a response filter that removes the encoding headers.

$proxy->filter(new RemoveEncodingFilter());

try {

    // Forward the request and get the response.

    $response = $proxy->forward($request)->to('http://example.com');

    // Output response to the browser.

    (new Laminas\HttpHandlerRunner\Emitter\SapiEmitter)->emit($response);

} catch(\GuzzleHttp\Exception\BadResponseException $e) {

    // Correct way to handle bad responses

    (new Laminas\HttpHandlerRunner\Emitter\SapiEmitter)->emit($e->getResponse());

}

```

## Filters

You can apply filters to the requests and responses using the middleware strategy:

```php

$response = $proxy

	->forward($request)

	->filter(function ($request, $response, $next) {

		// Manipulate the request object.

		$request = $request->withHeader('User-Agent', 'FishBot/1.0');

		// Call the next item in the middleware.

		$response = $next($request, $response);

		// Manipulate the response object.

		$response = $response->withHeader('X-Proxy-Foo', 'Bar');

		return $response;

	})

	->to('http://example.com');

```