docs: add GRPC guide (#8290)

Author: bshaffer

GRPC.md

@@ -0,0 +1,196 @@
+# Install gRPC for PHP
+
+gRPC is a modern, open-source, high-performance remote procedure call framework.
+If you want to use PHP client libraries for gRPC-enabled APIs, you must install
+gRPC for PHP. This tutorial explains how to install and enable gRPC.
+
+## Objectives
+
+* Install the gRPC extension for PHP.
+* Enable the gRPC extension for PHP.
+
+## Requirements
+
+* PHP 7.0 or later
+* [PECL](https://pecl.php.net/) (unless you build from source)
+* [Composer](https://getcomposer.org/)
+
+Note: Windows users can
+[download and enable DLLs][pecl_grpc]
+from PECL.
+
+[pecl_grpc]: https://pecl.php.net/package/gRPC
+
+## Installing PECL
+
+### Ubuntu / Debian
+
+```
+sudo apt-get install autoconf zlib1g-dev php-dev php-pear
+```
+If using PHP 7.4+, PHP must have been installed with the `--with-pear` flag.
+
+### 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 does not require PECL.
+
+[pecl-grpc]: https://pecl.php.net/package/grpc
+
+## Installing the gRPC extension
+
+### Using PECL
+
+```
+sudo pecl install grpc
+```
+
+This compiles and installs the gRPC PHP extension into the standard PHP
+extension directory.
+
+**Note**: For users on CentOS/RHEL 6, unfortunately this step won't work. Follow
+the instructions under the **Build from source** tab to compile the
+extension from source.
+
+
+### Build from source
+
+Follow these instructions to compile the gRPC core library and PHP extension
+from source.
+
+1. Clone the gRPC repository from GitHub.
+
+        git clone https://github.com/grpc/grpc
+
+2. Build and install the gRPC C core library.
+
+    ```
+    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. Compile the gRPC PHP extension.
+    ```
+    cd src/php/ext/grpc
+    phpize
+    ./configure
+    make
+    sudo make install
+    ```
+
+#### Windows
+
+Windows users can download the pre-compiled gRPC directly from the
+[PECL website][pecl-grpc].
+
+Read the [PHP documentation for installing extensions](https://www.php.net/manual/en/install.pecl.windows.php) on Windows.
+
+
+[pecl-grpc]: https://pecl.php.net/package/grpc
+
+### Enable the gRPC extension in php.ini
+
+#### Linux / macOS
+
+Add this line anywhere in your `php.ini` file, for example, `/etc/php7/cli/php.ini`.
+You can find this file by running `php --ini`.
+
+```sh
+extension=grpc.so
+```
+
+
+#### Windows
+
+Add this line anywhere in your `php.ini` file, for example, `C:\Program Files\PHP\7.3\php.ini`.
+
+```sh
+extension=php_grpc.dll
+```
+
+
+### Add gRPC as a Composer dependency
+
+Use Composer to add the `grpc/grpc` package to your PHP project:
+
+```sh
+composer require "grpc/grpc:^1.38"
+```
+
+## Installing the protobuf runtime library
+
+You can choose from two protobuf runtime libraries. The APIs they offer are
+identical. The C implementation performs better than the PHP (native)
+implementation, while the native implementation installs easier than the
+C implementation.
+
+### C implementation
+
+For better performance with gRPC, enable the protobuf C-extension.
+
+**Linux / macOS**
+
+Install the `protobuf.so` extension by using PECL.
+
+```
+sudo pecl install protobuf
+```
+
+Now add this line to your `php.ini` file, for example,
+`/etc/php5/cli/php.ini`.
+
+```
+extension=protobuf.so
+```
+
+**Windows**
+
+Download the pre-compiled protobuf extension directly from the
+[PECL website][pecl-protobuf].
+
+Now add this line to your `php.ini` file, for example,
+`C:\Program Files\PHP\7.3\php.ini`.
+
+```
+extension=php_protobuf.dll
+```
+
+
+[pecl-protobuf]: https://pecl.php.net/package/protobuf
+
+### PHP implementation
+
+For easier installation, require the `google/protobuf` package by using
+Composer.
+
+```
+composer require "google/protobuf:^3.17"
+```
+
+
+## What's next
+
+Now that you've installed gRPC and the gRPC PHP extension, try out gRPC-enabled
+APIs such as
+[Google Cloud Spanner](https://cloud.google.com/php/docs/reference/cloud-spanner/latest).

dev/src/Command/DocFxCommand.php

@@ -55,6 +55,7 @@ class DocFxCommand extends Command
         'AUTHENTICATION.md' => 'Authentication',
         'DEBUG.md' => 'Debug Logging',
         'MIGRATING.md' => 'Migrating to V2',
+        'GRPC.md' => 'Installing gRPC',
     ];
 
     protected function configure()
@@ -94,7 +95,7 @@ protected function execute(InputInterface $input, OutputInterface $output)
             $output->writeln('Generating <options=bold;fg=white>product neutral guides</>');
             $tocItems = [];
             foreach (self::$productNeutralGuides as $file => $name) {
-                $href = $file === 'README.md' ? 'getting-started.md' : strtolower($file);
+                $href = $file === 'README.md' ? 'getting-started.md' : strtolower(basename($file));
                 file_put_contents(
                     $outDir . '/' . $href,
                     file_get_contents(Component::ROOT_DIR . '/' . $file)