ThinkPHP正式發(fā)布了云引擎版本，本篇就簡單說明下如何使用云引擎擴展。

概述

ThinkPHP的云引擎擴展是為云平臺服務(wù)的ThinkPHP擴展。通常所說的云平臺是指PaaS類型的云計算平臺（服務(wù)），他們的名稱一般叫App Engine 。如新浪的有SAE（Sina App Engine） ，百度有 BAE（Baidu App Engine），等等。
可以看到當今云計算已經(jīng)十分流行，但是云計算有兩個缺點。
學(xué)習(xí)成本高： 我們要學(xué)習(xí)云計算提供的服務(wù)怎么使用，每使用一個云平臺都需要學(xué)習(xí)一次。
平臺不兼容： 因為我們使用了這個云平臺的服務(wù)，其他云平臺沒有和它相同的服務(wù)，導(dǎo)致我們的程序?qū)Υ嗽破脚_有依賴， 不能移植到其他云平臺，也不能移植到普通環(huán)境。
ThinkPHP的引擎擴展出現(xiàn)的目的就是為了解決云計算的兩大缺點。降低用戶學(xué)習(xí)成本，讓用戶只要會使用ThinkPHP就能用所有的云平臺，我們還是按照傳統(tǒng)使用ThinkPHP的方式，但你已經(jīng)不知不覺使用了云計算的服務(wù)。解決平臺兼容性問題，同樣的代碼既能在普通環(huán)境運行，也能在各種云平臺上運行。
ThinkPHP原來的SAE引擎，只適合在SAE平臺下使用，不能在其他云平臺下使用，所以只是一種支持云平臺的探索，而Cluster引擎擴展適合所有云平臺以及分布式集群環(huán)境。
Cluster引擎采用IO分離的機制，實現(xiàn)了一個引擎擴展，通用所有云平臺，所有分布式環(huán)境，普通環(huán)境下也可以運行，真正的打破了云平臺不兼容的缺點。開發(fā)人員用ThinkPHP的Cluster引擎寫出的程序?qū)氐讛[脫對云平臺的依賴，從而實現(xiàn)一次編碼，多處（云平臺）部署。

下載

我們首先需要下載Cluster引擎擴展，選擇下載其中任意一個：
云引擎擴展單獨下載
ThinkPHP云引擎版本下載
如果是下載的引擎擴展，下載后解壓縮放入系統(tǒng)的Extend/Engine/目錄。
云引擎版本則集成了最新github版本的3.1.2核心包和最新的Cluster引擎擴展，以及常用的驅(qū)動和類庫擴展。

入口文件定義

新版的引擎擴展無需在入口文件中載入引擎入口文件，和使用標準模式一樣載入框架入口文件即可，然后在入口文件定義常量ENGINE_NAME為引擎擴展的名稱即可，如定義為：然后在本地運行你的代碼，生成項目目錄。
注意：項目目錄一定要在本地生成，不可在云平臺下生成， 因為云平臺往往是不可寫的環(huán)境。

上傳代碼到云平臺

然后將你生成的項目目錄和文件以及ThinkPHP的核心文件上傳到云平臺。因為ThinkPHP Cluster引擎在云平臺下不會生成任何文件，因此你無需上傳項目的Runtime目錄。
下面以SAE和BAE為例，說明如何上傳代碼到云平臺。

上傳代碼到SAE

將代碼上傳到SAE可以參考SAE文檔： http://sae.sina.com.cn/?m=devcenter&catId=212
上傳代碼后，還需要開啟一些服務(wù)。

開啟Memcahce服務(wù)
進入SAE的應(yīng)用列表： http://sae.sina.com.cn/?m=myapp
選擇你剛才上傳代碼的應(yīng)用。 然后在網(wǎng)站左側(cè)的服務(wù)管理處 點擊Memcache，然后開啟Memcahe服務(wù)即可。
ThinkPHP Cluster在SAE平臺使用Memcache存儲核心編譯緩存，模板緩存以及S緩存。你不用學(xué)習(xí)SAE的Memcache服務(wù)怎么使用， 如果你需要使用Memcache，使用ThinkPHP的S函數(shù)即可。

開啟KVDB服務(wù)
開啟KVDB服務(wù)和開啟Memcahce服務(wù)一樣，也需要在服務(wù)管理處進行開啟。
ThinkPHP Cluster將靜態(tài)緩存，F(xiàn)緩存存入了KVDB，你不用學(xué)習(xí)SAE的KVDB怎么使用，如果需要使用KVDB，使用ThinkPHP的F函數(shù)即可。

創(chuàng)建Storage
ThinkPHP上傳文件使用UploadFile.class.php。 在SAE上一樣是使用UploadFile類上傳文件，用法不變。只是SAE是不可寫的環(huán)境，文件不會被上傳到代碼空間而是上傳到了Storage 。 我們需要在SAE服務(wù)管理處創(chuàng)建storage ， storage的domain名稱和你的上傳路徑相關(guān)，是你上傳路徑中的第一個文件夾名稱。 比如我們的上傳代碼如下：因為上傳路徑為'./Public/upload/' 第一個文件夾名詞為Public， 所以我們需要在SAE創(chuàng)建storage的domain名詞為public，然后這段上傳代碼在本地也能運行，在SAE上也能運行，在SAE上文件被上傳到了storage中。
注：1,SAE平臺storage的domain不區(qū)分大小寫，統(tǒng)一小寫， 所以domain名稱Public 可以不用首字母大寫。
2,使用的UploadFile類，請使用首次運行代碼生成項目目錄中的Lib/ORG/UploadFile.class.php文件，這個文件已經(jīng)被修改適合所有云平臺。

將代碼上傳到BAE

一樣的代碼，不僅能上傳到SAE，上傳到BAE也可以運行，上傳到所有其他云平臺也可以運行。但BAE目前還在內(nèi)測，使用需要先獲得邀請碼， 如果你無法使用BAE，可以測試一下我們已經(jīng)部署在BAE上的應(yīng)用： http://tpcluster.duapp.com/
BAE和SAE一樣也可以使用SVN部署代碼，在創(chuàng)建應(yīng)用后會獲得一個SVN地址。
上傳完代碼后，需要開啟一些服務(wù)。

開啟cache服務(wù)
進入你的管理中心 http://developer.baidu.com/dev 進入你剛才上傳的應(yīng)用，在左側(cè)的服務(wù)管理處點擊cache服務(wù)。
然后初始化服務(wù)即可。BAE的cache服務(wù)實際也是Memcache實現(xiàn)的。
ThinkPHP在BAE上將核心緩存，模板緩存，S緩存存入了Memcache， BAE并沒有像SAE的KVDB那樣的nosql服務(wù)，所以F函數(shù)，靜態(tài)緩存也都存入了Memcache（過期時間是0，永不過期）。
注意： BAE雖然并沒有像SAE那樣強制環(huán)境為不可寫的環(huán)境。但是我們不要在BAE上寫入文件，因為云平臺都是分布式環(huán)境，寫入的文件很容易讀取不到。

開啟云存儲服務(wù)
和SAE一樣，ThinkPHP在BAE上傳文件一樣使用UplaodFile類，用法不變。但在BAE文件是被存在云存儲中。
在管理中心的左側(cè)點擊“我的云服務(wù)” ， 在新打開的頁面的左側(cè)菜單中點擊“云存儲”，在這里需要創(chuàng)建bucket， 這里的bucket 就相當于是SAE storage的domain。 Bucket的名稱和你的上傳路徑相關(guān)，是你路徑中的第一個文件夾名稱。 如果上傳路徑是 ./Public/upload/ 按理說 我們要建立一個名為public的bucket，但是BAE的存儲的bucket要求是全局唯一的， 別人創(chuàng)建了一個名為public的bucket，你就不能再創(chuàng)建了。 所以我們要加上前綴。 假設(shè)我們的前綴為“think-” ， 創(chuàng)建的bucket名詞為 “think-public” (和SAE一樣，名詞全部小寫) 。 而這個think- 的前綴需要在 BAE配置文件中配置。編輯你項目目錄下 Conf/config_bae.php 文件，配置

使用專用文件

我們知道，如果在本地上傳一張圖片到 ./Public/upload/目錄下， 要顯示圖片，模板中的代碼如下：而在SAE和BAE上圖片并沒有存在該上傳目錄下，上面的代碼能正常顯示圖片嗎？在ThinkPHP云引擎中實現(xiàn)了不管是在普通環(huán)境還是云平臺，使用的代碼都一樣， 在云平臺還是像普通環(huán)境那樣使用代碼， 上面顯示圖片的代碼，在云平臺也能正常顯示。原理是利用了云平臺專用文件。

各個平臺都會有一些差異，我們盡量不要在我們的代碼中帶入平臺特征，比如顯示圖片如果寫為 那么只能顯示在SAE平臺下上傳的圖片，普通環(huán)境，BAE將無法顯示。因為圖片地址中使用了SAE storage的域名，帶入了SAE平臺的特征。 如果代碼中帶入平臺特征就會導(dǎo)致代碼沒有可移植性，本地調(diào)試也很困難。但是各個平臺有都各有差異，我們將差異寫入專用文件中，不在普通文件中體現(xiàn)，這樣就能兼容全平臺的。

專用文件是指在不同平臺下會加載這個平臺專用的文件， 如前面提到的config_bae.php 配置文件一樣只在BAE會加載， 在其他平臺不會加載。
專用文件有兩種配置文件和函數(shù)文件。

（1）配置專用文件

在項目的Conf文件夾下config_sae.php文件中的配置項是SAE平臺才會加載的配置。
config_bae.php文件中的配置項在BAE中才會加載。 配置專用文件會后于項目配置文件(config.php) 加載。 如果有相同配置項，后加載的會覆蓋先加載的。 比如config.php和config_sae.php都有數(shù)據(jù)庫配置項。 在sae下數(shù)據(jù)庫配置以config_sae.php中的值為準，而在普通環(huán)境，因為不會加載config_sae.php， 數(shù)據(jù)庫配置項還是config.php中的值。我們知道SAE和BAE下數(shù)據(jù)庫配置都是常量，所以可以把數(shù)據(jù)庫配置寫死在配置專用文件中， SAE的配置專用文件還實現(xiàn)了數(shù)據(jù)庫的主從讀寫分離。 而config.php中的數(shù)據(jù)庫信息可以寫成你在本地開發(fā)時的數(shù)據(jù)庫，這樣每次上線代碼都不用修改配置。
首次在本地運行代碼時生成的默認項目中已經(jīng)為大家創(chuàng)建好了SAE和BAE的配置專用文件。默認的配置專用文件中除了配置了數(shù)據(jù)庫相關(guān)配置項，還實現(xiàn)了圖片顯示的兼容，是利用ThinkPHP模版替換變量功能實現(xiàn)的。模版替換變量的配置項是TMPL_PARSE_STRING顯示圖片代碼為：其中/Public 就是一個模版替換變量， 他一般為替換為 /Public 然后我們再配置專用文件中配置了將 '/Public/upload'替換為file_domain ('Public').'/upload'
file_domain () 函數(shù)在SAE用于獲得storage的域名， BAE用于獲得云存儲的域名。 這個函數(shù)需要傳遞一個參數(shù)， SAE下傳遞storage的domain，BAE下傳遞的是buncket的名稱。
通過上面的手段就實現(xiàn)的顯示圖片的代碼在各個平臺的兼容。
注：BAE不支持pathinfo，所以在BAE的配置專用文件中還配置了URL_MODEL 為3 的兼容模式。

（2）函數(shù)專用文件

除了配置文件，你還可以建立不同平臺的函數(shù)文件。在項目的 Common文件下 common_sae.php是SAE的函數(shù)專用文件，在SAE平臺下才會加載， common_bae.php是BAE的函數(shù)專用文件，在BAE平臺下才會加載， common_local.php 是普通環(huán)境的函數(shù)文件，在本地運行時才會加載。 如果我們有一個操作在不同平臺的實現(xiàn)方式都不一樣，那么我們把它封裝成函數(shù)， 在各個函數(shù)專用文件中實現(xiàn)同名的函數(shù)。這樣也實現(xiàn)了全平臺兼容。

云引擎增加的常量

在云引擎擴展中，為了方便使用，增加了相應(yīng)的常量。

IS_SAE	判斷是否為SAE平臺
IS_BAE	判斷是否為BAE平臺
IS_CLOUD	判斷是不是云計算平臺（在SAE,BAE下都為true，在本地環(huán)境下為false）

通過以上常量，可以判斷不同平臺進行不同操作。

測試應(yīng)用

首次運行代碼默認創(chuàng)建的項目中有些簡單的測試例子，包括S函數(shù)，F(xiàn)函數(shù)，文件上傳，日志記錄等。大家都可以在各個平臺測一測。 注意日志記錄各個平臺記錄的地方不一樣， SAE是記錄到了日志中心，查看日志時需要類型為debug類型。

BAE是記錄在BaeLog中，需要選擇類型為debug。

引擎定制

ThinkPHP的Cluster引擎不光適合于云平臺，所有分布式的環(huán)境都適合，云平臺也一般是分布式的環(huán)境。 他們共同的特點都是環(huán)境不讓直接寫入文件（限制IO寫操作）。原因很簡單，因為他們是分布式的環(huán)境，每次訪問都可能是訪問在不同的服務(wù)器上面，而寫操作是單機的， 比如程序在A服務(wù)器寫入了一個文件test.txt，而下次訪問可能是訪問到了B服務(wù)，B服務(wù)并沒有test.txt，讀取test.txt就會失敗。各個平臺的最大差異就是把程序?qū)懭氲奈募?nèi)容存儲在哪兒。
注：BAE環(huán)境當流量大時才會觸發(fā)分布式模式，流量小一直運行在單機模式中，所以你可以在BAE上測試讀取寫入文件，可能不會出現(xiàn)讀取失敗的現(xiàn)象，只有當?shù)竭_一定流量才會看見。
ThinkPHP Cluster 采用IO分離的機制， 將IO操作交給了用戶實現(xiàn)，從而實現(xiàn)了對不同平臺的兼容的。 我們進入默認創(chuàng)建的項目中，可以看見多了一個IO文件夾， 該文件夾下 sae.php 文件實現(xiàn)了SAE平臺的IO操作， bae.php實現(xiàn)了BAE平臺的IO操作，auto.php文件能智能判斷云平臺加載不同的IO文件， Cluster默認就是加載的auto.php。 sample.php 文件是一個IO文件的例子。如果你要在自己的分布式環(huán)境下運行代碼，你需要參考sample.php 創(chuàng)建自己得IO文件。 然后在入口文件中定義IO_NAME常量，指定加載的IO文件。 如定義為這時候程序運行時會加載sample.php 。 如果沒有定義IO_NAME ，IO_NAME的默認值為auto。 我們?nèi)绻x 這樣程序只能在SAE和普通環(huán)境上運行，不能在BAE上運行了。
所以，要支持不同的云平臺，只需要編寫不同的IO文件就行了。
編寫IO文件
在IO文件中，我們要實現(xiàn)以下函數(shù)：
runtime_set($filename,$content), 在寫入核心緩存或者模版緩存時會調(diào)用這個函數(shù)，函數(shù)傳遞了要存的文件路徑和文件內(nèi)容，你需要在這個函數(shù)中定義緩存內(nèi)容存放在哪里。函數(shù)返回true表示存儲成功，false表示存儲失敗。你可以將內(nèi)容存儲在memcache等分布式緩存中。
runtime_get($filename), 獲取緩存的文件內(nèi)容，函數(shù)需要返回存儲的文件內(nèi)容。
runtime_delete($filename), 刪除緩存文件的方法，刪除成功返回true，失敗返回false。
F_set($name,$vlaue)， F緩存存儲方法，F(xiàn)緩存一般是需要持久化的，建議存儲在redis，mongodb等能持久化存儲數(shù)據(jù)的地方。 成功返回true，失敗返回false
F_get($name), 獲得設(shè)置的F緩存。返回緩存內(nèi)容
F_delete($name), 刪除F緩存，刪除成功返回true，失敗返回false。
S_set($name,$value,$expire), S緩存存儲方法， S緩存建議存儲在具有過期機制的緩存中（如memcache）。 成功返回true，失敗返回false
S_get($name) ，獲得設(shè)置的S緩存。返回緩存內(nèi)容
S_delete($name),刪除設(shè)置的S緩存。 成功返回true，失敗返回false
S_clear()， 清空所有S緩存的方法。成功返回ture，失敗返回false
file_upload($src_file,$desc_file)， 實現(xiàn)文件上傳， 傳遞參數(shù)src_file為準備上傳的文件地址， $desc_file 是文件的保存地址。 上傳成功返回true，失敗返回false
file_delete($filename), 實現(xiàn)文件的刪除，成功返回true，失敗返回false。
file_domain($domain), 獲得顯示圖片地址的根路徑， 這個函數(shù)前面已經(jīng)在配置專用函數(shù)中使用過， 而這個函數(shù)的實現(xiàn)是在IO文件中實現(xiàn)。
html_set($filename,$content) , 存儲靜態(tài)HTML內(nèi)容，成功返回true，失敗返回false
html_get($filename), 獲得靜態(tài)html內(nèi)容。一旦我們設(shè)置靜態(tài)緩存后會觸發(fā)html_set 和html_get函數(shù)。
log_save($logs,$request_info)， 日志保存方法， 傳遞的參數(shù)logs是一個數(shù)組，它是單次請求的所有日志， request_info 是這次請求的信息包括了請求時間，客戶端ip等。
log_write($log)， 寫入單條日志。
注：只有當DATA_CACHE_TYPE 配置項為file時，對S緩存操作時才會觸發(fā)S_set,S_get,S_delete 這些函數(shù)。 如果DATA_CACHE_TYPE 系統(tǒng)默認為file，如果你設(shè)置了這個配置項不為file，那么S緩存的實現(xiàn)為你指定的緩存類型。

RoadMap

現(xiàn)在ThinkPHP云引擎已經(jīng)有了SAE和BAE的IO文件，還將計劃添加騰訊TAE、 阿里云ACE、盛大云等IO文件。
更多描述，還可以參考視頻說明：http://v.youku.com/v_show/id_XNTA2NjU0OTg4.html。
關(guān)于云引擎我們還會不斷的完善和改進，也非常歡迎大家反饋和建議，最后感謝大家對ThinkPHP的支持。