param bool $replace Whether to replace the actual value or not (true by default)
public function setVary(string|array $headers, bool $replace = true): static
public function setVary(string|array $headers, bool $replace = true): static
{
$this->headers->set('Vary', $headers, $replace);
return $this;
}
Dans Symfony, la méthode setVary() de la classe Symfony\Component\HttpFoundation\Response est utilisée pour définir l'en-tête HTTP Vary pour une réponse.
Imaginez un serveur qui renvoie différentes versions d'une page web en fonction de l'en-tête User-Agent (par exemple, une version mobile et une version de bureau). Le serveur doit inclure Vary: User-Agent dans sa réponse. Cela garantit que les caches mettent en cache séparément les versions mobile et de bureau, et renvoient la version correcte en fonction du navigateur de l'utilisateur.
Exemple 1 : Définir un seul en-tête Vary
use Symfony\Component\HttpFoundation\Response;
$response = new Response();
$response->setContent("Contenu de la réponse.");
// Définir l'en-tête Vary pour indiquer que la réponse varie en fonction de l'en-tête User-Agent
$response->setVary('User-Agent');
// En-tête Vary résultant : Vary: User-Agent
Exemple 2 : Définir plusieurs en-têtes Vary
use Symfony\Component\HttpFoundation\Response;
$response = new Response();
$response->setContent("Contenu de la réponse.");
// Définir l'en-tête Vary pour indiquer que la réponse varie en fonction des en-têtes User-Agent et Accept-Language
$response->setVary(['User-Agent', 'Accept-Language']);
// En-tête Vary résultant : Vary: User-Agent, Accept-Language
Exemple 3 : Ajouter des en-têtes Vary à un en-tête Vary existant
use Symfony\Component\HttpFoundation\Response;
$response = new Response();
$response->setContent("Contenu de la réponse.");
$response->setVary('User-Agent'); // Définit initialement Vary: User-Agent
$response->setVary('Accept-Encoding'); // Ajoute Accept-Encoding
// En-tête Vary résultant : Vary: User-Agent, Accept-Encoding
$response->setVary(['Accept-Language', 'Cookie']);
//En-tête Vary résultant : Vary: User-Agent, Accept-Encoding, Accept-Language, CookiePowered by Froala Editor