Telegram Bot
How to Add a Vary: Accept Header Using PHP
3 min read
The Vary: Accept HTTP response header is used when the content served by your application may vary based on the Accept header sent by the client. This is particularly useful when your server supports content negotiation for different media types, such as JSON, XML, or HTML.
For closely related Vary / caching topics, see Gzip and Vary: Accept-Encoding, cPanel Vary: Accept Header, and How to Specify Vary: Accept-Encoding in Nginx.
You can add the Vary: Accept header dynamically in PHP by using the header() function.
Step-by-Step Guide
Add the Header in PHP
Use the header() function to include the Vary: Accept header in the HTTP response. This ensures that caches recognize that the resource might differ based on the Accept request header.
Example:
<?php
// Add the Vary: Accept header
header("Vary: Accept");
// Optional: Serve content based on the client Accept header
$acceptHeader = $_SERVER['HTTP_ACCEPT'];
if (strpos($acceptHeader, 'application/json') !== false) {
header('Content-Type: application/json');
echo json_encode(['message' => 'This is a JSON response']);
} elseif (strpos($acceptHeader, 'text/xml') !== false) {
header('Content-Type: text/xml');
echo '<?xml version="1.0"?><message>This is an XML response</message>';
} else {
header('Content-Type: text/html');
echo '<html><body><p>This is an HTML response</p></body></html>';
}
?>
When to Use Vary: Accept
You should use this header if:
- Your server or application delivers different representations of a resource (e.g., JSON, XML, or HTML) based on the
Acceptheader in the request. - You want to ensure that caching mechanisms (e.g., CDNs, browsers) store and serve the correct version for each type of
Acceptrequest.
Verify the Header
You can verify the Vary: Accept header using:
- Browser Developer Tools:
- Open the browser developer tools (F12).
- Go to the Network tab.
- Reload the page and inspect the response headers.
- cURL: Run the following command:
curl -I https://yourdomain.com/your-script.phpLook for the Vary: Accept header in the response.
Why Vary: Accept is Important
- Cache Differentiation: Ensures that CDNs, proxies, and browsers store separate versions of the resource based on the
Acceptrequest header. - Content Negotiation: Properly informs caching mechanisms and clients that different representations are available.
- Improved SEO: Search engines like Google use
Varyheaders to index appropriate content versions (e.g., mobile-specific or JSON APIs).
Best Practices
- Use the Header Only When Necessary: Overusing
Varyheaders (e.g.,Vary: Accept, User-Agent) can lead to cache fragmentation and reduced efficiency. - Combine with Proper Cache-Control Headers: Ensure the resource has appropriate caching policies alongside the
Varyheader. - Test Across Clients: Verify that different client requests receive the appropriate response type.
- Document Supported Media Types: Clearly document which
Acceptvalues your application supports for easier debugging and integration.
By adding the Vary: Accept header with PHP, you ensure proper caching and content negotiation for your application, improving performance and compatibility.
USD - United States Dollar
EUR - Euro
GBP - British Pound
CAD - Canadian Dollar
CHF - Swiss Franc
JPY - Japanese Yen
AUD - Australian Dollar
RUB - Russian Ruble
TRY - Turkish Lira
CNY - Chinese Yuan
INR - Indian Rupee
UAH - Ukrainian Hryvnia