diff --git a/docs/book/validators.md b/docs/book/validators.md index 46870847..4eb67493 100644 --- a/docs/book/validators.md +++ b/docs/book/validators.md @@ -57,67 +57,3 @@ languages therefore are unsupported with regards to the `Alnum` validator. When using the `Alnum` validator with these languages, the input will be validated using the English alphabet. - -## Alpha - -`Laminas\I18n\Validator\Alpha` allows you to validate if a given value contains -only alphabetical characters. There is no length limitation for the input you -want to validate. This validator is identical to the `Laminas\I18n\Validator\Alnum` -validator with the exception that it does not accept digits. - -### Supported options - -The following options are supported for `Laminas\I18n\Validator\Alpha`: - -- `allowWhiteSpace`: Whether or not whitespace characters are allowed. This - option defaults to `FALSE`. - -### Basic usage - -```php -$validator = new Laminas\I18n\Validator\Alpha(); -if ($validator->isValid('Abcd')) { - // value contains only allowed chars -} else { - // false -} -``` - -### Using whitespace - -By default, whitespace is not accepted as it is not part of the alphabet. -However, if you want to validate complete sentences or phrases, you may need to -allow whitespace; this can be done via the `allowWhiteSpace` option, either at -instantiation or afterwards via the `setAllowWhiteSpace()` method. - -To get the current state of the flag, use the `getAllowWhiteSpace()` method. - -```php -$validator = new Laminas\I18n\Validator\Alpha(['allowWhiteSpace' => true]); - -// or set it via method call: -$validator->setAllowWhiteSpace(true); - -if ($validator->isValid('Abcd and efg')) { - // value contains only allowed chars -} else { - // false -} -``` - -### Using different languages - -When using `Laminas\I18n\Validator\Alpha`, the language provided by the user's -browser will be used to set the allowed characters. For locales outside of -English, this means that additional alphabetic characters may be used -— such as `ä`, `ö` and `ü` from the German alphabet. - -Which characters are allowed depends completely on the language, as every -language defines its own set of characters. - -Three languages supported by ext/intl, however, define multibyte characters, -which cannot be matched as alphabetic characters using normal string or regular -expression options. These include *Korean*, *Japanese*, and *Chinese*. - -As a result, when using the `Alpha` validator with these languages, the input -will be validated using the English alphabet. diff --git a/docs/book/validators/alpha.md b/docs/book/validators/alpha.md new file mode 100755 index 00000000..ab579dcf --- /dev/null +++ b/docs/book/validators/alpha.md @@ -0,0 +1,73 @@ +# Alpha + +`Laminas\I18n\Validator\Alpha` allows you to validate if a given value +**contains only alphabetical characters**. This validator is identical to the +[`Laminas\I18n\Validator\Alnum` validator](alnum.md) with the exception that it +does not accept digits. + +## Basic Usage + +```php +$validator = new Laminas\I18n\Validator\Alpha(); + +if ($validator->isValid('Abcd')) { + // Value contains only allowed chars +} +``` + +## Using Whitespace + +By default, whitespace is not accepted as it is not part of the alphabet. +However, if you want to validate complete sentences or phrases, you may need to +allow whitespace; this can be done via the `allowWhiteSpace` option, either at +instantiation or afterwards via the `setAllowWhiteSpace()` method. + +```php fct_label="Constructor Usage" +$validator = new Laminas\I18n\Validator\Alpha(['allowWhiteSpace' => true]); + +if ($validator->isValid('Abcd and efg')) { + // Value contains only allowed chars +} +``` + +```php fct_label="Setter Usage" +$validator = new Laminas\I18n\Validator\Alpha(); +$validator->setAllowWhiteSpace(true); + +if ($validator->isValid('Abcd and efg')) { + // Value contains only allowed chars +} +``` + +### Get Current Value + +To get the current value of this option, use the `getAllowWhiteSpace()` method. + +```php +$validator = new Laminas\I18n\Validator\Alpha(['allowWhiteSpace' => true]); + +$result = $validator->getAllowWhiteSpace(); // true +``` + +### Default Value + +The default value of this option is `false` that means whitespace characters are +not allowed. + +## Using different Languages + +When using `Laminas\I18n\Validator\Alpha`, the language provided by the user's +browser will be used to set the allowed characters. For locales outside of +English, this means that additional alphabetic characters may be used +— such as `ä`, `ö` and `ü` from the German alphabet. + +Which characters are allowed depends completely on the language, as every +language defines its own set of characters. + +Three languages supported by PHP's internationalization extension (`ext/intl`), +however, define multibyte characters, which cannot be matched as alphabetic +characters using normal string or regular expression options. These include +*Korean*, *Japanese*, and *Chinese*. + +As a result, when using the `Alpha` validator with these languages, the input +will be validated using the English alphabet. diff --git a/mkdocs.yml b/mkdocs.yml index 5dee557e..bce928da 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -9,6 +9,7 @@ nav: - Filters: filters.md - Validators: - 'Standard Validators': validators.md + - Alpha: validators/alpha.md - DateTime: validators/date-time.md - IsFloat: validators/is-float.md - IsInt: validators/is-int.md