php-file-browser

基于PHP开发的可生成静态页面的在线文件浏览器

特性介绍

• 现代化设计风格
• 极简操作
• 无刷新更新页面
• 可过滤显示文件与文件夹
• 可自定义标题
• 可自定义子标题
• 可自定义关于与鸣谢
• 可设置是否显示多媒体下载按钮
• 支持环境变量设置
• 支持扫描目录自定义
• 支持代码压缩
• 支持远程模板（仅推荐在静态模式使用）
• 支持index.html文件保存位置自定义
• 支持jsDelivr加速下载（仅GitHub部署有效）

依赖

• PHP > 7.0

环境变量设置

• 所有.config.example文件中的设置项都可以覆盖设置
• 使用全部大写的设置项键值加上前缀FB_即可覆盖

例如配置项 title

KEY: FB_TITLE
VALUE: 欲设置的标题

静态模式使用方法（推荐）

自建

• 修改.config配置
• 增加文件至根目录
• 运行tool.php生成index.html文件

GitHub Action

• 修改.config配置
• 增加文件至根目录
• 提交GitHub
• 等待Action提交gh-pages分支
• 开启Pages

动态模式使用方法

• 修改.config配置
• 将tool.php重命名为index.php

国内访问加速

• 配置Action
• 登录vercel.com
• 导入项目
• 绑定域名
• 将该域名设置分支为gh-pages
• 再次触发Deploy即可生效

环境变量设置

• 查看.config文件中需要修改的配置项
• 配置项全部大写并加上前缀FB_
• 如FB_TITLE
• 设置环境变量后需要再次运行Action生效

版本重大修改说明

2.0.0

• 远程模板版本不再与主程序版本一致
• 远程模板优先使用CDN方式获取
• 配置文件不兼容1.x.x版本