README

如果该父内容本身 尚未开始，则在它的子内容之一开始时不会写入或更新其进度记录。如果它在“完成”允许类型列表中，如果所有子内容都已完成，则可以将其标记为完成，但除非确实发生这种情况，否则不会保存其进度百分比。除非它自己已经启动。如果父内容已经启动，则当子内容更新时，父内容的进度百分比值将根据允许启动的配置设置按其他类型的允许内容进行编辑。

验证

非技术介绍

这是一种业务规则验证，有助于确保需要特定信息或组件的内容不会因未满足这些要求而受到损害。例如，你可能有一个“发布”状态，你希望只将其分配给准备好供客户查看的内容。你不希望意外发布缺少重要组件的内容，这会对品牌产生负面影响。因此，可以在内容管理系统（CMS）中设置规则以确保内容符合既定标准。

如果没有验证，所有编辑都将“未经检查”地持久保存 - 即使它们毫无意义。这可能会导致一个内容不完整、用户体验差的网站。为了防止这种情况，技术管理员可以配置规则。内容编辑在提交时将“检查”这些设置规则。也就是说，它们将被“验证”。

在最初创建内容时，我们需要假设一个时期，内容将无法通过所有验证——因为所有字段都将为空！因此，可以设置“草稿”、“计划中”和“已发布”等“状态”在内容上。验证规则随后设置为仅应用于某些“受保护”的状态——通常是“计划中”和“已发布”。

了解这一点后，我们现在可以查看触发验证的两种情况：

1. 请求将内容的状态更改为“受保护”的状态。
2. 内容处于“受保护”状态，任何细节更改将触发验证。

在上述所有情况下，验证失败将导致以下结果：

1. 请求更改到受保护状态将不会执行——状态将保持不变。请注意，当前或之前的状态是受保护或未受保护的状态无关紧要。唯一发生的事情是请求的状态更改不会被持久化。
2. 请求的更改将不会执行。这样做会导致内容违反其类型的业务规则。

* 除了Musora CMS，对于2018年的Musora Media，当前视频ID和练习ID首先由另一个系统验证，该系统不会启用设置无意义值，无论内容状态如何。

技术介绍

这是“业务规则”验证。这并不验证内容是否适合数据库。这由特定实体和操作中的“规则”方法中硬编码的规则处理（扩展自Railroad\Railcontent\Requests\FormRequest，所有在/src/Requests）。相反，此“业务规则”验证用于当应用程序中独特的内容需要根据其在你域内的预期使用而特定的信息时。例如，对于可消费的消费者教育和娱乐，你可能会有“公开”或“已发布”等状态，你只想将这些状态分配给满足你质量和完善性要求的全部组件的内容。

在你的应用程序的config/目录中，你应该有一个railcontent.php文件。在那里，在'validation'下，你可以列出你想要进行验证的品牌。如果品牌不存在，则不会运行验证。

规则组织如下：

品牌 -> 内容类型 -> 受保护状态 -> 规则*

* 请参阅下方的“定义规则”部分

关于定义规则

每个内容类型的键必须与在应用程序中使用的表示内容类型的字符串相同。每个内容类型的规则有两个必需组件，可以有一个可选组件

1. 字段
2. 数据
3. number_of_children（可选）

如果内容类型存在于这些规则中，则将按上述方式运行验证。如果内容类型未在规则中表示，则验证规则不会根据规则保护该内容类型。

(目前还没有提供为特定内容类型提供自定义“限制”的方法。请参阅“todo.md”文件以了解如何更改此包以使其成为可能。)

关于字段或数据引用其他内容的部分的说明

当内容具有自身是另一篇内容引用的字段或数据时，评估的是该引用内容的ID。

因此，你的规则必须适应或使用这一点。

例如：一个视频有一个ID为视频的字段...并且那个视频本身也是一篇内容。规则可能看起来像这样

'video' => [
    'rules' => [
        Rule::exists($connectionMaskPrefix . 'content', 'id')->where(
            function ($query) { $query->where('type', 'vimeo-video'); }
        ),
        'required'
    ]
],

这是在"\Railroad\Railcontent\Requests\CustomFormRequest"类的"validateContent"方法中使用的以下逻辑完成的

if (($contentProperty['type'] ?? null) === 'content' && isset($inputToValidate['id'])) {
    $inputToValidate = $inputToValidate['id'];
}

你可以看到如果($contentProperty['type']是"content"并且

关于“数值”规则的重要说明

If you don't include the "numeric" rule here, this doesn't work. I don't know why and it
doesn't make sense. Laravel' validator should - for the min, max, and size rules according to the
documentation - evaluate the evaluated value in regards to these rules based on the data-type
of the value under evaluation. If it's a string, it will evaluate the length. Thus, if min:5,
the string must have at least 5 characters. If the value is an integer min:5 will pass only if
the value of the integer is 5 or higher. If an array it evaluates the count. You get the idea.
But here it's failing to do that. Even if casting the value to an int just to be sure, and then
debugging to make sure it's not changed into a string somehow (because that would break it of
course because the string "6" would only pass for "min:1" and would fail for "min:2" and upwards
but the integer 6 would pass for "min:2" to "min:6". Maybe something about the "numeric" rule
is casting it to an int somewhere I didn't see. Anyways this is smelly af because that "numeric"
condition is just there as a hack to circumvent failure of the system to act as expected. But
it works, so fuck.

(粗略地写下的注释从这里复制自代码中的注释)

指定规则

你可以“...将验证规则指定为数组，而不是使用|字符来分隔它们”（来自“指定自定义列名”部分这里）。

例如；这里的bar和bax会产生相同的效果

foo => [
    'bar' => ['max:2|required'],
    'bax' => [
        'max:2',
        'required'
    ]
]

每个品牌可用的选项详细信息

字段

(必需)

根据它们应用的字段进行键控的规则数组。这个“fields”数组中的每个键控值代表一个字段。每个值可以是字符串或数组，表示所使用的Laravel版本中可用的规则。有关Laravel规则的详细信息，请参阅他们的文档。

数据

(必需)

与fields相同，除了数据。

number_of_children

(可选)

参见上面的“关于"numeric"规则的注意事项”。

在需要设置内容类型为“受限”状态（例如“发布”或“计划”）之前，必须先设置一定数量的子内容的情况下提供。

可以定义为以下两种方式之一

'number_of_children' => 'min:3', 
'number_of_children' => ['rules' => 'min:3'],

与其它规则不同，这个不需要是数组中的一个名为"rules"的项目。可以是，也可以不是。两种方式都可行。

配置示例

'validation' => [
    'brand' => [
        'content-type' => [
            'content-status|content-status|...' => [
                'number_of_children' => 'min:3',
                'fields' => [
                    'key' => [
                        rules => ['validation-rule', 'validation-rule', ...],
                        'can_have_multiple' => true/false],
                    ],
                    'key' => [
                        rules => 'validation-rule|validation-rule|...',
                        'can_have_multiple' => true/false],
                    ],
                ],
                'data' => [
                    'key' => [
                        rules => ['validation-rule', 'validation-rule', ...],
                        'can_have_multiple' => true/false],
                    ],
                    'key' => [
                        rules => 'validation-rule|validation-rule|...',
                        'can_have_multiple' => true/false],
                    ],
                ]
            ]
        ],
    ]
]

MultipleColumnExistsValidator

注意：目前这个功能实际上并没有正常工作，所以上述可能并不完全准确。

这还准确吗？（Jonathan，2018年7月）

您可能无法使用Laravel验证器的Rule::Exists()功能来指定您的验证规则。也许您指定了配置文件中的规则，这些文件以静态方式调用方法并缓存，这可能是导致规则失效的原因。

为了解决这个问题，这个包中存在一个自定义规则，名为（Railroad\Railcontent\Validators）"MultipleColumnExistsValidator"。还有一个针对它的测试：（Tests\Feature）"MultipleColumnExistsRuleTest"。

如果需要，请查看该类以完全理解其工作原理。如果您只需要快速查看，以下是它的功能：

$exists = $this->databaseManager->connection($connection)
    ->table($table)
    ->where($row, $value)
    ->exists();

您通过规则传递这些参数

$connection = $parameterParts[0];
$table = $parameterParts[1];
$row = $parameterParts[2];
$value = isset($parameterParts[3]) ? $parameterParts[3] : $value;

配置的规则看起来像这样

'video' => 'exists_multiple_columns:mysql,railcontent_content,id&mysql,railcontent_content,type,vimeo-video'

解包后得到以下内容

exists_multiple_columns:
    mysql,railcontent_content,id
    &
    mysql,railcontent_content,type,vimeo-video

逐行分解

exists_multiple_columns是自定义规则的名字

mysql,railcontent_content,id是一组规则，用于数据库验证中的单个"where exists"子句。

&（与号）是我们的分隔符——因为管道或垂直线（|）已经被Laravel用于分隔规则。

mysql,railcontent_content,type,vimeo-video是另一个添加到数据库验证中的"where exists"子句，当所有子句都编译时将运行。

在这种情况下，验证要成功，两个"where exists"验证都必须通过。

在每个"where exists"验证中，值通过逗号（,）分隔。

因此，第一组有三个（3）个值

mysql
railcontent_content
id

第二组有四个（4）个值

mysql
railcontent_content
type
vimeo-video

前三个（3）个参数是必需的，第四个（第4个）是可选的。

如上代码片段所示，参数如下

1. 连接（必需）
2. 表（必需）
3. $row（必需）
4. $value（可选）

如果未传递第四个（第4个）参数，用于"where exists"评估的值将是整个规则正在验证的值。

回顾示例，我们看到我们正在验证提交给video输入的值是否与规则'exists_multiple_columns:mysql,railcontent_content,id&mysql,railcontent_content,type,vimeo-video'匹配，以确保值匹配两个子句mysql,railcontent_content,id和mysql,railcontent_content,type,vimeo-video。第一个确保通过连接"mysql"，在表"railcontent_content"中，正在验证的值匹配"id"列的值。第二个做同样的事情，但值不是传递的值，而是规则中硬编码的第四个参数-"vimeo-video"。因此，它确保存在一条记录，其中传递的值与"id"列中的值匹配，并且至少有一条记录匹配该值，其"类型"列至少有一个值为"vimeo-video"。

WHERE AND

上述示例描述了一个“WHERE ... AND ...”查询。这是标准行为——验证通过至少需要在某一行中包含所有内容。

WHERE OR

这描述了一个“WHERE ... OR ...”查询。

您可以在“条款规则字符串”（记住这些字符串之间用和符号（&）分隔）前加上or:，所以对于上面的例子，第二个查询将不是这样

mysql,railcontent_content,type,vimeo-video

而是这样

or:mysql,railcontent_content,type,vimeo-video

这与前面的规则一样，当存在一个or:“在它们之间”时，它们通过一个或语句连接。

请注意，因为您可以在一个规则中有超过两个“条款规则字符串”，所以您可以这样组合OR和AND

exists_multiple_columns:
    mysql,railcontent_content,id
    &
    or:mysql,railcontent_content,foo_id
    &
    mysql,railcontent_content,type,vimeo-video
    &
    or:mysql,railcontent_content,slug,'bar baz'

这意味着前两个“条款规则字符串”之一必须与最后两个“条款规则字符串”之一匹配。

(
    mysql,railcontent_content,id
    OR
    mysql,railcontent_content,foo_id
)
AND
(
    mysql,railcontent_content,type,vimeo-video
    OR
    mysql,railcontent_content,slug,'bar baz'
)