类 MailContainsAttachment
MailContainsAttachment
方法摘要
-
__construct() public
构造函数
-
additionalFailureDescription() protected
在需要时返回额外的失败描述。
-
count() public
计算约束元素的数量。
-
evaluate() public
针对参数 $other 评估约束。
-
fail() protected
针对给定的比较值和测试描述抛出异常。
-
failureDescription() protected
覆盖描述,以便我们可以删除自动的“预期”消息
-
failureDescriptionInContext() protected
返回此约束出现在 $operator 表达式上下文中时的失败描述。
-
getAssertedMessages() protected
返回所有消息的类型相关字符串,这些字符串符合 $this->at
-
getMessages() public
获取要检查的电子邮件或电子邮件
-
getTypeMethod() protected
-
matches() public
检查约束
-
reduce() protected
通过跳过退化子表达式来减少从 $this 开始的子表达式,并返回第一个从非可减少子表达式开始的后代约束。
-
toString() public
断言消息字符串
-
toStringInContext() protected
当约束出现在 $operator 表达式的上下文中时,返回约束对象的自定义字符串表示形式。
-
valueToTypeStringFragment() protected
方法详情
additionalFailureDescription() ¶ protected
additionalFailureDescription(mixed $other): string
在需要时返回额外的失败描述。
该函数可以被覆盖以提供额外的失败信息,例如 diff
参数
-
mixed
$other
返回值
string
evaluate() ¶ public
evaluate(mixed $other, string $description = '', bool $returnResult = false): ?bool
针对参数 $other 评估约束。
如果 $returnResult 设置为 false(默认值),则在发生错误时会抛出异常。否则返回 null。
如果 $returnResult 为 true,则评估结果将以布尔值形式返回:成功为 true,失败为 false。
参数
-
mixed
$other -
string
$description 可选 -
bool
$returnResult 可选
返回值
?bool
抛出
ExpectationFailedException
fail() ¶ protected
fail(mixed $other, string $description, ?ComparisonFailure $comparisonFailure = null): never
针对给定的比较值和测试描述抛出异常。
参数
-
mixed
$other -
string
$description -
?ComparisonFailure
$comparisonFailure 可选
返回值
never
抛出
ExpectationFailedException
failureDescription() ¶ protected
failureDescription(mixed $other): string
覆盖描述,以便我们可以删除自动的“预期”消息
失败消息的开头在大多数情况下是“断言失败”。此方法应返回该句子的第二部分。
要提供额外的失败信息,可以使用 additionalFailureDescription
参数
-
mixed
$other 值
返回值
string
failureDescriptionInContext() ¶ protected
failureDescriptionInContext(Operator $operator, mixed $role, mixed $other): string
返回此约束出现在 $operator 表达式上下文中时的失败描述。
此方法的目的是在 LogicalNot 等运算符的上下文中提供有意义的失败描述。本机 PHPUnit 约束由 LogicalNot 开箱即用地支持,但外部开发的约束在该上下文中无法提供正确的消息。
当该方法本身不处理自定义时,该方法应返回空字符串。
参数
-
Operator
$operator -
mixed
$role -
mixed
$other
返回值
string
getAssertedMessages() ¶ protected
getAssertedMessages(): string
返回所有消息的类型相关字符串,这些字符串符合 $this->at
返回值
string
getMessages() ¶ public
getMessages(): arrayCake\Mailer\Message>
获取要检查的电子邮件或电子邮件
返回值
arrayCake\Mailer\Message>
reduce() ¶ protected
reduce(): self
通过跳过退化子表达式来减少从 $this 开始的子表达式,并返回第一个从非可减少子表达式开始的后代约束。
对于终端约束以及从非可减少子表达式开始的运算符返回 $this,或者返回 $this 的最接近后代,该后代从非可减少子表达式开始。
约束表达式可以被建模为一棵树,树上包含非终端节点(运算符)和终端节点。例如
LogicalOr(运算符,非终端)
- LogicalAnd(运算符,非终端) | + IsType('int')(终端) | + GreaterThan(10)(终端)
- LogicalNot(运算符,非终端)
- IsType('array')(终端)
退化子表达式是树的一部分,它实际上对它出现的表达式的评估没有贡献。退化子表达式的示例是用单个操作数或嵌套的 BinaryOperators(每个都有单个操作数)构造的 BinaryOperator。涉及退化子表达式的表达式等效于删除退化子表达式的简化表达式,例如
LogicalAnd(运算符)
- LogicalOr(退化运算符) | + LogicalAnd(退化运算符) | + IsType('int')(终端)
- GreaterThan(10)(终端)
等效于
LogicalAnd(运算符)
- IsType('int')(终端)
- GreaterThan(10)(终端)
因为子表达式
- LogicalOr
- LogicalAnd
- -
- LogicalAnd
是退化的。在上面的 LogicalOr 对象以及 LogicalAnd 上调用 reduce() 将返回 IsType('int') 实例。
可以实现其他特定的简化,例如 LogicalNot 运算符的级联
- LogicalNot
- LogicalNot +LogicalNot
- IsTrue
- LogicalNot +LogicalNot
可以简化为
LogicalNot
- IsTrue
返回值
self
toStringInContext() ¶ protected
toStringInContext(Operator $operator, mixed $role): string
当约束出现在 $operator 表达式的上下文中时,返回约束对象的自定义字符串表示形式。
此方法的目的是在 LogicalNot 等运算符的上下文中提供有意义的描述性字符串。本机 PHPUnit 约束由 LogicalNot 开箱即用地支持,但外部开发的约束在该上下文中无法提供正确的字符串。
当该方法本身不处理自定义时,该方法应返回空字符串。
参数
-
Operator
$operator -
mixed
$role
返回值
string
valueToTypeStringFragment() ¶ protected
valueToTypeStringFragment(mixed $value): non-empty-string
参数
-
mixed
$value
返回值
非空字符串