一：简介

• h5ai是一款功能强大php文件目录列表程序，不需要数据库。它提供多种文件目录列表呈现方式，支持Apache httpd,
  lighttpd, nginx等多种web服务器，支持多国语言（如英语，简体中文等），你可以在线预览txt，图片，音频，视频等文件格式。
• h5ai功能包括：文件排序，不同视图模式，本地化，面包屑，树视图，自定义页眉和页脚，文件过滤器和搜索，文件夹大小，自动刷新，打包下载，QR码，缩略图，文件预览。
• 仅支持直接在线查看PDF、TXT、PHP、sh
• doc不能在线阅读，只可以下载

h5ai官网 | github下载地址

二：h5ai安装

要求：PHP 5.5+
在宝塔面板，我们需要在php中安装ImageMagick、fileinfo、exif扩展。
我们可以在官网下载安装，也可以在github上下载，不过官网打开貌似不稳定。我们下载程序包，解压然后将_h5ai上传到网站根目录

设置
添加/_h5ai/public/index.php到默认的首页列表中. 以下是Apache、Nginx等修改配置的方法：

Apache：

DirectoryIndex  index.html  index.php  /_h5ai/public/index.php

lighttpd：

index-file.names += ("index.html", "index.php", "/_h5ai/public/index.php")

nginx：

index  index.html  index.php  /_h5ai/public/index.php;

Cherokee：

vserver!1!directory_index = index.html,index.php,/_h5ai/public/index.php

宝塔面板在网站设置→默认文档底部添加/_h5ai/public/index.php省略上面步骤

三：使用与问题

目录修改
默认的_h5ai文件夹可以修改一下，比如修改成h5ai
需要修改以下两个地方

• 网站默认文档：网站设置→默认文档里面添加为h5ai/public/index.php
• options.json文件：h5ai/private/conf/options.json，修改"hidden"后方内容大约69行，将_h5ai改为h5ai如下--

   "view": {
        "binaryPrefix": false,
        "disableSidebar": false,
        "fallbackMode": false,
        "fastBrowsing": true,
        "fonts": ["Ubuntu", "Roboto", "Helvetica", "Arial", "sans-serif"],
        "fontsMono": ["Ubuntu Mono", "Monaco", "Lucida Sans Typewriter", "monospace"],
        "hidden": ["^\\.", "^h5ai"],
        "hideFolders": false,
        "hideIf403": true,
        "hideParentFolder": false,
        "maxIconSize": 40,
        "modes": ["details", "grid", "icons"],
        "modeToggle": false,
        "setParentFolderLabels": true,
        "sizes": [20, 40, 60, 80, 100, 140, 180, 220, 260, 300],
        "theme": "comity",
        "unmanaged": ["index.html", "index.htm", "index.php"],
        "unmanagedInNewWindow": false
    }

设置访问密码
在_h5ai/public/index.php最下面增加以下代码：

function mima(){

        $user=array('填写你的用户名','填写你的密码');

        if(!($user[0]===$_SERVER['PHP_AUTH_USER'] && $user[1]===$_SERVER['PHP_AUTH_PW'])){

          header('WWW-Authenticate: Basic realm="MY Mark"');

          header('HTTP/1.0 401 Unauthorized');

          die("please login");

        }

}

然后在第一行，也就是<?php的下面（也就是第二行）插入以下代码：

mima();

h5ai其它的一些配置，例如字体、CSS、标题等都可以在options.json文件进行修改。默认路径： _h5ai/private/conf/options.json

运行异常
如果存在文件，但读不出来，可能原因就是php已禁用scandir函数了，将php.ini中的putenv、exec、passthru三个函数删除，将private和public两个文件夹中的cache目录权限设置为777

disable_functions=passthru,exec,system,chroot,scandir,...

删掉scandir,字样，再重启php即可：/etc/init.d/php-fpm restart

缩略图异常
需要配置好PHPexif模块、ffmpeg、ImageMagick等组件。

设置默认中文语言

"l10n": {
   "enabled": true,
   "lang": "zh-cn",
   "useBrowserLang": true
},

版权修改
修改_h5ai/private/php/pages/index.php文件，建议保留网站右上角的powerby部分！