README

此插件包含针对特定国家的各种本地化验证类。

要求

此分支用于与 CakePHP 5.x 一起使用。有关详细信息，请参阅版本映射

演示

有关本地化验证的实时沙箱演示，请参阅 sandbox.dereuromark.de/sandbox/localized

安装

您可以使用 composer 将此插件安装到您的 CakePHP 应用程序中。

安装 composer 包的推荐方法是

composer require cakephp/localized

使用以下命令加载插件

bin/cake plugin load Cake/Localized

或者通过手动将 'Cake/Localized' 添加到应用程序的 config/plugins.php 文件中的数组中。

模型验证

本地化验证类可用于验证模型字段。

namespace App\Model\Table;

use Cake\ORM\Table;
use Cake\Localized\Validation\FrValidation;
use Cake\Validation\Validator;

class PostsTable extends Table
{
    public function validationDefault(Validator $validator): Validator
    {
        $validator->setProvider('fr', FrValidation::class);
        $validator->add('phoneField', 'myCustomRuleNameForPhone', [
            'rule' => 'phone',
            'provider' => 'fr',
        ]);
    }
}

有关验证规则的更多信息，请参阅 CakePHP 验证文档

PO 文件

此插件还包含核心（cake 域）面向客户端的翻译字符串的翻译。要使用这些文件，请将它们链接或复制到预期的位置：resources/locales/<locale>/cake.po

为 Localized 贡献

如果您发现您所在的国家不是 Localized 插件的一部分，请在 GitHub 上 fork 此项目。一旦您已经 fork 了项目，您就可以提交您的验证器类（以及任何测试用例）。一旦您将更改推送到 GitHub，您就可以发送拉取请求，您的更改将得到审查和合并，或者会提供反馈。

验证方法

有一些方法是所有类共有的，通过 "ValidationInterface" 接口定义

phone() 检查电话号码
postal() 检查邮政编码
personId() 检查特定国家的个人 ID

请尽量将您的验证规则与该命名方案相匹配。除此之外，您当然也可以在实现类中定义更多的验证方法。

Localized 的问题

如果您遇到 Localized 的问题，您可以在 github.com/cakephp/localized/issues 上报告它们。

cakephp / localized

维护者

详细信息