brpc最新安装上手指南

笔者曾发表过一篇介绍RPC的文章：

[]

文末有网友评论“RPC的话，brpc应该有一席之地”。没错，当然要有，只是那篇文章原文是2017年发表的，当时brpc还未开源。后于同年百度对外开源了brpc。在百度内部brpc叫baidu-rpc。后来由于进入了Apache基金会进行孵化，brpc的含义做了调整，改成了better RPC。这倒也无伤大雅，众所周知，百度和腾讯是国内鲜有的C++大厂，而brpc也算是笔者见过C++开源世界里比较优秀且实用的框架了。

好了，关于brpc的溢美之词暂且按下不表，我们言归正传，赶快上手吧！另外brpc支持Mac和Linux环境。本文是基于某云的Centos实机操作纪实！brpc的版本是0.9.7。

github

brpc的github地址如下：

https://github.com/apache/incubator-brpc

我们也可以直接在本地克隆：

git clone https://github.com/apache/incubator-brpc.git

安装编译依赖

cmake

我习惯用cmake编译一些第三方库，这里我们安装一下cmake。云主机默认安装的cmake可能是cmake 2的版本。但由于brpc其中一个依赖gflags需要cmake3，所以我们先安装一下cmake3：

yum install cmake3

第三方库

• gflags
• leveldb
• protobuf (2或3均可)
• openssl

上面是brpc编译所依赖的几个第三方库，基本上在github上都能找到。除openssl外都支持cmake编译。

• https://github.com/gflags/gflags
• https://github.com/google/leveldb
• https://github.com/protocolbuffers/protobuf
• https://github.com/openssl/openssl

其中gflags、leveldb默认cmake的编译方式会编译成静态库，导致最终编译brpc时会报错：

/usr/local/lib/libgflags.a(gflags.cc.o): relocation R_X86_64_32S against `.rodata' can not be used

所以请注意我们需要把gflags、leveldb都编译成动态库。在下载完源码后，cd到对应目录，执行如下操作：

mkdir bld
cd bld
cmake3 -DBUILD_SHARED_LIBS=ON ..
make -j 8
sudo make install

也就是给cmake加上一个-DBUILD_SHARED_LIBS=ON参数。gflags、leveldb可以安装上述流程来编译。

另外关于openssl和protobuf，参照编译文档编译即可。没有什么坑点。

唯一需要提醒的是，如果是autotool编译安装的方式（要执行./configure的），最好不要自作聪明加--prefix参数来修改默认的库安装路径。因为如果安装到自定义路径下，后续其他编译如果依赖到这个库，都需要修改编译时的库检索路径，简直自找麻烦！

编译brpc

好了，准备工作做完，终于要编译brpc了。cd到brpc的下载目录中。

mkdir bld
cd bld
cmake3 ..
make
make install

这里我make的时候没加j8参数来开启并行编译。因为我机器上实测并行编译会编译失败，串行编译无问题。当然缺点就是编译比较慢了。我建议是在云主机上开一个tmux，在tmux会话里开始make，然后你就可以忙别的去了。

漫长等待之后，最终会编译成功。

编译example

brpc编译完成，基本上你就可以使用了。但是brpc自带的例子没有编译。我们可以编译一下，启动看看。在example目录下面。

需要提醒的是example的代码用cmake编译，可能会失败（反正我是遇到了）。没关系，我们改成普通make编译的方式。

首先要先生成config.mk，回到brpc的顶级目录:

sh config_brpc.sh --headers=/usr/local/include  --libs=/usr/local/lib

headers和libs指定第三方库的头文件和库所在路径。这也就是我为什么说不要随意修改库的安装路径的原因了，库装在不同位置着实不便。尽量集中到一起，不在一起的时候，可以通过建立软连接，弄到一起。

生成config.mk之后，就可以去example目录编译了，比如我们编译echo_c++。

cd example/echo_c++
make

运行echo_c++

上面编译完成之后会有echo_server和echo_client的可执行文件。

我们启动server：

nohup ./echo_server &

echo_client 其实我一般不用。echo_client是默认的baidu_std协议。实际工作中多有使用，但作为demo测试，其实不用。因为brpc有个强大的特性是支持单端口多协议，并且号称支持协议最多的RPC框架。所以我们可以用HTTP请求的方式来请求它！

curl -d '{"message":"hello world"}' 127.0.0.1:8000/EchoService/Echo

端口号后面的路径和proto定义有关。查看echo.proto的定义：

service EchoService {
      rpc Echo(EchoRequest) returns (EchoResponse);
};

好了。后面我们就可以通过调试修改这个echo_server来学习了解brpc啦。