wp_unslash() の使い方｜説明・引数・注意点

説明

基本構文

wp_unslash( string|array $value ): string|array

引数

• $value：文字列または配列

戻り値

サニタイズ済みの文字列。

使い方（サンプル）

$value = wp_unslash( $input );

注意点

• WordPressは入力値（$_POST など）に自動でエスケープを施しているため、取り出すときにこの関数が必要です。
• サニタイズ関数に渡す前に呼びます。

実務での使いどころ

• $_POST・$_GET・$_REQUEST から値を取り出したときに、スラッシュを取り除くとき。
• サニタイズの前の、最初の処理として使うとき。

よくあるミスと対処

• $_POST の値を、スラッシュを取り除かずに、サニタイズ・保存している。バックスラッシュが、余分に付いたままになる。
• すでに処理した値に、さらに使い、必要なバックスラッシュまで、失われる。
• キーの存在を、確認せずに使っている（isset()）。

NG例

$title = sanitize_text_field( $_POST['title'] ); // unslash していない

OK例

if ( isset( $_POST['title'] ) ) {
	$title = sanitize_text_field( wp_unslash( $_POST['title'] ) );
}

使い分け早見表

関連項目

wp_slash()、sanitize_text_field()

公式リファレンス：wp_unslash() | Function | WordPress Developer Resources