PHPを使用してウェブサイトのディレクトリ構造を出力 – ディレクトリツリーブラウザ – 指定されたフォルダのツリー構造を安全に表示します。

目次ツリーブラウザ – 指定されたフォルダのツリーモデルを安全に表示します

使用方法：
1. 本ファイルをウェブサイトのルートディレクトリに配置し、「tree.php」またはその他の名前を付けてください。
2. 下記の `TARGET_BASE` 定数を変更し、閲覧対象のルートフォルダ（ウェブサイトのルートディレクトリに対する相対パス）を設定してください。
3. ブラウザでアクセス：http://あなたのウェブサイト/tree.php
4. オプションパラメータ：`?dir=サブフォルダのパス` —— サブディレクトリを表示します。例：`?dir=images/icons`

セキュリティ特性：
- すべてのパスは `realpath` によって検証されており、ディレクトリ越境攻撃を防止しています。
- TARGET_BASEディレクトリおよびそのサブディレクトリへのアクセスのみ許可されます。
- 出力時には htmlspecialchars を用いてエンコードし、XSS攻撃を防ぐ。

<?php
/**
 * 目录树浏览器（文本风格）- 使用树形连线符号代替缩进空格
 * 
 * 使用方法：
 * 1. 将本文件放置于网站根目录，命名为 tree.php 或其他名称
 * 2. 修改下方的 TARGET_BASE 常量，设置您要浏览的根文件夹（相对于网站根目录）
 * 3. 通过浏览器访问：http://您的网站/tree.php
 * 4. 可选参数 ?dir=子文件夹路径 来浏览子目录，例如：?dir=images/icons
 * 
 * 安全特性：
 * - 所有路径均经过 realpath 验证，防止目录遍历攻击
 * - 只允许访问 TARGET_BASE 目录及其子目录
 * - 输出使用 htmlspecialchars 转义，防止 XSS 攻击
 */

// ---------- 配置区域 ----------
// 定义要浏览的根文件夹（相对于网站根目录 $_SERVER['DOCUMENT_ROOT']）
// 例如：'storage' 表示浏览 /网站根目录/storage
define('TARGET_BASE', '');  // 请修改为您需要显示的文件夹名称

// 是否显示隐藏文件（以点开头的文件/文件夹）
define('SHOW_HIDDEN', false);

// 图标定义（仍保留，使输出更友好）
define('ICON_FOLDER', '');
define('ICON_FILE', '');
// -----------------------------

// 设置时区与编码
date_default_timezone_set('Asia/Shanghai');
header('Content-Type: text/html; charset=utf-8');

// 基础路径：网站根目录下的目标文件夹
$basePath = rtrim($_SERVER['DOCUMENT_ROOT'], DIRECTORY_SEPARATOR) . DIRECTORY_SEPARATOR . TARGET_BASE;
$baseReal = realpath($basePath);

// 检查基目录是否存在且可读
if ($baseReal === false) {
    die("<h2>错误：基目录不存在或不可读</h2><p>请检查配置：<code>" . htmlspecialchars($basePath) . "</code></p>");
}

// 获取请求的子目录参数，并清理
$requestDir = isset($_GET['dir']) ? trim($_GET['dir'], '/\\ ') : '';
$requestDir = str_replace(['../', '..\\'], '', $requestDir); // 额外过滤，但主要依赖 realpath

// 构建完整目标路径
if ($requestDir !== '') {
    // 替换目录分隔符为系统分隔符
    $requestDir = str_replace(['/', '\\'], DIRECTORY_SEPARATOR, $requestDir);
    $targetPath = $baseReal . DIRECTORY_SEPARATOR . $requestDir;
} else {
    $targetPath = $baseReal;
}

// 获取目标路径的真实路径（必须存在）
$targetReal = realpath($targetPath);
if ($targetReal === false) {
    die("<h2>错误：请求的路径不存在或无法访问</h2><p>路径：" . htmlspecialchars($targetPath) . "</p>");
}

// 安全检查：确保目标路径在基目录之下
$baseRealWithSep = $baseReal . DIRECTORY_SEPARATOR;
if (strpos($targetReal . DIRECTORY_SEPARATOR, $baseRealWithSep) !== 0 && $targetReal !== $baseReal) {
    die("<h2>错误：无权访问指定目录</h2>");
}

// 获取当前目录相对于基目录的路径（用于URL）
$relativePath = ($targetReal === $baseReal) ? '' : substr($targetReal, strlen($baseReal) + 1);
$relativePathForUrl = str_replace(DIRECTORY_SEPARATOR, '/', $relativePath);

/**
 * 递归生成文本风格的目录树（带连线符号）
 *
 * @param string $path      绝对路径
 * @param string $prefix    前缀字符串（用于递归构建连线）
 * @return array            每行文本组成的数组
 */
function buildTreeLines($path, $prefix = '') {
    $lines = [];
    $items = @scandir($path);
    if ($items === false) {
        return ['<无法读取目录>'];
    }

    // 过滤掉 . 和 ..
    $items = array_diff($items, ['.', '..']);
    
    // 如果不显示隐藏文件，过滤以点开头的项目
    if (!SHOW_HIDDEN) {
        $items = array_filter($items, function($item) {
            return $item[0] !== '.';
        });
    }

    // 自然排序：文件夹在前，文件在后，各自按名称排序
    $folders = [];
    $files   = [];
    foreach ($items as $item) {
        $fullPath = $path . DIRECTORY_SEPARATOR . $item;
        if (is_dir($fullPath)) {
            $folders[] = $item;
        } else {
            $files[] = $item;
        }
    }
    natcasesort($folders);
    natcasesort($files);
    $sortedItems = array_merge($folders, $files);

    $count = count($sortedItems);
    $i = 0;
    foreach ($sortedItems as $item) {
        $i++;
        $isLast = ($i === $count);
        $fullPath = $path . DIRECTORY_SEPARATOR . $item;
        $safeName = htmlspecialchars($item);
        
        // 选择连接符
        $connector = $isLast ? '└── ' : '├── ';
        
        if (is_dir($fullPath)) {
            // 文件夹行
            $lines[] = $prefix . $connector . ICON_FOLDER . ' ' . $safeName;
            // 递归子文件夹，生成新的前缀
            $subPrefix = $prefix . ($isLast ? '    ' : '│   ');
            $subLines = buildTreeLines($fullPath, $subPrefix);
            $lines = array_merge($lines, $subLines);
        } else {
            // 文件行：附加文件大小
            $size = filesize($fullPath);
            $sizeFormatted = formatBytes($size);
            $lines[] = $prefix . $connector . ICON_FILE . ' ' . $safeName . ' (' . $sizeFormatted . ')';
        }
    }
    return $lines;
}

/**
 * 格式化字节数
 */
function formatBytes($bytes, $precision = 2) {
    $units = ['B', 'KB', 'MB', 'GB', 'TB'];
    $bytes = max($bytes, 0);
    $pow = floor(($bytes ? log($bytes) : 0) / log(1024));
    $pow = min($pow, count($units) - 1);
    $bytes /= (1 << (10 * $pow));
    return round($bytes, $precision) . ' ' . $units[$pow];
}

/**
 * 获取父目录的相对路径（用于返回上一级）
 */
function getParentRelative($currentRelative) {
    if (empty($currentRelative)) {
        return null; // 已经在根目录，无上级
    }
    $parts = explode(DIRECTORY_SEPARATOR, $currentRelative);
    array_pop($parts);
    return implode(DIRECTORY_SEPARATOR, $parts);
}

// 生成当前目录的文本树行数组
$treeLines = buildTreeLines($targetReal);
$treeText = implode("\n", $treeLines);

// 获取当前目录名称（用于显示）
$currentDisplayName = ($targetReal === $baseReal) ? TARGET_BASE . ' (根)' : basename($targetReal);
?>
<!DOCTYPE html>
<html lang="zh">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>目录树浏览器（文本风格） - <?php echo htmlspecialchars($currentDisplayName); ?></title>
    <style>
        * {
            box-sizing: border-box;
        }
        body {
            font-family: 'Segoe UI', 'SF Pro Text', 'Helvetica Neue', sans-serif;
            background: #f8f9fa;
            margin: 0;
            padding: 20px;
            color: #2c3e50;
        }
        .container {
            max-width: 1200px;
            margin: 0 auto;
            background: white;
            border-radius: 16px;
            box-shadow: 0 10px 30px rgba(0,0,0,0.1);
            overflow: hidden;
            padding: 25px 30px;
        }
        h1 {
            margin-top: 0;
            font-size: 1.8rem;
            font-weight: 400;
            border-bottom: 1px solid #e9ecef;
            padding-bottom: 15px;
            color: #1e3c5c;
        }
        h1 small {
            font-size: 0.9rem;
            font-weight: 300;
            color: #6c757d;
            margin-left: 10px;
        }
        .path-bar {
            background: #e9ecef;
            border-radius: 30px;
            padding: 10px 20px;
            margin-bottom: 25px;
            display: flex;
            align-items: center;
            flex-wrap: wrap;
            gap: 10px;
            font-size: 0.95rem;
        }
        .path-label {
            font-weight: 600;
            color: #495057;
            margin-right: 5px;
        }
        .path-links {
            display: flex;
            flex-wrap: wrap;
            align-items: center;
            gap: 5px;
        }
        .path-links a {
            color: #0d6efd;
            text-decoration: none;
            padding: 2px 8px;
            border-radius: 20px;
            background: white;
            border: 1px solid #dee2e6;
            transition: 0.2s;
        }
        .path-links a:hover {
            background: #0d6efd;
            color: white;
            border-color: #0d6efd;
        }
        .path-links span.sep {
            color: #adb5bd;
            margin: 0 2px;
        }
        .nav-form {
            margin-left: auto;
            display: flex;
            gap: 8px;
        }
        .nav-form input {
            padding: 8px 15px;
            border-radius: 30px;
            border: 1px solid #ced4da;
            width: 250px;
            font-size: 0.9rem;
        }
        .nav-form button {
            background: #0d6efd;
            color: white;
            border: none;
            border-radius: 30px;
            padding: 8px 20px;
            cursor: pointer;
            font-weight: 500;
            transition: 0.2s;
        }
        .nav-form button:hover {
            background: #0b5ed7;
        }
        /* 文本树样式 */
        .tree-container {
            background: #fefefe;
            border-radius: 12px;
            padding: 20px;
            font-family: 'SF Mono', 'Fira Code', 'Consolas', 'Courier New', monospace;
            font-size: 1rem;
            line-height: 1.5;
            overflow-x: auto;
            border: 1px solid #e9ecef;
            white-space: pre;
            margin: 15px 0;
        }
        .tree-text {
            margin: 0;
            color: #212529;
        }
        .footer {
            margin-top: 30px;
            text-align: center;
            font-size: 0.85rem;
            color: #6c757d;
            border-top: 1px solid #e9ecef;
            padding-top: 15px;
        }
        .footer code {
            background: #e9ecef;
            padding: 2px 6px;
            border-radius: 6px;
        }
        .parent-link {
            display: inline-block;
            background: #e7f3ff;
            color: #0d6efd;
            padding: 8px 18px;
            border-radius: 30px;
            text-decoration: none;
            font-weight: 500;
            border: 1px solid #b8daff;
            transition: 0.2s;
        }
        .parent-link:hover {
            background: #0d6efd;
            color: white;
            border-color: #0d6efd;
        }
    </style>
</head>
<body>
    <div class="container">
        <h1>
             目录树浏览器（文本风格）
            <small><?php echo htmlspecialchars(TARGET_BASE); ?> 及其子目录</small>
        </h1>

        <!-- 路径导航 -->
        <div class="path-bar">
            <span class="path-label">当前位置：</span>
            <div class="path-links">
                <a href="?">根目录</a>
                <?php
                // 生成面包屑导航
                if (!empty($relativePath)) {
                    $parts = explode(DIRECTORY_SEPARATOR, $relativePath);
                    $cumulative = '';
                    echo '<span class="sep">/</span>';
                    foreach ($parts as $index => $part) {
                        $cumulative .= ($cumulative ? DIRECTORY_SEPARATOR : '') . $part;
                        $safePart = htmlspecialchars($part);
                        $url = '?dir=' . urlencode(str_replace(DIRECTORY_SEPARATOR, '/', $cumulative));
                        if ($index === count($parts) - 1) {
                            echo '<span>' . $safePart . '</span>';
                        } else {
                            echo '<a href="' . $url . '">' . $safePart . '</a><span class="sep">/</span>';
                        }
                    }
                }
                ?>
            </div>

            <!-- 快速跳转子目录表单 -->
            <form class="nav-form" method="get" action="">
                <input type="text" name="dir" placeholder="输入子目录路径 (如 images/icons)" value="<?php echo htmlspecialchars($relativePathForUrl); ?>">
                <button type="submit">跳转</button>
            </form>
        </div>

        <!-- 文本树输出 -->
        <div class="tree-container">
            <pre class="tree-text"><?php
                // 输出根目录行，然后输出树内容
                echo ICON_FOLDER . ' ' . htmlspecialchars($currentDisplayName) . "\n";
                echo $treeText;
            ?></pre>
        </div>

        <!-- 父目录链接与说明 -->
        <div style="margin-top: 20px;">
            <?php
            $parentRelative = getParentRelative($relativePath);
            if ($parentRelative !== null):
                $parentUrl = '?dir=' . urlencode(str_replace(DIRECTORY_SEPARATOR, '/', $parentRelative));
            ?>
                <a href="<?php echo $parentUrl; ?>" class="parent-link">⬆ 返回上一级 (<?php echo htmlspecialchars(basename($parentRelative) ?: '根目录'); ?>)</a>
            <?php endif; ?>
        </div>

        <div class="footer">
            <p> 安全限制：只能浏览 <code><?php echo htmlspecialchars($baseReal); ?></code> 及其子目录 | 隐藏文件<?php echo SHOW_HIDDEN ? '显示' : '不显示'; ?> | 连线符号: ├── └── │</p>
        </div>
    </div>
</body>
</html>