TARS-PHP,TarsPHP/TARS-PHP使用实践.md at master · TarsPHP/TarsPHP · GitHub

TARS-PHP使用实践

综合资料

一、安装相关

安装环境依赖

软件

软件要求

备注

linux内核版本:

2.6.18及以上版本(操作系统依赖)

centos6.9

gcc版本:

4.8.2及以上版本、glibc-devel(c++语言框架依赖)

bison工具版本:

2.5及以上版本(c++语言框架依赖)

flex工具版本:

2.5及以上版本(c++语言框架依赖)

cmake版本：

2.8.8及以上版本(c++语言框架依赖)

resin版本：

4.0.49及以上版本(web管理系统依赖)

下载设置软链

Java JDK版本：

java语言框架(最低1.6)，web管理系统(最低1.8)

安装可能会报错，注意环境变量设置

Maven版本：

2.2.1及以上版本(web管理系统、java语言框架依赖)

mysql版本:

4.1.17及以上版本(框架运行依赖)

注意账号和权限设置

rapidjson版本:

1.0.2版本(c++语言框架依赖)

可以不用单独安装，安装过程会自行下载

安装Tars核心服务

错误修正：

tars_install.sh和monitor.sh文件安装后没有的话，可手工复制文件：

从源码/cpp/build/framework/deploy/tars_install.sh、cpp/build/framework/deploy/tarsnode/util/monitor.sh复制

其他按照文档说明和顺序照着执行。

安装web管理界面

文档中“2.2. java语言框架开发环境安装”部分，构建web工程项目可直接到源码web目录下修改app.config.properties和tars.conf配置，然后直接打包即可！

运行/usr/local/resin/bin/resin.sh start启动web管理界面，正常的话会看到初始化界面，默认配置好三个服务。

服务启动

service mysql start

/usr/local/app/tars/tars_install.sh

/usr/local/app/tars/tarspatch/util/init.sh

/usr/local/app/tars/tarsnode/bin/tarsnode --config=/usr/local/app/tars/tarsnode/conf/tarsnode.conf

/usr/local/resin/bin/resin.sh start

正常启动，将会看到如下进程：

[[email protected] data]# ps -ef|grep tars

root 5495 1 0 11:35 pts/0 00:00:03 /usr/local/app/tars/tarsregistry/bin/tarsregistry --config=/usr/local/app/tars/tarsregistry/conf/tarsregistry.conf

root 5504 1 0 11:35 pts/0 00:00:01 /usr/local/app/tars/tarsAdminRegistry/bin/tarsAdminRegistry --config=/usr/local/app/tars/tarsAdminRegistry/conf/adminregistry.conf

root 5514 1 0 11:35 pts/0 00:00:02 /usr/local/app/tars/tarsconfig/bin/tarsconfig --config=/usr/local/app/tars/tarsconfig/conf/tarsconfig.conf

root 5523 1 0 11:35 pts/0 00:00:01 /usr/local/app/tars/tarspatch/bin/tarspatch --config=/usr/local/app/tars/tarspatch/conf/tarspatch.conf

root 5610 1 0 11:35 ? 00:00:00 rsync --address=192.168.222.132 --daemon --config=/usr/local/app/tars/tarspatch/conf/rsync.conf

root 5621 1 2 11:35 ? 00:00:18 /usr/local/app/tars/tarsnode/bin/tarsnode --config=/usr/local/app/tars/tarsnode/conf/tarsnode.conf

root 6021 5621 0 11:36 ? 00:00:05 /usr/local/app/tars/tarsnode/data/tars.tarslog/bin/tarslog --config=/usr/local/app/tars/tarsnode/data/tars.tarslog/conf/tars.tarslog.config.conf

root 6022 5621 0 11:36 ? 00:00:05 /usr/local/app/tars/tarsnode/data/tars.tarsnotify/bin/tarsnotify --config=/usr/local/app/tars/tarsnode/data/tars.tarsnotify/conf/tars.tarsnotify.config.conf

root 6054 5621 0 11:36 ? 00:00:03 /usr/local/app/tars/tarsnode/data/tars.tarsqueryproperty/bin/tarsqueryproperty --config=/usr/local/app/tars/tarsnode/data/tars.tarsqueryproperty/conf/tars.tarsqueryproperty.config.conf

root 6108 5621 0 11:36 ? 00:00:03 /usr/local/app/tars/tarsnode/data/tars.tarsquerystat/bin/tarsquerystat --config=/usr/local/app/tars/tarsnode/data/tars.tarsquerystat/conf/tars.tarsquerystat.config.conf

root 6163 5621 0 11:37 ? 00:00:04 /usr/local/app/tars/tarsnode/data/tars.tarsstat/bin/tarsstat --config=/usr/local/app/tars/tarsnode/data/tars.tarsstat/conf/tars.tarsstat.config.conf

root 7097 5621 0 11:42 ? 00:00:01 /usr/local/app/tars/tarsnode/data/tars.tarsproperty/bin/tarsproperty --config=/usr/local/app/tars/tarsnode/data/tars.tarsproperty/conf/tars.tarsproperty.config.conf

安装基础服务

将安装文档中“4.1. 框架基础服务打包”相关基础包打包然后通过管理界面配置和上传发布

发布时需要在web管理的“运维管理模块”配置，具体参考“4.4. 安装框架普通基础服务”部分

其他

php语言相关 建议安装php7+swoole2

二、Tars使用相关

tars协议

tars协议采用接口描述语言(Interface description language，缩写IDL)来实现，它是一种二进制、可扩展、代码自动生成、支持多平台的协议，使得在不同平台上运行的对象和用不同语言编写的程序可以用PRC远程调用的方式相互通信交流， 主要应用在后台服务之间的网络传输协议，以及对象的序列化和反序列化等方面。

协议支持的类型分两种，基本类型和复杂类型。

基本类型包括：void、bool、byte、short、int、long、float、double、string、unsigned byte、unsigned short、unsigned int；

复杂类型包括：enum、const、struct、vector、map，以及struct、vector、map的嵌套。

开发和打包

不同语言在开发上存在差异，但基本思路一致：

编写tars文件xx.tars；

比如

module MTT

{

enum MYE1

{

EM_CAT,

EM_DOG,

};

struct A

{

0 require int b;

};

struct HelloWorld

{

0 require int nId;

1 require string sMsg;

2 require vector vNews;

///4 optional string sNew="client new";

5 require map mAddr;

6 require A a;

};

struct HelloPerson

{

0 require int nId;

1 require string sName;

2 optional vector vFavor;

3 optional MYE1 ePet;

///4 optional byte aPetAge[5];

5 optional map mAddr;

6 optional string sPhone;

7 optional bool bMan;

9 optional HelloWorld shello;

};

interface Hello

{

int testHello(string s,vector vsh,out string r);

int testPerson(HelloPerson stPersonIn,out HelloWorld stPersonOut);

};

};

利用tars官方转换工具根据tars文件内容生成客户端或服务端代码(在配置文件中指定生成客户端还是服务端，注意命名规范)；

完善代码逻辑(完形填空)；

打包代码；

通过web管理界面添加应用信息(与tars定义保持一致)并上传以上步骤最终的打包代码并发布。

代码打包文件上传位置/data/tars/patchs/tars.upload/

发布

代码打包同时会执行发布过程，还可以在服务管理列表中重启或关闭处理。

打包程序上传后，会放置在应用服务器的/usr/local/app/tars/tarsnode/data目录下，——应用名+服务名，服务名PHPTest，服务名PHPHttpServer则会将代码解压放置在PHPTest.PHPHttpServer目录下

每个完整的目录下会放置bin、conf、data文件夹，基本作用为：

bin目录——放置解压后的程序文件，tars同时自动生成对应的启动命令文件和关闭命令文件 tars_start.sh、tars_stop.sh (也可以跳过web管理界面直接使用此文件开启/关闭服务)

conf目录下，则存放此应用相关的服务模版配置文件——结合应用发布填写的配置项生成的最终配置文件；

data目录下放置服务的缓存信息文件，以及进程id文件等

日志查看

日志目录位置 /usr/local/app/tars/app_log/，在此目录下的应用名称目录下找到对应的日志文件，如 /usr/local/app/tars/app_log/PHPTest/PHPHttpServer/PHPTest.PHPHttpServer.log

服务打的日志路径在/usr/local/app/tars/app_log/服务的应用名/服务的服务名/目录下，例如:/usr/local/app/tars/app_log/Test/HelloServer/

服务的可执行文件在/usr/local/app/tars/tarsnode/data/服务的应用名.服务的服务名/bin/下,例如:/usr/local/app/tars/tarsnode/data/Test.HelloServer/bin/

服务的模版配置文件在/usr/local/app/tars/tarsnode/data/服务的应用名.服务的服务名/conf/下,例如:/usr/local/app/tars/tarsnode/data/Test.HelloServer/conf/

服务的缓存信息文件在/usr/local/app/tars/tarsnode/data/服务的应用名.服务的服务名/data/下,例如:/usr/local/app/tars/tarsnode/data/Test.HelloServer/data/

三、Tars PHP开发相关

PHP服务模版配置

每个Tars服务启动运行时，必须指定一个模版配置文件，在Tars web管理系统中部署的服务的模版配置由node进行组织生成，若不是在web管理系统上，则需要自己创建一个模版文件。具体https://github.com/Tencent/Tars/blob/master/docs/tars_template.md

对php开发，首先在web管理界面中->运维管理->模板管理，找到tars.tarsphp.default模板，根据实际php安装位置修改，如:

php=/usr/bin/php/bin/php

同时，将tars.tarsphp.default内容复制，新建tcp、http、timer版本的模板

相比较将tars.tarsphp.default,http模板，差异为：

http模板在server节点增加：

protocolName=http

type=http

TCP模板在server节点增加：

package_length_type=N

open_length_check=1

package_length_offset=0

package_body_offset=0

package_max_length=2000000

protocolName=tars

type=tcp

timer模板在server节点增加：

protocolName=http

type=http

isTimer=1

注：

父模板名均选择tars.default即可

文档中protocolName、type的说明缺失，实际使用中发现会报错，保险起见按照以上说明配置