将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:81 Started
然后打开浏览器访问上面给出的地址即可进行测试。下面的命令可以结束调试
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中上传图片并且列表展示
<?php
require_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 storage
if (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