<?php

/**

* Requests for PHP, an HTTP library.

*

* @copyright 2012-2023 Requests Contributors

* @license https://github.com/WordPress/Requests/blob/stable/LICENSE ISC

* @link https://github.com/WordPress/Requests

*/

namespace WpOrg\Requests;

use WpOrg\Requests\Hooks;

/**

* Proxy connection interface

*

* Implement this interface to handle proxy settings and authentication

*

* Parameters should be passed via the constructor where possible, as this

* makes it much easier for users to use your provider.

*

* @see \WpOrg\Requests\Hooks

*

* @package Requests\Proxy

* @since 1.6

*/

interface Proxy {

/**

* Register hooks as needed

*

* This method is called in {@see \WpOrg\Requests\Requests::request()} when the user

* has set an instance as the 'auth' option. Use this callback to register all the

* hooks you'll need.

*

* @see \WpOrg\Requests\Hooks::register()

* @param \WpOrg\Requests\Hooks $hooks Hook system

*/

public function register(Hooks $hooks);

}