之前在微博开发者大会上做过一个演讲,不过因为时间和形式的问题,忽略了很多细节。正好InfoQ的同学问我能不能写一篇文章,于是就有了本文。文章分三个部分,介绍篇讲SAE的基本情况;环境篇讲SAE和标准PHP环境的主要区别;实践篇则提供了一个完整的微博应用开发实例。



介绍篇



基于SAE的微博应用开发_开放平台

Sina App Engine (简称SAE)是由新浪网研发中心出品的云计算平台,也是国内第一个公有云平台。从09年11月alpha版本发布到今年8月beta版上线,SAE已经进入了稳定运行的阶段。即使是在我们严格控制邀请码的情况下,也已经拥有了超过4000的开发者和超过3000的应用。光是新浪微博的应用频道,就有40个以上的应用运行在SAE上,而在Web应用的Top10中,有7个都运行于SAE。

  • SAE可以降低开发者在硬件方面的投入,省钱;
  • 可以加快应用开发的速度,省时间;
  • 可以提供门户级别的可靠性,让大家专注于应用本身,省心。
  • 特别适合于没有专门的架构团队和运维团队的公司和个人使用。

环境篇

基于SAE的微博应用开发_开放平台

SAE采用大家熟悉的PHP+Mysql作为主要环境。所以在SAE上开发应用并不需要学习新的知识,只需要注意一些细节就可以了。移植一个现有的PHP应用到SAE上是很简单的事情,之前我将WordPress移植到SAE上时就只花了3个小时。

本地文件操作

在SAE上不允许对本地文件系统进行写操作。这既是系统架构的要求,也是为了保证代码的安全和应用的性能。

我们提供了TMPFS服务来解决临时文件的问题。TMPFS服务为开发者提供了一个目录,开发者可以将文件写到这个目录下,但是当本次请求结束时,这个文件将不再存在。

为了方便大家迁移项目,我们还允许大家利用PHP Wrapper通过文件系统函数来操作SAE的Memcache和Storage。大家知道Smarty是很依赖文件系统的模板,但是通过Wrapper方式,只需要修改非常少的代码,就可以让Smarty改为使用SAE的Memcache服务。(​​https://code.google.com/p/smarty4sae/​​)

数据抓取

出于安全原因,SAE不允许应用直接抓取外部的数据。所有对外的抓取操作,都需要使用Fetchurl服务。相对于CURL来做,封装后的Fetchurl服务其实更为简单,也可以支持自定义头和cookie等操作。

数据库

SAE使用的是标准的Mysql数据库,所以以Mysql为核心的应用不用做任何修改就能使用。Mysql的host和端口信息我们通过环境变量提供,直接在Runtime中获取就可以了。

我们强烈建议大家使用SaeMysql class来操作SAE的数据库,因为这个class默认进行了主从分离,可以避免在高并发时出现锁表等问题。

分布式存储

由于不允许对本地文件系统进行写操作,我们提供了分布式存储服务来帮大家存放一些应用运行过程中产生的文件,比如用户上传的图片等。使用SaeStorage可以方便的保持这些内容并生成可访问的URL。

在了解了以上需要注意的地方后,大家就可以很容易的在SAE上开发应用了。

实践篇

接下来我们来看看如何从头到尾开发一个简单的微博应用。

应用目标

先说说我们要做的应用。微博开放平台最近新增了一个接口,可以查询当前用户发布的某一条微博的转发信息。在微博平台上,信息通过转发进行链式传播,转发信息对微博营销来说是很重要的;而目前微博Web版本并不显示这些信息。所以我们想做一个应用,允许用户可以查看某条微博的转发情况。

具体做法如下:

  • 首先要取得用户授权
  • 取得当前用户的最近若干条微博,添加查看链接
  • 获取并展示被选中微博的转发信息

准备工作

在开发应用之前,你需要有新浪微博的账号和SAE的账号。微博的账号可以在​​这里​​​注册;SAE的账号在这里可以​​注册​​。

有了微博账号之后,就可以在​​微博开放平台​​创建应用了。

基于SAE的微博应用开发_开放平台

这部分微博开放平台上有详细的​​图文说明​​,就不再重复了。完成应用的创建后,可以得到应用App Key和App Secret。

基于SAE的微博应用开发_开放平台

在SAE上创建应用

使用之前注册的SAE账号(不同于微博账号,是完全独立账号)登入SAE,在“我的应用”下,“创建应用”。

基于SAE的微博应用开发_开放平台

我们创建了一个appname为relink的应用,它可以通过relink.sinaapp.com进行访问。

在SAE上写微博应用不用从头开始,有方便快捷的应用向导可用。

在“应用向导”下选择“社会化应用”分类,点击“新浪微博OAuth框架”下边的“安装”按钮。

基于SAE的微博应用开发_开放平台

选择安装到应用“relink”下,安装为新版本1。

基于SAE的微博应用开发_开放平台

填写好我们从微博开放平台得到的微博应用的AppKey和AppSecret。

基于SAE的微博应用开发_开放平台

至此,我们已经完成了最基本的微博应用。

基于SAE的微博应用开发_开放平台

访问relink.sinaapp.com,已经可以进行应用的授权和当前用户最新微博的列表了。

基于SAE的微博应用开发_开放平台

编写代码

接下来我们修改weiblolist.php的代码,加入“查看转发”连接。

进入应用“relink”的管理页面,点击左侧的“代码管理”,在右侧的“操作”列点击“编辑代码”,启用SAE的在线编辑器。

基于SAE的微博应用开发_开放平台

点击左侧的文件名,进入代码编辑。

基于SAE的微博应用开发_开放平台

我们给现在的微博列表添加一个“查看转发”的链接。

基于SAE的微博应用开发_开放平台

Ctrl+S发布代码,刷新页面看效果。

基于SAE的微博应用开发_开放平台

在点击编辑器左侧的新建文件按钮,创建show.php。

基于SAE的微博应用开发_开放平台

编写展示代码



<?php
// 载入共用函数和配置
session_start();
include_once( 'config.php' );
include_once( 'saet.ex.class.php' );
header('Content-Type:text/html; charset=utf-8');
// 创建SaeTClient 对象
$c = new SaeTClient( WB_AKEY , WB_SKEY , $_SESSION['last_key']['oauth_token'] , $_SESSION['last_key']['oauth_token_secret'] );

// 获取并展示转发信息
if( $items = $c->oauth->get('http://api.t.sina.com.cn/statuses/repost_timeline.json' , array('id'=>$_REQUEST['sid'])) ):?>
<div style="border:1px solid red;padding:5px;margin:5px">原始微博 - <?=$items[0]['retweeted_status']['user']['name']?>: <?=$items[0]['retweeted_status']['text']?></div>
<?foreach( $items as $item ):?>
<div style="border:1px solid #eee;padding:5px;margin:5px"><?=$item['user']['name']?>: <?=$item['text']?></div>
<?endforeach;?>
<?php endif; ?>



点击之前页面的“查看转发”链接,即可查看到相关信息。

基于SAE的微博应用开发_开放平台

小结

到这里,我们已经完成了应用的开发。虽然应用本身很简单,但是完整的演示了整个开发流程。期待大家都能在SAE上开发出优秀的微博应用。微博开放平台的接口可以查阅​​API文档​​​,SAE提供的API可以访问​​http://apidoc.sinaapp.com/​​。

关于作者

陈理捷(EasyChen),资深Web应用架构师,在facebook、人人和新浪微博开放平台拥有数十个应用,累计用户近百万。09年加入新浪研发中心,主导新浪云计算平台的战略规划和产品设计,现任SAE产品经理。