安装适用于 PHP 的 gRPC

gRPC 是一种高性能的现代开源远程过程调用框架。 如果要将 PHP 客户端库用于已启用 gRPC 的 API,则必须安装适用于 PHP 的 gRPC。本教程介绍如何安装和启用 gRPC。

目标

  • 安装适用于 PHP 的 gRPC 扩展程序。
  • 启用适用于 PHP的 gRPC 扩展程序。

要求

  • PHP 7.0 或更高版本
  • PECL(除非从源代码构建)
  • Composer

安装 PECL

Ubuntu/Debian

sudo apt-get install autoconf zlib1g-dev php-dev php-pear

如果使用的是 PHP 7.4 或更高版本,则必须使用 --with-pear 标记安装 PHP。

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 php-devel php-pear gcc zlib-devel

macOS

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

Windows

Windows 不需要 PECL。

安装 Composer

Linux

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

macOS

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

Windows

按照适用于 Windows 的官方 Composer 安装说明进行操作。

安装 gRPC 扩展程序

使用 PECL

sudo pecl install grpc

这会将 gRPC PHP 扩展程序编译并安装到标准的 PHP 扩展程序目录中。

从源代码构建

按照这些说明从源代码编译 gRPC 核心库和 PHP 扩展程序。

  1. 从 GitHub 克隆 gRPC 代码库。

    git clone --depth=1 -b $(curl -L https://grpc.io/release) \
      https://github.com/grpc/grpc
    
  2. 构建并安装 gRPC C 核心库。

    cd grpc
    git submodule update --init
    make
    sudo make install
    
    It can take a few minutes to download and execute the library.
    If you have git version 1.8.4 or greater, you can speed up
    the `git submodule update --init` command by adding the `--depth=1`
    flag.
    
  3. 编译 gRPC PHP 扩展程序。

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

Windows

Windows 用户可以直接从 PECL 网站下载预编译的 gRPC。

阅读关于在 Windows 上安装扩展程序的 PHP 文档

在 php.ini 中启用 gRPC 扩展程序

Linux/macOS

将此行添加到 php.ini 文件中的任意位置,例如 /etc/php7/cli/php.ini。 您可以通过运行 php --ini 找到此文件。

extension=grpc.so

Windows

将此行添加到 php.ini 文件中的任意位置,例如 C:\Program Files\PHP\7.3\php.ini

extension=php_grpc.dll

将 gRPC 添加为 Composer 依赖项

使用 Composer 将 grpc/grpc 软件包添加到 PHP 项目中:

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

安装 protobuf 运行时库

您可以从两个 protobuf 运行时库中进行选择。它们提供的 API 是相同的。C 实现可提供比 PHP(原生)实现更高的性能,而原生实现比 C 实现更易于安装。

C 实现

为了使 gRPC 实现更好的性能,请求拍卖行 protobuf C 扩展程序。

Linux/macOS

使用 PECL 安装 protobuf.so 扩展程序。

sudo pecl install protobuf

接下来,将这行内容添加到您的 php.ini 文件(例如 /etc/php5/cli/php.ini)中。

extension=protobuf.so

Windows

直接从 PECL 网站下载预编译的 protobuf 扩展程序。

接下来,将这行内容添加到您的 php.ini 文件(例如 C:\Program Files\PHP\7.3\php.ini)中。

extension=php_protobuf.dll

PHP 实现

为了便于安装,使用 Composer 对 google/protobuf 软件包执行 require 命令。

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

后续步骤

现在您已安装 gRPC 和 gRPC PHP 扩展程序,请试用启用了 gRPC 的 API,例如 Cloud Spanner