antispambot()

基本構文と使い方（引数・実行結果）

エンティティ化したメールアドレスを返します。メールアドレスをそのままHTMLに組み込んでページに表示するとボットに拾われて迷惑メールの対象になりますが、その対策として使えるテンプレートタグです。

antispambot($email_address,$hex_encoding);

Copy

antispambot($email_address,$hex_encoding);

引数	必須/任意	引数に指定するもの
第１引数 $email_address	必須	メールアドレスを`文字列`で指定
第２引数 $hex_encoding	任意	16進数の文字参照でエンティティ化するには`1`を指定（`true`でもOK）初期値：`0` （10進数）

戻り値（返す値）：エンティティ化したメールアドレス
※表示するにはechoします。

下記の例では info@example.com をエンティティ化しています。echoで表示されるメールアドレスはそのまま info@example.com ですが、レンダリング前の生のHTMLは結果例のように、エンティティ化されます。

<?php echo antispambot("info@example.com"); ?>

Copy

<?php echo antispambot("info@example.com"); ?>

結果例（レンダリング前のHTML）：info@sample.com
※引数に指定した文字列の中からランダムにエンティティ化されるので常に同じ結果ではありません。

【引数とは】
テンプレートタグ（=関数）を実行する際に、引数を渡すことができるテンプレートタグがあります。引数は、関数の中で使われるので、渡す引数の値によって実行結果が変わってきます。何を処理したいのか、どのようなデータを取得したいのかによって渡す引数が変わります。

【引数について】

指定できる引数の数はテンプレートタグによって異なります。（引数なしもあり）
引数ごとに必須 / 任意が決まっています。（必須は必ず指定、任意は指定しなければ初期値）
引数名(例：$post)は仕様の便宜上の名前と考えてください。（この名前自体はテンプレートタグ実行に関係しません。各引数に何を指定するのかを理解していればOKです。）

下記の例では、mailtoをつかったメールリンクをエンティティ化しています。

<?php
$email = antispambot('info@example.com');
echo '<a href="mailto:' . $email . '">' . $email . '</a>';
?>

Copy

<?php
$email = antispambot('info@example.com');
echo '<a href="mailto:' . $email . '">' . $email . '</a>';
?>

※当サイトでは初期値とデフォルト値の言葉の定義を区別せず、原則統一して初期値を採用しています。

テンプレートタグ	説明
esc_html()	HTMLをエスケープし、安全な文字列として出力します。
esc_attr()	属性値をエスケープし、安全な文字列として出力します。
esc_url()	URLをエスケープし、安全な文字列として出力します。

Akiyuki Tanaka

2014年にフリーランス（Webデザイナー／コーダー）として独立。2016年にWeb制作会社ソーイ株式会社を設立し、現在までWeb制作・開発の現場に携わってきました。

初学者だった頃は、学習に苦労し随分と遠回りしました。かつての自分と同じような人に提供できるものがあるのではないかと考え、YouTubeでの講義配信を経て、より体系的で実践的な学習環境を提供する、独自の学習プラットフォーム unazuki を立ち上げました。

制作と教育、両方の現場に立ってきた経験を活かし、「とりあえずコードが書ける」ではなく、考えて作れるWeb制作者を増やすことを目指しています。