CFML 列表目录 （Lucee）

CFML 是一门广泛应用于 Web 开发的动态脚本语言，Lucee 是 CFML 的一个开源实现。其中，列出目录（List Directory）是我们在许多 Web 应用程序和网站项目中所必须的功能之一。在本文中，我们将讨论如何使用 Lucee 中的内置函数来列出目录，并演示一些示例代码。

Lucee 中的 ListDir() 函数

Lucee 中的 ListDir() 函数是一个用于列表目录的内置函数。它可以接受一个路径作为参数，并返回该路径下的所有文件和文件夹的列表。

<cfset directory = "/path/to/directory/">
<cfset files = ListDir(directory)>
<cfdump var="#files#">

上面的代码块，将返回一个数组，包含指定目录下的所有文件和文件夹的名称。可以通过循环来迭代这个列表并将它们显示在 Web 应用程序的用户界面中。

<cfset directory = "/path/to/directory/">
<cfset files = ListDir(directory)>
<ul>
  <cfloop array="#files#" index="file">
    <li>#file#</li>
  </cfloop>
</ul>

上述代码块将为指定目录下的每个文件和文件夹创建一个 HTML 列表项。

指定过滤器

ListDir() 函数还允许我们指定一个或多个过滤器，以更精确地指定我们想要列出的文件或文件夹。例如，如果我们只想列出指定目录下的所有 PHP 文件，可以在调用 ListDir() 函数时传递一个通配符参数。

<cfset directory = "/path/to/directory/">
<cfset files = ListDir(directory, "*.php")>
<ul>
  <cfloop array="#files#" index="file">
    <li>#file#</li>
  </cfloop>
</ul>

上述代码块将返回指定目录下的所有 PHP 文件。

我们还可以通过给 ListDir() 函数传递一个包含多个过滤器的数组来进一步过滤文件和文件夹列表。例如，以下代码块返回指定目录下所有 PNG、JPG 和 GIF 图像文件：

<cfset directory = "/path/to/directory/">
<cfset files = ListDir(directory, ["*.png", "*.jpg", "*.gif"])>
<ul>
  <cfloop array="#files#" index="file">
    <li>#file#</li>
  </cfloop>
</ul>

筛选隐藏文件

默认情况下，ListDir() 函数将返回指定目录下所有文件和文件夹，包括系统隐藏文件。如果你想排除这些隐藏文件，可以在函数的第三个参数中传递一个布尔值 true。

<cfset directory = "/path/to/directory/">
<cfset files = ListDir(directory, "*.jpg", true)>
<ul>
  <cfloop array="#files#" index="file">
    <li>#file#</li>
  </cfloop>
</ul>

上面的代码块，返回的列表将不包含系统隐藏文件。

结论

在本文中，我们简要介绍了 Lucee 中的 ListDir() 函数，并演示了如何使用它来列出指定路径下的文件和文件夹。还讨论了如何使用过滤器来过滤列表，以及如何剔除隐藏文件。这些示例代码将帮助你快速开始实现列表目录功能，为你的 Web 应用程序增加更多的功能。