Merge pull request GoogleCloudPlatform#2 from bshaffer/add-storage-samples

Add storage samples

Author: bshaffer

storage/README.md

@@ -0,0 +1,47 @@
+# Google Cloud Storage PHP Sample Application
+
+## Description
+This is a simple web-based example of calling the Google Cloud Storage API in
+PHP.
+
+## Prerequisites:
+Please make sure that all of the following is installed before trying to run
+the sample application.
+
+- PHP 5.2.x or higher [http://www.php.net/]
+- PHP Curl extension [http://www.php.net/manual/en/intro.curl.php]
+- PHP JSON extension [http://php.net/manual/en/book.json.php]
+- The google-api-php-client library checked out locally
+
+## Setup Authentication
+NOTE: This README assumes that you have enabled access to the Google Cloud
+Engine API via the Google API Console page.
+
+1) Visit https://console.developers.google.com to register your
+application and generate an API key.
+- Click  **APIs & Auth** in the left column, and then click **Credentials**.
+- Click **Create new client ID** to create a new client ID.
+- In the **Create Client ID** window, choose **Web application**.
+- In the **Redirect URIs** box, specify the URL for your PHP page, e.g., http://localhost/app.php.
+- Click **Create Client ID**.
+- In the **Public API access** section of the **Credentials** page, click **Create new Key**.
+- In the **Create a new Key** window, choose **Browser key**.
+
+2) Update app.php with the redirect uri, consumer key, secret, and developer
+key obtained in step 1.
+- Update `YOUR_CLIENT_ID` with your oauth2 client id.
+- Update `YOUR_CLIENT_SECRET` with your oauth2 client secret.
+- Update `YOUR_REDIRECT_URI` with the fully qualified redirect URI, e.g., http://localhost/app.php.
+- Update `YOUR_API_KEY` with your API key.
+- Update `YOUR_PROJECT_DEFAULT_ID` with your project ID, which
+can be found by visiting https://console.developers.google.com and selecting a project.
+
+3) Update app.php with remaining default settings. Search and replace all
+strings starting with 'YOUR_DEFAULT_' with their associated values.
+
+## Running the Sample Application
+4) Load app.php on your web server, and visit the appropriate website in
+your web browser.
+
+## More Information
+See [https://developers.google.com/storage/docs/json_api/v1/json-api-php-samples](https://developers.google.com/storage/docs/json_api/v1/json-api-php-samples)

storage/app.php

@@ -0,0 +1,197 @@
+
+/**
+ * Copyright 2012 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.
+ */
+
+/**
+ * Follow the instructions on https://github.com/google/google-api-php-client
+ * to download, extract and include the Google APIs client library for PHP into
+ * your project.
+ */
+require_once 'google-api-php-client/autoload.php';
+
+session_start();
+
+/**
+ * Visit https://console.developers.google.com to generate your
+ * oauth2_client_id, oauth2_client_secret, and to register your
+ * oauth2_redirect_uri.
+ */
+$client = new Google_Client();
+$client->setApplicationName("Google Cloud Storage PHP Starter Application");
+$client->setClientId('YOUR_CLIENT_ID');
+$client->setClientSecret('YOUR_CLIENT_SECRET');
+$client->setRedirectUri('YOUR_REDIRECT_URI');
+$client->setDeveloperKey('YOUR_API_KEY');
+$client->setScopes('https://www.googleapis.com/auth/devstorage.full_control');
+$storageService = new Google_Service_Storage($client);
+
+/**
+ * Constants for sample request parameters.
+ */
+define('API_VERSION', 'v1');
+define('DEFAULT_PROJECT', 'YOUR_DEFAULT_PROJECT_ID');
+define('DEFAULT_BUCKET', 'YOUR_DEFAULT_BUCKET_NAME');
+define('DEFAULT_OBJECT', 'YOUR_DEFAULT_OBJECT_NAME');
+
+/**
+ * Generates the markup for a specific Google Cloud Storage API request.
+ * @param string $apiRequestName The name of the API request to process.
+ * @param string $apiResponse The API response to process.
+ * @return string Markup for the specific Google Cloud Storage API request.
+ */
+function generateMarkup($apiRequestName, $apiResponse) {
+  $apiRequestMarkup = '';
+  $apiRequestMarkup .= "" . $apiRequestName . "";
+
+  if ($apiResponse['items'] == '' ) {
+    $apiRequestMarkup .= "";
+    $apiRequestMarkup .= print_r(json_decode(json_encode($apiResponse), true),
+      true);
+    $apiRequestMarkup .= "";
+  } else {
+    foreach($apiResponse['items'] as $response) {
+      $apiRequestMarkup .= "";
+      $apiRequestMarkup .= print_r(json_decode(json_encode($response), true),
+        true);
+      $apiRequestMarkup .= "";
+    }
+  }
+
+  return $apiRequestMarkup;
+}
+
+/**
+ * Clear access token whenever a logout is requested.
+ */
+if (isset($_REQUEST['logout'])) {
+  unset($_SESSION['access_token']);
+}
+
+/**
+ * Authenticate and set client access token.
+ */
+if (isset($_GET['code'])) {
+  $client->authenticate($_GET['code']);
+  $_SESSION['access_token'] = $client->getAccessToken();
+  $redirect = 'http://' . $_SERVER['HTTP_HOST'] . $_SERVER['PHP_SELF'];
+  header('Location: ' . filter_var($redirect, FILTER_SANITIZE_URL));
+}
+
+/**
+ * Set client access token.
+ */
+if (isset($_SESSION['access_token'])) {
+  $client->setAccessToken($_SESSION['access_token']);
+}
+
+/**
+ * If all authentication has been successfully completed, make Google
+ * Cloud Storage API requests.
+ */
+if ($client->getAccessToken()) {
+  /**
+   * Google Cloud Storage API request to retrieve the list of buckets in your
+   * Google Cloud Storage project.
+   */
+  $buckets = $storageService->buckets->listBuckets(DEFAULT_PROJECT);
+  $listBucketsMarkup = generateMarkup('List Buckets', $buckets);
+
+  /**
+   * Google Cloud Storage API request to retrieve the list of objects in your
+   * Google Cloud Storage bucket.
+   */
+  $objects = $storageService->objects->listObjects(DEFAULT_BUCKET);
+  $listObjectsMarkup = generateMarkup('List Objects', $objects);
+
+  /**
+   * Google Cloud Storage API request to retrieve the list of Access Control
+   * Lists on your Google Cloud Storage buckets.
+   */
+  $bucketsAccessControls = $storageService->bucketAccessControls->
+    listBucketAccessControls(DEFAULT_BUCKET);
+  $listBucketsAccessControlsMarkup = generateMarkup(
+    'List Buckets Access Controls', $bucketsAccessControls);
+
+  /**
+   * Google Cloud Storage API request to retrieve the list of Access Control
+   * Lists on your Google Cloud Storage objects.
+   */
+  $objectsAccessControls = $storageService->objectAccessControls->
+    listObjectAccessControls(DEFAULT_BUCKET, DEFAULT_OBJECT);
+  $listObjectsAccessControlsMarkup = generateMarkup(
+    'List Objects Access Controls', $objectsAccessControls);
+
+  /**
+   * Google Cloud Storage API request to retrieve a bucket from your
+   * Google Cloud Storage project.
+   */
+  $bucket = $storageService->buckets->get(DEFAULT_BUCKET);
+  $getBucketMarkup = generateMarkup('Get Bucket', $bucket);
+
+  // The access token may have been updated lazily.
+  $_SESSION['access_token'] = $client->getAccessToken();
+} else {
+  $authUrl = $client->createAuthUrl();
+}
+?>
+
+
+  
+    
+  
+  
+    Google Cloud Storage Sample App
+
+       if(isset($listBucketsMarkup)): ?>
+
+           print $listBucketsMarkup ?>
+        
+       endif ?>
+
+       if(isset($listObjectsMarkup)): ?>
+
+           print $listObjectsMarkup ?>
+        
+       endif ?>
+
+       if(isset($listBucketsAccessControlsMarkup)): ?>
+
+           print $listBucketsAccessControlsMarkup ?>
+        
+       endif ?>
+
+       if(isset($listObjectsAccessControlsMarkup)): ?>
+
+           print $listObjectsAccessControlsMarkup ?>
+        
+       endif ?>
+
+       if(isset($getBucketMarkup)): ?>
+
+           print $getBucketMarkup ?>
+        
+       endif ?>
+
+      
+        if(isset($authUrl)) {
+          print "Authorize Me!";
+        } else {
+          print "Logout";
+        }
+      ?>
+    
+  
+