php-file-browser 基于PHP开发的可生成静态页面的在线文件浏览器
php-file-browser 基于PHP开发的可生成静态页面的在线文件浏览器截图演示
作者：jokin1999
下载地址：https://github.com/file-browser/php-file-browser
常见问题：1.静态模式(index.html)启用方法tool.php程序文件默认是动态模式，如果需要静态模式把下面的一段代码中的 IS_CLI === FALSE 改为 IS_CLI !== FALSE 即可。
// 生成静态文件与运行if (IS_CLI === FALSE) {echo $tpl;}else{// 相对路径不允许设置index.html保存位置$filename = isset($config['static_file']) && !empty($config['static_file']) ? $config['static_file'] : './index.html';file_put_contents($filename, $tpl);}
2.解决中文网址内容不显示问题
含有中文字符的网址链接被转为Unicode编码后， 在手机版浏览器打开，子目录不显示中文，仍为Unicode编码，并且子目录内的文件也不显示的解决方法：
在index.tpl文件中查找如下一段 JavaScript代码：path = path.substring(0, 1) == '#' ? path.substring(2) : path;在此行下面添加一行如下代码：path = decodeURI(path);
添加完成后，此段完整代码如下： function opendir(path = '') { path = path.substring(0, 1) == '#' ? path.substring(2) : path; path = decodeURI(path); console.log('open: ' + path); location.href = '#/' + path; $('#list').html(''); if (path == '') { arr = list; $('#nav').html($('#nav_item').html().replace('{{__NAME__}}', '根目录').replace('{{__PATH__}}', '')); }else{ var sp = path.split('/'); var arr = list; var nav_path = ''; var nav_item = ''; $('#nav').html($('#nav_item').html().replace('{{__NAME__}}', '根目录').replace('{{__PATH__}}', '')); $.each(sp, function(key, value){ nav_path = (nav_path == '' ? nav_path : nav_path + '/') + value; nav_item = '/ ' + value; $('#nav').html($('#nav').html() + $('#nav_item').html().replace('{{__NAME__}}', nav_item).replace('{{__PATH__}}', nav_path)); arr = arr; }); }
3.英文长文件名不自动换行问题文件列表页中，但显示屏的宽度不足以显示文件名时，如果是中文长文件名会自动换行显示，英文和数字长文件名则不自动换行。
解决方法：在index.tpl文件中查找如下一段 div 代码：<div id="content" >在此行代码中内联一个css样式：<div id="content" style="word-break: break-all;">添加完成后，此段完整代码如下： <div id="content" style="word-break: break-all;"> <table class="table table-hover"> <thead> <tr> <th scope="col">文件名</th> <th scope="col">操作</th> </tr> </thead> <tbody id="list"> </tbody> </table> </div>
4.给文件名称添加超链接方法文件列表中的所有文件标题都没有超链接，如果是图片、PDF、txt之类的可在线预览的文件，只能通过右侧下载按钮，下载到本地后才能浏览，无法实现通过浏览器在线预览，给文件名称添加超链接可解决此问题，方法如下：在index.tpl文件中查找id标识为"list_item" 的一段template 标签代码，把其中的 {{__NAME__}} 添加超链接即可，添加后代码如下： <template id="list_item"> <tr> <th scope="row"> <i class="fas {{__ICON__}} fa-fw"></i> <a href="{{__PATH__}}" target="_blank" > {{__NAME__}} </a> </th> <td> {{__DOWNLOAD__}} {{__VIDEO__}} {{__AUDIO__}} {{__FILE__}} </td> </tr>
</template>
5.json相关生成的json是所有目录与文件，导航是根据这个json文件进行无刷新切换目录的，这个json文件在新版本自动集成在静态文件中了，不再外挂。
# php-file-browser
基于PHP开发的可生成静态页面的在线文件浏览器
https://img.shields.io/github/fo ... r?style=flat-square
https://github.com/file-browser/php-file-browser/network
https://img.shields.io/github/is ... r?style=flat-square
https://github.com/file-browser/php-file-browser/issues
https://img.shields.io/github/v/tag/file-browser/php-file-browser?style=flat-square
https://cdn.jsdelivr.net/gh/file-browser/pages@latest/demo_2.0.0.png
## 特性介绍
- 现代化设计风格
- 极简操作
- 无刷新更新页面
- 可过滤显示文件与文件夹
- 可自定义标题
- 可自定义子标题
- 可自定义关于与鸣谢
- 可设置是否显示多媒体下载按钮
- 支持环境变量设置
- 支持扫描目录自定义
- 支持代码压缩
- 支持远程模板（仅推荐在静态模式使用）
- 支持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版本**
页:
[1]