L'en-tête HTTPUpgrade, réservé à HTTP/1.1, peut être utilisé pour basculer une connexion client/serveur déjà établie sur un autre protocole (en conservant le même protocole de transport). Un client pourra par exemple utiliser cet en-tête pour demander la mise à niveau de la connexion HTTP/1.1 en HTTP/2 ou le passage d'une connexion HTTP ou HTTPS à une connexion WebSocket.

Description

L'en-têteUpgrade 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êteGET suivante, indiquant les protocoles préférés vers lesquels basculer (ici,exemple/1, puistoto/2) :

GET /index.html HTTP/1.1Host: www.example.comConnection: upgradeUpgrade: exemple/1, toto/2

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

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

1. Renvoyer une réponse avecle statut101 Switching Protocols et qui contient un en-têteUpgrade indiquant le(s) protocole(s) sur le(s)quel(s) basculer. Par exemple :

   http

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

2. Envoyer une réponse à la requête originelleen 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éponse426 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, voirl'article sur le mécanisme de mise à niveau du protocole.

Syntaxe

Connection: upgradeUpgrade: protocol_name[/protocol_version]

Notes :

• L'en-têteConnection doittoujours être envoyé avec la valeurupgrade lorsque l'en-têteUpgrade 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: upgradeUpgrade: un_protocole/1, exemple, un_autre_protocole/2.2

Directives

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.

Exemples

Connection: upgradeUpgrade: HTTP/2.0, SHTTP/1.3, IRC/6.9, RTA/x11

Connection: UpgradeUpgrade: websocket

Spécifications

Compatibilité des navigateurs

Voir aussi

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