Adds Cloud Storage sample for AppEngine Flex (GoogleCloudPlatform#279)

Author: bshaffer

appengine/flexible/storage/README.md

@@ -0,0 +1,67 @@
+# Cloud Storage & Google App Engine
+
+This sample application demonstrates how to use [Cloud Storage with Google App Engine](https://cloud.google.com/appengine/docs/flexible/php/using-cloud-storage).
+
+## Setup
+
+Before running this sample:
+
+### Register your application
+
+- Go to
+  [Google Developers Console](https://console.developers.google.com/project)
+  and create a new project. This will automatically enable an App
+  Engine application with the same ID as the project.
+
+- Go to
+  [Google Cloud Storage](https://console.cloud.google.com/storage/browser)
+  and create a new bucket. Optionally, use the default bucket for your project
+  (`YOUR_BUCKET.appspot.com`).
+
+### Prerequisites
+
+- Install [`composer`](https://getcomposer.org)
+- Install dependencies by running:
+
+    ```sh
+    composer install
+    ```
+
+- Install the [Google Cloud SDK](https://developers.google.com/cloud/sdk/).
+- Initialize the SDK by running `gcloud init`
+
+## Run Locally
+
+Set the environment variables `GOOGLE_BUCKET_NAME` and `GCLOUD_PROJECT` to the name of your storage bucket and project ID respectively.
+
+```
+export GOOGLE_BUCKET_NAME=your-bucket-name
+export GCLOUD_PROJECT=your-project-id
+```
+
+Run the sample with the PHP built-in web server:
+
+```
+php -S localhost:8080
+```
+
+> Note: Your PHP executable path may be different than the one above.
+
+Now browse to `http://localhost:8080` to view the sample.
+
+## Deploy to App Engine
+
+**Prerequisites**
+
+- Set `your-bucket-name` in `app.yaml` to the name of your Cloud Storage Bucket.
+
+**Deploy with gcloud**
+
+```
+gcloud config set project YOUR_PROJECT_ID
+gcloud app deploy
+gcloud app browse
+```
+
+The last command will open `https://{YOUR_PROJECT_ID}.appspot.com/`
+in your browser.

appengine/flexible/storage/app.php

@@ -0,0 +1,81 @@
+<?php
+/**
+ * Copyright 2016 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.
+ */
+
+# [START import_client]
+use Google\Cloud\Storage\StorageClient;
+# [END import_client]
+use Silex\Application;
+use Symfony\Component\HttpFoundation\Request;
+
+// create the Silex application
+$app = new Application();
+
+$app->get('/', function () use ($app) {
+    /** @var Google\Cloud\StorageClient */
+    $storage = $app['storage'];
+    $bucketName = $app['bucket_name'];
+    $objectName = $app['object_name'];
+    $bucket = $storage->bucket($bucketName);
+    $object = $bucket->object($objectName);
+    $content = $object->exists() ? $object->downloadAsString() : '';
+    $escapedContent = htmlspecialchars($content);
+    $form = <<<EOF
+    <h1>Storage Example</h1>
+    <h3>Write [<a href="https://cloud.google.com/appengine/docs/flexible/php/using-cloud-storage">docs</a>]:</h3>
+    <form action="/write" method="post">
+        Some file content:<br />
+        <textarea name="content"></textarea><br />
+        <input type="submit" />
+    </form>
+EOF;
+    if ($content) {
+        $form .= "<p><strong>Your content:</strong><p><p>$escapedContent</p>";
+    }
+    return $form;
+});
+
+/**
+ * Write to a Storage bucket.
+ * @see https://cloud.google.com/appengine/docs/flexible/php/using-cloud-storage
+ */
+$app->post('/write', function (Request $request) use ($app) {
+    /** @var Google\Cloud\StorageClient */
+    $storage = $app['storage'];
+    $bucketName = $app['bucket_name'];
+    $objectName = $app['object_name'];
+    $content = $request->get('content');
+    # [START write]
+    $metadata = ['contentType' => 'text/plain'];
+    $storage->bucket($bucketName)->upload($content, [
+        'name' => $objectName,
+        'metadata' => $metadata,
+    ]);
+    # [END write]
+    return $app->redirect('/');
+});
+
+$app['storage'] = function () use ($app) {
+    $projectId = $app['project_id'];
+    # [START create_client]
+    $storage = new StorageClient([
+        'projectId' => $projectId
+    ]);
+    # [END create_client]
+    return $storage;
+};
+
+return $app;

appengine/flexible/storage/app.yaml

@@ -0,0 +1,8 @@
+runtime: php
+vm: true
+
+# [START env_variables]
+env_variables:
+  GOOGLE_BUCKET_NAME: "your-bucket-name"
+# [END env_variables]
+

appengine/flexible/storage/composer.json

@@ -0,0 +1,10 @@
+{
+    "require": {
+        "silex/silex": "^1.3",
+        "google/cloud": "^0.20"
+    },
+    "require-dev": {
+        "symfony/browser-kit": "^3.0",
+        "google/cloud-tools":"^0.6"
+    }
+}