TPM（ThinkPHPMobile）使用简明教程

一、基础知识

1 手机APP的类型

2 手机APP的一般架构

3 其他手机开发的知识

二、环境搭建

项目需要开启layout ， 在项目配置文件中配置：

'LAYOUT_ON'=>true

在项目的Conf文件夹下建立tags.php ,代码为：

return array( 
 'action_begin'=>array('SwitchMobileTpl')
 )
如果想手机客户端支持页面跳转，需要修改核心文件 ThinkPHP/Common/functions.php 中得redirect函数，修改为：

function redirect($url, $time=0, $msg='') {
    //多行URL地址支持
    $url        = str_replace(array("\n", "\r"), '', $url);
    if (empty($msg))
        $msg    = "系统将在{$time}秒之后自动跳转到{$url}！";
    if (!headers_sent()) {
        // redirect
        if (0 === $time) {
           //手机客户端跳转发送redirect的header
            if(defined('IS_CLIENT') && IS_CLIENT){
                if(''!==__APP__){
                    $url=substr($url,strlen(__APP__));
                }
                header('redirect:'.$url);
            }else{
                header('Location: ' . $url);
            }
        } else {
            header("refresh:{$time};url={$url}");
            echo($msg);
        }
        exit();
    } else {
        $str    = "";
        if ($time != 0)
            $str .= $msg;
        exit($str);
    }
}

编辑器打开Tpl/index.html文件，修改代码

TPM.run("http://yourappurl"); 

，将网址修改为你项目的真实访问地址。
然后，我们可将模板目录打包成手机APP 。 
首先打开你的命令行， cd 到模板目录， 运行命令：

php  build.php  

然后我们发现在模板目录会生成手机APP文件， 我们在手机上面安装即可。 
命令行打包程序需要你的环境开启zip和curl扩展，如果不清楚的话请自行百度解决。
注意：打包命令需要联网，如果没有联网的话 可以用第三方打包工具例如phonegap打包。

打包命令还可以跟更多参数：
php build.php
参数说明：
platform ：输入android或ios, 默认为android，现在还不支持IOS打包，大家敬请期待。 
name ：应用名称， 默认为TPM 。
package： 应用的包名，如：com.think.yourname ，一般为一个域名的倒序。 默认为 cn.thinkphp.tpm
version: 应用版本， 默认为1.0

三 使用说明

1 运行原理

TPM会把每次渲染模板的结果放到ID为main的层中。 class为ajax_wait的层 是在请求接口的时候会显示，我们可以在css文件中定义ajax_wait的样式。

2 模板标签

不能省略Action。如果有分组也不能省略分组。 其他标签的用法不变。

TPM未实现的标签有： defined，define等

TPM未实现 __URL__，__PUBLIC__，__ROOT__，__SELF__ 等模板替换变量。

大家需要在模板中写固定的URL ， 以斜杠开头。URL地址格式为： /Action/method 

3 独立手机APP的模板

'TPM_THEME'=>'mobile'

然后在Tpl目录下建立一个mobile文件夹。 在mobile文件夹中放置手机APP的模板。 这样如果是浏览器浏览网站首页，程序渲染的模板是Tpl/Index/index.html， 如果是手机APP打开，渲染的首页模板是 Tpl/mobile/Index/index.html .

4 配置说明

TPM.run(config)

TPM.run传递的config参数是配置项。 以对象形式传递。 可以设置的主要配置有： 
api_base： 项目入口文件地址, http开头。
api_index： 首次请求的控制器方法，默认为/Index/index
下面举例说明一下这些配置项。 
假设我们创建了一个项目， 入口文件的浏览地址是 http://www.xxx.com/index.php , 我们想手机APP打开的第一个页面不是首页，而是登陆页，登陆页的浏览地址假设是： 
http://www.xxx.com/index.php/Index/login

那么TPM.run的传参如下：

TPM.run({
    api_base:'http://www.xxx.com/index.php',
    api_index:'/Index/login'
});
如果你的项目做了隐藏入口文件的处理，那么api_base也可以不写入口文件，配置为：

TPM.run({
    api_base:'http://www.xxx.com',//注意，末尾不带斜杠
    api_index:'/Index/login'
});
如果只想配置api_base这个参数，其他参数使用默认值，只传递一个网址作为参数：

TPM.run('http://www.xxx.com')

5 元素监听

$(document).ready(function(){
    $('#id').click(function(){
    alert('click');
});
});

这段代码监听一个元素的点击事件，但在TPM中这样监听可能会失效， 因为这种监听方式不能监听到新生的元素， 而TPM 的界面都是 请求接口渲染模板后新生的， 新生的内容会放在Tpl/index.html 文件中main层中。在TPM中要对这种新生的元素进行事件监听，可以使用TPM.ready，用法如下：

TPM.ready(function($){
$('#id').click(function(){
    alert('click');
});
});
TPM还有很多特性，它不仅能和ThinkPHP结合， 也可以结合自己已有的接口。还有一些附件插件帮助我们实现一些常用功能。 其他高级的用法我们会陆续发布使用文档，大家敬请期待。
TPM首次发布，可能有诸多不足的地方，希望大家能予以谅解。多为我们提供宝贵建议， 我们会不断努力，继续完善好TPM 。 让我们和广大TPer一起推开移动互联网的大门。