项目目前是存档状态,感谢您对腾讯开源项目的关注!您可以继续fork后更新迭代,感谢理解和支持;如果您有其他疑问,建议请发送邮件:tencentopen@tencent.com 与我们联系
Tencent Server Framework
Overview
Tencent Server Framework is a coroutine and Swoole based server framework for fast server deployment which developed by Tencent engineers.
Features
PHP Based. Compared with C++, the framework is more efficient in developing and programing.
based on Swoole extension. powerful async IO, timers and other infrastructure capacity can be used in this framework.
support PHP coroutine. Synchronous programing is possible using the coroutine schedule system, and can lead to the similar server capability with that of server deveoped in an asynchronous way.
support server monitor and provide interface to add more rules
Requirements
php5.5+
Swoole1.7.18+
linux,OS X
Installation
Introduction
Tencent Server Framework can help you to start your server quickly,you just need to set a few settings
Server config
vim server.ini
[server]
;server type:tcp,udp,http
type = http
; port
listen[] = 12312
; entrance file
root = '/data/web_deployment/serv/test/index.php'
;php start path
php = '/usr/local/php/bin/php'
[setting]
; worker process num
worker_num = 16
; task process num
task_worker_num = 0
; dispatch mode
dispatch_mode = 2
; daemonize
daemonize = 1
; system log
log_file = '/data/log/test.log'
How to start your server
cd /root/tsf/bin/
php swoole testHttpServ start
Support Cmds: start,stop,reload,restart,status,shutdown,startall,list
How to use TCP/UDP/HTTP Client
we support different network protocols: TCP,UDP,HTTP
$tcpReturn=(yield $this->tcpTest());
$udpReturn=(yield $this->udpTest());
$httpReturn=(yield $this->httpTest());
public function tcpTest(){
$ip = '127.0.0.1';
$port = '9905';
$data = 'test';
$timeout = 0.5; //second
yield new Swoole\Client\TCP($ip, $port, $data, $timeout);
}
public function udpTest(){
$ip = '127.0.0.1';
$port = '9905';
$data = 'test';
$timeout = 0.5; //second
yield new Swoole\Client\UDP($ip, $port, $data, $timeout);
}
public function httpTest(){
$url='http://www.qq.com';
$httpRequest= new Swoole\Client\HTTP($url);
$data='testdata';
$header = array(
'Content-Length' => 12345,
);
yield $httpRequest->get($url); //yield $httpRequest->post($path, $data, $header);
}
How to use Muticall
Beside that,we also support Muticall:
you can use Muticall to send TCP,UDP packets at the sametime
when all the requests come back,return to interrupt
$res = (yield $this->muticallTest());
public function muticallTest(){
$calls=new Swoole\Client\Multi();
$firstReq=new Swoole\Client\TCP($ip, $port, $data, $timeout);
$secondReq=new Swoole\Client\UDP($ip, $port, $data, $timeout);
$thirdReq= new Swoole\Client\HTTP("http://www.qq.com");
$calls ->request($firstReq,'first'); //first request
$calls ->request($secondReq,'second'); //second request
$calls ->request($thirdReq,'third'); //third request
yield $calls;
}
var_dump($res)
Concect to mysql async
$sql = new Swoole\Client\MYSQL(array('host' => '127.0.0.1', 'port' => 3345, 'user' => 'root', 'password' => 'root', 'database' => 'test', 'charset' => 'utf-8',));
$ret = (yield $sql ->query('show tables'));
var_dump($ret);
$ret = (yield $sql ->query('desc test'));
var_dump($ret);
Router
We support individuation route rules
now we realize some universal route rules and restful rules
besides that, we also support default GET parameter
URL METHOD CONTROLLER ACTION
http://127.0.0.1:80/Test?h=1 ANY ==> TestController/ActionIndex
http://127.0.0.1:80/Test/send?h=1 ANY ==> TestController/ActionSend
Restful
http://127.0.0.1:80/rest GET ==> TestController/ActionList
http://127.0.0.1:80/rest/Test/22 GET ==> TestController/ActionView
Get['id']=22
http://127.0.0.1:80/rest/Test POST ==> TestController/ActionCreate
http://127.0.0.1:80/rest/Test/22 PUT ==> TestController/ActionUpdate
Get['id']=22
http://127.0.0.1:80/rest/Test/22 DELETE ==> TestController/ActionDelete
Get['id']=22
http://127.0.0.1:80/rest/Test/send/1/li GET ==> TestController/ActionSend
Get['cid']=1 Get['name']=li
Performance
Contribution
Your contribution to TSF development is very welcome!
You may contribute in the following ways:
Submit fixes, features via Pull Request
Write/polish documentation