Add README and config files for flexible/pubsub.

Also, remove the text describing how to create the topic and
subscription, because that no happens automatically.

Author: SurferJeffAtGoogle

appengine/flexible/pubsub/README.md

@@ -0,0 +1,61 @@
+# Google PubSub PHP Sample Application for App Engine Flexible Environment.
+
+## Description
+
+This sample demonstrates how to invoke PubSub from Google App Engine Flexible
+Environment.
+
+The sample code lives in [a parent pubsub directory](../../../pubsub).
+Only two configuration files differ: `app.yaml` and `nginx-app.conf`.
+
+## 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.
+
+- Enable the "Google Cloud Pub/Sub" API under "APIs & auth > APIs."
+- Enable the "Google Cloud Datastore" API under "APIs & auth > APIs."
+- For local development also follow the instructions below.
+  - Go to "Credentials" and create a new Service Account.
+  - Select "Generate new JSON key", then download a new JSON file.
+  - Set the following environment variable:
+    - `GOOGLE_APPLICATION_CREDENTIALS`: the file path to the downloaded JSON file.
+
+
+## Configuration
+
+- Edit `app.yaml`.  Replace `your-google-project-id` with your google project id.
+
+- Copy `app.yaml` and `nginx-app.conf` into [../../../pubsub](../../../pubsub).  Ex:
+```sh
+~/gitrepos/php-docs-samples/appengine/flexible/pubsub$ cp -f app.yaml nginx-app.conf ../../../pubsub
+~/gitrepos/php-docs-samples/appengine/flexible/pubsub$ cd ../../../pubsub/
+~/gitrepos/php-docs-samples/pubsub$ 
+```
+
+## Deploy the application to App Engine
+
+```
+$ gcloud preview app deploy app.yaml --set-default --project YOUR_PROJECT_NAME
+```
+
+Then access the following URL:
+  https://{YOUR_PROJECT_NAME}.appspot.com/
+
+## Run the application locally
+
+```
+/usr/bin/php -S localhost:8910 -t web
+```
+
+## Contributing changes
+
+* See [CONTRIBUTING.md](../../../CONTRIBUTING.md)
+
+## Licensing
+
+* See [LICENSE](../../../LICENSE)
+
+

appengine/flexible/pubsub/app.yaml

@@ -0,0 +1,8 @@
+runtime: php
+vm: true
+
+runtime_config:
+  document_root: web
+
+env_variables:
+  GOOGLE_PROJECT_NAME: your-google-project-id

appengine/flexible/pubsub/nginx-app.conf

@@ -0,0 +1,4 @@
+location / {
+  # try to serve file directly, fallback to front controller
+  try_files $uri /index.php$is_args$args;
+}

pubsub/README.md

@@ -37,29 +37,6 @@ TODO(tmatsuo): Better implementation for devserver.
 $ composer install
 ```
 
-## Configuration
-
-Run the following commands to create your pubsub subscription topic:
-
-```sh
-$ gcloud alpha pubsub topics create [your-topic-name]
-1 topic(s) created successfully
- - projects/[your-project-name]/topics/[your-topic-name]
-```
-
-> We use **`php-pubsub-example`** as the topic name, but you can change this
-> by setting the `PUBSUB_TOPIC` environment variable (see `app.yaml`)
-
-Then you need to create your subscription to this topic by supplying
-the endpoint to be notified when the topic is published to:
-
-```
-gcloud alpha pubsub subscriptions create [your-subscription-name] \
- --topic [your-topic-name] \
- --push-endpoint https://[your-project-name].appspot.com/receive_message \
- –-ack-deadline 30
-```
-
 ## Deploy the application to App Engine
 
 ```
@@ -69,6 +46,10 @@ $ gcloud preview app deploy app.yaml --set-default --project YOUR_PROJECT_NAME
 Then access the following URL:
   https://{YOUR_PROJECT_NAME}.appspot.com/
 
+## Deploy the application to App Engine Flexible Environment.
+
+See the instructions [here](../appengine/flexible/pubsub/README.md).
+
 ## Run the application locally
 
 ```