标签:sel 来源 name array data note 程序 http dem
public为程序入口
Demo和MyApp为具体的实现
public为多入口
demo和myapp都是入口,但是进入后即又为单入口
list为接口文档,是自动解析程序里的注释自动生成的文档
框架执行流程
Public/demo-》Demo/Api-》Demo/Domain-》Demo/Model
Api/User.php
主要是接收传参,以及调用Domain/User.php里的方法(有点像实体类)
<?php class Api_User extends PhalApi_Api { public function getRules() { return array( ‘getBaseInfo‘ => array( ‘userId‘ => array(‘name‘ => ‘user_id‘, ‘type‘ => ‘int‘, ‘min‘ => 1, ‘require‘ => true, ‘desc‘ => ‘用户ID‘), ), ‘getMultiBaseInfo‘ => array( ‘userIds‘ => array(‘name‘ => ‘user_ids‘, ‘type‘ => ‘array‘, ‘format‘ => ‘explode‘, ‘require‘ => true, ‘desc‘ => ‘用户ID,多个以逗号分割‘), ), ); } /** * 获取用户基本信息 * @desc 用于获取单个用户基本信息 * @return int code 操作码,0表示成功, 1表示用户不存在 * @return object info 用户信息对象 * @return int info.id 用户ID * @return string info.name 用户名字 * @return string info.note 用户来源 * @return string msg 提示信息 */ public function getBaseInfo() { $rs = array(‘code‘ => 0, ‘msg‘ => ‘‘, ‘info‘ => array()); $domain = new Domain_User(); $info = $domain->getBaseInfo($this->userId); if (empty($info)) { DI()->logger->debug(‘user not found‘, $this->userId); $rs[‘code‘] = 1; $rs[‘msg‘] = T(‘user not exists‘); return $rs; } $rs[‘info‘] = $info; return $rs; } /** * 批量获取用户基本信息 * @desc 用于获取多个用户基本信息 * @return int code 操作码,0表示成功 * @return array list 用户列表 * @return int list[].id 用户ID * @return string list[].name 用户名字 * @return string list[].note 用户来源 * @return string msg 提示信息 */ public function getMultiBaseInfo() { $rs = array(‘code‘ => 0, ‘msg‘ => ‘‘, ‘list‘ => array()); $domain = new Domain_User(); foreach ($this->userIds as $userId) { $rs[‘list‘][] = $domain->getBaseInfo($userId); } return $rs; } }
Domain/User.php
主要是方法的抽象实现,不是具体实现,类似于一个服务,这样有利于方法重用
<?php class Domain_User { public function getBaseInfo($userId) { $rs = array(); $userId = intval($userId); if ($userId <= 0) { return $rs; } // 版本1:简单的获取 $model = new Model_User(); $rs = $model->getByUserId($userId); // 版本2:使用单点缓存/多级缓存 (应该移至Model层中) /** $model = new Model_User(); $rs = $model->getByUserIdWithCache($userId); */ // 版本3:缓存 + 代理 /** $query = new PhalApi_ModelQuery(); $query->id = $userId; $modelProxy = new ModelProxy_UserBaseInfo(); $rs = $modelProxy->getData($query); */ return $rs; } }
Model/User.php
方法的具体实现,最小粒度
<?php class Model_User extends PhalApi_Model_NotORM { public function getByUserId($userId) { return $this->getORM() ->select(‘*‘) ->where(‘id = ?‘, $userId) ->fetch(); } public function getByUserIdWithCache($userId) { $key = ‘userbaseinfo_‘ . $userId; $rs = DI()->cache->get($key); if ($rs === NULL) { $rs = $this->getByUserId($userId); DI()->cache->set($key, $rs, 600); } return $rs; } /** protected function getTableName($id) { return ‘user‘; } */ }
缓存方法
public function getByUserIdWithCache($userId) { $key = ‘userbaseinfo_‘ . $userId; $rs = DI()->cache->get($key); if ($rs === NULL) { $rs = $this->getByUserId($userId); DI()->cache->set($key, $rs, 600); } return $rs; }
如果缓存不存在,执行sql查询
否则直接返回缓存值
一个很漂亮的接口文档
标签:sel 来源 name array data note 程序 http dem
原文地址:http://www.cnblogs.com/hellowzd/p/6264136.html