当サイト、Codex 日本語版は今後積極的な更新は行わない予定です。後継となる新ユーザーマニュアルは、https://ja.wordpress.org/support/ にあります。
万が一、当サイトで重大な問題を発見した際などは、フォーラムWordSlack #docs チャンネルでお知らせください。</p>

「関数リファレンス/esc sql」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(英語版をコピペ。)
 
(和訳完了。)
1行目: 1行目:
== Description ==
+
{{Copyedit}}
  
An alias for <tt>[[Class_Reference/wpdb|$wpdb->escape()]]</tt>. Prepares a string for use as an SQL query. A glorified <tt>[http://php.net/manual/en/function.addslashes.php addslashes()]</tt> that works with arrays.
+
<div id="Description">
 +
== 説明 ==
 +
</div>
 +
<tt>[[Class_Reference/wpdb|$wpdb->escape()]]</tt> のエイリアスです。SQL クエリーで用いる文字列を用意する関数です。配列に対して動作する、見せかけの <tt>[http://php.net/manual/en/function.addslashes.php addslashes()]</tt> です。
  
== Usage ==
+
<div id="Usage">
 +
== 使用法 ==
 +
</div>
 +
<?php esc_sql( $sql ); ?>
  
%%% <?php esc_sql( $sql ); ?> %%%
+
<div id="Parameters">
 +
== パラメーター ==
 +
</div>
 +
{{Parameter|$string|string|エスケープしていない SQL クエリー。}}
  
== Parameters ==
+
<div id="Return">
 +
== 戻り値 ==
 +
</div>
 +
{{Return||string| SQL クエリーに適切に用いるためにエスケープした値。}}
  
{{Parameter|$string|string|An unescaped SQL query string.}}
+
<div id="Example">
 
+
== 使用例 ==
== Return Value ==
+
</div>
 
+
{{Return||string| Escaped value appropriate for use in a SQL query.}}
+
 
+
== Example ==
+
 
<pre>
 
<pre>
 
<?php
 
<?php
28行目: 36行目:
  
 
== Notes ==
 
== Notes ==
<tt>[[Class_Reference/wpdb#Protect_Queries_Against_SQL_Injection_Attacks|$wpdb->prepare()]]</tt> is generally preferred as it corrects some common formatting errors.
+
一般的に <tt>[[Class_Reference/wpdb#Protect_Queries_Against_SQL_Injection_Attacks|$wpdb->prepare()]]</tt> の方が好まれます。これは共通のフォーマットエラーを直してくれるからです。
== Change Log ==
+
  
Since: [[Version 2.8|2.8.0]]
+
<div id="Change Log">
 +
== 改訂履歴 ==
 +
</div>
 +
* [[Version 2.8|2.8.0]] にて導入されました。
  
== Source File ==
+
<div id="Source File">
 +
== ソースファイル ==
 +
</div>
 +
<tt>esc_sql()</tt> は {{Trac|wp-includes/formatting.php}} にあります。
  
<tt>esc_sql()</tt> is located in {{Trac|wp-includes/formatting.php}}.
+
<div id="Related">
 
+
== 関連項目 ==
== Related ==
+
</div>
 
[[Function Reference/esc_attr|esc_attr()]], [[Function Reference/esc_html|esc_html()]], [[Function Reference/esc html e|esc_html_e()]], [[Function Reference/esc_textarea|esc_textarea()]], [[Function Reference/esc_url|esc_url()]], [[Function Reference/esc_url_raw|esc_url_raw()]], [[Function Reference/like escape|like_escape()]], [[Function Reference/tag escape|tag_escape()]], [[Function Reference/urlencode|urlencode()]], [[Function Reference/urlencode_deep|urlencode_deep()]]
 
[[Function Reference/esc_attr|esc_attr()]], [[Function Reference/esc_html|esc_html()]], [[Function Reference/esc html e|esc_html_e()]], [[Function Reference/esc_textarea|esc_textarea()]], [[Function Reference/esc_url|esc_url()]], [[Function Reference/esc_url_raw|esc_url_raw()]], [[Function Reference/like escape|like_escape()]], [[Function Reference/tag escape|tag_escape()]], [[Function Reference/urlencode|urlencode()]], [[Function Reference/urlencode_deep|urlencode_deep()]]
  
 
{{Tag Footer}}
 
{{Tag Footer}}
 +
 +
{{原文|Function Reference/esc sql|134599}}<!--  06:39, 17 August 2013 Djkaz  版 -->
  
 
[[Category:Functions]]
 
[[Category:Functions]]
 
{{Copyedit}}
 

2013年8月17日 (土) 18:19時点における版

この記事は翻訳時に編集が必要であるとマークされていました。その為Codex原文が大きく編集されている可能性があります。内容を確認される際は原文を参照していただき、可能であれば本項目へ反映させてください。よりよいCodexを作成するためのお手伝いをお願いします。

$wpdb->escape() のエイリアスです。SQL クエリーで用いる文字列を用意する関数です。配列に対して動作する、見せかけの addslashes() です。

使用法

<?php esc_sql( $sql ); ?>

パラメーター

$string
string) (必須) エスケープしていない SQL クエリー。
初期値: なし

戻り値

(string) 
SQL クエリーに適切に用いるためにエスケープした値。

使用例

<?php

$name   = esc_sql( $name );
$status = esc_sql( $status );

$wpdb->get_var( "SELECT something FROM table WHERE foo = '$name' and status = '$status'" );

?>

Notes

一般的に $wpdb->prepare() の方が好まれます。これは共通のフォーマットエラーを直してくれるからです。

改訂履歴

  • 2.8.0 にて導入されました。

ソースファイル

esc_sql()wp-includes/formatting.php にあります。

esc_attr(), esc_html(), esc_html_e(), esc_textarea(), esc_url(), esc_url_raw(), like_escape(), tag_escape(), urlencode(), urlencode_deep()


関数リファレンステンプレートタグ目次もご覧ください。


最新英語版: WordPress Codex » Function Reference/esc sql最新版との差分