【PHP8.x】quoted_printable_decode関数の使い方

Copy
1<?php
2
3/**
4 * Quoted-Printableエンコードされた文字列をデコードするサンプル
5 *
6 * このコードは、メール本文などで使われるQuoted-Printable形式でエンコードされた文字列を、
7 * 元の読みやすい文字列に変換する方法を示します。
8 * 例えば、非ASCII文字（日本語など）や制御文字が `=XX` の形式で表現されている場合、
9 * それらをデコードして通常のテキストに戻します。
10 */
11
12/**
13 * Quoted-Printableエンコードされた文字列をデコードし、結果を表示します。
14 *
15 * @param string $encodedString Quoted-Printableエンコードされた入力文字列。
16 * @return void
17 */
18function runQuotedPrintableDecodeExample(string $encodedString): void
19{
20    // quoted_printable_decode 関数を使用して、エンコードされた文字列をデコードします。
21    // この関数は、RFC 2045で定義されているQuoted-Printable形式を処理します。
22    $decodedString = quoted_printable_decode($encodedString);
23
24    echo "=== Quoted-Printable デコードの例 ===" . PHP_EOL;
25    echo "エンコード前 (入力): " . $encodedString . PHP_EOL;
26    echo "デコード後 (出力):  " . $decodedString . PHP_EOL;
27    echo "==================================" . PHP_EOL;
28}
29
30// 実行例1: 基本的な英数字と特殊文字のデコード
31// "=20" は半角スペース、"=3D" は "=" 記号、"=21" は "!" を表します。
32$sample1 = "Hello=20World=21=3DExample.";
33runQuotedPrintableDecodeExample($sample1);
34
35// 実行例2: 日本語（UTF-8エンコード）を含む文字列のデコード
36// "=E3=83=86=E3=82=B9=E3=83=88" は UTF-8 でエンコードされた「テスト」です。
37// "=0D=0A" は改行コード (CRLF) を表します。
38$sample2 = "Japanese text: =E3=83=86=E3=82=B9=E3=83=88=0D=0AThis is a new line.";
39runQuotedPrintableDecodeExample($sample2);
40
41?>

PHPのquoted_printable_decode関数は、Quoted-Printable形式でエンコードされた文字列をデコードし、元の読める形式に戻すための関数です。Quoted-Printableエンコーディングは、主に電子メールの本文などで、日本語のような非ASCII文字や半角スペース、イコール記号などの特殊文字を安全に扱うために使用されます。これらの文字は、=E3=83=86や=20のように「=の後に16進数2桁」の形式で表現されます。

この関数は、string $stringという一つの引数を受け取ります。この$stringには、デコードしたいQuoted-Printable形式でエンコードされた文字列を渡します。関数はRFC 2045で定義されているQuoted-Printable形式を処理し、その結果をstring型のデコードされた文字列として返します。

サンプルコードでは、まず"Hello=20World=21=3DExample."という基本的な英数字と特殊文字のデコード例を示しています。これは半角スペースや記号が=20や=3Dといった形式で表現されている文字列です。次に、日本語の「テスト」が=E3=83=86=E3=82=B9=E3=83=88のようにUTF-8エンコードされてQuoted-Printable形式になった文字列をデコードしています。これにより、エンコードされた特殊な記号の羅列が、本来の読みやすいテキストに変換されることを確認できます。電子メール受信時など、Quoted-Printable形式のデータを元の内容に戻したい場合に非常に役立つ関数です。

Copy
1<?php
2
3/**
4 * quoted_printable_decode関数の使用例。
5 * Quoted-Printableエンコードされた文字列をデコードします。
6 * 主にメールの本文などで使われるエンコーディング形式です。
7 */
8
9// Quoted-Printableエンコードされた文字列の例
10// =E3=83=86=E3=82=B9=E3=83=88 は日本語の「テスト」をUTF-8でエンコードし、
11// さらにQuoted-Printableで表現したものです。
12$encodedString = "Hello =E3=83=86=E3=82=B9=E3=83=88 World.=0D=0A" .
13                 "This is a new line with some =C3=A4umlaut=C3=BC characters.";
14
15echo "元のエンコードされた文字列:\n";
16echo $encodedString . "\n\n";
17
18// quoted_printable_decode関数を使って文字列をデコード
19$decodedString = quoted_printable_decode($encodedString);
20
21echo "デコードされた文字列:\n";
22echo $decodedString . "\n";
23
24?>

PHPのquoted_printable_decode関数は、Quoted-Printableという形式でエンコードされた文字列を元の形式にデコード（復元）するために使用されます。このQuoted-Printableエンコーディングは、主に電子メールの本文で、日本語や絵文字などの非ASCII文字、あるいは特殊文字を安全に送受信するために利用されることが多いです。

この関数は、引数として$stringにデコードしたいQuoted-Printable形式の文字列を一つ受け取ります。そして、デコードされた通常の文字列を戻り値として返します。

サンプルコードでは、まず$encodedStringという変数に、Quoted-Printableエンコードされた文字列が格納されています。この文字列は、日本語の「テスト」や改行、ウムラウト付きの文字などがQuoted-Printable形式で表現されたものです。

次に、quoted_printable_decode関数にこの$encodedStringを渡すことで、$decodedString変数には人間が読める形式に変換された文字列が代入されます。例えば、「=E3=83=86=E3=82=B9=E3=83=88」は「テスト」に、「=0D=0A」は改行コードに、「=C3=A4umlaut=C3=BC」は「äumlautü」のようにデコードされます。

このように、この関数を使うことで、メールなどで受け取ったQuoted-Printable形式のデータを簡単に元の内容に戻すことができます。