Zdir是一款使用PHP开发的目录列表程序


主要功能

目录浏览
MarkDown文件预览
CSS/JavaScript一键复制
文件hash
图片预览
文件索引
二维码生成
文件删除
视频播放
文本查看器

安装Zdir

具体步骤如下:
1.访问 https://github.com/helloxz/zdir/archive/master.zip 下载最新源码，并解压到站点根目录。
2.修改config.php 文件，里面有说明，后面会详细介绍。
3.访问您的域名测试

config.php配置文件说明

设置站点基本信息

打开config.php 配置文件

$siteinfo = array(
        "title"        =>    "Zdir 实用的目录列表程序",
        "keywords"    =>    "zdir,h5ai,Directory Lister,Fdscript,目录列表,目录索引",
        "description"    =>    "Zdir是一款使用PHP开发的目录列表程序，简单实用，免费开源。"
    );

title:设置站点标题
keywords：设置网站关键词
description：设置网站描述

排除某个目录

//需要忽略的目录
    $ignore    = array(
        ".",
        ".git",
        "favicon.ico",
        "functions",
        "config.php",
        "index.php",
        "static",
        "LICENSE",
        "template",
        "cache.php",
        "indexes.php"
    );

如果您需要排除某个目录，请修改上面的$ignore变量。

删除文件设置

为了安全性考虑，Zdir仅允许指定的IP和对应的密码才拥有删除权限，您可以修改config.php设置自己的IP，由于本地IP可能经常发生变化，因此可添加多个IP或192.168.这样的IP段。如果您不想限制IP，可填写0.0.0.0 ，这样只需要密码即可删除文件。

//设置IP与密码
    $config = array(
        "allowip"    =>    array(
            "::1",
            "127.0.0.1",
            "192.168.1."
        ),
        "password"    =>    "xiaoz.me"
    );

Zdir 管理与维护

Markdown预览

Zdir支持Markdown文件预览，该预览功能存在1-2小时缓存，因此如果您更新了.md文件，但是内容未及时更新是正常现象。

文件索引

为了快速找出需要的文件，Zdir提供了文件索引功能，可访问http://您的域名/cache.php进行查看，访问该页面后可按Ctrl + F搜索文件，如下截图。

为了降低资源消耗，文件索引存在24小时缓存，您可以访问cache.php?del=cache清除当前缓存并重新生成索引。

删除文件

在您访问的页面加上?admin或&admin 参数，文件后面会出现删除按钮，可以对文件进行删除，如下截图。

删除密码是在config.php中设置，请看删除文件设置.

文件搜索

文件搜索功能依赖于“文件索引”，因此请先确保您的文件索引功能可以正常使用，并且已经成功生成了索引文件。然后在右上角输入搜索框进行搜索，如下截图。

升级Zdir

1.打开functions/version.txt可以查看当前Zdir版本
2.如果不存在version.txt这个文件，说明您正在使用beta版本，请尽快参考如下方法升级

beta版本升级v1.0正式版

2019.01.17之前下载的版本均为beta版本，请尽快升级到最新版本，升级方法如下。

1.备份好重要数据
2.删除beta版本的Zdir，需要删除的文件如下
        /functions
        /static
        /template
        /cache.php
        /index.php
        /indexes.php
3.然后下载最新版解压覆盖即可

正式版之后升级

直接下载最新版解压覆盖原来的文件，如果有其它需要配置会特殊说明