absint()

absint() は、 正の整数 を取得するためのWordPress関数です。渡された値が負の数や小数であっても、絶対値を取得し 整数として返す よう設計されています。

機能の説明

• absint() は、 安全な正の整数値を取得するためのユーティリティ関数 です。
• この関数は、 数値や文字列の入力を強制的に0以上の整数に変換 し、主にユーザー入力や外部データのバリデーションに使用されます。
• もし引数が数値に変換できない場合、0を返します。

シンプルなコード例

$value = absint('-42');
echo $value; // 出力: 42

この例では、負の整数 -42 が 正の整数42 に変換されて出力されます。

使い方の解説

• absint() は、ユーザー入力のバリデーションやクエリ変数の処理で使われます。
• データベースから取得した数値が期待通りの形式かどうかを 整数として厳密に扱いたい場合 に便利です。
• 非数値やnull が渡された場合は 0 を返します。

使用例

$post_id = isset($_GET['post_id']) ? absint($_GET['post_id']) : 0;

if ($post_id > 0) {
    echo "投稿ID: " . $post_id;
} else {
    echo "有効な投稿IDが指定されていません。";
}

• 上記のコードでは、$_GET['post_id'] にユーザーが指定したIDを受け取り、それを absint() で正の整数に変換 しています。
• 有効な投稿ID が指定された場合はIDを表示し、指定されていない場合はエラーメッセージが表示されます。

一緒に使うことが多い関連タグ

intval()

整数型に変換 するPHPの標準関数です。absint() と違い、負の数をそのまま返します。

$value = intval('-42');
echo $value; // 出力: -42

intval() は負の整数もそのまま返すため、正の値のみ必要な場合には absint() のほうが安全 です。

sanitize_text_field()

ユーザー入力の テキストを安全にエスケープ する関数です。

$input = sanitize_text_field($_POST['name']);
echo "入力された名前: " . $input;

フォームから送信されたテキスト入力を サニタイズして不正なデータを排除 します。

esc_attr()

HTML属性に出力する文字列を エスケープ します。

$attribute = esc_attr('こんにちは!');
echo "<input value='{$attribute}' />";

esc_attr() を使うことで、不正な文字列がHTMLに埋め込まれるのを防ぎます。

追加情報を取得したい場合

数値以外の値も処理したい場合

$input = 'abc123';
$value = absint($input);
echo $value; // 出力: 0

absint() は 数値として解釈できない文字列を0 として処理します。

想定されるトラブル

数値以外の入力が渡される

ユーザーが不正な値を入力した場合、absint() は 0 を返します。

解決方法

$post_id = absint($_GET['post_id']);
if ($post_id === 0) {
   echo "無効な投稿IDです。";
}

バリデーションのメッセージ を表示し、エラー処理を行います。

Q&A

echo absint(12.34); // 出力: 12

まとめ

absint() は、 数値を安全に正の整数に変換するための便利な関数 です。

負の値や小数もすべて 正の整数として処理 されるため、ユーザー入力や外部データのバリデーションで役立ちます。

intval() との違いは、常に 正の整数を返す点 にあります。

フォームデータやURLパラメータの処理など、さまざまな場面で使用されるため、 入力の安全性を保つための必須ツール と言えます。