yaf-oss

基于yaf框架的仿阿里云oss私有静态资源服务器

---

yaf_oss简介

1. 此源码结合了yaf框架和阿里云oss的授权原理sts，自行结合开发，目前只实现了一些常用功能，并没有做集群开发，所以只用于互联公司自身的业务需要，作为自用静态资源服务器
2. 业务服务器作为超级管理员admin，访问yaf_oss服务器，可以对其进行任何业务操作，最好是内网连接，不是内网请做好防火墙等安全措施
3. 简单介绍下sts流程，业务服务器admin获取ststoken授权，此授权低权限，低时效，返回给客户端，客户端用ststoken鉴权上传文件到yaf_oss，yaf_oss会将文件保存至缓冲区(会被定时清除)并返回结果，客户端将结果上报给业务服务器，业务服务器再与yaf_oss核对信息后将合法文件储存。
4. 通过nginx配置，在客户端上传文件时使用安全的https，访问文件时使用更加快速的http，具体配置这里不赘述。

一.配置环境

1. php环境

   1. php版本：7.0及以上，推荐版本7.2(5.5,5.6版本理论上也可以，可能需要修改部分bug)
   2. yaf扩展：2.0以上，推荐3.0以上(2.0只支持到php5.5,5.6)
   3. php.ini配置：
      1. 错误等级,推荐E_ALL & ~E_NOTICE
      2. 加入yaf配置

      [yaf]
      extension=yaf.so
      yaf.use_namespace=1
      yaf.cache_config=1
      yaf.environ=dev     #(dev,local,product根据部署环境填写)
      

2. nginx环境

   1. 版本：1.9以上,推荐1.14，低版本未尝试(apache理论上也是可以的，但未尝试)
   2. 配置,参考demo示例:

   server {
   	listen      80;
   	server_name oss.yourdomain.com;		#填写自己的域名
   	charset     utf-8;
   	
   	access_log  /usr/www/log/yourdomain-oss-access.log;
   	error_log   /usr/www/log/yourdomain-oss-error.log;
   
   
   	root    /usr/www/yaf_oss/public/;
   
   	index   index.php;
   	
   	location / {
   		##以下跨域设置
   		if ( $request_method = OPTIONS ) {
   			add_header Access-Control-Allow-Origin *;
   			add_header Access-Control-Allow-Methods GET,POST,PUT,PATCH,DELETE,OPTIONS,HEAD;
   			add_header Access-Control-Allow-Headers Origin,X-Requested-With,Content-Type,Accept,Authorization;
   			return 200;
   		}
   		##以上跨域设置
   		try_files $uri $uri/ /index.php$is_args$args;
   	}
   	
   	##静态资源公共读
   	location ~ /(public|cache/public) {
   		root /usr/www/yaf_store/;
   	}
   
   	location ~ \.php$ {
   		include fastcgi_params;
   		fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
   		#fastcgi_param  HTTPS	on;		#开启https标识
   		fastcgi_pass 127.0.0.1:9000;
   		try_files $uri =404;
   	}
   	
   	location ~* /\. {
   		deny all;
   	}
   	
   }
   

3. redis环境

   1. 版本：4.0以上，推荐5.0以上，低版本理论理论可行但未尝试
   2. php拓展版本：推荐3.0以上

二.运行环境

1. 配置

   1. 集成了local，lan，dev，product四个环境，对应php.ini中的yaf.environ配置，具体请参考yaf-oss\conf\dev\application.ini
   2. yaf_oss\conf\errorcode.ini为错误代号，方便调试和查找错误，尤其是正式环境运行错误代号显得更重要，这部分也可以自己设计，更改请认真阅读相关源码。
   3. web入口文件为yaf-oss\public\index.php，cli入口文件为yaf-oss\yaf.php，可以在入口文件做一些全局操作，比如引入composer

2. 集成

   1. library中集成了redis，file，log等操作类，为本源码使用的功能插件，自行结合yaf开发，不足之处可以自行修改
   2. 集成了composer，但是本源码示例并未用到，web接口需要用到请打开yaf_oss\public\index.php注释的composer部分，同理，cli需要用到也可以添加引入composer部分

3. 运行

   1. web运行：作为示例源码，为了简单易懂并没有使用yaf的路由，即{{host}}/oss/sts/token对应的模块是oss，控制器是StsController，方法是tokenAction()，实际使用中需要的话请自行加入yaf路由
   2. cli运行：由于本系统有cache文件缓冲机制，需要运行定时命令，进入yaf-oss根目录，运行php yaf.php File/Recovery/delCache清理过期文件，建议配置在linux定时任务crond中，示例：

   0 1 * * *  cd /usr/www/yaf-oss ; php yaf.php File/Recovery/delCache
   

   运行的对应方法是yaf-oss\application\library\command\中的File目录Recovery.php中的delCache()，可以仿造此模式编写其它cli脚本

三. 接口文档

详情请见api.md