tars2php说明文档

简介

tars2php主要功能是通过tars协议文件,自动生成client端和server端php代码,方便大家使用。(server端主要为框架代码,实际业务逻辑需要自己补充实现)

使用说明

如果用户只有使用打包解包需求的,那么使用流程如下: 1. 准备一份tars协议文件,例如example.tars 2. 编写一个tars.proto.php文件,这是用来生成代码的配置文件。

    //本范例的servant name为PHPTest.PHPServer.obj    
    return array(    
        'appName' => 'PHPTest', //tars服务servant name 的第一部分    
        'serverName' => 'PHPServer', //tars服务servant name 的第二部分    
        'objName' => 'obj', //tars服务servant name 的第三部分    
        'withServant' => true,//决定是服务端,还是客户端的自动生成    
        'tarsFiles' => array(    
            './example.tars' //tars文件的地址    
        ),    
        'dstPath' => './server/', //生成php文件的位置    
        'namespacePrefix' => 'Server\servant', //生成php文件的命名空间前缀 );
  1. 执行 php ./tars2php.php ./tars.proto.php

  2. 工具会根据servant name自动生成三级目录结构,demo中会在./server目录下生成PHPTest/PHPServer/obj/目录,obj目录下的classers是struct对应的php对象,tars目录是tars协议文件本身。 如example.tars中的struct:

     struct SimpleStruct {    
         0 require long id=0;    
         1 require unsigned int count=0;    
         2 require short page=0;    
     };

    转变成classes/SimpleStruct.php

     <?php    
    
     namespace Server\servant\PHPTest\PHPServer\obj\classes;    
    
     class SimpleStruct extends \TARS_Struct {    
        const ID = 0; //tars协议中的tag    
        const COUNT = 1;    
        const PAGE = 2;    
    
        public $id; //元素的实际值    
        public $count;     
        public $page;     
    
        protected static $_fields = array(    
           self::ID => array(    
              'name'=>'id', //tars协议中没个元素的name    
              'required'=>true, //tars协议中是require或者optional    
              'type'=>\TARS::INT64, //类型    
              ),    
           self::COUNT => array(    
              'name'=>'count',    
              'required'=>true,    
              'type'=>\TARS::UINT32,    
              ),    
           self::PAGE => array(    
              'name'=>'page',    
              'required'=>true,    
              'type'=>\TARS::SHORT,    
              ),    
        );    
    
        public function __construct() {    
           parent::__construct('PHPTest_PHPServer_obj_SimpleStruct', self::$_fields);    
        }    
     }
  3. 以example.tars中的interface部分会自动生成单独的已interface命名的php文件。 例如int testLofofTags(LotofTags tags, out LotofTags outtags);接口生成的方法如下

    • server部分

      <?php  
        //注意生成文件中的注释部分会在server启动的时候转换为php代码,如非必要,请勿修改.    
        //server部分具体实现需要自己继承完成,注释说明依次如下    
        //参数为struct类型,对应$tags变量,对应的php对象在\Server\servant\PHPTest\PHPServer\obj\classes\LotofTags    
        //参数为struct类型,对应$outtags变量,对应的php对象在\Server\servant\PHPTest\PHPServer\obj\classes\LotofTags,是输出参数    
        //接口防止为int    
       /**    
        * @param struct $tags \Server\servant\PHPTest\PHPServer\obj\classes\LotofTags    
        * @param struct $outtags \Server\servant\PHPTest\PHPServer\obj\classes\LotofTags =out=    
        * @return int     
        */    
       public function testLofofTags(LotofTags $tags,LotofTags &$outtags);
    • client部分

      <?php  
       try {    
          $requestPacket = new RequestPacket(); //构建请求包需要的参数    
          $requestPacket->_iVersion = $this->_iVersion;    
          $requestPacket->_funcName = __FUNCTION__;    
          $requestPacket->_servantName = $this->_servantName;    
      
          $encodeBufs = [];    
      
          $__buffer = TUPAPIWrapper::putStruct("tags",1,$tags,$this->_iVersion); //打包第一个参数tags    
          $encodeBufs['tags'] = $__buffer;    
      
          $requestPacket->_encodeBufs = $encodeBufs; //在请求包中设置请求bufs    
      
          $sBuffer = $this->_communicator->invoke($requestPacket,$this->_iTimeout); //发送请求包,接收返回包    
      
          $ret = TUPAPIWrapper::getStruct("outtags",2,$outtags,$sBuffer,$this->_iVersion); //从返回包中解出第一个输出参数outtags    
          return TUPAPIWrapper::getInt32("",0,$sBuffer,$this->_iVersion); //解出返回参数 返回参数 name是空,tag为0    
      
       }    
       catch (\Exception $e) {    
          throw $e;    
       }

Last updated