Upgrade

L'en-tête Upgrade pourra être utilisé par les clients pour inviter un serveur à basculer sur l'un des protocoles indiqués dans na liste triée par ordre de préférence décroissant.

Un client pourra par exemple envoyer la requête GET suivante, indiquant les protocoles préférés vers lesquels basculer (ici, exemple/1, puis toto/2) :

GET /index.html HTTP/1.1
Host: www.example.com
Connection: upgrade
Upgrade: exemple/1, toto/2

Le serveur est libre d'ignorer la requête et répondre alors comme si l'en-tête Upgrade n'avait pas été envoyé (par exemple avec un statut 200 OK).

Si le serveur décide de mettre à niveau la connexion, il doit :

1. Renvoyer une réponse avec le statut 101 Switching Protocols et qui contient un en-tête Upgrade indiquant le(s) protocole(s) sur le(s)quel(s) basculer. Par exemple :

   http

   HTTP/1.1 101 Switching Protocols
   Upgrade: toto/2
   Connection: Upgrade
   

2. Envoyer une réponse à la requête originelle en utilisant le nouveau protocole (le serveur ne peut basculer sur un protocole que s'il est en mesure de répondre à la requête originelle avec celui-ci).

Un serveur pourra également envoyer cet en-tête lors d'une réponse 426 Upgrade Required pour indiquer que le serveur ne traitera pas la requête avec le protocole actuel, mais pourrait le faire si le protocole était changé. Le client peut alors initier un changement de protocole comme vu ci-avant.

Pour plus de détails et d'exemples, voir l'article sur le mécanisme de mise à niveau du protocole.

Connection: upgrade
Upgrade: protocol_name[/protocol_version]

Notes :

• L'en-tête Connection doit toujours être envoyé avec la valeur upgrade lorsque l'en-tête Upgrade est envoyé.
• Les protocoles indiqués en valeurs forment une liste, séparée par des virgules, et triée par ordre de préférence décroissant. La version du protocole est optionnelle. Par exemple :

Connection: upgrade
Upgrade: un_protocole/1, exemple, un_autre_protocole/2.2

Une liste de noms de protocoles (avec une version optionnelle), séparés par des virgules. La liste est triée par ordre de préférence décroissant.

• Mécanisme de mise à niveau du protocole
• 101 Switching Protocol
• 426 Upgrade Required
• Connection