php使用grpc简单教程

GRPC PHP客户端实现教程

依赖工具

本demo要实现的是通过php-fpm(非cli)调用grpc与远程服务进行交互。

- nginx 1.8.0+
- gcc 4.8+
- php5.6+
- grpc c library
- protoc
- php grpc extension

grpc使用方法

1. 使用命令: 使用下面这个命令生成客户端存根stub

   $ protoc --proto_path=./ --plugin=protoc-gen-grpc=/usr/local/grpc/bins/opt/grpc_php_plugin --php_out=./ --grpc_out=./ user.proto 

   • protoc: protoc编译器可执行文件的地址
   • –plugin: protoc-gen-grpc可执行文件的地址,该可执行文件在安装c library时会默认生成，位置是:/usr/local/grpc/bins/opt/grpc_php_plugin
   • –php_out: 指定类和文件生成
   • user.proto 自定义的protoc协议文件

2. 使用composer安装插件

   $ vim composer.json
   
   { 
       "name": "grpc/grpc-dev", 
       "description": "gRPC library for PHP - for Developement use only", 
       "license": "BSD-3-Clause", 
       "version": "1.4.3", 
       "require": { 
           "php": ">=5.5.0", 
           "google/protobuf": "^v3.3.0" 
       }, 
       "require-dev": { 
           "google/auth": "v0.9" 
       }, 
       "autoload": { 
           "psr-4": { 
               "Grpc\\": "lib/Grpc/", 
               "GPBMetadata\\": "GPBMetadata/",
               "Ytzb\\Ytb\\Proto\\User\\": "Ytzb/Ytb/Proto/User/" //自动加载命令空间下的类
           } 
       } 
   }
   :wq
   $ curl -sS https://getcomposer.org/installer | sudo php 
   $ php composer.phar install
   

3. 代码中require autoload.php即可使用

工具安装(方法1)

1. 安装gcc 4.8

   $ cd /tmp 
   $ wget http://gcc.skazkaforyou.com/releases/gcc-4.8.2/gcc-4.8.2.tar.gz 
   $ tar -zxvf gcc-4.8.2.tar.gz 
   $ cd gcc-4.8.2 
   $ ./contrib/download_prerequisities 
   $ ./configure --prefix=/usr --enable-threads=posix --disable-checking --enable-languages=c,c++ --disable-multilib 
   $ make -j8 && sudo make install 
   $ ln -s 将可执行文件链接或拷贝到/usr/local/bin和/usr/bin目录下   

   • 检查安装是否成功: 安装位置的gcc -v, g++ -v
   • 安装参考：参考一、参考二

2. grpc c library安装

   $ cd /usr/local
   $ git clone -b $(curl -L https://grpc.io/release) https://github.com/grpc/grpc
   $ cd /usr/local/grpc 
   $ git pull --recurse-submodules && git submodule update --init --recursive 
   $ make -j8 
   $ sudo make install 

   注:
   以上git命令需要git版本>=1.7.3,centOS yum安装的git低于该版本，如果服务器上未安装高版本git，请根据以下命令进行编译安装:

   $ yum install curl-devel expat-devel gettext-devel openssl-devel zlib-devel asciidoc 
   $ yum install gcc perl-ExtUtils-MakeMaker 
   $ yum remove git (如果之前有默认安装了git，请移除) 
   $ cd /tmp/ 
   $ wget https://www.kernel.org/pub/software/scm/git/git-2.1.2.tar.gz 
   $ tar -zxvf git-2.1.2.tar.gz 
   $ cd git-2.1.2 
   $ make -j8 configure 
   $ ./configure --prefix=/usr/local/git --with-iconv=/usr/local/libiconv 
   $ make -j8 all doc 
   $ sudo make install install-doc install-html 

   检查是否安装成功:

   /usr/local/git/bin/git --version 

   安装成功后，将git可执行文件copy或者软链到 /usr/bin /usr/local/bin 两个目录下
   如果安装过程中提示libiconv不存在，请先安装libiconv,然后再make clean, make && sudo make install:

   $ cd /tmp 
   $ wget http://ftp.gnu.org/pub/gnu/libiconv/libiconv-1.14.tar.gz 
   $ tar -zxvf libiconv-1.14.tar.gz 
   $ cd libiconv-1.14 
   $ ./configure --prefix=/usr/local/libiconv 
   $ make -j8 && sudo make install 

3. php grpc extension安装

   grpc依赖的c library安装完成后，安装php grpc扩展

   $ cd /usr/local/grpc/src/php/ext/grpc 
   $ phpize (若提示命令不存在，请全路径执行,即/usr/local/php/bin/phpize，取决于服务器php的安装路径) 
   $ ./configure --with-php-config=/usr/local/php/bin/php-config (php-config路径) 
   $ make -j8
   $ sudo make install 
   $ vim php.ini 加入extension=grpc.so 

   • 检测php grpc扩展是否安装成功 php –ri grpc 或者 php -m | grep grpc
   • php-fpm要使用grpc请重启nginx和php-fpm
   • 注： 命令行执行php文件提示Warning: insecure environment read function getenv used,请修改c文件/tmp/grpc/src/core/lib/support/env_linux.c
     注释掉相关的gpr_log，然后重新进入grpc目录更新c library，即make clean然后make && sudo make install

4. protoc 编译器安装

   $ cd /tmp 
   $ wget https://github.com/google/protobuf/releases/download/v3.2.0/protobuf-php-3.2.0.tar.gz 
   $ tar -zxvf protobuf-php-3.2.0.tar.gz 
   $ cd protobuf-php-3.2.0 
   $ ./configure --prefix=/usr/local/protobuf 
   $ make -j8
   $ sudo make install 

   • 检测是否安装成功, /usr/local/protobuf/bin/protoc –version
   • 安装成功后，请将protoc可执行文件copy或者软链到/usr/local/bin和/usr/bin目录下

5. 所有预装软件安装升级完成后，删除源码(可选)

   rm -rf /tmp/gcc-4.8.2* 
   rm -rf /tmp/git-2.1.2* 
   rm -rf /tmp/libiconv-1.14* 
   rm -rf /tmp/protobuf-php-3.2.0* 

6. 安装升级过程中可能出现的问题

   • /lib64/libstdc++.so.x: version: `GLIBCXX_X.X.XX’ not found
     提示你cmake时libstdc++.so.x中缺少GLIBCXX_X.X.XX或更高版本
     解决办法: (这libstdc++.so.x中的x根据是数字)

     1. 先确保所有旧版本gcc、cc、g++已被全部替换,再重新执行编译安装，如果仍然提示该错误，请执行2解决
     2. 核实该文件中都有哪些版本,可以看出确实缺少了该版本
        

        strings /usr/lib64/libstdc++.so.x | grep GLIBCXX 

     查找新安装的gcc路径下是否有包含GLIBCXX_X.X.XX(gcc 4.8中肯定会包含的)

     strings /usr/local/lib64/libstdc++.so.x | grep GLIBCXX 

     看到该文件里确实包含了该版本，那么把这份文件软链到提示缺失的位置(包含新版本的该份文件可能与原文件不同名)

     cd /usr/lib64 
     mv libstdc++.so.x libstdc++.so.x.old 
     cp /usr/local/lib64/libstdc++.so.x.xx(新文件) /usr/lib64/ 
     ln -s libstdc++.so.x.xx(新文件) libstdc++.so.x

   • 安装各个软件过程中，如提示其他错误，缺失则安装，其他则请google或baidu解决。

工具安装(方法2)

1. 一次性安装所有依赖包:

   $ yum install cmake sqlite-devel bzip2-devel libcurl-devel enchant-devel gmp-devel libicu-devel openldap-devel mysql-devel unixODBC-devel aspell-devel libedit-devel recode-devel net-snmp-devel libtidy-devel libxml2-devel pcre-devel libjpeg-devel libpng-devel libXpm-devel freetype-devel libxslt-devel gcc-c++ -y

2. 安装PHP5.6(可选,如果服务器上还未装的话)

   下载地址: http://php.net/downloads.php

   $ wget http://php.net/downloads.php(对应版本的地址)
   $ ln -s /usr/lib64/mysql/libmysqlclient.so.16.0.0 /usr/lib/libmysqlclient.so(可选，软链一下mysql库)
   $ './configure' '--prefix=/usr/local/php' '--with-libxml-dir=/usr/lib' '--with-gd' '--with-zlib' '--with-mysql=/usr' '--enable-sockets' '--enable-mbstring' '--enable-safe-mode' '--enable-ftp' '--with-png' '--with-freetype-dir=/usr' '--with-jpeg' '--with-sqlite=shared' '--with-openssl'
   $ make -j8
   $ sudo make install
   $ vim /usr/local/php/bin 添加PATH环境变量

3. 直接升级GCC到4.8

   $ wget -O /etc/yum.repos.d/slc6-devtoolset.repo http://linuxsoft.cern.ch/cern/devtoolset/slc6-devtoolset.repo
   $ yum install --nogpgcheck devtoolset-2
   $ scl enable devtoolset-2 bash

4. 安装grpc c library

   $ git clone --recursive -b v1.3.x https://github.com/grpc/grpc
   $ cd grpc
   $ make -j8
   $ make install

5. php extension 安装

   $ cd /usr/local/grpc/src/php/ext/grpc
   $ phpize
   $ ./configure
   $ make -j8
   $ make install

   在php.ini中加入: extension=grpc.so

参考文献

• https://github.com/grpc/grpc/tree/master/src/php#generated-code-tests
• http://www.grpc.io/docs/quickstart/php.html
• http://www.grpc.io/docs/tutorials/basic/php.html
• http://www.grpc.io/
• https://gist.github.com/stephenturner/e3bc5cfacc2dc67eca8b
• https://github.com/grpc/grpc/tree/master/src/php
• https://github.com/grpc/grpc/blob/master/src/core/lib/support/env_linux.c
• http://doc.oschina.net/grpc?t=58008#quickstart
• http://www.jianshu.com/p/fa126a8535a0
• http://blog.csdn.net/u012580566/article/details/53515938
• http://blog.csdn.net/zimiao815/article/details/51242814