小蚂蚁学习APP接口开发（9）—— APP版本升级的接口实例

最新推荐文章于 2021-03-10 00:21:23 发布

weixin_34166472

最新推荐文章于 2021-03-10 00:21:23 发布

阅读量175

点赞数

文章标签： php 数据库 python

原文链接：https://my.oschina.net/woshixiaomayi/blog/519783

版权

2019独角兽企业重金招聘Python工程师标准>>>

今天的笔记主要来记录最后两个知识要点之一，APP客户端版本升级的接口开发。

APP的开发主要由伟大而神圣的用户来更新，更新的流程应该是这样的：

开启APP——请求初始化接口init.php——检测是否需要更新---否——首页

---是——更新

在初始化接口的时候，需要客户端发送几个数据：

app_id 客户端id，比如： 1，安卓手机 2，iphone手机

version_id 大版本号id

version_mini 小版本号id

did 用户客户端信息（客户端工程师会获取这个数据）

encrypt_did did加密后的字符串（did 加上 APP设备数据表中的key，然后md5）

使用一个html表单来模拟一下APP客户端post发送过来的请求数据：

<!doctype html>
<html>
	<head>
		<title>
			模拟手机APP提交的POST数据，用户请求初始化接口init.php
		</title>
	</head>
	<body>
		<form action="./init.php" method="post">
			app_id		<input type="text" name='app_id' ><br/>
			version_id	<input type="text" name="version_id"><br/>
			<!--did客户端的开发工程师会获取到-->
			did	        <input type="text" name="did" value="123"><br/>
			version_mini    <input type="text" name="version_mini"><br/>
			encrypt_did	<input type="text" name="encrypt_did" value="e10adc3949ba59abbe56e057f20f883e"><br/>
			<input type="submit" />
		</form>
	</body>
</html>

忘了说还需要数据库表了，这里需要两张表。一张是记录升级版本信息的表，记录着设备的id，版本号信息，下载地址等。另外一张表是记录的设备的信息，比如安卓手机的信息，安卓pad的信息等等，版本信息表中有一个外键app_id，关联的就是设备信息表的主键。

    设备信息表，记录了各种客户端的信息
    CREATE TABLE IF NOT EXISTS `app_table` (
      `app_id` smallint(6) NOT NULL AUTO_INCREMENT COMMENT '主键',
      `name` varchar(10) NOT NULL COMMENT '设备名称',
      `is_encryption` tinyint(1) NOT NULL COMMENT '是否加密',
      `key` varchar(10) NOT NULL COMMENT '加密key',
      `image_size` text NOT NULL COMMENT '按照json来存储',
      `create_time` int(11) NOT NULL COMMENT '添加时间',
      `update_time` int(11) NOT NULL COMMENT '修改时间',
      `status` tinyint(1) NOT NULL COMMENT '状态 1正常0删除',
      PRIMARY KEY (`app_id`)
    ) ENGINE=MyISAM  DEFAULT CHARSET=utf8 COMMENT='app设备表' AUTO_INCREMENT=2 ;
    
    版本升级信息表，存放了各种版本的信息
    CREATE TABLE IF NOT EXISTS `version_upgrade` (
      `id` smallint(4) NOT NULL AUTO_INCREMENT COMMENT '主键',
      `app_id` smallint(4) NOT NULL COMMENT '客户端设备id',
      `version_id` smallint(4) NOT NULL COMMENT '大版本号id',
      `version_mini` mediumint(8) NOT NULL COMMENT '小版本号',
      `version_code` varchar(10) NOT NULL COMMENT '版本标识1.2',
      `type` tinyint(4) NOT NULL COMMENT '是否升级1是0否',
      `apk_url` varchar(255) NOT NULL COMMENT '下载链接地址',
      `upgrade_point` varchar(255) NOT NULL COMMENT '升级提示',
      `status` tinyint(4) NOT NULL,
      `create_time` int(11) NOT NULL COMMENT '添加时间',
      `update_time` int(11) NOT NULL COMMENT '修改时间',
      PRIMARY KEY (`id`)
    ) ENGINE=MyISAM  DEFAULT CHARSET=utf8 COMMENT='软件升级信息表' AUTO_INCREMENT=2 ;

为处理请求的init.php创建一个基础类，在基础类的方法check（）中，进行各种判断，比如：该客户端设备是否存在，是否需要加密处理，是否有权限更新等等。

<?php 

/***********************************
*
*	版本升级接口开发的基础类
*	学php的小蚂蚁
*	博客 http://my.oschina.net/woshixiaomayi/blog
*
************************************/

//载入之前写好的接口响应类
//代码内容请参考 http://my.oschina.net/woshixiaomayi/blog/517384
require_once('./response.php');
//载入之前写好的db类
//代码内容请参考 http://my.oschina.net/woshixiaomayi/blog/518295
require_once('./db.php');

class common{

	//post提交过来的数据
	public $param;
	//该客户端设备的信息详情
	public $app;
	//数据库连接资源
	public $connect;

	//确认设备的版本信息，权限等
	public function check(){
		//post提交过来的数据整合，一行太长了，分开来写\(^o^)/~
		$app_id	=	isset($_POST['app_id'])?$_POST['app_id']:'';
		$this	->	param['app_id']	=	$app_id;
		$version_id	=	isset($_POST['version_id'])?$_POST['version_id']:'';
		$this	->	param['version_id']	=	$version_id;
		$did	=	isset($_POST['did'])?$_POST['did']:'';
		$this	->	param['did']	=	$did;
		$version_mini	=	isset($_POST['version_mini'])?$_POST['version_mini']:'';
		$this	->	param['version_mini']	=	$version_mini;
		$encrypt_did	=	isset($_POST['encrypt_did'])?$_POST['encrypt_did']:'';
		$this	->	param['encrypt_did']	=	$encrypt_did;

		//判断app_id和version_id数据类型是否正确
		if(!is_numeric($app_id) or !is_numeric($version_id)){
			return Response::show(400,'数据不合法');
		}

		//判断是否需要加密处理
		$this->app=$this->getApp();
		if(!$this->app){
			return Response::show(400,'该app不存在');
		}

		/*
			判断是否有权限，判断权限的方式，1,是否需要加密处理 
			2,发送过来的encrypt_did是否和服务端生成的值一致
		*/
		if($this->app['is_encryption'] && $this->param['encrypt_did'] != md5($did . $this->app['key'])){
			return Response::show(405,'你没有权限');
		}
	}

	//获取该设备信息
	public function getApp(){
		//这几天这一段都写烂了，就不写注释了
		try{
			$this->connect =	Db::getInstance()->connect();
		}catch(Exception $e){
			//返回给APP的错误提示
			return Response::show(400,'mysql not connect');
		}

		$sql="select * from app_table where app_id=".$this->param['app_id'];
		
		$result=mysql_query($sql,$this->connect);
		return mysql_fetch_assoc($result);
	}

	//获取新版本信息
	public function getVersionUpgrade($app_id){

		$sql="select * from version_upgrade where app_id=".$app_id." order by create_time desc limit 1";
		$result=mysql_query($sql,$this->connect);
		$result=mysql_fetch_assoc($result);
		return $result;
	}
}

 ?>

创建init.php，将数据发送到这个脚本做处理即可，最后返回的数据可以确定，该客户端是否需要/能够升级版本。

<?php 

/********************************
*
*   版本升级接口逻辑
*   学php的小蚂蚁
*   博客 http://my.oschina.net/woshixiaomayi/blog
*
***************************/

//载入基础类，进行版本判断
require_once('./common.php');

class Init extends Common{

	public function index(){
		//本方法在基类中，确实数据的正确性	
		$this->check();
		/*
			获取新版本信息，和APP发送过来的版本信息进行对比
			如果是最新版本，不升级
			如果是老版本，升级
		*/
		$version_grade=$this->getVersionUpgrade($this->param['app_id']);
		//检测是否拿到版本信息
		if($version_grade){
			/*
				判断type类型看能否升级，并且判断客户端是不是最新版本
				如果可以更新，添加键值is_upload = 1
				不能更新，is_upload	= 0
				APP工程师根据返回的is_upload的值进行相应的操作
			*/
			if ($version_grade['type'] && $this->param['version_id'] < $version_grade['version_id']) {
				$version_grade['is_upload']=$version_grade['type'];	
			}else{
				$version_grade['is_upload']=0;
			}
			return Response::show(200,'获取版本成功',$version_grade);
		}else{
			return Response::show(400,'获取新版本失败');
		}
	}
	
}	

$obj	=	new Init();
$obj	->	index();
 
?>

APP客户端版本升级的接口，基本上就完成了，明天再把APP客户端错误日志接口的笔记写一下，APP接口开发的内容就结束了。学习这个也花费了不少时间 (～￣▽￣)～

转载于:https://my.oschina.net/woshixiaomayi/blog/519783