README

#概述

此包包含 JimMoser\EmptyValidator、JimMoser\OrChain 和 JimMoser\VerboseOrChain 验证器，适用于 Laminas Framework 2。

EmptyValidator 是一个适用于空值的验证器。它可以被认为是 Laminas\Validator\NotEmpty 验证器的逻辑对立面。

OrChain 和 VerboseOrChain 验证器类似于 Laminas\Validator\ValidatorChain，但它们使用逻辑 OR 而不是逻辑 AND 来链接验证器。

VerboseOrChain 与 OrChain 具有相同的目的，但提供了附加的验证失败消息。

有关每个验证器的详细信息，请参阅验证器源代码中的注释。

这是一个基础包，包含提供验证器所需的最低依赖。单元测试和 Module.php 文件（用于向 Laminas Framework 验证器插件管理器提供配置）在单独的包中提供。

如果在使用 "non-Laminas Framework" 环境中使用了 laminas/laminas-validator 包，则建议使用此包以及 jim-moser/zf2-validators-empty-or-test 包。换句话说，如果一个环境中没有安装 laminas/laminas-module-manager 和 Laminas Framework 的其他关键组件。

对于更完整的 Laminas Framework 安装，建议使用 jim-moser/zf2-validators-empty-or-plugin 和 jim-moser/zf2-validators-empty-or-plugin-test 包。

有关为什么创建 EmptyValidator、OrChain 和 VerboseOrChain 验证器的解释，请参阅 http://epicride.info/JimMoser/zendframework/or_validator.php。

#依赖关系

此包直接依赖于 laminas/laminas-validator 和 laminas/laminas-stdlib 的代码和类。

laminas/laminas-validator 包包含依赖于 laminas/laminas-servicemanager 和 laminas/laminas-i18n 包中的代码的代码，但这些依赖未列在其 composer.json 文件中。如果使用验证器插件管理器（Laminas/Validator/ValidatorPluginManager），则需要安装这些依赖项。如果您的应用程序使用验证器插件管理器，则应使用 jim-moser/zf2-validators-empty-or-plugin 包（推荐）或将这些依赖项添加到您的应用程序的 composer.json 文件中。

请注意，即使您的应用程序的自定义代码从未直接调用它，您的应用程序也可能使用验证器插件管理器。例如，JimMoser\OrChain 和 JimMoser\VerboseOrChain 类使用验证器插件管理器通过名称添加验证器。在下面的代码中，attachByName() 方法调用导致 JimMoser\OrChain 对象使用 Laminas\Validator\ValidatorPluginManager 实例创建 Laminas\Validator\NotEmpty 验证器实例。

$orChain = new \JimMoser\OrChain();
$orChain->attachByName('NotEmpty');

#相关包

jim-moser/zf2-validators-empty-or

包含 EmptyValidator、OrChain 和 VerboseOrChain 验证器的基础包，适用于 Laminas Framework 2。

	<p>This package has the fewest dependencies. Depends directly on 
	laminas/laminas-validator and laminas/laminas-stdlib.</p>
			
	<p>Does not include unit testing. The unit testing is available in the
	jim-moser/zf2-validators-empty-or-test package.</p>
	
	<p>Does not include the Module.php and configuration file used to 
	inform the validator plugin manager of the validators added by this 
	package. These files are provided by the 
	jim-moser/zf2-validators-empty-or-plugin package.</p>
</dd>
<dt>jim-moser/zf2-validators-empty-or-test</dt>
<dd><p>Package containing unit tests for 
	jim-moser/zf2-validators-empty-or package.</p>
	
	<p>Depends directly on jim-moser/zf2-validators-empty-or, 
	laminas/laminas-inputfilter, laminas/laminas-servicemanager, 
	laminas/laminas-validator, and phpunit/phpunit.</p>
</dd>
<dt>jim-moser/zf2-validators-empty-or-plugin</dt>
<dd>
	<p>This package adds a Module.php file and configuration file which are 
	used to add configuration for the Laminas Framework 2 validator plugin 
	manager. This configuration allows the plugin manager to return 
	instances of the EmptyValidator, OrChain, and VerboseOrChain validators 
	given strings containing their names.</p>
	
	<p>Depends directly on jim-moser/zf2-validators-empty-or and 
	laminas/laminas-modulemanager.</p>
</dd>
<dt>jim-moser/zf2-validators-empty-or-plugin-test</dt>
<dd><p>Package containing framework integration tests for
	jim-moser/zf2-validators-empty-or-plugin package. The tests verify that 
	the added validators are available from the validator plugin manager.</p>
	
	<p>Depends directly on jim-moser/zf2-validators-empty-or, 
	jim-moser/zf2-validators-empty-or-plugin. phpunit/phpunit,
	laminas/laminas-i18n, laminas/laminas-loader, laminas/laminas-log,
	laminas/laminas-mvc, laminas/laminas-serializer,
	laminas/laminas-servicemanager, and laminas/laminas-view.
	</p>
</dd>

#安装

##替代方案 1：使用 Composer 安装

对于现有的 Laminas Framework 安装，请进入 vendor 目录的父目录。此目录应包含现有的 composer.json 文件。对于新安装，请进入您希望包含 vendor 目录的目录。
```
 $ cd <parent_path_of_vendor>	
```
运行以下命令，该命令将更新 composer.json 文件，将 zf2-validators-empty-or-plugin 包及其依赖项安装到 vendor 目录下的相应目录中，并更新 composer 自动加载文件。
```
 $ composer require jim-moser/zf2-validators-empty-or
```

##替代方案 2：手动安装到 Vendor 目录

如果您想手动安装软件包并使用 Module.php 文件来配置自动加载，而不是使用 Composer 进行配置，那么请使用 jim-moser/zf2-validators-empty-or-plugin 软件包而不是这个软件包。请遵循该软件包的 README.md 文件中的安装说明。

jim-moser / zf2-validators-empty-or

维护者

详细信息

README