PHPのquoted_printable_encode()関数の使い方を徹底解説

PHPのquoted_printable_encode()関数は、8ビット文字列をquoted-printable形式の文字列に変換するための組み込み関数です。quoted-printableはMIME（Multipurpose Internet Mail Extensions）で定義されているエンコード方式の一つで、主に電子メールで非ASCII文字（日本語など）を安全に送信する際に利用されます。

構文

quoted_printable_encode(str)

パラメータ

• str − 変換対象となる8ビット文字列を指定します。この引数は必須です。

戻り値

quoted_printable_encode()関数は、quoted-printable形式に変換された文字列を返します。変換に失敗した場合はFALSEを返します（PHP 7.x以前）。PHP 8以降では、失敗時にValueError例外がスローされる点に注意してください。

使用例

以下は、quoted_printable_encode()関数を使用した基本的なサンプルコードです。

<?php
    echo quoted_printable_encode("www.example.com")
?>

出力

上記のコードを実行すると、次のような出力結果になります。

www.example.com

補足：エンコードの挙動について

この例では、入力文字列「www.example.com」にASCII範囲外の文字や特殊記号が含まれていないため、元の文字列がそのまま出力されています。しかし、日本語などのマルチバイト文字や一部の記号が含まれる場合は、「=E3=81=82」のように「=」記号と16進数表現を組み合わせた形式へと変換されます。これにより、メール送信時などに文字化けを防ぎ、データを安全に伝送することが可能になります。