Le Base64 réécrit n’importe quelles données (texte, image, fichier) avec seulement 64 caractères sans risque : lettres, chiffres, « + » et « / ». Il sert partout où un canal ne transporte que du texte : pièces jointes d’e-mails, images intégrées dans du CSS, jetons d’authentification, données binaires dans du JSON. Il est défini par la norme RFC 4648.

Comment fonctionne l’encodage

L’idée est de découper les données en paquets de 3 octets (24 bits), puis chaque paquet en 4 groupes de 6 bits. Chaque groupe de 6 bits vaut un nombre de 0 à 63, remplacé par un caractère de l’alphabet :

Valeurs0 à 2526 à 5152 à 616263
CaractèresA à Za à z0 à 9+/

Exemple avec « Man » : les octets M, a, n valent 77, 97 et 110, soit en binaire 01001101 01100001 01101110. Regroupés par 6 bits : 010011 010110 000101 101110, soit 19, 22, 5 et 46, qui donnent TWFu.

Le signe « = » à la fin

Quand la longueur des données n’est pas un multiple de 3, le dernier paquet est incomplet. On le complète, et on ajoute un ou deux « = » pour l’indiquer :

  • « Man » (3 octets) → TWFu
  • « Ma » (2 octets) → TWE=
  • « M » (1 octet) → TQ==

Une chaîne Base64 complète a donc toujours une longueur multiple de 4. Certains formats (comme les JWT) suppriment ces « = » : le décodeur de l’outil les rajoute automatiquement.

Exemples d’encodage

TexteOctets (UTF-8)Base64
Bonjour7Qm9uam91cg==
Hello5SGVsbG8=
été5 (chaque « é » occupe 2 octets)w6l0w6k=
€34oKs

Une taille qui augmente d’un tiers

Comme 3 octets deviennent 4 caractères, le résultat est environ 33 % plus lourd que l’original : une image de 30 Ko donne environ 40 Ko de Base64. Dans les e-mails (norme MIME), on ajoute en plus un retour à la ligne tous les 76 caractères.

C’est pourquoi intégrer des images en Base64 dans une page (data:image/png;base64,…) n’est intéressant que pour de très petits fichiers, comme une icône : au-delà, le surpoids et l’absence de mise en cache séparée ralentissent la page. Pour alléger une image, mieux vaut la compresser ou la convertir en WebP.

Base64 n’est pas un chiffrement

Il n’y a ni clé ni secret : n’importe qui décode du Base64 en une seconde. C’est un encodage, comme écrire un texte en morse. Deux conséquences pratiques :

  • L’authentification HTTP « Basic » envoie Authorization: Basic suivi de identifiant:motdepasse en Base64. Sans HTTPS, le mot de passe circule donc lisiblement.
  • La partie centrale d’un jeton JWT est du Base64URL : son contenu est lisible par tous. Seule la signature empêche de le modifier ; n’y mettez pas de données confidentielles.

Pour rendre un texte illisible sans la clé, il faut un vrai chiffrement, comme celui de l’outil de chiffrement de texte. Et pour obtenir une empreinte irréversible, c’est une fonction de hachage qu’il faut utiliser.

Base64URL : la variante pour les URL

Les caractères « + », « / » et « = » ont un sens particulier dans une URL. La variante Base64URL (définie dans la même RFC 4648) remplace « + » par « - » et « / » par « _ », et supprime généralement les « = ». Les octets FB FF donnent +/8= en Base64 et -_8 en Base64URL. C’est le format utilisé par les jetons JWT : {"alg":"HS256","typ":"JWT"} devient eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.

À ne pas confondre avec l’encodage d’URL (%20, %C3%A9…), qui sert à placer du texte dans une adresse web.

Encoder et décoder dans le code

JavaScript : attention aux accents

Les fonctions natives btoa() et atob() ne connaissent que les caractères Latin-1 : btoa("€") provoque une erreur, et btoa("é") donne 6Q== au lieu du w6k= attendu en UTF-8. Passez par TextEncoder :

// Encoder du texte UTF-8
const octets = new TextEncoder().encode("été");
const b64 = btoa(String.fromCharCode(...octets)); // "w6l0w6k="

// Décoder
const bin = atob(b64);
const texte = new TextDecoder().decode(Uint8Array.from(bin, c => c.charCodeAt(0))); // "été"

Autres langages et terminal

  • Python : base64.b64encode("été".encode()).decode() et base64.urlsafe_b64encode() pour la variante URL.
  • PHP : base64_encode() et base64_decode().
  • Linux : printf 'Bonjour' | base64 pour encoder, base64 -d pour décoder. Avec echo, un saut de ligne final est encodé aussi (Qm9uam91cgo=).

Questions fréquentes

Pourquoi mon décodage donne des caractères bizarres ?

Soit le contenu d’origine n’est pas du texte (une image, un PDF, un fichier compressé), soit il n’était pas encodé en UTF-8. Le Base64 restitue fidèlement les octets ; c’est leur interprétation comme texte qui échoue.

Comment reconnaître du Base64 ?

Une chaîne composée uniquement de lettres, de chiffres, de « + » et de « / » (ou de « - » et « _ »), souvent terminée par « = » ou « == », avec une longueur multiple de 4. Ce n’est qu’un indice : le mot « Test » est lui-même une chaîne Base64 valide, qui ne décode pas en texte lisible.

Le Base64 compresse-t-il les données ?

Non, au contraire : il les alourdit d’un tiers. Compressez d’abord (gzip, zip), encodez ensuite si nécessaire.