HTTP Proxy

Rationale

Some machines in restricted networks may not access other networks directly.

API: The HttpProxy class

  class HttpProxy extends Object {
    
    /**
     * Constructor
     *
     * @param   string host
     * @param   int port default 8080
     */
    public function __construct($host, $port= 8080) {
      // ...
    }
    
    /**
     * Add a URL pattern to exclude.
     *
     * @param   string pattern
     */
    public function addExclude($pattern) {
      // ...
    }
    
    /**
     * Add a URL pattern to exclude and return this proxy. For use with
     * chained method calls.
     *
     * @param   string pattern
     * @return  peer.http.HttpProxy this object
     */
    public function withExclude($pattern) {
      // ...
    }
  }

API: The HttpConnection class

  class HttpConnection extends Object {
    // ...
    
    /**
     * Set proxy
     *
     * @param   peer.http.HttpProxy proxy
     */
    public function setProxy(HttpProxy $proxy) {
      // ...
    }
    
    // ...
  }

Example

  $conn= new HttpConnection($url);
  $conn->setProxy(create(new HttpProxy($host, $port))
    ->withExclude('localhost')
    ->withExclude('.example.com')
  );
  $response= $this->conn->get();

n/a

n/a

n/a

• Advanced HTTPClient Info: http://www.innovation.ch/java/HTTPClient/advanced_info.html
• Implementing patch http://xp-framework.net/rfc/contrib/rfc0162.diff

friebe, Sun Jun 1 13:56:30 2008

I'm not really happy with the implementation, and it is not testable in an easy fashion. Since the HttpConnection class itself isn't easily testable either and accessing the request (e.g. for logging purposes) is hacky, too (can't be done until is has been sent!), maybe we should rewrite completely within this RFC (thus delaying it longer, though).

<EOF>