[教程] 文件上传 OSS 三部曲（一）

对象存储（Object Storage Service，简称OSS），是阿里云对外提供的海量、安全和高可靠的云存储服务。RESTful API的平台无关性，容量和处理能力的弹性扩展，按实际容量付费真正使您专注于核心业务。

第一步，给大家普及下OSS大法好：

    ___     __    _                                    ____    _____   _____
   /   |   / /   (_)   __  __  __  __   ____          / __ \  / ___/  / ___/
  / /| |  / /   / /   / / / / / / / /  / __ \        / / / /  \__ \   \__ \
 / ___ | / /   / /   / /_/ / / /_/ /  / / / /       / /_/ /  ___/ /  ___/ /
/_/  |_|/_/   /_/    \__, /  \__,_/  /_/ /_/        \____/  /____/  /____/
                    /____/      

OSS是什么？ 它相对自建服务器存储优势在哪里？ 我们怎么使用OSS？
一些详细深入的介绍，可见阿里云官网（在看完本文可以初步使用后，你再去深入了解，现在不要走吖吖吖）。Touch me
环境：
在lnmp环境下基于laravel5.1LTS框架。当然，该组件支持php任何框架。

安装：

composer require "johnlui/aliyun-oss"   

配置：
此处可参考作者推荐配置方式，详情请点击Touch me
此处把composer链接引用过来，并贴上部分aliyunoss组件文章的部分代码，是为了让初学者不需要页面切换，只需要看一篇教程，就可以学到怎样使用OSS，增强可读性。
构建 Service 文件：
新建 app/services/OSS.php：

<?php
namespace App\Services;
use JohnLui\AliyunOSS\AliyunOSS;
use Config;
class OSS {
  private $ossClient;
  public function __construct($isInternal = false)
  {
    $serverAddress = $isInternal ? Config::get('app.ossServerInternal') : Config::get('app.ossServer');
    $this->ossClient = AliyunOSS::boot(
      $serverAddress,
      Config::get('app.AccessKeyId'),
      Config::get('app.AccessKeySecret')
    );
  }
  public static function upload($ossKey, $filePath)
  {
    $oss = new OSS(true); // 上传文件使用内网，免流量费
    $oss->ossClient->setBucket('你的 bucket 名称');
    return $oss->ossClient->uploadFile($ossKey, $filePath);
  }
  /**
   * 直接把变量内容上传到oss
   * @param $osskey
   * @param $content
   */
  public static function uploadContent($osskey,$content)
  {
    $oss = new OSS(true); // 上传文件使用内网，免流量费
    $oss->ossClient->setBucket('你的 bucket 名称');
    return $oss->ossClient->uploadContent($osskey,$content);
  }
  /**
   * 删除存储在oss中的文件
   *
   * @param string $ossKey 存储的key（文件路径和文件名）
   * @return
   */
  public static function deleteObject($ossKey)
  {
      $oss = new OSS(true); // 上传文件使用内网，免流量费
      return $oss->ossClient->deleteObject('你的 bucket 名称', $ossKey);
  }
  /**
   * 复制存储在阿里云OSS中的Object
   *
   * @param string $sourceBuckt 复制的源Bucket
   * @param string $sourceKey - 复制的的源Object的Key
   * @param string $destBucket - 复制的目的Bucket
   * @param string $destKey - 复制的目的Object的Key
   * @return Models\CopyObjectResult
   */
  public function copyObject($sourceBuckt, $sourceKey, $destBucket, $destKey)
  {
      $oss = new OSS(true); // 上传文件使用内网，免流量费
      return $oss->ossClient->copyObject($sourceBuckt, $sourceKey, $destBucket, $destKey);
  }
  /**
   * 移动存储在阿里云OSS中的Object
   *
   * @param string $sourceBuckt 复制的源Bucket
   * @param string $sourceKey - 复制的的源Object的Key
   * @param string $destBucket - 复制的目的Bucket
   * @param string $destKey - 复制的目的Object的Key
   * @return Models\CopyObjectResult
   */
  public function moveObject($sourceBuckt, $sourceKey, $destBucket, $destKey)
  {
      $oss = new OSS(true); // 上传文件使用内网，免流量费
      return $oss->ossClient->moveObject($sourceBuckt, $sourceKey, $destBucket, $destKey);
  }
  public static function getUrl($ossKey)
  {
    $oss = new OSS();
    $oss->ossClient->setBucket('你的 bucket 名称');
    return $oss->ossClient->getUrl($ossKey, new \DateTime("+1 day"));
  }
  public static function createBucket($bucketName)
  {
    $oss = new OSS();
    return $oss->ossClient->createBucket($bucketName);
  }
  public static function getAllObjectKey($bucketName)
  {
    $oss = new OSS();
    return $oss->ossClient->getAllObjectKey($bucketName);
  }
  /**
   * 获取指定Object的元信息
   * 
   * @param  string $bucketName 源Bucket名称
   * @param  string $key 存储的key（文件路径和文件名）
   * @return object 元信息
   */
  public static function getObjectMeta($bucketName, $osskey)
  {
      $oss = new OSS();
      return $oss->ossClient->getObjectMeta($bucketName, $osskey);
  }
}

放入自动加载：
遵循 psr-0 的项目（如Laravel 4、CodeIgniter、TinyLara）中：
在 composer.json 中 autoload -> classmap 处增加配置：

"autoload": {
    "classmap": [
      "app/services"
    ]
  }

然后运行 composer dump-autoload。
遵循 psr-4 的项目（如 Laravel 5、Symfony）中：
无需配置，保证目录 App/Services 和命名空间 namespace App\Services; 一致即可自动加载。

注意：我们使用的laravel框架符合psr-4代码规范，所以这一步可省略。

增加相关配置
作者建议在 app/config/app.php 中增加配置，本人建议在app/config 下面新建一个 alioss.php 文件然后在添加配置:

<?php  
return [  
    'ossServer' => env('ALIOSS_SERVER', null),                      // 外网
    'ossServerInternal' => env('ALIOSS_SERVERINTERNAL', null),      // 内网
    'AccessKeyId' => env('ALIOSS_KEYID', null),                     // key
    'AccessKeySecret' => env('ALIOSS_KEYSECRET', null),             // secret
    'BucketName' => env('ALIOSS_BUCKETNAME', null)                  // bucket
];

根据laravel的生命周期可知，项目会首先加载app/config目录下文件，新建一个alioss.php便于和其他组件区分管理。
要去.env文件去配置。
注意：
这里有一个大坑, 粗心的朋友一般不会发现, 在填写外网和公网配置的时候, 有的朋友直接在 OSS 管理控制台中把外网和内网一长串的链接复制走, 如下图:

在这个组件中, 桶名称是需要额外填写的, 所以外网和内网哪儿, 只需要填写桶名后面的内容, 如图:

再有一点是填写外网和内网的时候需要加上 http:// 协议, 不然后面出错你又得掉坑半天出不来, 最终配置信息如下图:

使用：
首先引入命名空间 use App\Services\OSS;, 在 Laravel 5.1 中使用方法如下：

use App\Services\OSS;

// 上传一个文件
OSS::upload('文件名', '本地路径');

// 打印出某个文件的外网链接
echo OSS::getUrl('某个文件的名称');

// 新增一个 Bucket。注意，Bucket 名称具有全局唯一性，也就是说跟其他人的 Bucket 名称也不能相同。
OSS::createBucket('一个字符串');

// 获取该 Bucket 中所有文件的文件名，返回 Array。
OSS::getAllObjectKey('某个 Bucket 名称'); 

// 指定 options 如：Content-Type 类型
OSS::upload('文件名', '文件路径', [
    'ContentType' => 'application/pdf',
    // ...

])

实际使用：

public function store(Request $request)
    {
        $input=$request->except('_token');
//        dd($input);
        // 获取表单提交的图片
        $pic = $request->file('picture_url');
        // 判断图片有效性
//        dd($pic);
        //如果有上传图片
        if(!empty($pic)){
            if (!$pic->isValid()) {
                return back()->withErrors('上传图片无效..');
            }else{
                //获取后缀名
                $titles = $pic->getClientOriginalExtension();
                // 获取图片在临时文件中的地址
                $picpath = $pic->getRealPath();
                // 制作文件名
                $key = time() . rand(10000, 99999999) . '.'.$titles;
                //阿里 OSS 图片上传
                $result = OSS::upload('news/'.$key, $picpath);

                if (!$result) return back()->withErrors('上传图片失败..');
                $input['picture_url']=env('ALIOSS_ACCESS','http://weiyuyan.oss-cn-beijing.aliyuncs.com/').'news/'.$key;
            }
        }

附录：
官方其他的一些使用指南Touch Me

Thanks