一款不错的PHP目录列表程序：h5ai安装教程

2018 年 02 月 11 日

2664 次浏览

2570字数

## 简介
`h5ai`是一款功能强大的`php`文件目录列表程序，它提供多种文件目录列表呈现方式，支持`Apache httpd`, `lighttpd`, `nginx`等多种web服务器，支持多国语言（如英语，简体中文等），你可以在线预览`txt`，图片，音频，视频等文件格式。

**h5ai官网：**https://larsjung.de/h5ai/

## 截图
![h5ai.png](https://blog.litchi.ren/usr/uploads/2018//02/1474176615.png)
##安装
**要求：**`PHP 5.5+`

**1、搭建php网站环境**
可使用军哥的`lnmp`、`lamp`一键包或者`amh`、`vestacp`、宝塔等面板程序搭建。

**2、上传h5ai文件到网站根目录**
`h5ai`本地下载地址：[h5ai-0.29.0.zip](http://d.xtrboy.com/Blog/h5ai-0.29.0.zip "h5ai-0.29.0.zip")，将文件解压后放在网站根目录。

**3、修改配置文件**
只需要在配置文件某个地方加上`/_h5ai/public/index.php`即可，比如：
Apache httpd 2.2 / 2.4：`httpd.conf`
```
DirectoryIndex  index.html  index.php  /_h5ai/public/index.php
```
lighttpd 1.4：`lighttpd.conf`

```
index-file.names += ("index.html", "index.php", "/_h5ai/public/index.php")
```
nginx 1.2：`nginx.conf`
```
index  index.html  index.php  /_h5ai/public/index.php;
```
**4、重启 web 服务器：**

service php-fpm restart
service nginx reload

并将要共享的文件均放到根目录（与`_h5ai`同一目录下）。
**5、结构目录**

虚拟主机 `ROOT` 目录大概是这个样子的，要在网站上显示的目录和 `_h5ai` 文件夹放在一起：

├── _h5ai
│   ├── CHANGELOG.md
│   ├── private
│   ├── public
│   └── README.md
├── 您要显示的文件夹
│   ├── 子文件夹1
│   ├── 文件1
│   └── 文件2
└── 您要显示的文件夹
├── 文件1
└── 文件2
## h5ai 功能扩展
#### 安装 FFmpeg
CentOS：

安装 `FFmpeg` 或 `libav`。

FFmpeg：
注意：请转至 http://www.ffmpeg.org/releases/ 查看最新的 `FFmpeg` 版本。

编译安装。

```shell
wget http://www.ffmpeg.org/releases/ffmpeg-*.*.tar.gz
tar -zxvf ffmpeg-*.*.tar.gz
cd ffmpeg-*.*
./configure
make
make install
```

libav：

http://libav.org/download/

下载源码编译即可。

#### 略缩图功能
**图片：**

把`h5ai`程序`_h5ai`中`private`和`public`两个文件夹中的`cache`目录权限设置为`777`。

**EXIF：**

通过 `phpize` 安装 `PHP` 的 `exif` 模块即可。

**视频略缩图：**

参考安装 `FFmpeg` 即可。
**PDF 略缩图：**

安装 `ImageMagick`。

可使用如下命令：

CentOS:

`yum install ImageMagick -y`
#### Shell tar、Shell zip和Shell du

参考注意事项去除在 `php.ini` 中被禁用函数 `exec`与 `passthru` 即可。

另外去除禁用的 `scandir` 函数（如果有），不然会导致无法显示目录。

#### options.json 中的更多功能
位于 `_h5ai/private/conf` 目录下。

打包下载：
搜索 `download`
127 行，`enabled` 由 `false` 改为 `true`。

文件信息及二维码：
搜索 `info`
185 行，`enabled` 由 `false` 改为 `true`。

默认简体中文：
搜索 `l10n`
202 行，`enabled` 由 `false` 改为 `true`。

文件及文件夹多选：
搜索 `select`
323 行，`enabled` 由 `false` 改为 `true`。

默认密码：为空

首先生成自定义 sha512 密码：
http://tool.oschina.net/encrypt?type=2
然后搜索 `passhash`，大概第 10 行，将其密码改成自己生成的。

##注意
如果存在文件，但读不出来，可能原因就是`php`已禁用`scandir`函数了，请修改`php.ini`解决。
```
disable_functions=passthru,exec,system,chroot,scandir,...
```
删掉`scandir`,字样，再重启`php`即可：`/etc/init.d/php-fpm restart`。

一款不错的PHP目录列表程序：h5ai安装教程