Directory Lister 魔改 Xdir v1.4.0 发布

　　Xdir是一款源于 Directory Lister，基于2.7.1原版内核，使用PHP开发的目录列表程序，由笔者魔改、优化后的Xdir版本。这是一个非常简单即优秀的目录列表程序，体积小巧，功能丰富强大，界面精致友好，简单实用，上传即用无需数据库，纯保姆级全局调配部署运行。

　　程序后端采用基于Tiny File Manager的管理方式，功能丰富，界面友好，支持像操作本地文件一样具备上传下载、URL上传、多用户账号/密码权限设置、在线编辑、预览、解压、压缩、创建、移动、粘贴、移动、删除、重命名等常规操作，并支持简单的离线下载功能，在线搜索和筛选，支持全局配置文件中隐藏指定文件及文件夹。

　　本次更新共计发布三个版本“赞助版、清爽版、标准版”。最大化减重提速、化繁为简，去除了无用并过气的内容，使用感知、便捷、中文化、响应式布局、自适应各种设备预览、功能较全的一款魔改Xdir版本，其保留了基于Directory Lister原版内核，优化细节的同时并减重程序运行调用速度，全新UI美化，下面是魔改前后对照及Xdir版本的具体功能介绍。

使用方法

• 下载Xdir源码放到站点并解压全部文件至站点指定的Web根目录（有条件的，建议目录尽量放到大一点的储存空间中，方便日后大文件存放）；
• 首先需要将Xdir目录下的文件“config.simple.php”修改为 “config.php” 并检查是否可以正常访问Xdir主页，这一步很重要噢；
• config.php文件为Xdir站点全局统一参数配置部署文件，推荐使用类似Notepad++、EditPlus、DW工具来进行调配；
• 程序做了优化，化繁为简，核心配置统一接口对接，纯保姆式级别全局调配，大大降低并简化非专业人员的代码性繁琐修改；
• 需对Xdir站点根目录权限进行预设，赋予目录\functions\caches读写删权限（Linux / Centos / Ubuntu 等系统下如无http用户，则增加一个，授予读写删权限）;
• 支持 Windows / Linux / Centos / Ubuntu 等系统下部署安装（傻瓜式部署环境建议通过类似面板的方式，有能力的还是建议采用更为专业的环境部署方案）；
• 程序运行核心组件采用PHP内核，建议PHP版本为5.6 – 7.2版本之间为好，官方采取的是PHP 7.4版本，暂不支持更高版本下部署运行，因为笔者未尝试过；
• config.php支持自定义网站标题/关键词/描述/logo/尾部运行起始时间/密码/功能唤醒/忽略目录及文件/简介说明解析方式等，化繁为简，纯保姆级调配；
• 排除首页遍历列表下某个目录或文件，请于路径/resources/config.php中调整屏蔽；
• 排除文件管理器后端列表下不显示某个目录或文件，请于根目录路径/config.php中调整屏蔽；
• 文件索引页面支持通过”功能键盘快捷方式“Ctrl + F”，找文件也是分分钟的事情噢。
• 当Xdir遍历目录列表下出现 .html / .md 文件后缀时，程序则自动判断并显示该文件在遍历目录列表下输出预览，无README文件时则不显示简介功能展示；
• 赞助版（同演示站全线功能一致）
• 清爽版（除无维护模式外同赞助版全线功能一致）
• 标准版（除无暗黑明亮、无维护模式功能外，其余功能保持不变）
• 清爽版、标准版后台管理无Guest只读用户权限启用，可自行调整或有偿支持调整；
• 若开启密码访问方式，修移步至文件“Xdir\resources\themes\bootstrap\index.php”、“gengxin.php”中搜索“访问密码”可修改默认密码参数值；
• 统一配置文件中thedir值，请务必修改为站点实际目录路径，如:/wwwroot/demo.xuxiaokun.com，不修改则无法登陆文件管理器后台；
• 本程序适合个人、初创期单位做网盘，轻需求的你，必备工具的多场景下适用。

注意事项

不显示文件和目录

sed -i 's/,scandir//g' /usr/local/php/etc/php.ini
# 取消scandir函数禁用
/etc/init.d/php-fpm restart
# 重启 PHP生效

如果安装lnmp一键包上传Xdir后，不显示文件和目录，那么可能是PHP函数scandir被禁用了，取消禁用即可。

如果是Windows Server环境下部署，上传Xdir后，不显示文件和目录，那么可能是PHP函数scandir被禁用了，取消禁用即可。（建议宝塔面板类环境自定义部署比较方便）

文件索引打印无索引缓存输出，请检查“\Xdir\functions\caches”目录是否被赐予文件读写权限；

如Xdir目录列表或子文件夹下无README简介说明，目录无README.html 文件时则不显示简介功能区展示，请自行检查文档文件是否存在；

文本后缀格式支持预览功能，上传前，建议对文件用 UTF-8无BOM编码 保存，避免出现中文乱码显示；

PHP优化建议

PHP优化参照建议，需要修改的参数如下：
1）. memory_limit=128M
2）. post_max_size=1024M
3）. upload_max_filesize=1024M
4）. max_execution_time=600
5）. max_input_time=600

修改完成后前往Xdir后台，上传一个大500Mb左右的文件进行测试下试试，因考虑到PHP上传还是比较吃资源的；
尽量避免长时间的大文件上传，如有此需求，可以通过SMB/FTP等共享方式手动上传大文件到Xdir下对应的子目录。

主要功能

• 目录浏览（默认文件夹在最前面）；
• 一键复制（支持普通文件超链接、遍历目录路径链接、CSS/JavaScript/Img 一键复制）；
• 文件Hash
• 图片预览（支持全局预览）；
• 文件索引
• 密码验证（v1.3.5正式版已优化该功能的使用，支持二级目录密码访问，仅赞助用户获取）；
• 音乐播放试听（mp3、wma、wav、ape、flac）
• 视频播放预览（mp4、m3u8、flv、rm、rmvb、mkv、avi）
• 文本预览（txt、py、sh、conf、go、c、cpp、json、html、js、css、reg）注意：支持行号显示、代码高亮、预览区域内一键复制内容
• 支持Markdown文件预览
• office文档预览（doc、docx、ppt、pptx、xls、xlsx）注意：如果是内网或IP访问或非标准多端口方式不支持预览
• PDF预览（PDF文档支持内外网在线预览）
• 文件管理（支持上传、删除、编辑、复制、移动、预览、当前目录和全局搜索、解压缩）
• 增加返回顶部
• 站内搜索功能
• 支持手机界面访问
• 界面式样UI魔改化
• 发展史时间流更新日志页面（可记录站点发展史、更新日志使用）
• 各种CDN文件本地化
• 支持中文目录和文件名
• 支持顶部公告栏，文件独立配置（支持多条并循环滚播，标准版不支持全局修改）；
• 顶部文件为遍历目录最后更新文件的时间显示（仅官网显示）；
• 搜索结果页面增加复制、二维码功能（自 Xdir v1.3.6 版本及以上支持）；
• 支持显示各文件夹内的新简介说明（自 Xdir v1.3.6 版本及以上支持）；
• 新简介说明功能（README文档文件解析模式支持：README.html、README.md，支持锚点定位）；
• 二维码分享功能（自 Xdir v1.3.6 版本及以上支持）；
• 新增暗黑/明亮功能（全局支持开启，默认支持自夜间22点至次日凌晨6点无忧唤醒）；
• 支持站点维护模式功能（高级赞助版支持）；
• 支持顶部公告通知栏，支持多条循环滚动展示（仅**赞助版、标准版**支持）；
• 顶部文件为遍历目录最后更新文件的时间显示；
• 搜索结果页面增加复制功能（自Xdir v1.3.6 版本及以上支持）；
• 支持显示各文件夹内的新简介说明（**高级赞助版**已调整遍历目录优先顶部显示，简介遍历目录下显示）；
• 支持多用户管理后端，默认密码请移至config.php下的设置IP与密码中对应用户密码；
• 支持管理员及普通账号权限，Guest普通用户登陆时，仅支持查阅文件目录及文件，无写入权限；
• 支持安装到二级目录提供访问（比如：www.xuxiaokun.com/Xdir，但个别调用路径需要调整下）；
• 标准版：修改顶部轮播消息，喜欢作者的，可以有偿获得无广告清爽版或重新指向本地资源展示；

更新日志

版本号：魔改 v1.4.0 20230519 正式版

• 增强新功能的使用；
• 细节优化；
• 修复上一版本BUG错误异常；
• 2023/03/08，功能更新，新增复制按钮获取文件后缀自动增加标签SRC属性；
• 2023/03/13，优化更新，复制提醒自动判断文件后缀标签属性，给出不同属性的弹窗提示信息；
• 2023/04/03，功能更新，增加鼠标指针样式，鼠标点击特效（爱心）效果；
• 2023/04/04，功能更新，增加图片格式“.cur”后缀文件预览，优化更新个别遍历附件文件图标显示；
• 2023/04/11，优化更新，HTML5“DPlayer”视频播放器升级至v1.27.1，播放器功能参数优化更新；
• 2023/04/12，功能更新，Xdir 遍历页面加载新增 Loading 等待效果；
• 2023/04/24，优化更新，Disk显示title优化更新，站点更新日志优化更新，更新版本号；
• 2023/04/25，版本发布，Xdir v1.4.0.20230425 Beta version版本上线试运行；
• 2023/05/17，功能、优化更新，简介功能优化升级，新增Readme文档解析模式配置（html、md）、支持添加锚点，官网站点界面UI样式优化调整；
• 2023/5/19，版本发布，Xdir v1.4.0.20230519 正式版本上线运行；

文件结构

假设你的主机是/home/wwwroot/Xdir v1.4.0

/home/wwwroot/Xdir v1.4.0
│
├─ functions
│   ├ caches
│   │    └ indexes.html # 索引文件 #
│   │    └ css
│   │       └ dropzone.min.css # 自定义样式 #
│   │    └ js
│   │       └ dropzone.min.js # JavaScript脚本文件 #
│   │    └ .....
├─ resources
│   ├ jianzhanshi
│   │  └ .....
│   ├ Top
│   │  └ .....
│   ├ themes
│   │  └ bootstrap
│   ├       └ css # 样式文件夹 #
│   ├       └ fonts
│   ├       └ img
│   ├       └ js # JavaScript脚本文件夹 #
│   ├       └ less
│   ├       └ scss
│   ├       └ default_bulletin.php # 顶部公告栏内容 #
│   ├       └ default_footer.php # 底部公共文件 #
│   ├       └ default_header.php # 顶部公共文件（可放网站流量统计代码）#
│   ├       └ index.php # 站点主文件 #
│   ├ DirectoryLister.php # 核心函数处理文件 #
│   ├ config.php  # 基础配置文件 #
│   └ fileTypes.php # 遍历图标控制器 #
│   └ Parsedown.php # Markdown解析器 #
│   └ ParsedownExtra.php # 可配置的Markdown到HTML转换器 #
│   └ ParsedownExtraPlugin.php # Markdown扩展插件 #
├─ static
├─   └ ..... # 核心库文件夹 #
├─ template
├─   └ gengxin # 更新日志页 #
├─   └ img
├─   └ .....
├ README.html / README.md  # 文件夹内简介说明文件 #
├ config.simple.php  # 核心配置文件 #
├ index.php # 核心 #
├ gengxin.php  # 更新日志调用 #
├ Xdir v1.4.0 LOGO.png
├ LICENSE # 许可证 #
├ COPYING # 许可说明 #
├ 其它文件*.*

历史版本更新日志

版本号：魔改 v1.3.8 20220627 正式版

• 2022/5/11，减轻重量，提升运行性能；
• 2022/5/15，优化CSS/Javascript，以及部分功能细节优化；
• 2022/5/17，新增当前位置导航路径目录复制按钮功能，方便目录链接分享；
• 2022/6/15，优化复制文件及目录链接弹窗提醒样式；
• 2022/6/15，优化功能按钮CSS；
• 2022/6/15，升级jQuery版本；
• 2022/6/16，支持jQuery的图像预览imagePreview功能，支持全局预览；
• 2022/6/21，功能区域新增“下载按钮”；
• 2022/6/23，功能区域新增“音乐、视频、office文档预览按钮”，待优化为判断文件后缀类型并自动识别显示功能按钮；
• 2022/6/25，功能区域新增“文本、MD文档预览按钮”，并优化判断文件后缀类型并自动识别显示功能按钮；
• 2022/6/25，功能区域按钮样式优化更新；
• 2022/6/27，发布 Xdir v1.3.8 20220627 正式版，功能强大，使用便捷，体积轻、访问快；
• 2022/6/29，文本预览新增支持“go、c、cpp、json”后缀格式并支持代码高亮预览；
• 2022/10/9，Tiny File Manager 2.4.1 优化，部分字符中文显示；
• 2022/10/17，更新二维码API接口；

版本号：魔改 v1.3.7 20220420 正式版

• 2022/4/16，站标LOGO及文本UI效果调整；
• 2022/4/16，优化遍历目录列表导航栏UI效果；
• 2022/4/17，优化新简介功能展开和折叠状态，默认为折叠状态，简介功能配置独立文件调用，修复当子目录下无简介文件时默认隐藏简介说明；
• 2022/4/18，优化CSS，部分CSS压缩、格式化，大力提升加载速度；
• 2022/4/19，优化JS，部分Javascript压缩、格式化，大力提升加载速度；；
• 2022/4/20，遍历目录列表文件后缀图标更新；
• 2022/4/20，修复一些BUG错误；
• 2022/4/23，修复建站史页面部分谷歌字体为国内调用；
• 2022/4/25，因站长统计cnzz.com需要续费，现更新为百度统计；

下一版本更新预告

版本号：魔改 v1.4.* Beta version

• 增强新功能的使用；
• 细节优化；
• 修复上一版本BUG错误异常；

呜谢

　　基于 Directory Lister 2.7.1 魔改 Xdir v1.4.0 的诞生离不开以下资源的技术支撑，其内核原版版权归原作者所有。

• Directory Lister 2.7.1
• Zdir
• Tiny File Manager
• LayUI
• jQuery Growl
• jQuery.imagePreview
• highlightjs-line-numbers
• jquery-jtoast
• DPlayer
• Markdown
• woytu

Demo

索取源码方式

赞助版¥88.00

白金会员¥33.44

黄金会员¥15.84

钻石会员¥免费

版本 v1.4.0 大小 6.1Mb 发行 2023/5/19 更新 2023/5/19 功能 与官网一致 下载量 820

推荐使用 开通会员

已付费？登录 或 刷新

索取 Xdir 赞助版解压密码

索取解压密钥 ¥1.00

开通会员

白金会员¥免费

黄金会员¥免费

钻石会员¥免费

已有822人解锁查看

已付费？登录 或 刷新

清爽版¥68.00

白金会员¥25.84

黄金会员¥12.24

钻石会员¥30.00

版本 v1.4.0 大小 2.66Mb 发行 2023/5/19 更新 2023/5/19 功能 与赞助版一致 下载量 307

立即下载 开通会员

已付费？登录 或 刷新

标准版

白金会员¥免费

黄金会员¥免费

钻石会员¥免费

版本 v1.4.0 大小 6.04Mb 发行 2023/5/19 更新 2023/5/19 价格 ¥8.00 下载量 623

立即下载 开通会员

已付费？登录 或 刷新

此处内容已经被作者无情的隐藏，请输入验证码查看内容！

验证码：

请关注“ITxuxiaokun”官方公众号，回复关键字“v1.4.0”，获取验证码。
【注】微信扫描二维码可快速关注“ITxuxiaokun”官方公众号。

一起来秀一秀吧，以下格式跟帖互动！
1、您的昵称：
2、电子邮箱：
3、将作何用：
4、不妨拿出来秀秀（访问地址）：

历史上的今天

2020年：WordPress如何加入右键复制弹出提示框（0条评论）

2020年：WordPress后台访问速度慢的解决办法（0条评论）

2020年：Discuz!X 目录结构（总览）（0条评论）

2015年：MySQL无法关停启动，无法改变状态。（0条评论）

本文最后更新于 2023-07-17 11:21