阿里云ACE的应用模板移植

Aliyun Cloud Engine（以下简称ACE）是基于弹性计算平台的可线性伸缩的应用托管运行环境。应用模板是我们借鉴了业内的App Store的概念，简化用户创建应用的步骤，方便应用的推广。本文只讲述PHP应用的模板移植，其它语言请参考相关文档。

1. 文件、目录读写

出于安全角度考虑，ACE对本地文件读写进行了一些限制，用户数据建议放在我们的OSS中（开放存储服务，具备高可靠性及可扩展性的海量数据存储），文件读写都需使用ACE提供的统一接口。ACE支持创建用户数据目录，也支持创建源代码文件上的目录。

PHP自带的fread、fwite 已被ACE默认关闭，请使用以下方法实现。

< ?php

Class CeFile{}

Function write($fileName, $content, $sync=0) 文件写入

$fileName 文件路径（相对路径）

$content 文件内容

$sync是否需要同步到所有web端，为保证多台web数据同步，默认设为0

返回 true|false

Function read($fileName) 读取文件内容

$fileName 文件路径（相对路径）

返回文件内容|false

Function delete($fileName) 删除文件

$fileName 文件路径（相对路径）

返回 true|false

成员变量errno 为错误代号

成员变量errmsg 为返回的错误信息供debug时使用

?>

ACE文件读写方法如下：

//创建cefile对象

$ce = new CeFile()；

//文件写入

$ce->write($fileName, $content, $sync=0);

//读取文件内容

$ce->read($fileName);

//删除文件

$ce->delete($fileName);

2. 文件缓存部署

文件缓存的主要目的是把经常访问的数据保存在本地文件中，当有请求访问的时候，直接将数据调出，避免了再次对数据库的请求的I/O操作，减少数据库的负载压力。

ACE给每个应用默认部署两个实例，当有请求访问的时候，该请求就会路由到其中的一个实例。ACE具有伸缩性，随着请求的增加和减少，可以增加或减少实例。为了提高性能，ACE也具有文件缓存功能，如缓存配置信息。当用户修改配置文件时，应调用文件缓存的功能，实现多台实例间配置信息的同步。

因此，应用中若用到文件缓存，必须使用ACE提供的文件读写接口，使用方法同文件读写。使用文件缓存部署应将write方法$sync同步参数设置为1。

3. Memcache缓存部署

Memcache缓存管理是AACE为开发者提供的分布式缓存服务，以共享的方式缓存用户的key-value形式的小数据，以加快数据响应速度，减轻后端数据处理的压力。

ACE环境下的memchae是默认为开启的，默认给用户免费提供64M。若用户需要使用memcache缓存，注意以下事项。

ACE支持的Memcache 的API如下：

bool Memcache::init ()
array Memcache::get ( array $keys [, array &$flags ] )
bool Memcache::set ( string $key , mixed $var [, int $flag [, int $expire ]] )
bool add ( string $key , mixed $var [, int $flag [, int $expire ]] )
bool replace ( string $key , mixed $var [, int $flag [, int $expire ]] )
bool decrement ( string $key [, int $value = 1 ] )
bool increment ( string $key [, int $value = 1 ] )
bool delete ( string $key [, int $timeout = 0 ] )
bool close ()

ACE不支持的Memcache 的API 如下：

bool addServer* *( string $host [, int $port =
11211 [, bool $persistent [, int $weight [, int $timeout [, int $retry_interval [, bool
$status [, callback $failure_callback [, int $timeoutms ]]]]]]]] )
bool connect* *( string $host [, int $port [, int $timeout ]] )
bool flush* *( void )
bool* *pconnect ( string $host [, int $port [, int $timeout ]] )
bool setServerParams* *( string $host [, int $port =
11211 [, int $timeout [, int $retry_interval = false [, bool $status [, callback$failure_callback ]]]]] )

应用如果使用Memcache缓存，就必须使用ACE提供的memcache缓存接口。Memcache缓存使用方法如下：

< ?php

//连接

$mem = new Memcache(); //创建memcache对象，内部会访问agent获取地址 及ID

$mem->init();

//保存数据

$mem->set('key1', 'This is first value', 0, 60);

$val = $mem->get('key1');

//替换数据

$mem->replace('key1', 'This is replace value', 0, 60);

$val = $mem->get('key1');

//保存数组

$arr = array('aaa', 'bbb', 'ccc', 'ddd');

$mem->set('key2', $arr, 0, 60);

$val2 = $mem->get('key2');

//删除数据

$mem->delete('key1');

$val = $mem->get('key1');

//关闭连接

$mem->close();

?>

4. 文件上传

通过Web上传的文件都是基于OSS的存储（OSS是阿里云提供的开放存储服务，用户可以利用OSS搭建图片、视频等多媒体分享网站，个人/企业数据备份等基于大规模数据的服务）。

由于ACE平台的限制，其上传的文件不能存储在本地，只能存储在OSS中，必须使用ACE提供的上传文件接口，文件上传后会生成对应的url。PHP自带的move_uploaded_file 方法已不能使用，请使用ACE提供方法。

文件上传方法如下：

move_uploaded_file($tmp_name, $filename)

替换为：

$ce = new ACEStorage();

$result = $ce->upload($tmp_name, $filename);

#$rs1 = $ce->errmsg(); 输出错误信息

#$rs2 = $ce->errno();

$result为返回的附件文件路径，可直接访问，如:

www.domain.com/aliyun_ce_storage/$filename

5. 图片缩略、水印等特殊问题

受本地文件读写条件限制等问题，图片缩略、水印等功能暂不支持，我们会在后续的版本中支持。

6. 数据备份恢复问题

ACE提供在线备份数据功能，在创建应用时，可以选择备份时间点。

如果想从应用中导出数据，则需要使用数据库客户端工具进行操作。