How guzzle/guzzle works
Guzzle is a PHP HTTP client. The principal workflow is: an application creates a client and issues a PSR-7 request; client configuration and middleware prepare or augment it; a selected transport performs the exchange and returns a response or transfer error. Documented capabilities include sync/async calls, streaming, cookies, authentication, redirects, retries, pooling, and transport abstraction. Some feature modules were not excerpted, so their connections are shown as unverified where appropriate.
Main entry points: Client.php HTTP Client · HandlerStack.php Handler Stack · Utils.php Transport Selection · CookieJar.php Cookie Jar
Components 21
Client API
- HTTP Client
src/Client.php - Client Interface
src/ClientInterface.php - Request Pool
src/Pool.php
Request Behavior
- Handler Stack
src/HandlerStack.php - Authentication
src/AuthMiddleware.php - Body Preparation
src/PrepareBodyMiddleware.php - Redirect Handling
src/RedirectMiddleware.php - Retry Handling
src/RetryMiddleware.php
HTTP Transports
- Transport Selection
src/Utils.php - cURL Transport
src/Handler/CurlHandler.php - Async cURL
src/Handler/CurlMultiHandler.php - PHP Streams
src/Handler/StreamHandler.php
Transfer State
- Cookie Jar
src/Cookie/CookieJar.php - Cookie Parsing
src/Cookie/SetCookie.php - File Cookie Jar
src/Cookie/FileCookieJar.php - Session Cookie Jar
src/Cookie/SessionCookieJar.php - Transport Sharing
src/Handler/CurlShareHandleState.php
Errors and Diagnostics
- Request Errors
src/Exception/RequestException.php - Response Errors
src/Exception/ResponseException.php
Other components
- Application
- HTTP Service
Connections 24
- Application → HTTP Client: creates client
README.md - Application → Client Interface: issues requests
README.md - HTTP Client → Handler Stack: configures handlers
src/Client.php - HTTP Client → Cookie Jar: uses cookies
src/Client.php - HTTP Client → Client Interface: implements
src/Client.php - Handler Stack → Authentication: may compose
- Handler Stack → Body Preparation: may compose
- Handler Stack → Redirect Handling: may compose
- Handler Stack → Retry Handling: may compose
- HTTP Client → Request Pool: supports pooled requests
- Cookie Jar → Cookie Parsing: parses cookies
src/Cookie/CookieJar.php - File Cookie Jar → Cookie Jar: extends jar behavior
src/Cookie/FileCookieJar.php - Session Cookie Jar → Cookie Jar: extends jar behavior
src/Cookie/SessionCookieJar.php - HTTP Client → Transport Selection: selects handler
src/Client.php - Transport Selection → Async cURL: chooses async cURL
src/Utils.php - Transport Selection → cURL Transport: chooses cURL
src/Utils.php - Transport Selection → PHP Streams: chooses streams
src/Utils.php - cURL Transport → HTTP Service: sends HTTP
src/Handler/CurlHandler.php - Async cURL → HTTP Service: sends concurrent HTTP
- PHP Streams → HTTP Service: sends HTTP
- cURL Transport → Transport Sharing: configures sharing
src/Handler/CurlHandler.php - Async cURL → Transport Sharing: configures sharing
src/Handler/CurlMultiHandler.php - HTTP Service → HTTP Client: returns response
README.md - Request Errors → Response Errors: creates response errors
src/Exception/RequestException.php