diff --git a/language-snippets.ent b/language-snippets.ent index 92076a0ea..c7b7d082a 100644 --- a/language-snippets.ent +++ b/language-snippets.ent @@ -1,6 +1,6 @@ - + @@ -861,6 +861,7 @@ linkend="language.types.boolean">布尔类型章节以获取更多信息 '> + finfo_open 返回的 finfo 实例。'> @@ -1678,6 +1679,27 @@ It is strongly recommended to avoid timezone abbreviations. + + + + 如果 token 包含 null 字节,抛出 ValueError。 + + + + + 如果 token 是空字符串,抛出 code 为 Dom\SYNTAX_ERR + 的 Dom\DOMException。 + + + + + 如果 token 包含 ASCII 空格,抛出 code 为 Dom\INVALID_CHARACTER_ERR + 的 Dom\DOMException。 + + +'> + + @@ -2671,10 +2693,13 @@ Windows 环境下的 Apache 配置文件中添加路径值时,所有的反斜 调用此方法失败将给出 E_WARNING(未实现)。'> + 当合法的上下文传递给调用函数时,属性 streamWrapper::$context 会被改变。'> +bucket 现在期望 StreamBucket 实例;之前期望 stdClass。'> +StreamBucket 实例;之前返回 stdClass。'> @@ -2719,6 +2744,9 @@ Windows 环境下的 Apache 配置文件中添加路径值时,所有的反斜 '> + + + 为了最大限度地提高代码可移植性,建议在 ZIP 文件名中使用斜线 (/) 做为目录分隔符。'> @@ -4386,6 +4414,8 @@ local: { '> + + 如果 string1 小于 string2,则返回小于 0 的值; @@ -4395,17 +4425,23 @@ local: { '> + + + + filter - 要应用的过滤器 ID。 手册页面列出了可用的过滤器。 + 要应用的过滤器。可以使用 FILTER_VALIDATE_* 常量作为验证过滤器,使用 + FILTER_SANITIZE_*FILTER_UNSAFE_RAW + 作为清理过滤器,也可以使用 FILTER_CALLBACK 作为自定义过滤器。 - 如果省略,将使用 FILTER_DEFAULT,默认等同于 - FILTER_UNSAFE_RAW。这将导致不进行任何默认过滤。 + 默认值为 FILTER_DEFAULT,是 FILTER_UNSAFE_RAW + 的别名。这将导致默认情况下不进行过滤。 @@ -4414,6 +4450,8 @@ local: { + + diff --git a/reference/filter/examples.xml b/reference/filter/examples.xml index 519a95723..2f32870dc 100644 --- a/reference/filter/examples.xml +++ b/reference/filter/examples.xml @@ -1,6 +1,6 @@ - + &reftitle.examples; @@ -151,17 +151,6 @@ After: bogus@example.org - - - 配置默认过滤器 - - - - - diff --git a/reference/filter/functions/filter-var-array.xml b/reference/filter/functions/filter-var-array.xml index 8e5c29d24..eeb407de9 100644 --- a/reference/filter/functions/filter-var-array.xml +++ b/reference/filter/functions/filter-var-array.xml @@ -1,12 +1,13 @@ - + filter_var_array 获取多个变量并且过滤它们 + &reftitle.description; @@ -15,50 +16,52 @@ arrayintoptionsFILTER_DEFAULT booladd_empty&true; - - 不需要重复调用 filter_var 就能获取多个变量。 - + + 使用 FILTER_VALIDATE_* 验证过滤器、FILTER_SANITIZE_* + 清理过滤器或自定义过滤器来过滤关联 &array; 的值。 + + &reftitle.parameters; - - - - array - - - 数组,键为字符串,值为待过滤的数据。 - - - - - options - - - 一个定义参数的数组。一个有效的键必须是一个包含变量名的string,一个有效的值要么是一个filter type,或者是一个array - 指明了过滤器、标示和选项。如果值是一个数组,那么它的有效的键可以是 filter, - 用于指明 filter type,flags - 用于指明任何想要用于过滤器的标示,或者 options 用于指明任何想要用于过滤器的选项。 - 参考下面的例子来更好的理解这段说明。 - - - 这个参数也可以是一个filter constant的整数。那么数组中的所有值都会被这个过滤器所过滤。 - - - - - add_empty - - - 在返回值中添加 &null; 作为不存在的键。 - - - - - + + + array + + + 关联 &array;,包含要过滤的数据。 + + + + + options + + + 要么是选项的关联 array,要么是应用于每个条目的过滤器,可以是使用 FILTER_VALIDATE_* + 常量的验证过滤器,也可以是使用 FILTER_SANITIZE_* 常量的清理过滤器。 + + + 选项数组是关联数组,其中 key 对应于数据 array 中的键,而关联的值要么是应用于该条目的过滤器,要么是描述如何以及应用哪个过滤器到该条目的关联数组。 + + + 描述如何应用过滤器的关联数组必须包含 'filter' + key,其关联的值是要应用的过滤器,FILTER_VALIDATE_*FILTER_SANITIZE_*FILTER_UNSAFE_RAW + 或 FILTER_CALLBACK 常量之一。还可以选择性地包含 'flags' key,用于指定适用于过滤器的 + flag,以及 'options' key,用于指定适用于过滤器的任何选项。 + + + + + add_empty + + + 为缺失的 key 添加 &null; 到返回值中。 + + + + + &reftitle.returnvalues; @@ -76,37 +79,40 @@ 'libgd