[Storage] Add bucket_metadata sample (GoogleCloudPlatform#937)

Author: frankyn

storage/composer.json

@@ -29,6 +29,7 @@
             "src/enable_default_kms_key.php",
             "src/enable_requester_pays.php",
             "src/generate_encryption_key.php",
+            "src/bucket_metadata.php",
             "src/get_bucket_acl.php",
             "src/get_bucket_acl_for_entity.php",
             "src/get_bucket_default_acl.php",

storage/src/bucket_metadata.php

@@ -0,0 +1,44 @@
+
+/**
+ * Copyright 2019 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.
+ */
+
+/**
+ * For instructions on how to run the full sample:
+ *
+ * @see https://github.com/GoogleCloudPlatform/php-docs-samples/tree/master/storage/README.md
+ */
+
+namespace Google\Cloud\Samples\Storage;
+
+# [START storage_get_bucket_metadata]
+use Google\Cloud\Storage\StorageClient;
+
+/**
+ * Get bucket metadata.
+ *
+ * @param string $bucketName the name of your Cloud Storage bucket.
+ *
+ * @return void
+ */
+function get_bucket_metadata($bucketName)
+{
+    $storage = new StorageClient();
+    $bucket = $storage->bucket($bucketName);
+    $info = $bucket->info();
+
+    printf("Bucket Metadata: %s" . PHP_EOL, print_r($info));
+}
+# [END storage_get_bucket_metadata]

storage/storage.php

@@ -125,7 +125,7 @@
 $application->add(new Command('buckets'))
     ->setDescription('Manage Cloud Storage buckets')
     ->setHelp(<<
-The %command.name% command manages Cloud Storage ACL.
+The %command.name% command manages buckets.
 
 php %command.full_name% --help
 
@@ -134,12 +134,15 @@
     ->addArgument('bucket', InputArgument::OPTIONAL, 'The Cloud Storage bucket name')
     ->addOption('create', null, InputOption::VALUE_NONE, 'Create the bucket')
     ->addOption('delete', null, InputOption::VALUE_NONE, 'Delete the bucket')
+    ->addOption('metadata', null, InputOption::VALUE_NONE, 'Get the bucket metadata')
     ->setCode(function ($input, $output) {
         if ($bucketName = $input->getArgument('bucket')) {
             if ($input->getOption('create')) {
                 create_bucket($bucketName);
             } elseif ($input->getOption('delete')) {
                 delete_bucket($bucketName);
+            } elseif ($input->getOption('metadata')) {
+                get_bucket_metadata($bucketName);
             } else {
                 throw new \Exception('Supply --create or --delete with bucket name');
             }

storage/test/storageTest.php

@@ -112,7 +112,7 @@ public function testListBuckets()
         $this->assertContains("Bucket:", $output);
     }
 
-    public function testCreateAndDeleteBuckets()
+    public function testCreateGetDeleteBuckets()
     {
         $bucketName = sprintf('test-bucket-%s-%s', time(), rand());
         $bucket = self::$storage->bucket($bucketName);
@@ -127,6 +127,13 @@ public function testCreateAndDeleteBuckets()
         $bucket->reload();
         $this->assertTrue($bucket->exists());
 
+        $output = $this->runCommand('buckets', [
+          'bucket' => $bucketName,
+          '--metadata' => true,
+        ]);
+
+        $this->assertContains("Bucket Metadata:", $output);
+
         $output = $this->runCommand('buckets', [
             'bucket' => $bucketName,
             '--delete' => true,