变更集56069

时间戳：

2023年6月27日下午04:06:16(11个月（之前）

作者：

米克斯色度计

消息：

文件系统API：允许在中可选包含隐藏文件列表文件（）。

添加新的可选$include_hidden（$包含_隐藏）参数以允许包含隐藏的(。前缀）文件。
向后兼容性默认为false。

Props yani.iliev、sabernhardt、costdev、rutviksavsani、zunaid321、azaozz。
修复#53659。

位置：

大旅行箱

文件夹：

• src/wp-admin/includes/file.php （已修改）(2个差异)
• tests/phpunit/tests/functions/listFiles.php （已修改）(1个差异)

trunk/src/wp-admin/includes/file.php

@@ -128 +128 @@
 *@自2.6.0起
 *@自4.9.0起添加了`$exclusions`参数。
- *
-*@param string$folder可选。文件夹的完整路径。默认为空。
-*@param int$levels可选。要遵循的文件夹级别，默认为100（PHP循环限制）。
-*@param string[]$exclusions可选。要跳过的文件夹和文件的列表。
+*@自6.3.0起添加了`$include_hidden`参数。
+ *
+*@param string$folder可选。文件夹的完整路径。默认为空。
+*@param int$levels可选。要遵循的文件夹级别，默认为100（PHP循环限制）。
+*@param string[]$exclusions可选。要跳过的文件夹和文件列表。
+*@param bool$include_hidden可选。是否包含隐藏（前缀为“.”）文件的详细信息。
+*默认为false。
 *@return string[]| false成功时为文件数组，失败时为false。
  */
-函数列表文件（$folder=''，$level=100，$exclusions=数组（）){
+函数list_files（$folder=''，$levels=100，$exclusions=array（），$include_hidden=false){
 if（空（$folder））{
 返回false；
@@ -157 +160 @@
 
 //跳过隐藏和排除的文件。
-如果('.' === $文件[0]||in_array（$file，$exclusions，true）{
+如果(（！$include_hidden&&'.'===$文件[0]）||in_array（$file，$exclusions，true）{
 继续；
             }
 
 if（is_dir（$folder.$file））{
-$files2=列表文件（$folder.$file，$levels-1);
+$files2=列表文件（$folder.$file，$levels-1，数组（），$include_hidden);
 if（$files2）{
 $files=array_merge（$files，$files2）；

trunk/tests/phpunit/tests/functions/listFiles.php

@@ -20 +20 @@
 $this->assertNotContains（ABSPATH.'wp-admin/index.php'，$admin_files）；
     }
+
+    /**
+*list_files（）可以选择包含隐藏文件的测试。
+     *
+*@门票53659
+     *
+*@dataProvider data_list_files_should_optionally_include_hidden_files
+     *
+*@param string$filename隐藏文件的名称。
+*@param bool$include_hidden是否包含隐藏的（前缀为“.”）文件。
+*@param string[]$exclusions要跳过的文件夹和文件列表。
+*@param bool$应输入文件是否应包含在结果中。
+     */
+公共函数test_list_files_should_optionally_include_hidden_files（$filename，$include_hidden，$exclusions，$expected）{
+$test_dir=get_temp_dir（）。'test-list-files/'；
+$hidden_file=$test_dir$文件名；
+
+mkdir（$test_dir）；
+触摸（$hidden_file）；
+
+$actual=列表文件（$test_dir，100，$exclusions，$include_hidden）；
+
+取消链接（$hidden_file）；
+rmdir（$test_dir）；
+
+if（预期为$）{
+$this->assertContains（$hidden_file，$actual，'文件未包含。'）；
+}其他{
+$this->assertNotContains（$hidden_file，$actual，'文件已包含。'）；
+}
+    }
+
+    /**
+*数据提供商。
+     *
+*@return数组[]
+     */
+公共函数data_list_files_should_optionally_include_hidden_files（）{
+返回数组(
+“$include_hidden=false and no exclusions”=>数组(
+“文件名”=>“.hidden_file”，
+“include_hidden”=>假，
+“排除项”=>数组（），
+“预期”=>false，
+            ),
+“$include_hidden=true且无排除”=>数组(
+“文件名”=>“.hidden_file”，
+“include_hidden”=>true，
+“排除项”=>数组（），
+“预期”=>true，
+            ),
+“$include_hidden=true和排除的文件名”=>数组(
+“文件名”=>“.hidden_file”，
+“include_hidden”=>true，
+“exclusions”=>数组（“.hidden_file”），
+“预期”=>false，
+            ),
+        );
+    }
 }