From e37c78900c9b0ccdbaef43198548e6448ec07058 Mon Sep 17 00:00:00 2001 From: akagisho Date: Sun, 2 Sep 2012 22:57:51 +0900 Subject: [PATCH] Update classes/validation/validation.html --- classes/validation/validation.html | 174 ++++++++++++++--------------- 1 file changed, 87 insertions(+), 87 deletions(-) diff --git a/classes/validation/validation.html b/classes/validation/validation.html index fa2078333..8c6377068 100644 --- a/classes/validation/validation.html +++ b/classes/validation/validation.html @@ -44,61 +44,61 @@

-

Validation Class

+

Validation クラス

-

The Validation class helps you validate user input, if you want to create a form & its validation at - the same time use the Fieldset class instead.

+

Validation クラスは、ユーザ入力をバリデーションする際の手助けをします。 + フォームの生成とバリデーションを同時にしたい場合は、代わりに Fieldset クラスを使用してください。

-

Configuration

+

設定

-

Optionally, the validation class can be configured through the global application configuration file, app/config/config.php. Define a section called 'validation', in which the following settings can be defined:

+

オプションで、アプリケーション全体の設定ファイル app/config/config.php で validation クラスの設定を行うことができます。 'validation' セクションを定義し、以下の設定を行うことができます。

- - - - + + + + - + - + - + - + - + @@ -114,73 +114,73 @@

Configuration

VariableTypeDefaultDescription変数型デフォルト説明
no_errors string 
''
String to return if no validation errors were discovered.バリデーションでエラーが見つからなかった場合に返す文字列。
open_list string 
'<ul>'
String to be prepended to the list of errors. Usually this is some form of HTML to format the list. By default, it's formatted as an unordered list.エラーのリストの先頭に付加される文字列。通常、リストを定義する HTML タグになります。デフォルトでは、番号なしリストになります。
close_list string 
'</ul>'
String to be appended to the list of errors.エラーのリストの末尾に付加される文字列。
open_error string 
'<li>'
String to be prepended to each individual error message.個々のエラーメッセージの先頭に付加される文字列。
close_error string 
'</li>'
String to be appended to each individual error message.個々のエラーメッセージの末尾に付加される文字列。
quote_label
-

If one or more of these values are missing from the global configuration, the class will use the defaults as defined in this table.

+

これらの値が定義されない場合、上記の表に示したデフォルト値が使用されます。

-

Usage

+

使用方法

-

To start validation you need to create an object, this can be the default object named "default" or - you can name it if you need multiple validation objects.

+

バリデーションを開始するには、オブジェクトを生成する必要があります。 + デフォルトでは "default" という名前のオブジェクトになりますが、複数のバリデーションオブジェクトが必要な場合は名前を付けることができます。

- 
// Use default
+				
// デフォルトを使う
 $val = Validation::forge();
 
-// ... or name it
+// 名前を付ける
 $val = Validation::forge('my_validation');

 
-				
After having it instantiated you can start adding fields to it. This works exactly like the when using
-				the Fieldset class, however here we'll only document the preferred usage.

+				
インスタンスを生成したら、フィールドを追加していきます。
+					Fieldset クラスを使用するときと全く同じように動作しますが、ここでは推奨する使用方法のみを示します。

 
 				
$val = Validation::forge('my_validation');
 
-// Add a field for username, give it the label "Your username" and make it required
+// ユーザ名用のフィールドを追加して "Your username" というラベルを付加し、入力必須にする
 $val->add('username', 'Your username')->add_rule('required');
 
-// Now add another field for password, and require it to contain at least 3 and at most 10 characters
+// そしてさらにパスワード用のフィールドを追加し、3文字以上10文字以下の入力必須にする
 $val->add('password', 'Your password')->add_rule('required')
     ->add_rule('min_length', 3)
     ->add_rule('max_length', 10);

 
-				
The first parameter of the add_rule() method can contain PHP native function names, any valid PHP
-				callback and Closures in addition to the provided validation methods. The method will get the value to
+				
add_rule() メソッドの第1引数には、本機能で提供するルールに加え、任意の PHP のネイティブ関数やコールバック関数、無名関数を指定することもできます。
+				The method will get the value to
 				be validated as its first argument and any further arguments can be given to the add_rule() method.

 
 				
We also provide a shorter syntax which is very limited in comparison. It will not accept array-callbacks,
 				closures or parameters other then strings.

 
-				
// The same fields as the example above
+				
// 上記の例と同じ動作をします
 $val = Validation::forge('my_validation');
 $val->add_field('username', 'Your username', 'required');
 $val->add_field('password', 'Your password', 'required|min_length[3]|max_length[10]');

 
-				
Once all the fields have been added you can run your validation. This will default to $_POST input, but
-				can be extended and overwritten when given an input array.

+				
Once all the fields have been added you can run your validation. 
+				This will default to $_POST input, but be extended and overwritten when given an input array.

 
 				
// run validation on just post
 if ($val->run())
 {
-	// process your stuff when validation succeeds
+	// バリデーションに成功した場合の処理
 }
 else
 {
-	// validation failed
+	// 失敗
 }
 
 // alternative to above, overwriting the username in post, password will still be sought in post
 if ($val->run(array('username' => 'something')))

 
-				
When validation is ran there are three methods available for information about the input:

+				
バリデーションが実行されたとき、there are three methods available for information about the input:

 
-				
// get an array of successfully validated fields => value pairs
+				
// バリデートに成功したフィールドと値の組を配列で取得する
 $vars = $val->validated();
-// get an array of validation errors as field => error pairs
+// バリデーションエラーをフィールドとエラー内容の組の配列で取得する
 $errors = $val->error();
 // get an array of the input that was validated, this merged the post & input given to run()
 $input = $val->input();
 
-// all these methods can also get just the value for a single field
+// これらのメソッドでは、一つのフィールドにおいて値だけを取得することもできます
 $var = $val->validated('username');

 
 				
Validation can also run partially, in that case even required fields are ignored when they're not in
@@ -191,61 +191,61 @@ 
Usage
-

Validation rules

+

バリデーションルール

-

Note that all methods (even min_length) will also return true on empty input. To also require the field - you must add the rule "required" as well.

+

すべてのメソッドは (min_length さえも)、空の入力に対して true を返すことに注意してください。 + 入力必須にするためには、"required" ルールを使う必要があります。

-

All these rules can be used like below:

+

これらのすべてのルールは、次のように使えます:

// example normal usage with rule without and one with params
 $val->add('email', 'Email address')->add_rule('match_value', 'me@mydomain.com', true)->add_rule('valid_email');
 $val->add_field('email', 'Email address', 'match_value[me@mydomain.com,1]|valid_email');
-

Rules table

+

ルール表

- - - + + + - + @@ -253,130 +253,130 @@

Rules table

- + - + - +
RuleAdditional parametersDescriptionルール追加パラメータ説明
required(none)(なし) - The field must be set and have been given something other than null, - false or empty string. + フィールドがセットされ、null、false + および空の文字列以外の値が与えられているか。
required_with $fieldname - The field must be set if the field with the given $fieldname is set. + $fieldname フィールドがセットされている場合に、フィールドに値がセットされているか。
match_value $compare, $strict = false - The field input must match $compare, will be done using == unless 2nd parameter - is also given as true (then === is used). + 入力値が $compare と一致するかどうか。 + 比較には == が使用され、第2引数が true の場合は === が使用される。
match_pattern $pattern - Will try to match the value against the given $pattern which must be a full PREG regex. + $pattern で与えられた PREG 正規表現にマッチするかどうか。
match_field $field - Will try to match the field to the field with the given fieldname, the matching is done - using ===.
- Important: you can only match against a field that was added before the + 入力値が別のフィールドの値と一致しなければならない。 + 比較には === が使用される。
+ 重要: you can only match against a field that was added before the field this rule is added to.
min_length $length - Tests whether the string contains at least $length's number of character. + 文字数が $length 文字以上かどうか。
max_length $length - Tests whether the string contains no more than $length's number of character. + 文字数が $length 文字以内かどうか。
exact_length $length - Tests whether the string has precisely $length's number of character. + 文字数がちょうど $length 文字かどうか。
valid_email(none)(なし) - Validates if the given input is a valid email address. + 有効な email アドレスかどうか。
valid_emails $separator (optional) - Validates multiple email addresses separated by commas (or $separator). + カンマ (または $separator) で区切られた、有効な email アドレスかどうか。
valid_url(none)(なし) - Validates if the given input is a valid URL. + 有効な URL アドレスかどうか。
valid_ip(none)(なし) - Validates if the given input is a valid IP. + 有効な IP アドレスかどうか。
numeric_min $min_val - Tests whether the given input is a number that is greater than $min_val, it does - not check or cast the input to a numeric value so any non-numeric value will be considered - to be zero. Use the PHP function is_numeric to check that first. + 数値が $min_val 以上かどうか。 + 入力値が数値かどうかのチェックやキャストはしないので、数値でない文字列はゼロとみなされます。 + これをチェックするには、まず PHP の is_numeric 関数を使用してください。
numeric_max $max_val - Tests whether the given input is a number that is smaller than $max_val. (see - note about non-numeric values with numeric_min rule) + 数値が $max_val 以下かどうか。 + (数値でない場合の注意事項は numeric_min を見てください)
valid_string $flags = array('alpha', 'utf8') - See below. + 下記を参照。
-

Valid string rule

-

Validates whether a string adheres to the conditions set by the $flags parameter. The accepted flags - are:

+

Valid string ルール

+

$flags パラメータで与えられた条件を満たすかどうか検証します。 + 使用できる flag は次の通りです:

- + - + - + - + - + - + - + - + - + - + - + - +
FlagDescription説明
alphaAllow alphabetical characters.アルファベットの文字列
uppercaseUsed in combination with alpha to only allow uppercase characters.アルファベット大文字の文字列
lowercaseUsed in combination with alpha to only allow lowercase characters.アルファベット小文字の文字列
numericAllow numeric characters.数字の文字列
spacesAllow normal spaces.(一文字または複数の) スペース
newlinesAllow newline character.(一文字または複数の) 改行文字
tabsAllow tabs.(一文字または複数の) タブ
dotsAllow dots.(一文字または複数の) ドット
commasAllow commas.(一文字または複数の) カンマ
punctuationAllow dots, commas, exclamation marks, question marks, colons and semi-colons.(一文字または複数の) ドット、カンマ、エクスクラメーションマーク、クエスチョンマーク、コロン、セミコロン
dashesAllow dashes and underscores.(一文字または複数の) ハイフンとアンダーバー
utf8