Vary:

Syntaxe

Paramètres

Description

Ce champ d'entête permet d'indiquer de quel manière les entêtes de requêtes future sont associés pour décider si une réponse en cache à la possibilité d'être réutilisée plutôt que de solliciter à nouveau le serveur d'origine.

Remarques

• Le champ d'entête Vary: dans une réponse décrit quelles parties d'un message de requête, à part la méthode, le champ d'entête Host: et la cible de la requête, peuvent influencer le processus du serveur d'origine pour sélectionner et représenter cette réponse. La valeur se compose d'un astérisque unique («*») ou d'une liste de noms de champ d'entête (insensible à la casse).
• Une valeur de champ Vary: de «*» indique que tout ce qui concerne la requête peut jouer un rôle dans la sélection de la représentation de la réponse, y compris éventuellement des éléments en dehors de la syntaxe du message (par exemple, l'adresse réseau du client). Un destinataire ne pourra pas déterminer si cette réponse est appropriée pour une demande ultérieure sans transmettre la demande au serveur d'origine. Un proxy ne doit pas générer un champ Vary: avec une valeur «*».
• Une valeur de champ Vary: composée d'une liste de noms séparés par des virgules indique que les champs d'entête de requête nommés, appelés champs d'entête de sélection, peuvent jouer un rôle dans la sélection de la représentation. Les champs d'entête de sélection potentiels ne sont pas limités à ceux définis par cette spécification.
• Un serveur d'origine peut envoyer Vary: avec une liste de champs à deux fins : d'une part, pour informer les destinataires du cache qu'ils ne doivent pas utiliser cette réponse pour satisfaire une requête ultérieure à moins que la demande ultérieure n'ait les mêmes valeurs pour les champs listés que la demande d'origine. En d'autres termes, Vary étend la clef de cache requise pour faire correspondre une nouvelle requête à l'entrée de cache entreposée. D'autre part, pour informer les destinataires des agents utilisateurs que cette réponse est sujette à négociation de contenu et qu'une représentation différente peut être envoyée dans une demande ultérieure si des paramètres supplémentaires sont fournis dans les champs d'entête répertoriés (négociation proactive).
• Un serveur d'origine Devrait envoyer un champ d'entête Vary: lorsque son algorithme de sélection d'une représentation varie en fonction d'aspects du message de requête autres que la méthode et la cible de la requête, à moins que la variance ne puisse pas être franchie ou que le serveur d'origine ait été délibérément configuré pour empêcher la transparence du cache. Par exemple, il n'est pas nécessaire d'envoyer le nom du champ d'autorisation dans Vary: car la réutilisation entre les utilisateurs est limitée par la définition du champ. De même, un serveur d'origine peut utiliser des directives Cache-Control: pour supplanter Vary: s'il considère que la variance est moins importante que le coût de performance de l'impact de Vary: sur la mise en cache.