feat(servicedirectory): add samples for Service Directory (GoogleCloudPlatform#1127)

Author: makk94

servicedirectory/README.md

@@ -0,0 +1,68 @@
+# Google Service Directory PHP Sample Application
+
+[![Open in Cloud Shell][shell_img]][shell_link]
+
+[shell_img]: http://gstatic.com/cloudssh/images/open-btn.svg
+[shell_link]: https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googlecloudplatform/php-docs-samples&page=editor&working_dir=servicedirectory
+
+## Description
+
+This simple command-line application demonstrates how to invoke the
+[Google Service Directory API][servicedirectory-api] from PHP.
+
+[servicedirectory-api]: https://cloud.google.com/service-directory/
+
+## Build and Run
+1.  **Enable APIs** - [Enable the Service Directory API](
+    https://console.cloud.google.com/flows/enableapi?apiid=servicedirectory.googleapis.com)
+    and create a new project or select an existing project.
+2.  **Download The Credentials** - Click "Go to credentials" after enabling the APIs. Click
+    "New Credentials"
+    and select "Service Account Key". Create a new service account, use the JSON key type, and
+    select "Create". Once downloaded, set the environment variable `GOOGLE_APPLICATION_CREDENTIALS`
+    to the path of the JSON key that was downloaded.
+3.  **Clone the repo** and cd into this directory
+```
+    $ git clone https://github.com/GoogleCloudPlatform/php-docs-samples
+    $ cd php-docs-samples/servicedirectory
+```
+4.  **Install dependencies** via [Composer](http://getcomposer.org/doc/00-intro.md).
+    Run `php composer.phar install` (if composer is installed locally) or `composer install`
+    (if composer is installed globally).
+5.  Execute the snippets in the [src/](src/) directory by running
+    `php src/SNIPPET_NAME.php`. The usage will print for each if no arguments
+    are provided:
+    ```sh
+    $ php src/quickstart.php
+    Usage: php src/quickstart.php PROJECT_ID STRING
+
+    $ php src/quickstart.php your-project-id us-east1
+    Namespaces: projects/you-project-id/locations/us-east1/namespaces/your-namespace
+    ```
+
+See the [Service Directory Documentation](https://cloud.google.com/service-directory/docs/) for more information.
+
+## Troubleshooting
+
+### bcmath extension missing
+
+If you see an error like this:
+
+```
+PHP Fatal error:  Uncaught Error: Call to undefined function Google\Protobuf\Internal\bccomp() in /usr/local/google/home/crwilson/github/GoogleCloudPlatform/php-docs-samples/dlp/vendor/google/protobuf/src/Google/Protobuf/Internal/Message.php:986
+```
+
+You may need to install the bcmath PHP extension.
+e.g. (may depend on your php version)
+```
+$ sudo apt-get install php7.3-bcmath
+```
+
+
+## Contributing changes
+
+* See [CONTRIBUTING.md](../CONTRIBUTING.md)
+
+## Licensing
+
+* See [LICENSE](../LICENSE)

servicedirectory/composer.json

@@ -0,0 +1,5 @@
+{
+    "require": {
+        "google/cloud-service-directory": "^0.1.3"
+    }
+}

servicedirectory/phpunit.xml.dist

@@ -0,0 +1,35 @@
+xml version="1.0" encoding="UTF-8"?>
+
+<phpunit bootstrap="../testing/bootstrap.php"
+  convertNoticesToExceptions="false">
+    <testsuites>
+        <testsuite name="PHP Service Directory test">
+            <directory>testdirectory>
+        testsuite>
+    testsuites>
+    <logging>
+        <log type="coverage-clover" target="build/logs/clover.xml"/>
+    logging>
+    <filter>
+        <whitelist>
+            <directory suffix=".php">./srcdirectory>
+            <exclude>
+              <directory>./vendordirectory>
+            exclude>
+        whitelist>
+    filter>
+phpunit>

servicedirectory/src/create_endpoint.php

@@ -0,0 +1,58 @@
+
+
+/**
+ * Copyright 2020 Google Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+// Include Google Cloud dependendencies using Composer
+require_once __DIR__ . '/../vendor/autoload.php';
+
+if ($argc < 6 || $argc > 8) {
+    return printf("Usage: php %s PROJECT_ID LOCATION_ID NAMESPACE_ID SERVICE_ID ENDPOINT_ID [IP] [PORT]\n", basename(__FILE__));
+}
+list($_, $projectId, $locationId, $namespaceId, $serviceId, $endpointId) = $argv;
+$ip = isset($argv[6]) ? $argv[6] : '';
+$port = isset($argv[7]) ? (int) $argv[7] : 0;
+
+// [START servicedirectory_create_endpoint]
+use Google\Cloud\ServiceDirectory\V1beta1\RegistrationServiceClient;
+use Google\Cloud\ServiceDirectory\V1beta1\Endpoint;
+
+/** Uncomment and populate these variables in your code */
+// $projectId = '[YOUR_PROJECT_ID]';
+// $locationId = '[YOUR_GCP_REGION]';
+// $namespaceId = '[YOUR_NAMESPACE_NAME]';
+// $serviceId = '[YOUR_SERVICE_NAME]';
+// $endpointId = '[YOUR_ENDPOINT_NAME]';
+// $ip = '[IP_ADDRESS]';  // (Optional) Defaults to ''
+// $port = [PORT];  // (Optional) Defaults to 0
+
+// Instantiate a client.
+$client = new RegistrationServiceClient();
+
+// Construct Endpoint object.
+$endpointObject = (new Endpoint())
+    ->setAddress($ip)
+    ->setPort($port);
+
+// Run request.
+$serviceName = RegistrationServiceClient::serviceName($projectId, $locationId, $namespaceId, $serviceId);
+$endpoint = $client->createEndpoint($serviceName, $endpointId, $endpointObject);
+
+// Print results.
+printf('Created Endpoint: %s' . PHP_EOL, $endpoint->getName());
+printf('  IP: %s' . PHP_EOL, $endpoint->getAddress());
+printf('  Port: %d' . PHP_EOL, $endpoint->getPort());
+// [END servicedirectory_create_endpoint]

servicedirectory/src/create_namespace.php

@@ -0,0 +1,45 @@
+
+
+/**
+ * Copyright 2020 Google Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+// Include Google Cloud dependendencies using Composer
+require_once __DIR__ . '/../vendor/autoload.php';
+
+if ($argc != 4) {
+    return printf("Usage: php %s PROJECT_ID LOCATION_ID NAMESPACE_ID\n", basename(__FILE__));
+}
+list($_, $projectId, $locationId, $namespaceId) = $argv;
+
+// [START servicedirectory_create_namespace]
+use Google\Cloud\ServiceDirectory\V1beta1\RegistrationServiceClient;
+use Google\Cloud\ServiceDirectory\V1beta1\PBNamespace;
+
+/** Uncomment and populate these variables in your code */
+// $projectId = '[YOUR_PROJECT_ID]';
+// $locationId = '[YOUR_GCP_REGION]';
+// $namespaceId = '[YOUR_NAMESPACE_NAME]';
+
+// Instantiate a client.
+$client = new RegistrationServiceClient();
+
+// Run request.
+$locationName = RegistrationServiceClient::locationName($projectId, $locationId);
+$namespace = $client->createNamespace($locationName, $namespaceId, new PBNamespace());
+
+// Print results.
+printf('Created Namespace: %s' . PHP_EOL, $namespace->getName());
+// [END servicedirectory_create_namespace]

servicedirectory/src/create_service.php

@@ -0,0 +1,46 @@
+
+
+/**
+ * Copyright 2020 Google Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+// Include Google Cloud dependendencies using Composer
+require_once __DIR__ . '/../vendor/autoload.php';
+
+if ($argc != 5) {
+    return printf("Usage: php %s PROJECT_ID LOCATION_ID NAMESPACE_ID SERVICE_ID\n", basename(__FILE__));
+}
+list($_, $projectId, $locationId, $namespaceId, $serviceId) = $argv;
+
+// [START servicedirectory_create_service]
+use Google\Cloud\ServiceDirectory\V1beta1\RegistrationServiceClient;
+use Google\Cloud\ServiceDirectory\V1beta1\Service;
+
+/** Uncomment and populate these variables in your code */
+// $projectId = '[YOUR_PROJECT_ID]';
+// $locationId = '[YOUR_GCP_REGION]';
+// $namespaceId = '[YOUR_NAMESPACE_NAME]';
+// $serviceId = '[YOUR_SERVICE_NAME]';
+
+// Instantiate a client.
+$client = new RegistrationServiceClient();
+
+// Run request.
+$namespaceName = RegistrationServiceClient::namespaceName($projectId, $locationId, $namespaceId);
+$service = $client->createService($namespaceName, $serviceId, new Service());
+
+// Print results.
+printf('Created Service: %s' . PHP_EOL, $service->getName());
+// [END servicedirectory_create_service]

servicedirectory/src/delete_endpoint.php

@@ -0,0 +1,47 @@
+
+
+/**
+ * Copyright 2020 Google Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+// Include Google Cloud dependendencies using Composer
+require_once __DIR__ . '/../vendor/autoload.php';
+
+if ($argc != 6) {
+    return printf("Usage: php %s PROJECT_ID LOCATION_ID NAMESPACE_ID SERVICE_ID ENDPOINT_ID\n", basename(__FILE__));
+}
+list($_, $projectId, $locationId, $namespaceId, $serviceId, $endpointId) = $argv;
+
+// [START servicedirectory_delete_endpoint]
+use Google\Cloud\ServiceDirectory\V1beta1\RegistrationServiceClient;
+
+/** Uncomment and populate these variables in your code */
+// $projectId = '[YOUR_PROJECT_ID]';
+// $locationId = '[YOUR_GCP_REGION]';
+// $namespaceId = '[YOUR_NAMESPACE_NAME]';
+// $serviceId = '[YOUR_SERVICE_NAME]';
+// $endpointId = '[YOUR_ENDPOINT_NAME]';
+
+// Instantiate a client.
+$client = new RegistrationServiceClient();
+
+
+// Run request.
+$endpointName = RegistrationServiceClient::endpointName($projectId, $locationId, $namespaceId, $serviceId, $endpointId);
+$endpoint = $client->deleteEndpoint($endpointName);
+
+// Print results.
+printf('Deleted Endpoint: %s' . PHP_EOL, $endpointName);
+// [END servicedirectory_delete_endpoint]

servicedirectory/src/delete_namespace.php

@@ -0,0 +1,44 @@
+
+
+/**
+ * Copyright 2020 Google Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+// Include Google Cloud dependendencies using Composer
+require_once __DIR__ . '/../vendor/autoload.php';
+
+if ($argc != 4) {
+    return printf("Usage: php %s PROJECT_ID LOCATION_ID NAMESPACE_ID\n", basename(__FILE__));
+}
+list($_, $projectId, $locationId, $namespaceId) = $argv;
+
+// [START servicedirectory_delete_namespace]
+use Google\Cloud\ServiceDirectory\V1beta1\RegistrationServiceClient;
+
+/** Uncomment and populate these variables in your code */
+// $projectId = '[YOUR_PROJECT_ID]';
+// $locationId = '[YOUR_GCP_REGION]';
+// $namespaceId = '[YOUR_NAMESPACE_NAME]';
+
+// Instantiate a client.
+$client = new RegistrationServiceClient();
+
+// Run request.
+$namespaceName = RegistrationServiceClient::namespaceName($projectId, $locationId, $namespaceId);
+$client->deleteNamespace($namespaceName);
+
+// Print results.
+printf('Deleted Namespace: %s' . PHP_EOL, $namespaceName);
+// [END servicedirectory_delete_namespace]