#NAME

Mojo::UserAgent::Proxy - User agent proxy manager

#SYNOPSIS

use Mojo::UserAgent::Proxy;

my $proxy = Mojo::UserAgent::Proxy->new;
$proxy->detect;
say $proxy->http;

#DESCRIPTION

Mojo::UserAgent::Proxy manages proxy servers for Mojo::UserAgent.

#ATTRIBUTES

Mojo::UserAgent::Proxy implements the following attributes.

#http

my $http = $proxy->http;
$proxy   = $proxy->http('socks://sri:secret@127.0.0.1:8080');

Proxy server to use for HTTP and WebSocket requests.

#https

my $https = $proxy->https;
$proxy    = $proxy->https('http://sri:secret@127.0.0.1:8080');

Proxy server to use for HTTPS and WebSocket requests.

#not

my $not = $proxy->not;
$proxy  = $proxy->not(['localhost', 'intranet.mojolicious.org']);

Domains that don't require a proxy server to be used.

#METHODS

Mojo::UserAgent::Proxy inherits all methods from Mojo::Base and implements the following new ones.

#detect

$proxy = $proxy->detect;

Check environment variables HTTP_PROXY, http_proxy, HTTPS_PROXY, https_proxy, NO_PROXY and no_proxy for proxy information. Automatic proxy detection can be enabled with the MOJO_PROXY environment variable.

#is_needed

my $bool = $proxy->is_needed('intranet.example.com');

Check if request for domain would use a proxy server.

#prepare

$proxy->prepare(Mojo::Transaction::HTTP->new);

Prepare proxy server information for transaction.

CONTENTS