Skip to content
/ hfs4OSS Public

HTTP File Server for OSS:搭建一个云HTTP文件服务器,配合OSS,实现文件列表、上传下载、管理。

License

Notifications You must be signed in to change notification settings

YXuuan/hfs4OSS

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

87 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

hfs4OSS

在具备PHP代码执行环境和OSS对象存储服务的条件下,作为云HTTP文件服务器,提供简单的文件列表、上传下载、管理等功能。
相较于将文件直接存放在本地,无存储总量限制、传输速率限制、低可靠数据安全等问题。
对于移动终端也有良好的支持性。

SDK:aliyun-oss-php-sdk-2.3.0
样式:h5ai v0.29.0

预览/Demo

image

部署/Build

# git clone https://github.com/YXuuan/hfs4OSS.git
  1. 开通OSS服务、新建存储空间、上传文件:OSS新手入门
  2. 了解基本的OSS属性信息,得到Endpoint
  3. 申请具有对应访问权限的AccessKey
  • 配置:
    填写APP配置文件config/app.config.php
ROOT_DIR		:(str)根目录路径,类似于FTP服务器的虚拟目录显示(例如此项为"photo/"则会将photo文件夹下的内容当作根目录显示),为空则为不设置;
	注意:必须以"/"结尾且开头无需用"/"表示根目录
SIGNEDURL_TIMEOUT	:(int)每次下载文件时请求的签名URL有效期时长(秒)。缺省值:3600;
SHOW_FILEDATE		:(bool)是否显示文件修改时间;
ROOT_AUTH		:(arr)全站访问验证:
	[
		ENABLED			:(bool)是否开启,
		PASSWORD		:(str)访问密码,程序将在首次访问时要求输入,为空则为不设置,	
		FIRSTMET		:(str)首次时提示的信息,
		IFWRONG			:(str)密码错误的提示信息;
	];
AUTH			:(arr)目录访问验证:
	[			:一个数组设置一个路径,详见example
		PATH			:(str)需要验证的路径(包含ROOT_DIR的绝对路径),
		ENABLED			:(bool)是否开启,
		PASSWORD		:(str)访问密码,程序将在首次访问时要求输入,为空则为不设置,	
		FIRSTMET		:(str)首次时提示的信息,
		IFWRONG			:(str)密码错误的提示信息;
	],
	[
		...
	],
	...;

填写OSS配置文件config/oss.config.json:

ACCESS_ID		:(str)AccessKey ID值;
ACCESS_KEY		:(str)AccessKey Key值;
ENDPOINT		:(str)Endpoint值;
	注意:必须带前缀http://或https://
ENDPOINT_IS_CNAME	:(bool)如果Endpoint为自定义域名,此项为true;
BUCKET			:(str)存储空间(Bucket)名;

前端配置文件config/static.config.json:

SITE_NAME		:(str)站点名称;
SHOW_STATS		:(bool)底部是否显示状态信息,缺省值为true;
FOOTER			:(str)底部Footer的HTML代码;
  • 文件结构:
/
├──app/		--后端目录
	├──action/		--后端入口目录
	├──class/		--类库
	├──function/		--函数库
	└──sdk/		--SDK目录
├──config/	--配置文件目录
	├──app.config.php	--后端配置文件
	├──oss.config.php	--OSS配置文件
	└──static.config.json	--前端配置文件
├──static/	--前端目录
	├──_h5ai/		--h5ai目录
	└──script/		--前端脚本
└──index.html

更新日志/ChangeLog

version 2.4.1 2019-03-26
	[修复] 全站验证开关无效的问题
	[优化] 视频播放功能调用细节

更多:CHANGELOG.md

使用到的开源项目/Reference

已知的问题/Problems

顶部crumbbar过长时无法展示也无法收缩
	:歇菜
[已解决]直接通过url锚值入参访问某级目录时,父目录和当前目录共包含有两个及以上密码配置时无法正确请求
	:尽量避免父目录和子目录同时包含有密码或将子目录密码配置居于AUTH数组中较上的位置

后续可能的改动/Preview

[划掉]给不同类型的文件不一样的图标
[划掉]输出item的大小
批量下载(非压缩闭包)
简单的object管理功能(上传,重命名等)
[划掉]列表排序
[划掉]不同的路径不同的密码
前端多国语言支持
前端自定义文本支持
多站点配置支持
安装向导

开源协议/License

MIT License

Copyright (c) 2017-2018 YXuuan

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.