Fichier en Base64

Comment convertir un fichier en Base64

1. Déposez un ou plusieurs fichiers dans la zone, utilisez le sélecteur de fichiers ou collez des fichiers copiés avec Ctrl+V.
2. Choisissez Sortie en : Base64 brut (le choix par défaut ici), Data URI, HTML <a download>, JSON ainsi que les enveloppes pour images et polices.
3. Facultatif : URL-safe remplace + et / par - et _ ; Couper à 76 coupe les lignes pour les e-mails MIME.
4. Copier la sortie, ou Enregistrer en .txt pour obtenir filename.ext.b64.txt.

Avec plusieurs fichiers, une liste affiche chaque nom avec sa taille d’origine et sa taille encodée. Afficher montre un résultat, et Tout copier en JSON copie tous les fichiers sous forme de tableau d’objets {name, type, size, data}. C’est rapide à coller dans un fichier de fixtures ou un script de seed.

Ce que signifient les options de sortie pour les fichiers qui ne sont pas des images

Les clés JSON sont fixes (name, type, size, data). Si une API attend d’autres noms, renommez-les après le collage. size est la taille d’origine du fichier en octets, ce qui permet au destinataire de vérifier que la longueur décodée correspond.

Le type MIME de la data URI et le type du JSON viennent de votre navigateur. Si le navigateur ne connaît pas le fichier, l’outil devine d’après l’extension, et si cela échoue aussi, il utilise application/octet-stream. Seule l’étiquette en dépend ; le Base64 reste le même dans tous les cas.

Fichiers binaires dans les secrets de CI et la configuration

Une raison courante d’encoder un fichier entier est un coffre à secrets qui ne stocke que du texte : variables de CI, fichiers .env, Secrets Kubernetes. Les keystores de signature, les certificats et les fichiers de compte de service y entrent sous forme d’une ligne Base64 et sont restaurés dans le pipeline :

echo "$KEYSTORE_B64" | base64 -d > release.keystore

Laissez Couper à 76 désactivé dans ce cas. Une valeur contenant des sauts de ligne est souvent abîmée par l’interface des secrets ou par le shell. Kubernetes stocke ainsi chaque valeur sous data:, et le décodeur de Secret Kubernetes les relit.

Reconnaître ce que vous avez encodé aux premiers caractères

Les premiers octets de la plupart des formats de fichiers forment une signature fixe : le début du Base64 indique donc le type sans décodage. Quelques signatures courantes :

Une liste plus longue se trouve dans les préfixes Base64 courants. Quand vous décodez avec Base64 en fichier, le type est détecté de la même façon.

Taille, mémoire et gros fichiers

La sortie Base64 fait les 4/3 de l’entrée, arrondie au multiple de 4 caractères supérieur. Un fichier de 1 Mo devient 1 398 104 caractères, et avec Couper à 76, 18 396 caractères de saut de ligne s’y ajoutent. Les compteurs sous la sortie affichent les deux tailles et le surcoût en pourcentage.

Tout se passe dans l’onglet du navigateur : la limite pratique est donc la mémoire de votre appareil.

• La zone de texte affiche les 4 premiers Mo de la sortie ; Copier la sortie et Enregistrer en .txt utilisent toujours le résultat complet.
• Copier la sortie est désactivé pour une sortie de plus de 48 Mo environ.
• Les fichiers de plus de 48 Mo environ sont encodés par blocs, et le résultat n’est proposé que via Enregistrer en .txt.

Pour un fichier aussi gros, demandez-vous si Base64 est le bon moyen de transport. Un envoi multipart ou un transfert binaire direct évite le surcoût de 33 % et le pic de mémoire aux deux extrémités. Le calculateur de taille donne la taille encodée avant de commencer.

Encoder un fichier en ligne de commande ou dans le code

Linux, avec GNU coreutils (-w 0 désactive la coupure par défaut à 76 caractères) :

base64 -w 0 report.zip > report.zip.b64

macOS (où base64 ne coupe pas les lignes par défaut) :

base64 -i report.zip -o report.zip.b64

Windows PowerShell :

[Convert]::ToBase64String([IO.File]::ReadAllBytes("C:\data\report.zip")) | Set-Content report.zip.b64

Python :

import base64
from pathlib import Path

encoded = base64.b64encode(Path("report.zip").read_bytes()).decode("ascii")

Pour traiter de gros fichiers en streaming sans les charger en mémoire, voir Base64 en Python, Node.js, Java et PHP.

Problèmes courants

• Des sauts de ligne dans la sortie. Le base64 de GNU coupe à 76 caractères par défaut, openssl base64 à 64, et certutil -encode ajoute en plus des lignes d’en-tête. Beaucoup d’API JSON et de variables d’environnement exigent une seule ligne. Utilisez -w 0, openssl base64 -A, ou cet outil sans coupure.
• application/octet-stream dans la data URI. Le navigateur ne connaissait pas le type et l’extension ne figurait pas dans la liste de l’outil. Les octets restent corrects ; remplacez le type MIME dans le préfixe si le destinataire y tient.
• Copier la sortie est grisé. Le résultat dépasse la limite de copie d’environ 48 Mo. Enregistrer en .txt fonctionne toujours, et la plupart des outils qui ont besoin de la chaîne savent la lire dans un fichier.
• Le JSON contient "data": null pour un fichier. Dans un lot, les fichiers de plus de 48 Mo environ sont encodés par blocs pour le téléchargement uniquement : Tout copier en JSON laisse donc leurs données de côté. Encodez ce fichier seul et enregistrez-le en .txt.
• Le fichier décodé est plus petit que l’original. La chaîne a été tronquée. Comparez la longueur décodée avec la valeur size de la sortie JSON.
• Sortie illisible alors que l’entrée était du texte. Base64 conserve les octets tels quels, y compris l’encodage de caractères d’origine. Un fichier texte en UTF-16 se décode en UTF-16, pas en UTF-8. Pour un texte que vous saisissez, utilisez Texte en Base64, qui permet de choisir le jeu de caractères.

FAQ