Guides

PHP 8.3+

Use the guides to learn the library from installation through advanced integrations. The public API is described in the API reference.

Getting started

• Installation and requirements
• Quickstart

Core usage

• Making requests
• Global helper functions
• Working with responses
• HTTP enums
• Authentication
• Error handling

Advanced features

• Async promises and Matrix 4
• Promise helpers
• Retries
• HTTP caching
• Request and response validation
• Middleware
• Lifecycle events
• Streaming and SSE
• File uploads
• HTTP/2 and legacy pool APIs
• Logging
• Debugging and profiling
• Custom clients and transports
• Testing with fakes
• Architecture
• Troubleshooting
• Upgrading and compatibility

Limitations

• Async I/O requires cURL multi or an explicitly injected loop-compatible transport. A synchronous request wrapped in Matrix async() still blocks.
• Streaming is synchronous, consumes the underlying stream, and bypasses the cache and middleware pipeline.
• Validation requires optional adapters; OpenAPI support is limited to 3.0.x.