DirectoryLister 项目常见问题解决方案

项目基础介绍

DirectoryLister 是一个开源项目，旨在提供一种简单的方式来展示和分享任何可访问的网页文件夹内容。该项目的主要编程语言是 PHP，并且它支持多种功能，如文件搜索、文件哈希验证、README 文件渲染、ZIP 下载以及多语言支持等。

新手使用注意事项及解决方案

1. PHP 版本要求

问题描述: DirectoryLister 要求 PHP 版本 >= 8.0。如果服务器的 PHP 版本低于 8.0，项目将无法正常运行。

解决步骤:

• 检查当前服务器的 PHP 版本：在终端中运行 php -v 命令。
• 如果 PHP 版本低于 8.0，需要升级 PHP 版本。可以通过包管理器（如 apt 或 yum）或手动编译安装最新版本的 PHP。
• 升级完成后，再次运行 php -v 确认版本是否符合要求。

2. ZIP 扩展未启用

问题描述: 项目需要 ZIP 扩展来支持 ZIP 文件的下载功能。如果 ZIP 扩展未启用，ZIP 下载功能将无法使用。

解决步骤:

• 检查 ZIP 扩展是否启用：在终端中运行 php -m | grep zip，如果没有输出，说明 ZIP 扩展未启用。
• 启用 ZIP 扩展：编辑 php.ini 文件，找到 ;extension=zip 这一行，去掉前面的分号，保存并退出。
• 重启 Web 服务器（如 Apache 或 Nginx）以使更改生效。

3. README 文件渲染问题

问题描述: 项目依赖 DOM 和 Fileinfo 扩展来渲染 README 文件。如果这些扩展未启用，README 文件将无法正确显示。

解决步骤:

• 检查 DOM 和 Fileinfo 扩展是否启用：在终端中运行 php -m | grep dom 和 php -m | grep fileinfo，如果没有输出，说明这些扩展未启用。
• 启用 DOM 和 Fileinfo 扩展：编辑 php.ini 文件，找到 ;extension=dom 和 ;extension=fileinfo 这两行，去掉前面的分号，保存并退出。
• 重启 Web 服务器以使更改生效。

通过以上步骤，新手用户可以解决在使用 DirectoryLister 项目时可能遇到的常见问题，确保项目能够正常运行。