thinkphp整合系列之阿里云oss

白俊遥
2016-05-14 21:38:43
PHP
ThinkPHP

web2.0时代；除了纯信息展示类的网站；基本都是有文件上传功能的；
最不济你得让用户换个头像吧；但是随着业务的发展；
如果上传的文件都和网站程序源代码放在一起；那是有相当多的弊端的；
1：静态文件会占用大量带宽；
2：服务器的成本略高；
常规的做法是把php源代码放到一台服务器上；图片等静态文件放在另一台服务器上；
当一个神奇的“云”时代的到来后；一切就变的更加简单了；
在业务还比较小的时候；我们无需大费周折的去搞一台静态文件服务器；直接使用第三方的即可；
好了；洛里啰嗦了半天；下面请出本篇博客的主角：阿里云oss；
我就不再安利oss的优势了；还没了解过的先跟着这个链接走：https://www.aliyun.com/product/oss/
一：准备工作
1：申请key和secret
白俊遥博客
2：创建Bucket

需要注意的是要把读写权限改为：公共读；

根据服务器的位置获取外网endpoint；https://help.aliyun.com/document_detail/31834.html

ok；凑齐了这些配置项；下面可以召唤神龙了；
二：填写配置项
依然是以项目示例：https://github.com/baijunyao/thinkphp-bjyadmin
/Application/Common/Conf/config.php

    'ALIOSS_CONFIG'          => array(
        'KEY_ID'             => '', // 阿里云oss key_id
        'KEY_SECRET'         => '', // 阿里云oss key_secret
        'END_POINT'          => '', // 阿里云oss endpoint
        'BUCKET'             => ''  // bucken 名称
        ),

三：实例化并上传
/Application/Common/Common/function.php

/**
 * 实例化阿里云oos
 * @return object 实例化得到的对象
 */
function new_oss(){
    vendor('Alioss.autoload');
    $config=C('ALIOSS_CONFIG');
    $oss=new \OSS\OssClient($config['KEY_ID'],$config['KEY_SECRET'],$config['END_POINT']);
    return $oss;
}
/**
 * 上传文件到oss并删除本地文件
 * @param  string $path 文件路径
 * @return bollear      是否上传
 */
function oss_upload($path){
    // 获取配置项
    $bucket=C('ALIOSS_CONFIG.BUCKET');
    // 先统一去除左侧的.或者/ 再添加./
    $oss_path=ltrim($path,'./');
    $path='./'.$oss_path;
    if (file_exists($path)) {
        // 实例化oss类
        $oss=new_oss();
        // 上传到oss
        $oss->uploadFile($bucket,$oss_path,$path);
        // 如需上传到oss后 自动删除本地的文件 则删除下面的注释
        // unlink($path);
        return true;
    }
    return false;
}

ok现在首先使用框架的Upload上传类上传文件到服务器；获得文件路径；
调用oss_upload()函数；传入获得的文件路径；即可把文件上传到oss；
四：便捷方式
看第三步；我们可以发现；每上传一个文件就要调用oss_upload()函数；
那可不可以上传文件以后自动就上传到oss呢？
当然可以了；但是我们要对框架的Upload做点手术；
在 /ThinkPHP/Library/Think/Upload.class.php 的第229行添加如下代码；

//*************************添加部分开始*************************
// 判断是否上传成功
if (!empty($info)) {
    // 获取需要上传到oss的目录
    $need_upload_oos=C('NEED_UPLOAD_OSS');
    foreach ($info as $k => $v) {
        // 判断此路径是否需要上传到oss
        foreach ($need_upload_oos as $m => $n) {
            if (strpos($v['savepath'], $n)!==false) {
                // 上传到oss
                oss_upload($v['savepath'].$v['savename']);
                continue;
            }
        }
    }
}
//*************************添加部分结束*************************

白俊遥博客
然后在配置项中设置哪些目录的文件自动上传到oss；
/Application/Common/Conf/config.php

'NEED_UPLOAD_OSS'        => array( // 需要上传的目录
    '/Upload/avatar',
    '/Upload/cover',
    '/Upload/image/webuploader',
    '/Upload/video',
    ),

如果只有个别目不上传、或者是所有目录都上传的；直接改配置项和Upload即可；
四：获取文件链接
图片之类的静态文件是上传到oss了；那链接怎么获取呢？
/Application/Common/Common/function.php

/**
 * 获取完整网络连接
 * @param  string $path 文件路径
 * @return string       http连接
 */
function get_url($path){
    // 如果是空；返回空
    if (empty($path)) {
        return '';
    }
    // 如果已经有http直接返回
    if (strpos($path, 'http://')!==false) {
        return $path;
    }
    // 获取bucket
    $bucket=C('ALIOSS_CONFIG.BUCKET');
    return 'http://'.$bucket.'.oss-cn-beijing.aliyuncs.com'.$path;
}

调用上面这个get_url()函数；传入第三步获取到的文件路径；即可得到oss的文件链接；
到此；从创建、上传、获取文件链接；整个流程就结束了；
如果要整合到自己有的项目中；
那只需要把/ThinkPHP/Library/Vendor/Alioss文件夹拷贝到自己项目同目录下；
把上面哪些配置项和函数拿过去就可以直接用；
//*******************************回复鹤山童鞋的分割线************************
应鹤山童鞋的要求；这里增加了删除oss上的文件的函数

/**
 * 删除oss上指定文件
 * @param  string $object 文件路径 例如删除 /Public/README.md文件  传Public/README.md 即可
 */
function oss_delet_object($object){
    // 实例化oss类
    $oss=new_oss();
    // 获取bucket名称
    $bucket=C('ALIOSS_CONFIG.BUCKET');
    $test=$oss->deleteObject($bucket,$object);
}

方法还是挺简单的；唯一需要注意的是注释中写的路径的问题；

本文为白俊遥原创文章,转载无需和我联系,但请注明来自白俊遥博客https://baijunyao.com 欢迎捐赠赞赏加入组织创建QQ群及捐赠渠道

上一篇： thinkphp整合系列之rbac的升级版auth权限管理系统demo
下一篇： thinkphp整合系列之phpmailer批量发送邮件

请先登录后发表评论

latest comments
总共56条评论

cyberwin ：牛

2020-02-20 01:21:54 回复

分不清的＇殇：如何生成缩略图呀

2018-05-02 12:00:05 回复

久沉深海心必凉i ：2a58d88b22c830c7df211615915f0ef2请问如何实现文件断点上传到OSS?

2018-01-24 16:12:38 回复

折子戏：博主可以开发直传到阿里云OSS的功能吗？可以讲解一下UE编辑器下如何直传阿里云吗？

2018-01-23 19:59:31 回复

Kurapica ：请问如何实现文件断点上传到OSS?

2017-09-30 15:07:33 回复

一杯のお茶：白兄，相互关注下，我的博客是：www.oaiyou.com 谢谢

2017-08-18 13:02:27 回复

五儿：不了不了，呵呵哒

2017-09-15 10:04:40 回复

har ：建议你以类的方式封装，代码太过于零散

2017-08-18 10:11:15 回复

爱便流通于世：unlink($path);中$path左侧好像有/ unlink语法好像没有/才能删除，改成unlink（$oss_path）;就可以上传到oss成功后删除本地文件名的文件！

2017-06-19 16:02:42 回复

HelloSun ：楼主主要方法也不用引用阿里的SDK了吗，直接调用自己封装的吗

2017-03-07 11:42:44 回复

爱便流通于世：肯定用了呀？/** * 实例化阿里云oos * @return object 实例化得到的对象 */ ; $c"token punctuation">; $oss=new

2017-06-19 16:03:52 回复

守住信念丶：一直显示Class 'OSS\OssClient' not found 这个是咋回事，博主大大求解答啊，完全按照步骤来的

2017-02-27 15:27:31 回复

妥拾微凉ゝ/oh ：\OSS\OssClient

2017-03-06 11:16:56 回复

Fesa ：我的笔记本测试也是这样。另外一台电脑就不会同样代码

2017-03-20 23:04:05 回复

ray ：您是怎么解决这个问题的？

2017-09-01 21:09:00 回复

付先森：楼主啊，我这个是3.1.2版本的tp框架啊，该咋整啊

2017-02-23 20:22:42 回复

付先森：帅白楼主啊，我想看看你这个的HTML模板的代码啊，跪求白俊遥博客

2017-02-23 19:45:50 回复

不相问便各自安好：白俊遥博客 oss 能够实现多图上传吗？帅白

2017-02-08 15:05:50 回复

北有先生_ ：大哥我想问下提交的 html 是自己写的吗？您那有没有模板看下我是小白

2016-12-15 09:45:45 回复

云淡风晴：可以参考thinkphp官方手册的上传form：http://document.thinkphp.cn/manual_3_2.html#upload

2016-12-22 23:04:18 回复

TAB ：白俊遥博客

2018-01-23 20:02:36 回复

礼佛：说阿里的文档写的和屎一样还不如说人家业务大不能怪人家看了一星期不知道怎么下手看完这篇博客仿佛找到了新大陆谢谢楼主 ps:获取外网endpoint地址换成这个了：https://help.aliyun.com/document_detail/31837.html?spm=5176.doc31836.6.560.kww3fG

2016-12-14 18:05:18 回复

北有先生_ ：你的成功了吗？？？我这边配合了提交的表格是自己写的吗？

2016-12-15 09:46:40 回复

五儿：噗。。你别他么逗我了

2017-08-18 15:01:57 回复