站長資訊網php使用thrift做服務端開發
thrift采用接口描述語言定義和創建服務，用二進制格式傳輸數據，體積更小、效率更高，對于高并發、數據量大和多語言的環境有更好的支持。
Apache Thrift是啥？
Apache Thrift是FaceBook開發的一套可擴展的、跨語言的服務調用框架。簡單的說就是先定義一個配置文件，不同的語言可以利用thrift基于這個配置文件生成各自語言的服務端，不管客戶端用什么語言，都可以調用，也就是說基于thrift協議用java可以調用php的服務。目前支持C++, Java, Python, PHP, Ruby, Erlang, Perl, Haskell, C#, Cocoa, JavaScript, Node.js, Smalltalk, OCaml and Delphi等語言之間相互調用。
相對于傳統的xml和json等數據傳輸方式來說，thrift采用接口描述語言定義和創建服務，用二進制格式傳輸數據，體積更小、效率更高，對于高并發、數據量大和多語言的環境有更好的支持。
thrift安裝環境要求
-
g++ 4.2
-
boost 1.53.0
-
lex and yacc（基于flex和bison）
如果沒安裝lex和yacc的話要先安裝，否則會make失敗,提示lex和yacc command not found錯誤（一般的機器貌似都沒安，Ubuntu用apt-get install flex bision即可）。
安裝thrift
下載最新版thrift：
wget http://www.apache.org/dyn/closer.cgi?path=/thrift/0.9.3/thrift-0.9.3.tar.gz tar xvf thrift-0.9.3.tar.gz cd thrift-0.9.3
2.創建configure文件
// 創建./configure文件 ./bootstrap.sh // 配置并安裝 ./configure make // 檢測是否有問題，如果機子沒有安裝python和java等可能會報錯，不過本文主要講php，安了php環境就行 make check make install
編譯選項
-
使用./configure –help可以查看選項
-
如果想禁用某個語言，可以用./configure –without-java
thrift for php安裝環境要求
-
php版本>5.0，因為TBinaryProtocol協議用到了pack()和unpack()函數來序列化數據
-
需要安裝APC擴展，因為TSocketPool這個類用到了apc_fetch()和apc_store()函數進行apc緩存操作。
php使用thrift的時候，除了要將thrift/lib/php/lib里的基礎文件copy到項目目錄下，還需要將根據配置文件生成的php文件也copy到packages文件夾下，并引入到項目中，這個后續會詳細講。
類庫說明
數據傳輸格式（protocol）
定義的了傳輸內容，對Thrift Type的打包解包，包括：
-
TBinaryProtocol，二進制格式，TBinaryProtocolAccelerated則是依賴于thrift_protocol擴展的快速打包解包。
-
TCompactProtocol，壓縮格式
-
TJSONProtocol，JSON格式
-
TMultiplexedProtocol，利用前三種數據格式與支持多路復用協議的服務端（同時提供多個服務，TMultiplexedProcessor）交互
數據傳輸方式（transport）
定義了如何發送（write）和接收（read）數據，包括：
-
TBufferedTransport，緩存傳輸，寫入數據并不立即開始傳輸，直到刷新緩存。
-
TSocket，使用socket傳輸
-
TFramedTransport，采用分塊方式進行傳輸，具體傳輸實現依賴其他傳輸方式，比如TSocket
-
TCurlClient，使用curl與服務端交互
-
THttpClient，采用stream方式與HTTP服務端交互
-
TMemoryBuffer，使用內存方式交換數據
-
TPhpStream，使用PHP標準輸入輸出流進行傳輸
-
TNullTransport，關閉數據傳輸
-
TSocketPool在TSocket基礎支持多個服務端管理（需要APC支持），自動剔除無效的服務器
開發流程
1、定義IDL（Interface description language）接口描述文件，后綴.thrift
IDL規范：http://thrift.apache.org/docs/idl
thrift types：http://thrift.apache.org/docs/types
2、服務端代碼開發
3、客戶端編寫接入代碼
IDL：
1.tutorial.thrift
include "shared.thrift" namespace php tutorial typedef i32 MyInteger const i32 INT32CONSTANT = 9853 const map<string,string> MAPCONSTANT = {'hello':'world', 'goodnight':'moon'} enum Operation { ADD = 1, SUBTRACT = 2, MULTIPLY = 3, DIVIDE = 4 } struct Work { 1: i32 num1 = 0, 2: i32 num2, 3: Operation op, 4: optional string comment, } exception InvalidOperation { 1: i32 whatOp, 2: string why } service Calculator extends shared.SharedService { void ping(), i32 add(1:i32 num1, 2:i32 num2), i32 calculate(1:i32 logid, 2:Work w) throws (1:InvalidOperation ouch), oneway void zip() }
2.shared.thrift
namespace php shared struct SharedStruct { 1: i32 key 2: string value } service SharedService { SharedStruct getStruct(1: i32 key) }
php服務端
<?php namespace tutorialphp; ini_set('display_errors',1); error_reporting(E_ALL); // 引入類自動加載文件 require_once __DIR__.'/../../lib/php/lib/Thrift/ClassLoader/ThriftClassLoader.php'; // 載入自動加載類 use ThriftClassLoaderThriftClassLoader; // 定義根據.thrift文件生成的php文件 $GEN_DIR = realpath(dirname(__FILE__).'/..').'/gen-php'; // 注冊thrift服務 $loader = new ThriftClassLoader(); $loader->registerNamespace('Thrift', __DIR__ . '/../../lib/php/lib'); $loader->registerDefinition('shared', $GEN_DIR); $loader->registerDefinition('tutorial', $GEN_DIR); $loader->register(); if (php_sapi_name() == 'cli') { ini_set("display_errors", "stderr"); } use ThriftProtocolTBinaryProtocol; // 二進制格式打包解包 use ThriftTransportTPhpStream; // php流輸入輸出 use ThriftTransportTBufferedTransport; // 使用緩存 // 開始服務端邏輯 class CalculatorHandler implements tutorialCalculatorIf { protected $log = array(); public function ping() { error_log("ping()"); } // 相加 public function add($num1, $num2) { error_log("add({$num1}, {$num2})"); return $num1 + $num2; } // 枚舉計算類型 public function calculate($logid, tutorialWork $w) { error_log("calculate({$logid}, {{$w->op}, {$w->num1}, {$w->num2}})"); switch ($w->op) { case tutorialOperation::ADD: $val = $w->num1 + $w->num2; break; case tutorialOperation::SUBTRACT: $val = $w->num1 - $w->num2; break; case tutorialOperation::MULTIPLY: $val = $w->num1 * $w->num2; break; case tutorialOperation::DIVIDE: if ($w->num2 == 0) { $io = new tutorialInvalidOperation(); $io->whatOp = $w->op; $io->why = "Cannot divide by 0"; throw $io; } $val = $w->num1 / $w->num2; break; default: $io = new tutorialInvalidOperation(); $io->whatOp = $w->op; $io->why = "Invalid Operation"; throw $io; } $log = new sharedSharedStruct(); $log->key = $logid; $log->value = (string)$val; $this->log[$logid] = $log; return $val; } public function getStruct($key) { error_log("getStruct({$key})"); // This actually doesn't work because the PHP interpreter is // restarted for every request. //return $this->log[$key]; return new sharedSharedStruct(array("key" => $key, "value" => "PHP is stateless!")); } public function zip() { error_log("zip()"); } }; header('Content-Type', 'application/x-thrift'); if (php_sapi_name() == 'cli') { echo "rn"; } $handler = new CalculatorHandler(); $processor = new tutorialCalculatorProcessor($handler); // 客戶端和服務端在同一個輸入輸出流上 //1) cli 方式：php Client.php | php Server.php //2) cgi 方式：利用Apache或nginx監聽http請求，調用php-fpm處理，將請求轉換為PHP標準輸入輸出流 $transport = new TBufferedTransport(new TPhpStream(TPhpStream::MODE_R | TPhpStream::MODE_W)); $protocol = new TBinaryProtocol($transport, true, true); $transport->open(); $processor->process($protocol, $protocol); $transport->close(); //作為cli方式運行，非阻塞方式監聽，基于libevent實現，非官方實現 //$transportFactory = new TBufferedTransportFactory(); //$protocolFactory = new TBinaryProtocolFactory(true, true); //$transport = new TNonblockingServerSocket('localhost', 9090); //$server = new TNonblockingServer($processor, $transport, $transportFactory, $transportFactory, $protocolFactory, $protocolFactory); //$server->serve(); //作為cli方式運行，監聽端口，官方實現 //$transportFactory = new TBufferedTransportFactory(); //$protocolFactory = new TBinaryProtocolFactory(true, true); //$transport = new TServerSocket('localhost', 9090); //$server = new TSimpleServer($processor, $transport, $transportFactory, $transportFactory, $protocolFactory, $protocolFactory); //$server->serve();
php客戶端
<?php namespace tutorialphp; error_reporting(E_ALL); require_once __DIR__.'/../../lib/php/lib/Thrift/ClassLoader/ThriftClassLoader.php'; use ThriftClassLoaderThriftClassLoader; $GEN_DIR = realpath(dirname(__FILE__).'/..').'/gen-php'; $loader = new ThriftClassLoader(); $loader->registerNamespace('Thrift', __DIR__ . '/../../lib/php/lib'); $loader->registerDefinition('shared', $GEN_DIR); $loader->registerDefinition('tutorial', $GEN_DIR); $loader->register(); use ThriftProtocolTBinaryProtocol; use ThriftTransportTSocket; use ThriftTransportTHttpClient; use ThriftTransportTBufferedTransport; use ThriftExceptionTException; // 以上配置跟服務端類似 try { if (array_search('--http', $argv)) { // 使用http方式連接 $socket = new THttpClient('localhost', 8080, '/php/PhpServer.php'); } else { // 使用socket連接 $socket = new TSocket('localhost', 9090); } $transport = new TBufferedTransport($socket, 1024, 1024); $protocol = new TBinaryProtocol($transport); $client = new tutorialCalculatorClient($protocol); $transport->open(); $client->ping(); print "ping()n"; $sum = $client->add(1,1); print "1+1=$sumn"; // 調試異常情況 $work = new tutorialWork(); $work->op = tutorialOperation::DIVIDE; $work->num1 = 1; $work->num2 = 0; try { $client->calculate(1, $work); print "Whoa! We can divide by zero?n"; } catch (tutorialInvalidOperation $io) { print "InvalidOperation: $io->whyn"; } $work->op = tutorialOperation::SUBTRACT; $work->num1 = 15; $work->num2 = 10; $diff = $client->calculate(1, $work); print "15-10=$diffn"; $log = $client->getStruct(1); print "Log: $log->valuen"; $transport->close(); } catch (TException $tx) { print 'TException: '.$tx->getMessage()."n"; }
輸出：
// php client.php --http ping() 1+1=2 InvalidOperation: Cannot divide by 0 15-10=5 Log: PHP is stateless!
