From 41d389f41a97868ba51d83fc43ccdbff958ed2a3 Mon Sep 17 00:00:00 2001 From: wipped <116155485+wipped@users.noreply.github.com> Date: Mon, 1 Dec 2025 10:51:37 +0100 Subject: [PATCH 1/4] Update validation rules to specify better Specified that the alpha-rules fail on empty strings and that permit_empty will skip all other rules except for required_with and required_without. --- .../source/libraries/validation.rst | 20 +++++++++++-------- 1 file changed, 12 insertions(+), 8 deletions(-) diff --git a/user_guide_src/source/libraries/validation.rst b/user_guide_src/source/libraries/validation.rst index 96416355bb22..82c268dbd1f3 100644 --- a/user_guide_src/source/libraries/validation.rst +++ b/user_guide_src/source/libraries/validation.rst @@ -900,14 +900,14 @@ The following is a list of all the native rules that are available to use: Rule Parameter Description Example ======================= ========== ============================================= =================================================== alpha No Fails if field has anything other than - alphabetic characters in ASCII. + alphabetic characters in ASCII or is empty. alpha_dash No Fails if field contains anything other than alphanumeric characters, underscores or - dashes in ASCII. + dashes in ASCII or is empty. alpha_numeric No Fails if field contains anything other than - alphanumeric characters in ASCII. + alphanumeric characters in ASCII or is empty. alpha_numeric_punct No Fails if field contains anything other than - alphanumeric, space, or this limited set of + alphanumeric, space, this limited set of punctuation characters: ``~`` (tilde), ``!`` (exclamation), ``#`` (number), ``$`` (dollar), ``%`` (percent), @@ -915,11 +915,13 @@ alpha_numeric_punct No Fails if field contains anything other than ``*`` (asterisk), ``-`` (dash), ``_`` (underscore), ``+`` (plus), ``=`` (equals), ``|`` (vertical bar), - ``:`` (colon), ``.`` (period). + ``:`` (colon), ``.`` (period) or is empty. alpha_numeric_space No Fails if field contains anything other than - alphanumeric or space characters in ASCII. + alphanumeric or space characters in ASCII or + is empty. alpha_space No Fails if field contains anything other than - alphabetic characters or spaces in ASCII. + alphabetic characters or spaces in ASCII or + is empty. decimal No Fails if field contains anything other than a decimal number. Also accepts a ``+`` or ``-`` sign for the number. @@ -974,7 +976,9 @@ not_in_list Yes Fails if field is within a predetermined numeric No Fails if field contains anything other than numeric characters. permit_empty No Allows the field to receive an empty array, - empty string, null or false. + empty string, null or false. Skips all other + validation rules except for required_with and + required_without regex_match Yes Fails if field does not match the regular ``regex_match[/regex/]`` expression. required No Fails if the field is an empty array, empty From ca2a5240dec82070a0c704f9ab32ba93820b8468 Mon Sep 17 00:00:00 2001 From: wipped <116155485+wipped@users.noreply.github.com> Date: Mon, 1 Dec 2025 11:48:32 +0100 Subject: [PATCH 2/4] docs: missing dot --- user_guide_src/source/libraries/validation.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user_guide_src/source/libraries/validation.rst b/user_guide_src/source/libraries/validation.rst index 82c268dbd1f3..2164ba7cd2c3 100644 --- a/user_guide_src/source/libraries/validation.rst +++ b/user_guide_src/source/libraries/validation.rst @@ -978,7 +978,7 @@ numeric No Fails if field contains anything other than permit_empty No Allows the field to receive an empty array, empty string, null or false. Skips all other validation rules except for required_with and - required_without + required_without. regex_match Yes Fails if field does not match the regular ``regex_match[/regex/]`` expression. required No Fails if the field is an empty array, empty From ca8e202dd63309cbc660408132540e472740715f Mon Sep 17 00:00:00 2001 From: wipped <116155485+wipped@users.noreply.github.com> Date: Wed, 3 Dec 2025 14:25:24 +0100 Subject: [PATCH 3/4] Update permit_empty rule description Clarify behavior of permit_empty validation rule. --- user_guide_src/source/libraries/validation.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/user_guide_src/source/libraries/validation.rst b/user_guide_src/source/libraries/validation.rst index 2164ba7cd2c3..7194107cfe12 100644 --- a/user_guide_src/source/libraries/validation.rst +++ b/user_guide_src/source/libraries/validation.rst @@ -976,9 +976,9 @@ not_in_list Yes Fails if field is within a predetermined numeric No Fails if field contains anything other than numeric characters. permit_empty No Allows the field to receive an empty array, - empty string, null or false. Skips all other - validation rules except for required_with and - required_without. + empty string, null or false. When true, + skips all other validation rules except for + required_with and required_without. regex_match Yes Fails if field does not match the regular ``regex_match[/regex/]`` expression. required No Fails if the field is an empty array, empty From 3b08edb7eade8558ea0a55c66185dabc000b6f1f Mon Sep 17 00:00:00 2001 From: wipped <116155485+wipped@users.noreply.github.com> Date: Thu, 4 Dec 2025 20:40:07 +0100 Subject: [PATCH 4/4] Update permit_empty rule description in validation guide Clarify the behavior of the 'permit_empty' validation rule. --- user_guide_src/source/libraries/validation.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user_guide_src/source/libraries/validation.rst b/user_guide_src/source/libraries/validation.rst index 7194107cfe12..9046c1ff5275 100644 --- a/user_guide_src/source/libraries/validation.rst +++ b/user_guide_src/source/libraries/validation.rst @@ -976,7 +976,7 @@ not_in_list Yes Fails if field is within a predetermined numeric No Fails if field contains anything other than numeric characters. permit_empty No Allows the field to receive an empty array, - empty string, null or false. When true, + empty string, null or false. On success, it skips all other validation rules except for required_with and required_without. regex_match Yes Fails if field does not match the regular ``regex_match[/regex/]``