将PHP应用发布为Azure Cloud service

上一篇博客介绍了如何将PHP应用发布到Azure website上。Website使用很方便，不过由于Websites对于用户权限有很多限制，比如不能开端口(无法支持memcache)。有的时候，我们希望获得更多的灵活性，比如需要特别的PHP插件、需要不同的PHP版本，或者需要运行其他进程，甚至希望登录到目标虚拟机上去。这时，可以采用Cloud service来运行PHP应用。Cloud service是一组被Azure管理的虚拟机，上面运行了windows操作系统，并且加载了IIS和PHP运行环境，可以支持ASP和PHP的运行。PHP发布到Website时，用FTP把代码上传即可。采用Cloud service时，上传过程稍微不同。上传时需要使用Azure工具进行打包。下面看下具体步骤。

建立Azure发布项目

该工具只能运行在Windows下。从这里下载安装Windows Azure SDK for PHP。该工具包括了一个本地的Azure模拟器和Power shell工具。安装完毕后，在开始菜单中找到Windows Azure PowerShell程序，以管理员身份运行

 接下来就可以进行发布了。首先要为该PHP应用生成一个对应的Cloud service应用

PS C:\>New-AzureServiceProject myProject

 该操作会在C:\下生成一个目录，包含了该服务的基本文件，如服务定义ServiceDefinition.csdef和服务配置信息ServiceConfiguration.Cloud.cscfg。他们定义了该服务由几个角色构成，每个角色有几个虚拟机，以及各种变量信息等。任何一个cloud service都由一个或者若干个角色(Role)构成。一个Role代表了功能相同的一组虚拟机。比如，一个PHP站点有前段Web页面和后端一个批处理程序构成，那么我们可以定义两个role，分别是WebRole和WorkerRole

 接下来可以生成一个角色

PS C:\myProject> Add-AzurePHPWebRole MyWebRole

 该操作会在当前目录下生成一个目录容纳该角色包含的文件，新生成时里面只有index.php和一个bin目录。其中index.php是显示当前PHP环境信息。bin目录是Azure进行系统配置所需的一些脚本，我们可以不用管它。我们可以把已有的PHP应用代码拷贝到角色目录（C:\myProject\MyWebRole)下

在本地模拟环境进行测试

 在上传应用到Azure前，我门可以在本地先测试。在本地启动模拟器

PS C:\MyProject>Start-AzureEmulator

可以看到下面的输出：

Creating local package...Starting Emulator...Role is running at http://127.0.0.1:81Started

然后打开浏览器访问上面给出的地址即可进行测试。下面的命令可以结束调试

PS C:\MyProject> Stop-AzureEmulator

测试完成后，开始最终发布。

发布到Windows Azure

发布时我们要先和Azure订阅关联。执行如下命令：

PS C:\MyProject>Get-AzurePublishSettingsFile

该操作会打开一个浏览器，并提示登录Azure。输入登录信息后，系统会弹出一个下载对话框。把文件下载到本地。

 该文件是Azure订阅信息。下面导入该订阅信息：

PS C:\MyProject>Import-AzurePublishSettingsFile C:\Users\{MyAccount}\Downloads\****-credentials.publishsettings

 最后，执行发布命令。其中ServiceName是服务名，该名称将组成服务URL的前缀，Location是发布的数据中心

PS C:\MyProject> Publish-AzureServiceProject -ServiceName MyService -Location "East Asia"

 发布完成后，登录Azure管理门户，在Cloud service下可以找到新创建的服务。进入后可以查看其Dashboard。点击右侧的Site URL即可访问该服务

下面是结果

 

Publish-AzureServiceProject这个命令实际上完成了代码打包、上传、部署这几个步骤。有时我们不希望直接将代码部署，而是希望只打包，然后手动上传到Azure存储上，再从Azure界面上手动执行应用发布。此时，可以用这个命令进行代码的打包：

Save-AzureServiceProjectPackage

 执行后，一个名为cloud_package.cspkg的文件会在项目目录下生成。

配置cache 

网站服务运行PHP的一个问题是，没法添加memcache扩展模块。由于memcache服务的运行需要开启TCP端口，而这正是被网站服务所限制的。Cloud service运行PHP则不存在这样的问题，而且Cloud service本身支持Windows Azure Caching模块，该模块与Memcache功能类似，使用各虚拟机的内存运行缓存数据，但该模块的安装完全是自动在后台完成，只要在配置时启用Caching，Azure就会自动在Cloud service的每个虚拟机上启用该模块。Azure Caching提供与memcache客户端兼容的接口，PHP网页可以按调用Memcache的方式使用Azure Caching，不用做任何修改。

下面就看下怎么配置PHP使用Azure Caching. 这个功能本身不会产生任何费用。

1. 首先，要下载php_memcache.dll，这是memcache的客户端。该模块可以从http://downloads.php.net/pierre/下载。这里我们选择php_memcache-2.2.6-5.3-nts-vc9-x86.zip (2010-10-03 13:46 -0700) - 44K 这个模块

2.下载后，将其解压，把php_memcache.dll放到Role的bin\php\ext目录下，本例中具体地址是C:\MyProject\MyWebRole\bin\php\ext

3.在C:\MyProject\MyWebRole\bin\php下增加一个php.ini文件，内容如下：

extension=php_memcache.dll

4.用记事本打开C:\MyProject\ServiceDefinition.csdef进行编辑

4.1.在<Imports>内增加Caching模块定义

<Import moduleName="Caching" />

4.2.增加缓存所用的磁盘空间定义

<LocalResources>     <LocalStorage cleanOnRoleRecycle="false"  name="Microsoft.WindowsAzure.Plugins.Caching.FileStore" sizeInMB="1000"/>  </LocalResources>

4.3在<Endpoints>内增加端口定义

<InternalEndpoint name="memcache_default" protocol="tcp" port="11211" />

5.编辑完成后，保存。完整内容如下

<?xml version="1.0"?><ServiceDefinition xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="MyServicePHP" xmlns="http://schemas.microsoft.com/ServiceHosting/2008/10/ServiceDefinition">  <WebRole name="MyWebRole" vmsize="ExtraSmall">    <Imports>      <Import moduleName="Caching" />    </Imports>    <Startup>      <Task commandLine="setup_web.cmd > log.txt" executionContext="elevated">        <Environment>          <Variable name="EMULATED">            <RoleInstanceValue xpath="/RoleEnvironment/Deployment/@emulated" />          </Variable>          <Variable name="RUNTIMEVERSIONPRIMARYKEY" value="5.3.17" />          <Variable name="RUNTIMEID" value="PHP" />          <Variable name="RUNTIMEURL" value="http://nodertea.blob.core.windows.net/php/5.3.17.exe" />        </Environment>      </Task>    </Startup>    <LocalResources>      <LocalStorage name="Microsoft.WindowsAzure.Plugins.Caching.FileStore" cleanOnRoleRecycle="false" />    </LocalResources>    <Endpoints>      <InputEndpoint name="Endpoint1" protocol="http" port="80" />      <InternalEndpoint name="memcache_default" port="11211" protocol="tcp" />    </Endpoints>    <Sites>      <Site name="Web">        <Bindings>          <Binding name="Endpoint1" endpointName="Endpoint1" />        </Bindings>      </Site>    </Sites>  </WebRole></ServiceDefinition>

6.编辑C:\myProject\ServiceConfiguration.Cloud.cscfg文件，在<ConfigurationSettings />内增加如下有关Azure Caching的配置信息

      <Setting name="Microsoft.WindowsAzure.Plugins.Caching.NamedCaches" value="" />      <Setting name="Microsoft.WindowsAzure.Plugins.Caching.DiagnosticLevel" value="1" />      <Setting name="Microsoft.WindowsAzure.Plugins.Caching.CacheSizePercentage" value="30" />      <Setting name="Microsoft.WindowsAzure.Plugins.Caching.ConfigStoreConnectionString" value="DefaultEndpointsProtocol=https;AccountName=xxxxx;AccountKey=xxxxx" />

其中，ConfigStoreConnectionString后面的AccountName和AccountKey需要自行更改，需要填入一个存储账户的信息

编辑完成后，结果如下

<ConfigurationSettings>      <Setting name="Microsoft.WindowsAzure.Plugins.Caching.NamedCaches" value="" />      <Setting name="Microsoft.WindowsAzure.Plugins.Caching.DiagnosticLevel" value="1" />      <Setting name="Microsoft.WindowsAzure.Plugins.Caching.CacheSizePercentage" value="30" />      <Setting name="Microsoft.WindowsAzure.Plugins.Caching.ConfigStoreConnectionString" value="DefaultEndpointsProtocol=https;AccountName=xxxxx;AccountKey=xxxxx" /></ConfigurationSettings>

7.接下来，修改php中对cache的访问入口，将其改为如下的形式，其中MyWebRole是Role的名字

$memcache = new Memcache;$memcache->connect('localhost_MyWebRole', 11211) or die ("Could not connect");

到此为止，PHP使用memcache客户端访问缓存的配置就完成了。下面我们可以用一个小程序测试下。

在C:\myProject\MyWebRole\下创建一个cachetest.php，内容如下：

<?php$memcache = new Memcache;$memcache->connect('localhost', 11211) or die ("Could not connect");$version = $memcache->getVersion();echo "Server's version: ".$version."<br/>\n";$tmp_object = new stdClass;$tmp_object->str_attr = 'test';$tmp_object->int_attr = 123;$memcache->set('key', $tmp_object, false, 10) or die ("Failed to save data at the server");echo "Store data in the cache (data will expire in 10 seconds)<br/>\n";$get_result = $memcache->get('key');echo "Data from the cache:<br/>\n";var_dump($get_result);?> 

下面，重新发布该项目

PS C:\MyProject> Publish-AzureServiceProject -ServiceName MyService -Location "East Asia"

发布完成后，访问http://myservice.cloudapp.nen/cachetest.php，如果能看到如下结果，说明Cache已经配置成功

配置Session

Azure云服务的一个局限是不支持应用层负载均衡，即，在负载均衡用户请求时，不去判断请求中的session信息，这样，一个用户的不同请求可能会发送到不同的后台虚拟机实例上，造成session失效。为了解决这个问题，要么不用session（数据存在cache里面），要么需要实现session复制，即在每个实例上都可以访问同样的session数据。PHP原生支持利用memcache提供session复制。在Windows Azure上，我们在上一步已经实现了对memcache的兼容，因此可以基于现有的PHP session复制方法，让云服务中的PHP支持session。具体配置方法为：修改角色目录下的bin\php\php.ini，在末尾加上下面的内容：

session.save_handler = memcache
session.save_path = "tcp://localhost:11211"

当然，事先要按照上一节的方法配置cache

访问Azure存储

在PHP中，我们可以通过Azure PHP SDK去操作Azure的多种服务，包括存储、服务总线等。SDK的安装方法，是下载相应的软件包到云项目相应角色的目录中。具体方法可参考https://github.com/windowsazure/azure-sdk-for-php

安装之后，就可以在PHP代码中引用类库进行操作了。下面的例子是在PHP中上传图片并且列表展示

<?phprequire_once 'vendor\autoload.php';use WindowsAzure\Common\ServicesBuilder;use WindowsAzure\Blob\Models\CreateContainerOptions;use WindowsAzure\Blob\Models\PublicAccessType;use WindowsAzure\Common\ServiceException;use WindowsAzure\Common\CloudConfigurationManager;$connectionString = "$YOURSTRORAGEACCOUNT"// Create blob REST proxy.$blobRestProxy = ServicesBuilder::getInstance()->createBlobService($connectionString);$createContainerOptions = new CreateContainerOptions(); $createContainerOptions->setPublicAccess(PublicAccessType::CONTAINER_AND_BLOBS);try {    // Create container.    $blobRestProxy->createContainer("imagecontainer", $createContainerOptions);}catch(ServiceException $e){    // Handle exception based on error codes and messages.    // Error codes and messages are here:     // http://msdn.microsoft.com/en-us/library/windowsazure/dd179439.aspx    $code = $e->getCode();if($code != 409) {   $error_message = $e->getMessage();       echo $code.": ".$error_message."<br />";}    }// Insert any new image into storageif (isset($_REQUEST['completed']) and $_REQUEST['completed'] == 1) {        $instr = fopen($_FILES['imagefile']['tmp_name'],"rb");$blob_name = $_FILES['imagefile']['name'];try {    //Upload blob$blobRestProxy->createBlockBlob("imagecontainer", $blob_name, $instr);}catch(ServiceException $e){$code = $e->getCode();$error_message = $e->getMessage();echo $code.": ".$error_message."<br />";    }                fclose($instr);}try {    // List blobs.    $blob_list = $blobRestProxy->listBlobs("imagecontainer");    $blobs = $blob_list->getBlobs();    foreach($blobs as $blob)    {        echo $blob->getName()."<br>";echo "<img src='".$blob->getUrl()."'><p>";    }} catch(ServiceException $e){    $code = $e->getCode();    $error_message = $e->getMessage();    echo $code.": ".$error_message."<br />";}?><html> <head>    <style type="text/css">    h2 div{    width: 100%;    margin: 0 auto;   background-color:#0d2d80;   color:white;   }h3 div{    width: 100%;    margin: 0 auto;   background-color:#e6c671;   color:black;   }    </style>      <title>Upload an image to a storage</title> </head> <body bgcolor=white>   <h2>      <div>Upload an image to a storage</div>   </h2> <hr>   <h2>Please upload a new picture </h2>   <form enctype=multipart/form-data method=post>        <input type=hidden name=MAX_FILE_SIZE value=150000><input type=hidden name=completed value=1>Please choose an image to upload: <input type=file name=imagefile><br><input type=submit>   </form><br>  </body></html>

 

此外我们还可以对该Cloudservice进行管理，比如扩容、监控、修改配置等，可以参考http://www.windowsazure.com/en-us/manage/services/cloud-services/

这里并没有讨论如何发布数据库，可以参考http://blog.csdn.net/shaunfang/article/details/8555574

 

目前缺省的PHP版本是5.3，如果我们希望变更PHP版本，或者自定义PHP运行环境，可以参考http://www.windowsazure.com/en-us/develop/php/common-tasks/create-web-and-worker-roles/#CreateProject

而更多Powershell命令，可以参考http://www.windowsazure.com/en-us/develop/php/how-to-guides/powershell-cmdlets/#ImportPubSettings