PHP使用Azure Storage Blob上传文件

前言

分配到一个项目，一个需要内容管理的小站，前端页面展示与特效由前端同事完成。我负责搭建内容管理后台以及提供数据接口。这个项目里需要管理端能够上传视频，但是甲方提供的服务器带宽非常迷你，而且同一个服务器上还有其他项目并行。
为了防止突发升级带来的后续影响，组长建议我学习使用Azure Storage Blob，并随时做好升级准备。

PHP版本限制

在Github里找到了官方提供的sdk。

Minimum Requirements

PHP 5.6 or above

由于本地配置的PHP环境是5.5.12，而sdk需要的最低php版本为5.6，composer阻止了更新
于是使用composer update --ignore-platform-reqs绕过需求监测强升。
然而类BlobResources.php中将const设为数组，在5.5中会报错

Fatal error: Arrays are not allowed in class constants in E:webroot	p5cmsvendormicrosoftazure-storage-blobsrcBlobInternalBlobResources.php on line 103

没办法只能升级PHP。

升级WAMP 2.5-3.1

为了开发需要，决定将wampserver提升至最新版本。
升级wamp有个技巧：不能直接覆盖安装，要先去掉老版本再安装新版本。
仔细阅读升级提示。
总结一下需要做的大概是如下两件事：

移除服务

Start WampServer
【重要】登录MySQL备份所有数据库数据
wampmanager -> Stop all Services
wampmanager -> MySQL -> Service -> Remove service 移除MySQL服务
wampmanager -> Apache -> Service -> Remove service 移除Apache服务
stop wampmanager
右击 wampmanager -> Exit
重命名文件夹

将wamp命名为其他名字以作备份

安装存储模拟器

由于公司内没有用于测试的azure账号，幸好azure有用于测试开发的存储模拟器。Windows系统可以直接下载安装，Linux系统可以使用开源存储模拟器Azurite。

下载模拟器，此处有下载链接。
安装完成后运行StartStorageEmulator.cmd发现提示需要安装SQL Server Express Local DB，在此处有下载链接。选择Express Edition，进入后选择LocalDB下载并安装。
再次运行cmd发现错误

C:Program Files (x86)Microsoft SDKsAzureStorage Emulator>AzureStorageEmulato
r.exe start
Windows Azure Storage Emulator 5.3.0.0 command line tool
 
未经处理的异常: System.TimeoutException: Unable to open wait handle.
在 Microsoft.WindowsAzure.Storage.Emulator.Controller.EmulatorProcessControll
er.InternalWaitForStorageEmulator(Int32 timeoutInMilliseconds)
在 Microsoft.WindowsAzure.Storage.Emulator.Controller.EmulatorProcessControll
er.EnsureRunning(Int32 timeoutInMilliseconds)
在 Microsoft.WindowsAzure.Storage.Emulator.Commands.StartCommand.RunCommand()
 
在 Microsoft.WindowsAzure.Storage.Emulator.Program.Main(String[] args)

经过查询后发现这是因为有进程占用了10000号端口。

#运行：
>C:UsersWalter>netstat -p tcp -ano | findstr :10000
> TCP 127.0.0.1:10000 0.0.0.0:0 LISTENING 2664
 
#根据PID 2664查询对应的进程
>C:UsersWalter>tasklist | findstr "2664"
>YunDetectService.exe 2664 Console 1 9,944 K
 
#只是一个不重要的进程，去掉后继续开发
>C:UsersWalter>taskkill /pid 2664 /f
>成功: 已终止 PID 为 2664 的进程。
 
#以下是模拟器成功运行的范例
>C:Program Files (x86)Microsoft SDKsAzureStorage Emulator>AzureStorageEmulator.exe start
Windows Azure Storage Emulator 5.3.0.0 command line tool
The storage emulator was successfully started.
 
>C:Program Files (x86)Microsoft SDKsAzureStorage Emulator>AzureStorageEmulator.exe status
Windows Azure Storage Emulator 5.3.0.0 command line tool
IsRunning: True
BlobEndpoint: http://127.0.0.1:10000/
QueueEndpoint: http://127.0.0.1:10001/
TableEndpoint: http://127.0.0.1:10002/

开始开发

通过官方的例子可以尝试新增container，blob及删除功能。
成功上传blob后，却无法对存储模拟器中的资源进行寻址。
eg.使用的帐户名devstoreaccount1，创建的容器名mycontainerudfpbk，blob名5ac1a5c82021d.png。
根据文档中的规则，资源地址应为
http://127.0.0.1:10000/devstoreaccount1/mycontainerudfpbk/5ac1a5c82021d.png
但是返回数据一直是

<Error>
　　<Code>ResourceNotFound</Code>
　　<Message>
　　　　The specified resource does not exist. RequestId:9d2d1b08-12b1-4feb-8636-4325eb71b838 Time:2018-04-08T09:14:14.3007800Z
　　</Message>
</Error>

根据阅读相关文章后发现原来在创建容器时，若没有设置过访问权限(container-level access policies)，则默认为禁止外部访问。

ACL(PublicAccessType)权限分为三等CONTAINER_AND_BLOBS、BLOBS_ONLY、NONE，默认是NONE。
若资源需要外部能够访问则设置为BLOBS_ONLY即可。
附上自己封装的azure辅助类

这中间还遇到一个小问题，在设权限时，ACLBase报了个错
Static function MicrosoftAzureStorageCommonInternalACLBase::createAccessPolicy() should not be abstract
经过查询后发现，在PHP5.2以后不允许abstract和static同时使用在方法上。

#只要将ACLBase中的
abstract protected static function createAccessPolicy();
abstract protected static function validateResourceType($resourceType);
#改为
protected static function createAccessPolicy(){}
protected static function validateResourceType($resourceType){}
#即可

总结

中止进程的三个方法

利用pid结束进程
taskkill /pid PID /f
利用pid结束进程
ntsd -c q -p PID
利用进程名结束进程
ntsd -c q -pn NAME.exe

地址

注：强制结束前先明确这个进程的作用

Reference

Azure/azure-storage-php - Github
Hello World sample with the Storage SDK for PHP
使用 Azure 存储模拟器进行开发和测试
 SQL Server Express Downloads
Installing a new release of WAMPServer
Azure Blob Storage 基本用法 – Azure Storage 之 Blob