ForHosting KIT · Outils pour développeurs

Valider un nom de variable d'environnement POSIX

Vérifiez qu'un nom de variable d'environnement est portable avant qu'il ne casse un déploiement : DATABASE_URL est valide, alors qu'un nom qui commence par un chiffre ou contient un tiret échoue en indiquant la règle enfreinte. Gratuit dans votre navigateur.

Gratuit
Fonctionne dans votre navigateur
Sans inscription
Vos données restent sur votre appareil

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Exemple résolu

Si vous saisissez

Texte: DATABASE_URL

Vous obtenez

Nom: DATABASE_URL
Convention: POSIX

Les noms de variables d'environnement paraissent simples, jusqu'à ce qu'un déploiement échoue à cause d'un chiffre initial, d'un tiret, d'un espace ou d'un caractère non portable. Ce validateur contrôle un nom selon la convention POSIX : lettres ASCII, chiffres et traits de soulignement sont admis, mais le premier caractère doit être une lettre ou un trait de soulignement. Un nom conforme reçoit une confirmation claire ; sinon, le message indique la règle enfreinte. Vous pouvez ainsi sécuriser éditeurs, formulaires, contrôles CI et générateurs de configuration.

Ce que le validateur accepte

Un nom portable repose volontairement sur un jeu de caractères restreint. Le premier caractère doit être une lettre ASCII de A à Z ou de a à z, ou un trait de soulignement. Les caractères suivants peuvent également être des chiffres de 0 à 9.

DATABASE_URL, HOME, _INTERNAL_FLAG et API2_TOKEN sont donc conformes. Le validateur examine toute la chaîne sans la corriger, la normaliser ni supprimer ses espaces. Cette rigueur évite qu'un nettoyage silencieux transforme la valeur que vous avez fournie en un autre identifiant.

La casse est conservée et significative : PATH et Path sont deux noms distincts. Le contrôle porte uniquement sur la syntaxe portable ; il ne vérifie pas si la variable existe, est exportée, possède une valeur ou est prise en charge par un logiciel donné. Une réponse positive renvoie le nom inchangé, l'indicateur de validité et une confirmation concise.

Comment les noms incorrects sont expliqués

Chaque faute reçoit une explication adaptée afin que vous puissiez corriger le véritable problème. Une chaîne vide échoue faute de premier caractère. Un chiffre initial enfreint la règle dédiée, même si les chiffres sont autorisés ensuite.

Un tiret, un point, une espace ou une lettre non ASCII en tête est également refusé. Si le début est valide mais qu'un caractère interdit apparaît plus loin, le message précise ce caractère et sa position, comptée à partir de 1. Une affectation telle que NAME=value n'est pas confondue avec un nom : le signe égal est rejeté.

Intégrer le contrôle au développement

Ce contrôle convient partout où un nom est saisi avant que la configuration atteigne un shell ou l'environnement d'un processus. Un formulaire de déploiement peut valider une clé dès son envoi et signaler la règle à respecter. Un générateur peut refuser une clé incorrecte avant de produire un fichier dotenv, un manifeste de conteneur, une définition de service ou une correspondance de secrets CI.

Les linters peuvent appliquer la même règle aux modèles et exemples. L'algorithme n'utilise pas le réseau, ne lit aucun environnement, ne conserve aucune saisie et ne dépend ni de l'heure ni du hasard. Une syntaxe valide ne garantit toutefois pas la compatibilité avec chaque outil, qui peut réserver des préfixes ou imposer des conventions supplémentaires.

Cas d’usage

Valider les paramètres de déploiement

Contrôlez les noms avant d'enregistrer une configuration que l'environnement d'exécution ne pourrait pas exposer correctement.

Sécuriser les générateurs dotenv

Refusez les clés mal formées avant de créer un fichier qui n'échouerait qu'au démarrage de l'application.

Ajouter un contrôle de nommage au CI

Vérifiez modèles et noms documentés avec une règle déterministe pendant les contrôles du dépôt.

Questions fréquentes

Quels caractères sont autorisés ?

Les lettres ASCII, les chiffres et les traits de soulignement sont admis. Le premier caractère doit être une lettre ASCII ou un trait de soulignement.

Un nom peut-il commencer par un chiffre ?

Non. Les chiffres ne sont permis qu'après le premier caractère : 2FA_TOKEN échoue, tandis que TOKEN_2FA réussit.

Le contrôle vérifie-t-il que la variable existe ?

Non. Il valide seulement le nom proposé, sans lire l'environnement ni vérifier une exportation ou une affectation.

Les noms en minuscules sont-ils valides ?

Oui. Les lettres ASCII majuscules et minuscules sont valides, et la casse d'origine est conservée.

L'outil corrige-t-il ou nettoie-t-il un nom invalide ?

Non. Le texte entier est vérifié tel que vous l'avez saisi, sans retirer d'espaces ni réparer de caractères, car un nettoyage silencieux pourrait transformer votre nom en un autre. À la place, l'erreur indique quelle règle a échoué et à quel endroit.

Outils associés

Pour les développeurs — accès API

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

Endpoint

POSThttps://api.kit.forhosting.com/dev/env-var-name-validate

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

Appeler depuis votre stack

curl -X POST https://api.kit.forhosting.com/dev/env-var-name-validate \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"DATABASE_URL"}'

const res = await fetch("https://api.kit.forhosting.com/dev/env-var-name-validate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "text": "DATABASE_URL"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/dev/env-var-name-validate",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "text": "DATABASE_URL"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/dev/env-var-name-validate", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"text":"DATABASE_URL"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"text":"DATABASE_URL"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/dev/env-var-name-validate", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemple de requête

{
  "text": "DATABASE_URL"
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "dev.env_var_name_validate",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

Tarifs

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

Erreurs

HTTP	Code	Signification
`401`	`unauthorized`	Clé API absente ou invalide : vérifiez l’en-tête Authorization.
`402`	`insufficient_balance`	Solde insuffisant : rechargez votre compte pour lancer cette tâche.
`404`	`unknown_type`	Type de tâche inconnu : vérifiez le champ type de votre requête.
`429`	`rate_limited`	Trop de requêtes : ralentissez la cadence, puis réessayez.

Notes techniques

Comment les noms incorrects sont expliqués

Ainsi, API-KEY échoue sur le tiret et API KEY sur l'espace. Les erreurs typées portent le code invalid_input ; les clients API peuvent donc distinguer une donnée à corriger d'une panne interne sans analyser un message de transport.

Intégrer le contrôle au développement

Il fournit donc le même résultat dans le navigateur, les tests et l'API. Une requête API coûte $0.002.

Questions techniques

Les tirets et les points sont-ils autorisés ?

Non. Un tiret, point, espace, signe égal ou autre caractère hors du jeu portable produit invalid_input.

Combien coûte une requête API ?

Chaque requête API coûte $0.002. Le même contrôle déterministe peut aussi s'exécuter dans le navigateur.

Consulter la documentation complète du KIT →

Lancer gratuitement

Exemple résolu

Ce que le validateur accepte

Comment les noms incorrects sont expliqués

Intégrer le contrôle au développement

Cas d’usage

Valider les paramètres de déploiement

Sécuriser les générateurs dotenv

Ajouter un contrôle de nommage au CI

Questions fréquentes

Outils associés

Pour les développeurs — accès API

Endpoint

Appeler depuis votre stack

Exemple de requête

Exemple de réponse

Tarifs

Erreurs

Notes techniques

Comment les noms incorrects sont expliqués

Intégrer le contrôle au développement

Questions techniques

merci