TPM（ThinkPHP Mobile）使用簡明教程
一、基礎知識
1 手機APP的類型
移動端的應用有這幾種：WebApp，NativeApp，HybridApp。
WebApp 就是手機網站，需要用手機瀏覽器訪問。
NativeApp是用原生語言開發，用戶需要下載安裝的手機應用。 NativeApp的開發成本很高，每個平臺的開發語言都不一樣， 比如IOS的開發語言是object C ， Android系統的APP需要用Java開發， WindowsPhone 則需要用 C# 開發。那么我們如果需要做一個多平臺都能運行的APP，需要用多種語言重復開發多次。
相對于NativeApp來說, WebApp開發就簡單多了， 用html,css,js就可開發WebApp， 而且開發一次跨多個平臺。但是WebApp 需要用戶打開手機瀏覽器輸入網址才能訪問，而且不能像NativeApp 能調用手機的攝像頭，通訊錄等功能。WebApp的html,css,js圖片等靜態資源在服務器上，用戶需要下載，會消耗用戶更多的流量。 而NativeApp的靜態資源在手機本地。
HybridApp中和了NativeApp和WebApp各自的優勢。 我們可以用html,css,js 開發，兼容多個平臺。用戶也要下載安裝，并能調用手機的攝像頭、通訊錄等功能， HybridApp的靜態資源也在手機本地。
我們知道ThinkPHP的模板也是用HTML,CSS,JS 開發的。所以我們想能否將ThinkPHP的模板直接打包成手機APP？讓我們能一次開放同時擁有電腦版網站，手機版網站和手機APP， 因此才有了TPM的誕生。TPM能讓我們將ThinkPHP的模板打包成一個HybridApp。
2 手機APP的一般架構
很多手機APP的數據都是動態獲取的，我們需要給APP提供接口，讓APP請求接口獲取數據。 不管你是開發NavtiveApp 還是 HybridApp， 都需要給APP提供接口。
傳統的HybridApp 開發方式任然需要我們為APP開發一個接口程序， 我們還要用js寫調用接口的ajax的代碼。
如果使用TPM開發，不用特意寫接口程序，也不用寫ajax調用接口的程序 。 我們還是按照開發網站的方式開發手機客戶端，在Action中指派模板變量， 在模板中使用模板變量。 當我們將模板打包成APP時，APP能自動請求Action，然后渲染對應的模板，這時候請求Action時，Action會自動返回json格式數據。
3 其他手機開發的知識
我們要開發好手機APP，還需要了解更多手機開發的知識。 手機的尺寸大小不一樣，所有我們的界面一般不能寫成固定尺寸的， 要做響應式設計。 建議大家了解一下響應式設計的知識。 也可以結合一些UI框架，如bootstrap、purecss 他們自帶對響應式的支持。
建議大家再閱讀一下《移動端webapp開發必備知識》
http://www.qianduan.net/mobile-webapp-develop-essential-knowledge.html
二、環境搭建
首先你需要建立一個包含TPM的ThinkPHP項目。 你可以在ThinkPHP官方網站上下載TPM， 也可以中github中獲得。 Github的地址是：
https://github.com/liu21st/extend/tree/master/Extend/Tool/TPM
將下載的文件中， Tpl目錄下的文件復制到你的項目文件夾下Tpl目錄中。將SwitchMobileTplBehavior.class.php 復制到 項目目錄下 Lib/Behavior 目錄下，將TemplateMobile.class.php 文件復制到 ThinkPHP/Extend/Driver/Template 下。
項目需要開啟layout ， 在項目配置文件中配置：
'LAYOUT_ON'=>true
在項目的Conf文件夾下建立tags.php ,代碼為：
<?php
return array(
'action_begin'=>array('SwitchMobileTpl')
)
如果想手機客戶端支持頁面跳轉，需要修改核心文件 ThinkPHP/Common/functions.php 中得redirect函數，修改為：
function redirect($url, $time=0, $msg='') {
//多行URL地址支持
$url = str_replace(array("", ""), '', $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 = "<meta http-equiv='Refresh' content='{$time};URL={$url}'>";
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> <name> <package> <version>參數說明：
platform ：輸入android或ios, 默認為android，現在還不支持IOS打包，大家敬請期待。
name ：應用名稱， 默認為TPM 。
package： 應用的包名，如：com.think.yourname ，一般為一個域名的倒序。 默認為 cn.thinkphp.tpm
version: 應用版本， 默認為1.0
三 使用說明
1 運行原理
之前我們在部署項目的時候發現ThinkPHP開啟了layout，其實瀏覽器瀏覽網站時使用的layout文件是Tpl/layout.html， 而打包成手機APP后，layout文件其實是 Tpl/index.html ， 我們用編輯器打開 Tpl/index.html文件， 發現里面多加載了一個js文件：TPM.js 。 在手機APP上運行時,TPM.js文件負責解析ThinkPHP模板標簽和自動請求接口。
Tpl/index.html 中需要有這兩個層：
<div id="main"></div>
<div class="ajax_wait">正在加載中...</div>
TPM會把每次渲染模板的結果放到ID為main的層中。 class為ajax_wait的層 是在請求接口的時候會顯示，我們可以在css文件中定義ajax_wait的樣式。
2 模板標簽
我們知道在手機APP中并沒用PHP運行環境，解析ThinkPHP模板標簽的是js，ThinkPHP的大部分模板標簽都可以正常使用，但也有一些限制，比如模板標簽中不能用PHP的函數，所以也不能在模板中使用U函數。
支持的ThinkPHP模板標簽有： volist,foreach,for,empty,notempty,present,notpresent,eq,neq,heq,nheq,egt,gt,elt,lt,if,elseif,else,switch,case,default,in,notin,between,notbetween,include。
include標簽在使用時有點限制，file屬性必須寫明控制器和方法，不能省略控制器。 如
<include file="Action:method" />
不能省略Action。如果有分組也不能省略分組。 其他標簽的用法不變。
TPM未實現的標簽有： defined，define等
TPM未實現 __URL__，__PUBLIC__，__ROOT__，__SELF__ 等模板替換變量。
大家需要在模板中寫固定的URL ， 以斜杠開頭。URL地址格式為： /Action/method
3 獨立手機APP的模板
我們如果希望網站模板和手機APP模板分離，可以定義項目配置:
'TPM_THEME'=>'mobile'
然后在Tpl目錄下建立一個mobile文件夾。 在mobile文件夾中放置手機APP的模板。 這樣如果是瀏覽器瀏覽網站首頁，程序渲染的模板是Tpl/Index/index.html， 如果是手機APP打開，渲染的首頁模板是 Tpl/mobile/Index/index.html .
4 配置說明
Tpl/index.html文件中需要加載TPM.js以及運行TPM ， 運行TPM的代碼是：
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 元素監聽
我們做一些js效果，往往會監聽元素事件，比如：
<script>
$(document).ready(function(){
$('#id').click(function(){
alert('click');
});
});
<script>
這段代碼監聽一個元素的點擊事件，但在TPM中這樣監聽可能會失效， 因為這種監聽方式不能監聽到新生的元素， 而TPM 的界面都是 請求接口渲染模板后新生的， 新生的內容會放在Tpl/index.html 文件中main層中。在TPM中要對這種新生的元素進行事件監聽，可以使用TPM.ready，用法如下：
<script>
TPM.ready(function($){
$('#id').click(function(){
alert('click');
});
});<script>
TPM還有很多特性，它不僅能和ThinkPHP結合， 也可以結合自己已有的接口。還有一些附件插件幫助我們實現一些常用功能。 其他高級的用法我們會陸續發布使用文檔，大家敬請期待。
TPM首次發布，可能有諸多不足的地方，希望大家能予以諒解。多為我們提供寶貴建議， 我們會不斷努力，繼續完善好TPM 。 讓我們和廣大TPer一起推開移動互聯網的大門。
