テキストとファイルの Base64 エンコード

Base64 エンコードの仕組み

エンコーダーは入力を 3 バイトずつ読み取ります。その 24 ビットを 6 ビットずつ 4 つのグループに分け、各 6 ビット値（0～63）で 1 文字を選びます。0～25 は A-Z、26～51 は a-z、52～61 は 0-9、残りの 2 つは + と / です。3 バイトの入力から 4 文字が出力されるため、Base64 は元のデータより約 33% 大きくなります。

Text     M        a        n
Bytes    77       97       110
Bits     01001101 01100001 01101110
6-bit    010011 010110 000101 101110
Index    19     22     5      46
Base64   T      W      F      u

パディングと出力の長さ

入力の長さが 3 の倍数でない場合、最後のグループは不完全になります。余りが 1 バイトなら 2 文字の後に == が付き、2 バイトなら 3 文字と = 1 つになります。したがって、n バイトの入力に対するパディング付きの出力は、常に 4 × ceil(n / 3) 文字になります。

パディング自体にはデータが含まれません。JSON Web Token、URL パラメーター、多くの API ではパディングを省略するため、受信側がパディングなしの出力を想定している場合は「パディング」をオフにしてください。リンクやファイル名に使う場合は、「種類」で URL セーフを選ぶか、+ と / を - と _ に置き換える Base64URL のページを使用してください。

MIME と PEM の折り返し

デフォルトでは出力は 1 行の長い文字列になります。JSON、data URI、HTTP ヘッダーではこの形式が必要です。一方、次の 2 つの形式では改行が必要です。

• MIME（76 文字）。Content-Transfer-Encoding: base64 で送信するメールの添付ファイルでは、1 行が 76 文字を超えてはいけません（RFC 2045）。このオプションでは、MIME の要件どおり CRLF で改行します。
• PEM（64 文字）。-----BEGIN 行と -----END 行の間にある証明書や鍵は、1 行 64 文字で記述されます（RFC 7468）。このオプションでは LF で改行します。

文字コードとファイル

Base64 がエンコードするのは文字ではなくバイトです。そのため、テキストはまず文字コードに従ってバイト列に変換されます。たとえば文字 é は UTF-8 では 2 バイトですが、ISO-8859-1 や Windows-1252 では 1 バイトなので、同じテキストでも異なる Base64 になります。Web、JSON、ほぼすべての最新の API では UTF-8 が適切です。GBK、Shift_JIS、Windows-1251 などの文字コードは、古いシステムに合わせる場合にのみ選択してください。

ファイルは保存されている内容そのままにエンコードされ、文字コードの変換は行われません。画像を HTML や CSS のスニペット付きで変換するには画像を Base64 に変換を、MIME タイプを自動判別した data URI が必要な場合はファイルを Base64 に変換を使用してください。