h5ai介绍
h5ai
是一款功能强大的php
文件目录列表程序,它提供多种文件目录列表呈现方式,支持Apache httpd, lighttpd, nginx
等多种web服务器,支持多国语言(包涵简体中文),他还支持在线预览文档,自动识别各种语言并高亮显示代码。甚至支持在线预览图片、在线播放音频,视频等文件。实况很强大的目录列表程序。
搭建
1.1安装web服务器
安装h5ai首先需要一个web+php
服务器环境,例如lnmp/lamp
等,从简单易用角度出发,本文以宝塔面板为环境,介绍h5ai
的安装。其他环境大同小异。
所以我们先安装宝塔管理面板,具体安装脚本,请移步宝塔官网,安装完成后进入管理后台面板,它会弹出推荐安装界面,单纯的h5ai
只需要nginx
和php
,nginx
保持默认即可,php版本≥ php5.5
(基于目前官网最新版本0.29.0)。其余的组件可以根据你自己的其他需求自行选择安装。
1.2下载h5ai源文件并创建虚拟主机
- nginx与php安装完成后,进入宝塔面板的网站管理,添加站点,填入你的域名,如果没有域名直接填入ip地址也可以,提交完成站点新建。这时候你可以打开你的域名或ip看是又没新建成功,如果成功应该显示的是宝塔的默认欢迎页面。
- 接下来下载h5ai源文件,解压,并上传至刚刚新建的站点根目录,这些操作可以使用面板的文件管理功能来完成。这时候站点根目录的结构应该是这样的:
即你需要显示的文件与文件夹与_h5ai文件夹同级!。
1.3修改虚拟主机配置
- 接着你需要修改站点的配置文件,进入面板的网站管理,点击设置你刚刚创建的站点,选择配置文件,修改成如下图,然后保存配置文件。(
index /_h5ai/public/index.php;
)
- 因为h5ai需要调用php的
exec
、passthru
函数,而这两个函数默认是被宝塔所禁用的,因此需要解除禁用。具体操作为进入面板的软件管理界面,选择你站点所使用的php设置,选择禁用函数,从列表中删除exec
、passthru
,
在其他环境中也许scandir这个函数也是被默认禁用的,也需要解除禁用,否则将不显示目录与文件!
1.4初始配置
- 通过 http://站点域名/_h5ai/public/index.php 访问界面如下,初始密码为空,点击
- 出现以下界面即可。
进行到这一步,h5ai就已经基本可用了,你可以打开你的域名或ip查看效果了