一:简介

  • 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部分!

最后修改:2020 年 06 月 07 日 09 : 02 PM
您的大名:
万水千山总是情,给个打赏行不行。 打赏