如何在HTML/PHP中实现更美观的目录文件列表展示

1. 先开启错误提示定位具体问题 #

在你的PHP脚本最开头加入以下代码，直接访问页面就能看到具体报错信息，不用盲猜：

<?php
error_reporting(E_ALL);
ini_set('display_errors', 1);

如果报「Permission denied」就是权限问题，报「No such file or directory」就是路径写错了，报「open_basedir restriction in effect」就是目录访问被PHP配置限制了。

2. 权限问题（最常见） #

外接硬盘的目录权限不足会直接导致web进程无法遍历文件：

• 先确认web服务器运行用户，执行命令ps aux | grep [a]pache（Apache环境）或ps aux | grep [n]ginx（Nginx环境），输出第一列就是运行用户，Ubuntu默认环境通常为www-data
• 执行ls -ld /你的/pdf目录/绝对路径查看目录的权限和所属用户组，目录需要读+执行权限才能遍历内容
  • 如果硬盘是EXT4等Linux原生格式，直接执行sudo chmod -R o+rx /你的/pdf目录/绝对路径给所有用户开读和执行权限，或者执行sudo chown -R www-data:www-data /你的/pdf目录/绝对路径把目录所属权改为web运行用户
  • 如果硬盘是NTFS/exFAT格式，挂载时需要指定web用户的uid/gid，先执行id www-data获取对应的uid和gid（默认通常是33），修改fstab挂载配置，在挂载参数里加上uid=33,gid=33，重新挂载后权限才会生效

3. 路径配置错误 #

opendir传入的路径不正确会导致无法读取目录：

• 不要使用相对路径，优先用PHP常量__DIR__获取当前脚本所在目录的绝对路径，比如opendir(__DIR__)就能直接指向你放PHP脚本的pdf目录，避免相对路径相对于web执行目录不一致的问题
• 可以临时加调试代码输出路径验证：var_dump(__DIR__); exit;，访问页面确认输出的路径和你存放pdf的实际目录完全一致

4. PHP open_basedir限制 #

很多环境会开启open_basedir配置限制PHP可访问的目录范围，外接硬盘路径不在允许列表里就会被拦截：

• 在脚本里加phpinfo(); exit;访问页面，搜索open_basedir配置项，如果有配置值，确认你的pdf目录在允许的路径列表里，没有的话修改php.ini或者对应站点的配置（Apache可以改.htaccess，Nginx可以改fastcgi_param配置）把pdf目录路径加进去

5. 脚本遍历逻辑错误 #

就算opendir执行成功，遍历逻辑写错也会没有输出，你可以用以下最小可用代码测试，确认基础功能正常后再改样式：

<?php
// 存pdf的目录，这里用__DIR__就是当前脚本所在目录
$pdfDir = __DIR__;
$pdfList = [];

if ($dirHandle = opendir($pdfDir)) {
    while (($file = readdir($dirHandle)) !== false) {
        // 跳过特殊目录、当前PHP脚本、css文件
        $ext = strtolower(pathinfo($file, PATHINFO_EXTENSION));
        if ($file == '.' || $file == '..' || $ext == 'php' || $ext == 'css') {
            continue;
        }
        // 只保留pdf文件可以额外加判断：if ($ext == 'pdf')
        $pdfList[] = $file;
    }
    closedir($dirHandle);
}

// 输出列表
foreach ($pdfList as $pdf) {
    echo '<p><a href="'.htmlspecialchars($pdf).'" target="_blank">'.htmlspecialchars($pdf).'</a></p>';
}

你把PHP脚本放在pdf目录下的位置是正确的，不需要调整。

内容的提问来源于stack exchange，提问作者monkkey