【PHP実践｜実務向け】PHPでmailtoリンクを正しく実装する：http_build_queryの活用術

導入

Webサイト上でメール送信を促す「mailto:」リンクの実装は一見簡単そうに見えますが、日本語を含む件名や本文を扱う際にURLエンコードの不備でリンクが機能しなかったり、文字化けを起こしたりするトラブルが後を絶ちません。今回は、実務で安全かつ確実に「mailto:」リンクを生成するためのベストプラクティスを解説します。

基礎知識

「mailto:」スキームは、ブラウザからOSの標準メーラーを起動し、宛先や件名を自動入力させるための仕組みです。
書式は「mailto:宛先?subject=件名&body=本文」となります。ここで重要なのがURLエンコードです。URLには日本語などのマルチバイト文字を含めることができないため、これらをパーセントエンコーディング（%xxの形式）に変換する必要があります。
PHPにはurlencode()やrawurlencode()といった関数がありますが、メールリンクにおいてはRFC 3986に準拠するrawurlencode()を使用するのが適切です。

実装/解決策

複数のパラメータを扱う場合、個別にrawurlencode()をかけるのはコードが冗長になり、ミスも誘発しやすくなります。そこで役立つのがhttp_build_query()関数です。
この関数は連想配列をURLクエリ文字列に変換してくれるだけでなく、自動的にURLエンコードも行ってくれます。第4引数に「PHP_QUERY_RFC3986」を指定することで、スペースを「%20」として変換する現代的な仕様に合わせることが可能です。

サンプルプログラム

以下は、件名と複数行の本文を含んだmailtoリンクを安全に出力するサンプルコードです。

‘【お問い合わせ】サービス利用について’,
// 改行コードをCR+LFに統一し、メールクライアント側で正しく改行されるようにします
‘body’ => preg_replace(‘/\R/’, “\r\n”, $body)
];

// http_build_queryを使用してクエリ文字列を生成
// 第3引数に ‘&’ を指定することでHTMLエスケープに対応
// 第4引数に PHP_QUERY_RFC3986 を指定してRFC3986準拠にする
$queryString = http_build_query($params, null, ‘&’, PHP_QUERY_RFC3986);
?>

応用・注意点

1. 改行コードの制御: メール本文内の改行は、クライアントによって挙動が異なる場合がありますが、基本的には「\r\n」(CR+LF)で統一しておくのが最も安全です。サンプルコードのようにpreg_replace()を使うと、環境を問わず改行を制御できます。
2. セキュリティ: mailtoリンクにはユーザーのメールアドレスが含まれます。スパム対策として、可能であればJavaScriptで動的に生成する、あるいはメールフォームへ誘導するなどの対策も併せて検討してください。
3. HTMLエスケープ: タグのhref属性に出力する際は、XSSを防ぐためにHTMLエスケープが必須です。http_build_queryの第3引数に「&」を指定することで、クエリ間の区切り文字がHTML的に正しい形式で出力されます。