Download the PHP package jerome/fetch-php without Composer

Fetch PHP

Fetch PHP is a modern HTTP client library for PHP that brings JavaScript's fetch API experience to PHP. Built on top of Guzzle, Fetch PHP allows you to write HTTP code with a clean, intuitive JavaScript-like syntax while still maintaining PHP's familiar patterns.

With support for both synchronous and asynchronous requests, a fluent chainable API, and powerful retry mechanics, Fetch PHP streamlines HTTP operations in your PHP applications.

Full documentation can be found here

Key Features

• JavaScript-like Syntax: Write HTTP requests just like you would in JavaScript with the fetch() function and async/await patterns
• Promise-based API: Use familiar .then(), .catch(), and .finally() methods for async operations
• Fluent Interface: Build requests with a clean, chainable API
• Built on Guzzle: Benefit from Guzzle's robust functionality with a more elegant API
• Retry Mechanics: Automatically retry failed requests with exponential backoff
• PHP-style Helper Functions: Includes traditional PHP function helpers (get(), post(), etc.) for those who prefer that style

Why Choose Fetch PHP?

Beyond Guzzle

While Guzzle is a powerful HTTP client, Fetch PHP enhances the experience by providing:

• JavaScript-like API: Enjoy the familiar fetch() API and async/await patterns from JavaScript
• Global client management: Configure once, use everywhere with the global client
• Simplified requests: Make common HTTP requests with less code
• Enhanced error handling: Reliable retry mechanics and clear error information
• Type-safe enums: Use enums for HTTP methods, content types, and status codes

Installation

Requirements: PHP 8.3 or higher

Basic Usage

JavaScript-style API

PHP-style Helpers

Fluent API

Async/Await Pattern

Note: The async functions (async, await, all, race, map, batch, retry) are provided by the jerome/matrix library, which is included as a dependency.

Using Async/Await

Multiple Concurrent Requests with Async/Await

Sequential Requests with Async/Await

Error Handling with Async/Await

Traditional Promise-based Pattern

Advanced Async Usage

Concurrent Requests with Promise Utilities

Controlled Concurrency with Map

Batch Processing

With Retries

Advanced Configuration

Automatic Retries

Fetch PHP automatically retries transient failures with exponential backoff and jitter.

• Default attempts: initial try + 1 retry (configurable)
• Default delay: 100ms base with exponential backoff and jitter
• Retry triggers:
  • Network/connect errors (e.g., timeouts, DNS, connection refused)
  • HTTP status codes such as 408, 429, 500, 502, 503, 504 (customizable)

Configure per-request:

Notes:

• HTTP error statuses do not throw; you receive the response. Retries happen internally when configured.
• Network failures are retried and, if all attempts fail, throw a Fetch\\Exceptions\\RequestException.

Authentication

Proxies

Global Client Configuration

Working with Responses

// Inspect retry-related statuses explicitly if needed if ($response->getStatusCode() === 429) { // Handle rate limit response }

Working with Type-Safe Enums

Error Handling

Timeouts

Control both total request timeout and connection timeout:

If connect_timeout is not provided, it defaults to the timeout value.

Logging and Redaction

When request/response logging is enabled via a logger, sensitive values are redacted:

• Headers: Authorization, X-API-Key, API-Key, X-Auth-Token, Cookie, Set-Cookie
• Options: auth credentials

Logged context includes method, URI, selected options (sanitized), status code, duration, and content length.

License

This project is licensed under the MIT License – see the LICENSE file for full terms.

The MIT License allows you to:

• Use the software for any purpose, including commercial applications
• Modify and distribute the software
• Include it in proprietary software
• Use it without warranty or liability concerns

This permissive license encourages adoption while maintaining attribution requirements.

Contributing

Contributions are welcome! We're currently looking for help with:

• Expanding test coverage
• Improving documentation
• Adding support for additional HTTP features

To contribute:

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/amazing-feature)
3. Commit your Changes (git commit -m 'Add some amazing-feature')
4. Push to the Branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Acknowledgments

• Thanks to Guzzle HTTP for providing the underlying HTTP client
• Thanks to all contributors who have helped improve this package
• Special thanks to the PHP community for their support and feedback