如何安装和部署 Directory Lister?

Directory Lister 是一个用 PHP 编写的目录列表程序，安装方式很简单：把程序文件放到服务器上，用浏览器访问即可看到目录内容，不需要配置数据库。前提是你的服务器或虚拟主机支持 PHP，并且你想展示的目录对 PHP 进程可读。下面按从零开始的方式说明部署步骤和常见卡点。

部署前需要确认什么

• PHP 环境：Directory Lister 是 PHP 程序，服务器需要能运行 PHP。具体支持的 PHP 版本以项目页面说明为准。
• Web 服务器：Apache、Nginx 等常见 Web 服务器均可，只要能把请求交给 PHP 处理。
• 目录读取权限：PHP 进程需要对你要列出的目录有读取权限，否则页面会打不开或显示为空。
• 不需要数据库：这是它和很多网盘/文件管理程序的区别，省去了建库、配账号的步骤。

安装步骤

1. 获取程序文件
   从 Directory Lister 的官方发布渠道下载程序包，解压后得到一组 PHP 文件和资源文件。

2. 上传到服务器
   把解压后的文件放到网站根目录下的某个子目录，例如 /var/www/html/files/，或者你希望对外展示的目录中。
   预期结果：该目录下能看到 index.php 等程序文件。

3. 通过浏览器访问
   打开 http://你的域名/对应路径/。
   预期结果：页面显示该目录下的文件和文件夹列表，可以逐层点进去浏览。

4. （可选）调整展示目录
   如果你希望程序列出的不是它所在的目录，而是另一个目录，可以按项目文档修改配置，把目标路径指向要展示的目录。
   预期结果：访问入口不变，但列表内容变成指定目录。

常见卡点

• 访问后直接下载 index.php 或显示源码：说明 PHP 没有被正确解析，需要检查 Web 服务器是否安装并启用了 PHP 处理模块。
• 页面空白或提示权限错误：通常是 PHP 进程对目标目录没有读取权限，检查目录权限和所属用户。
• 列表里看不到某些文件：确认这些文件确实在目标目录中，且没有被配置规则排除。
• 放在公开目录下的安全考虑：Directory Lister 会把目录内容公开列出，不要把它指向含有敏感文件的目录，必要时用访问控制限制来源。

适合什么场景

Directory Lister 适合快速把服务器上的一个目录变成可浏览的列表页，比如分享资料、展示下载文件、做内部文件索引。它的优势是轻量、无需数据库；如果你需要用户登录、上传、权限分级等能力，它本身并不提供，需要另找方案或自行扩展。