Xdir是一款使用基于PHP开发的目录列表程序，基于开源 Directory Lister 2.7.1 原版内核并由笔者魔改成功的Xdir版本。这是一个非常简单又非常优秀的目录列表程序，无需数据库，体积小，功能完善，简单实用，界面友好，下载源码开箱即用，干脆又直接 ，简直纯保姆级调配。
本次更新共计发布三个版本“赞助版、清爽版、标准版”。程序上最大程度满足了功能上的刚需使用，也新增了例如文件预览格式增加、视听格式增加、图片预览格式增加、支持PDF预览、支持全局暗黑明亮模式、支持站内更新日志系统展示、程序核心参数配置统一接口、复制功能表现等优化。它是一款可以列出中英文目录内容的目录列表程序，在众多的目录列表程序中也一直保持简洁的风格。本次更新最大化减重提速了，去除了无用并过气的内容，提升整体使用感知、使用便捷、中文化、体验感好、响应式布局、自动适应各种设备、功能较全的一款魔改Xdir版本，它保留了Directory Lister原版内核，优化细节的同时并减重提升调优了程序运行速度，全新UI美化，下面是魔改前后的对照及Xdir V1.3.9版本中新增的具体功能介绍。
使用方法
- 下载源码放到站点指定的根目录，并解压全部文件至站点根目录（
有条件的，建议目录尽量放到大一点的储存空间中，方便日后大文件存放）； - 首先需要对“config.simple.php”配置文件进行统一参数调整，推荐使用类似Notepad++、EditPlus、DW工具来进行调配，完事后务必将 “config.simple.php” 修改为 “config.php” ，并检查是否正常访问Xdir主页，这一步很重要噢，否则访问失败，程序统一进行了部分接口对接，纯保姆级别调配；
- 修改其程序列表中\functions\caches其属性权限权限（Linux / Centos / Ubuntu 等系统下如无http用户，则增加一个，授予读写删权限）
- 建议使用PHP为5.6 – 7.2版本之间为好；
- 支持 Windows / Linux / Centos / Ubuntu 等系统下运行部署安装；
- 统一config.php配置中支持设置自己的网站标题/关键词/描述/logo/站点尾部运行起始年月日/密码/功能唤醒/忽略目录及文件等基础参数设置（后续版本会继续新增接口对接），减少繁琐的操作，纯保姆级调配；
- 排除某个目录，请于根目录/config.php中调整屏蔽；
- 文本格式预览功能，上传前，建议对文件用 UTF-8无BOM编码 保存，避免出现中文乱码显示；
- 遍历目录下不显示文件和目录时，请检查是否取消scandir函数的禁用；
- 索引打印页面访问失败，提示“无法打开文件！”请检查80/443端口是否被更改使用，程序默认用80/443端口访问，如需自定义可自行调整或有偿支持调配；
- 文件索引打印无索引缓存输出，请检查“\Xdir\functions\caches”目录是否被赐予文件读写权限；
- 文件索引页面通过”功能键盘快捷方式“Ctrl + F”，找文件也是分分钟的事情噢。
- 当目录下出现 README.html 文件时，则自动启用并显示该文件夹页面内简介说明预览，目录无README.html 文件时则不显示简介功能区展示；
- 赞助版（同演示站全线功能一致，获取方式见帖子下方自行所取）
- 清爽版（除无维护模式外同赞助版全线功能一致，获取方式见帖子下方自行所取）
- 标准版（除无暗黑明亮、无维护模式功能外，其余功能保持不变，获取方式见帖子下方自行所取）
- 清爽版、标准版后台管理无Guest只读用户权限启用，可自行调整或有偿支持调整；
- 若开启密码访问方式，修移步至文件“Xdir\resources\themes\bootstrap\index.php”、“gengxin.php”中搜索“访问密码”可修改默认密码参数值；
- 统一配置文件中thedir值，请务必修改为站点实际目录路径，如:/wwwroot/demo.xuxiaokun.com，不修改则无法登陆文件管理器后台；
- 适合做网盘，轻需求的你必备工具。
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下对应的子目录。主要功能
- 目录浏览
- 一键复制
- 文件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） - office文档预览（
doc、docx、ppt、pptx、xls、xlsx，仅支持域名方式下预览） - 新增PDF文件预览（支持内外网预览）
- 新增REG文件预览
- 新增文件预览代码高亮（支持行号显示、代码区域一键复制）
- 优化更新（个别文件后缀识别图标样式更新、消息提醒功能优化更新、减重提速优化、JS、CSS版本及优化调整更新、细节、性能优化）
- 支持Markdown文件预览
- 文件管理（Tiny File Manager 2.4.1）
- 返回顶部功能
- 站内搜索功能
- 支持手机界面访问
- 界面式样UI魔改化
- 发展史时间流页面（去除旧版功能，新增v1.0.0版本）
- 各种CDN文件本地化
- 支持中文目录和文件名
- 二维码分享功能；
- 新增暗黑/明亮功能（全局支持开启，默认支持自夜间22点至次日凌晨6点无忧唤醒）
- 支持站点维护模式功能（高级赞助版支持）；
- 支持顶部公告通知栏，支持多条循环滚动展示（
仅赞助版、标准版支持） - 顶部文件为遍历目录最后更新文件的时间显示
- 搜索结果页面增加复制功能（ 自Xdir v1.3.6 版本及以上支持）
- 支持显示各文件夹内的新简介说明（
高级赞助版已调整遍历目录优先顶部显示，简介遍历目录下显示） - 支持多用户管理后端，默认密码请移至config.php下的设置IP与密码中对应用户密码
- 支持管理员及普通账号权限，Guest普通用户登陆时，仅支持查阅文件目录及文件，无写入权限
- 支持安装到二级目录提供访问（比如：www.xuxiaokun.com/Xdir，但个别调用路径需要调整下）
- 标准版：修改顶部轮播消息，喜欢作者的，可以有偿获得无广告清爽版或重新指向本地资源展示
更新日志
版本号：魔改 v1.3.9 20221205 正式版
- 2022/11/15，性能优化；
- 2022/11/15，优化CSS/Javascript，以及部分功能细节优化；
- 2022/11/15，新增顶部炫酷暗黑模式/夜间模式自助按钮功能，默认支持自夜间22点至次日凌晨6点无忧模式；
- 2022/11/15，新增功能，支持线上PDF文档预览（支持内外网预览）；
- 2022/11/15，更新上一版本二维码失效的问题，调整API接口；
- 2022/11/15，其他细节优化；
- 2022/11/16，修复上一版本BUG问题，更新layer至3.5.1版本，支持弹窗预览时最大化/最小化；
- 2022/11/17，功能更新，支持线上JS、HTML、CSS文件预览，并支持代码高亮；
- 2022/11/18，功能更新，支持线上REG、HTM文件预览，并支持代码高亮；
- 2022/11/18，优化更新，个别图标样式更新、文件管理器个别中文转码更新；
- 2022/11/21，优化更新，代码高亮更新、优化调整后支持自动识别文件类型展示代码高亮，并支持代码自动行号、支持一键复制功能；
- 2022/11/23，魔改 v1.3.9 2022.11.23 正式版，上线；；
- 2022/11/23，魔改 v1.3.9 2022.11.23 正式版，优化更新，优化文本查看器代码高亮区域实现左右滑动块，方便看全内容；
- 2022/11/26，魔改 v1.3.9 2022.11.23 正式版，优化更新，调整并支持jquery-jtoast样式的消息提醒；
- 2022/11/27，魔改 v1.3.9 2022.11.23 正式版，版本更新，调整站点更新日志页面，去除旧日志页面，减轻站点程序体积；
- 2022/12/01，魔改 v1.3.9 2022.11.23 正式版，优化更新，调整文本查看器代码复制随屏滚动、消息提醒由jquery-mac-message-tips提供支持；
- 2022/12/06，魔改 v1.3.9 2022.12.05 正式版，优化调优、版本发布；
contact_support
问题反馈请移步至：问答社区Xdir用户及问题反馈
文件结构
假设你的主机是/home/wwwroot/Xdir v1.3.9
/home/wwwroot/Xdir v1.3.9
│
├─ functions
│ ├ caches
│ │ └ indexes.html # 索引文件 #
│ │ └ css
│ │ └ dropzone.min.css
│ │ └ js
│ │ └ dropzone.min.js
│ │ └ .....
├─ resources
│ ├ jianzhanshi
│ │ └ .....
│ ├ Top
│ │ └ .....
│ ├ themes
│ │ └ bootstrap
│ ├ └ css
│ ├ └ fonts
│ ├ └ img
│ ├ └ js
│ ├ └ less
│ ├ └ scss
│ ├ └ default_bulletin.php # 顶部公告栏内容 #
│ ├ └ default_footer.php # 底部公共文件 #
│ ├ └ default_header.php # 顶部公共文件（可放网站流量统计代码）#
│ ├ └ index.php # 站点主文件 #
│ ├ DirectoryLister.php # 核心文件 #
│ ├ config.php # 基础配置文件 #
│ ├ default.config.php
│ └ fileTypes.php
├─ static
├─ └ .....
├─ template
├─ └ .....
│
├ README.html # 文件夹内简介说明文件 #
├ config.simple.php # 核心配置文件 #
├ index.php
├ gengxin.php # 更新日志调用 #
├ Xdir v1.3.9 LOGO.png
├ .gitignore
├ LICENSE
└ COPYING
│
├ 其它文件.*升级方法：
由于此次版本更新，目录结构有所变动，新增文件和删除了部分陈旧文件和目录，建议备份数据后重新部署安装Xdir最新版。
历史版本更新日志
历史版本号：魔改 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.0 Beta version
- 增强新功能的使用；
- 细节优化；
- 修复上一版本BUG错误异常；
- 功能更新，新增复制按钮获取文件后缀自动增加标签SRC属性；
- 优化更新，复制提醒自动判断文件后缀标签属性，给出不同属性的弹窗提示信息；
- 功能更新，增加鼠标指针样式，鼠标点击特效（爱心）效果；
- 功能更新，增加图片格式“.cur”后缀文件预览，优化更新个别遍历附件文件图标显示；
- 优化更新，HTML5“DPlayer”视频播放器升级至v1.27.1，播放器功能参数优化更新；
- 功能更新，Xdir 遍历页面加载新增 Loading 等待效果；
呜谢
基于 Directory Lister 2.7.1 魔改 Xdir v1.3.9 的诞生离不开以下资源的技术支撑，其内核原版版权归原作者所有。
- Directory Lister 2.7.1
- Zdir
- Tiny File Manager
- LayUI
- jQuery Growl
- jQuery.imagePreview
- highlightjs-line-numbers
- jquery-jtoast
- DPlayer
Demo
Xdir v1.3.9 正式版：https://demo.xuxiaokun.com/
Directory Lister v2.7.1 原版魔改 v1.3.9 赞助版于 20221205 编译发布（与原版功能一致）
索取源码方式
白金会员
黄金会员Xdir v1.3.9 标准正式版源码可关注笔者公众号，并按指定格式跟帖留言可免费索取。魔改不易，也可线上获取对应版本，赞助版及清爽版支持提供线上技术支持，标准版技术相关问题请跟帖或问答社区提问。
Xdir v1.3.9 20221205 标准、清爽正式版源码解压缩密码获取方式，请通过公众号获取验证码。
此处内容已经被作者无情的隐藏，请输入验证码查看内容！
请关注“ITxuxiaokun”官方公众号，回复关键字“v1.4.0”，获取验证码。
【注】微信扫描二维码可快速关注“ITxuxiaokun”官方公众号。
【注】微信扫描二维码可快速关注“ITxuxiaokun”官方公众号。
更新补丁包
本次修复文本查看器Xdir部署在云端及本地时调用的CDN文件出现复制弹窗无效以及滚动条异常，现修复更改为本地调取方式，即解决本地和云端部署通用，请12月27日之前下载使用的用户尽快下载以下附件并解压后直接覆盖路径\wwwroot\functions\下的补丁文件即可完成更新修复。
一起来秀一秀吧，以下格式跟帖互动！
1、您的昵称：
2、电子邮箱：
3、将作何用：
4、不妨拿出来秀秀（访问地址）：历史上的今天
2023年：总结PHP如何获取当前主机、域名、网址、路径、端口和参数等（0条评论）
本文最后更新于 2023-06-09 09:23
请博主喝杯咖啡呢，谢谢^_^
如果本文“对您或有帮助”，欢迎随意打赏，以资鼓励继续创作！
原创文章《Directory Lister魔改Xdir v1.3.9发布》，作者：笔者 徐哲
，未经允许不得转载。
转载或复制时，请注明出处：https://www.xuxiaokun.com/2846.html，本文由 Mr.xu 博客网 整理。
本站资源下载仅供个人学习交流，请于下载后24小时内删除，不允许用于商业用途，否则法律问题自行承担。
微信扫一扫赞赏 
支付宝扫一扫赞赏 
评论列表（7条）
看看赞助版本1227补丁包，谢谢！
这个工具确实不错噢，界面比较简洁明了，关键自动支持明暗模式，确实是我想要得，部署易用性比较可以，简单，功能嘛相对比较全了，主要我用着比较实用就行啦，谢啦 [呲牙]
@7654：喜欢这款工具就行，满足所需要而部署使用，有任何问题和好的建议请及时反馈，再次感谢你对本工具的支持。
软件简单用着方便，高端大气，值得信赖，长期使用
@0502：感谢你的支持，有任何问题可以及时反馈。
终于见到你了，还以为需要到跨年才能看到这个超牛的版本，看了下这次更新动作挺大啊，框架也有所变化了，最大不足感觉是复制功能不支持自适应，也就是当复制前端文件时无法自动添加格式，不过总体来说，这个版本真的不错了，众多目录列表来说，这个还算比较简洁流畅度比较可以咯，看了下个别文件已经本地化了，也有国内访问速度稳定的cdn接入点，大幅度还是提升不少程序的响应，尤其我这2g以上附件较多的情况下，整体表现度还是蛮不错的，后续也希望对SEO加强优化，360貌似收录的较少。
@1353：感谢你的支持与反馈建议，后期更新或将考虑此类建议。