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 tutorial\php;
ini_set('display_errors',1);
error_reporting(E_ALL);
// 引入類自動載入檔案
require_once __DIR__.'/../../lib/php/lib/Thrift/ClassLoader/ThriftClassLoader.php';
// 載入自動載入類
use Thrift\ClassLoader\ThriftClassLoader;
// 定義根據.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 Thrift\Protocol\TBinaryProtocol; // 二進位制格式打包解包
use Thrift\Transport\TPhpStream; // php流輸入輸出
use Thrift\Transport\TBufferedTransport; // 使用快取
// 開始伺服器端邏輯
class CalculatorHandler implements \tutorial\CalculatorIf {
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, \tutorial\Work $w) {
error_log("calculate({$logid}, {{$w->op}, {$w->num1}, {$w->num2}})");
switch ($w->op) {
case \tutorial\Operation::ADD:
$val = $w->num1 + $w->num2;
break;
case \tutorial\Operation::SUBTRACT:
$val = $w->num1 - $w->num2;
break;
case \tutorial\Operation::MULTIPLY:
$val = $w->num1 * $w->num2;
break;
case \tutorial\Operation::DIVIDE:
if ($w->num2 == 0) {
$io = new \tutorial\InvalidOperation();
$io->whatOp = $w->op;
$io->why = "Cannot divide by 0";
throw $io;
}
$val = $w->num1 / $w->num2;
break;
default:
$io = new \tutorial\InvalidOperation();
$io->whatOp = $w->op;
$io->why = "Invalid Operation";
throw $io;
}
$log = new \shared\SharedStruct();
$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 \shared\SharedStruct(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 "\r\n";
}
$handler = new CalculatorHandler();
$processor = new \tutorial\CalculatorProcessor($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 tutorial\php;
error_reporting(E_ALL);
require_once __DIR__.'/../../lib/php/lib/Thrift/ClassLoader/ThriftClassLoader.php';
use Thrift\ClassLoader\ThriftClassLoader;
$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 Thrift\Protocol\TBinaryProtocol;
use Thrift\Transport\TSocket;
use Thrift\Transport\THttpClient;
use Thrift\Transport\TBufferedTransport;
use Thrift\Exception\TException;
// 以上設定跟伺服器端類似
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 \tutorial\CalculatorClient($protocol);
$transport->open();
$client->ping();
print "ping()\n";
$sum = $client->add(1,1);
print "1+1=$sum\n";
// 偵錯異常情況
$work = new \tutorial\Work();
$work->op = \tutorial\Operation::DIVIDE;
$work->num1 = 1;
$work->num2 = 0;
try {
$client->calculate(1, $work);
print "Whoa! We can divide by zero?\n";
} catch (\tutorial\InvalidOperation $io) {
print "InvalidOperation: $io->why\n";
}
$work->op = \tutorial\Operation::SUBTRACT;
$work->num1 = 15;
$work->num2 = 10;
$diff = $client->calculate(1, $work);
print "15-10=$diff\n";
$log = $client->getStruct(1);
print "Log: $log->value\n";
$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!
以上就是關於php使用thrift做伺服器端開發的那些事的詳細內容，更多請關注TW511.COM其它相關文章！