Instalar gRPC para PHP

Objetivos

  • Instalar e ativar a extensão gRPC para PHP.

Requisitos

  • PHP 5.5 e posterior ou PHP 7.0 e posterior
  • PECL, a menos que você crie a partir da fonte
  • Composer

Instalar o PECL

Ubuntu / Debian

Para PHP5

sudo apt-get install php5-dev php-pear phpunit

Para PHP7

sudo apt-get install php7.0-dev php-pear phpunit

CentOS / RHEL 7

 sudo rpm -Uvh https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
 sudo rpm -Uvh https://mirror.webtatic.com/yum/el7/webtatic-release.rpm
 sudo yum install php56w-devel php-pear phpunit gcc zlib-devel

Mac

 curl -O http://pear.php.net/go-pear.phar
 sudo php -d detect_unicode=0 go-pear.phar

Instalar o Composer

Linux ou Mac

curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer

Instalar a extensão gRPC

Como usar o PECL

sudo pecl install grpc

Esse comando compila e instala a extensão PHP do gRPC no diretório de extensão padrão do PHP.

Criar a partir da fonte

Siga estas instruções para compilar a biblioteca central gRPC e a extensão PHP da fonte.

  1. Clone o repositório gRPC do GitHub.

    git clone -b $(curl -L http://grpc.io/release) https://github.com/grpc/grpc
    
  2. Crie e instale a biblioteca principal do gRPC C.

    cd grpc
    git pull --recurse-submodules && git submodule update --init --recursive
    make
    sudo make install
    
  3. Compile a extensão PHP do gRPC.

    cd src/php/ext/grpc
    phpize
    ./configure
    make
    sudo make install
    

Ativar a extensão gRPC em php.ini

Adicione esta linha ao arquivo php.ini, por exemplo, /etc/php5/cli/php.ini

extension=grpc.so

Adicionar gRPC como uma dependência do Composer

Peça o pacote grpc/grpc usando o Composer.

composer require "grpc/grpc:^v1.1.0"

Instalar a biblioteca de tempo de execução Protobuf

Há duas bibliotecas de tempo de execução Protobuf a escolher. Elas são idênticas em termos de APIs oferecidas. A implementação C oferece um melhor desempenho, já a implementação nativa é mais fácil de instalar.

Implementação C

Para um melhor desempenho com gRPC, instale a extensão protobuf.so usando o PECL.

sudo pecl install protobuf

Agora, adicione esta linha ao arquivo php.ini, por exemplo, /etc/php5/cli/php.ini

extension=protobuf.so

Implementação PHP

Para uma instalação mais fácil, basta solicitar o pacote google/protobuf usando o Composer.

composer require "google/protobuf:^v3.3.0"

Próximas etapas

Agora que o gRPC e a extensão gRPC PHP estão instalados, teste as APIs ativadas para gRPC, como o Cloud Spanner.

Esta página foi útil? Conte sua opinião sobre: