Ce que les racines indiquent à un serveur

Votre serveur s’exécute comme un processus indépendant et ne peut donc pas voir directement le projet de l’utilisateur. Le client doit lui indiquer quels dossiers sont accessibles. Cette indication s’appelle une racine. 🧭

Une racine est un emplacement unique dans lequel le client indique que votre serveur peut travailler, généralement un dossier de projet. Elle marque la limite de la zone à laquelle vous devriez accéder.

La plupart des racines sont des URI file:// qui pointent vers un répertoire sur le disque. Le schéma indique clairement qu’il s’agit d’un dossier local, et non d’une adresse web.

Chaque racine peut porter un nom facultatif, une courte étiquette comme « Mon application ». Ce nom est destiné aux humains : les journaux et les invites restent lisibles au lieu d’afficher des chemins bruts.

Un client peut exposer plusieurs racines à la fois, par exemple un dossier de code et un dossier de documentation. Votre serveur doit considérer cette liste comme l’ensemble complet des emplacements auxquels il peut accéder.

Les racines fournissent des indications et ne sont pas imposées strictement par le protocole. Elles vous indiquent où vous concentrer, mais c’est à vous de rester réellement à l’intérieur de ces limites. ✋

Les racines permettent à l’utilisateur de dire : « travaillez ici, nulle part ailleurs ». Cette délimitation empêche un serveur d’explorer des fichiers privés très éloignés du projet que l’utilisateur a réellement ouvert.

Le client détermine ce qui constitue une racine, souvent à partir du dossier de l’espace de travail ouvert par l’utilisateur. Votre serveur ne définit jamais ses propres racines ; il lit uniquement celles qui lui sont fournies.

Les racines ne sont pas figées. Si l’utilisateur ouvre un nouveau dossier, l’ensemble change, et un client compatible peut informer votre serveur que la liste a été mise à jour.

Les racines sont une fonctionnalité facultative du client. Certains hôtes les proposent, d’autres non. Un serveur bien conçu fonctionne donc correctement que la liste soit complète ou vide.

Sur le réseau, une entrée de racine est minuscule : seulement un uri et un nom facultatif. Cette structure simple suffit à votre serveur pour savoir où il peut fonctionner.

Assurez-vous que le rôle d’une racine est clair.

Vous avez appris qu’une racine est un emplacement fourni par le client, souvent un dossier file:// avec un nom facultatif, qui délimite l’endroit où votre serveur doit travailler. Le client gère la liste, et celle-ci peut changer. 🎯