Adds Trace sample for App Engine PHP72 (GoogleCloudPlatform#628)

Author: bshaffer

appengine/php72/auth/test/DeployTest.php

@@ -19,8 +19,6 @@
 use Google\Cloud\TestUtils\AppEngineDeploymentTrait;
 use PHPUnit\Framework\TestCase;
 
-require_once __DIR__ . '/../../../../testing/FileUtil.php';
-
 class DeployTest extends TestCase
 {
     use AppEngineDeploymentTrait;

appengine/php72/errorreporting/README.md

@@ -17,9 +17,7 @@ This app demonstrates how to report errors on on App Engine for PHP 7.2.
 
 ### Run Locally
 
-These samples cannot be run locally with the Dev AppServer because gRPC has not
-been packaged with the Dev AppServer for PHP at this time. You can install gRPC
-locally and run them using PHP's build-in web server:
+You can run the sample locally using PHP's build-in web server:
 
 ```
 # export environemnt variables locally which are set by app engine when deployed
@@ -31,6 +29,8 @@ export GAE_VERSION=testing
 php -S localhost:8000
 ```
 
+Browse to `localhost:8000` to see a list of examples to execute.
+
 ### Deploy with gcloud
 
 Deploy the samples by doing the following:

appengine/php72/errorreporting/test/DeployTest.php

@@ -24,8 +24,6 @@
 
 use PHPUnit\Framework\TestCase;
 
-require_once __DIR__ . '/../../../../testing/FileUtil.php';
-
 class DeployTest extends TestCase
 {
     use AppEngineDeploymentTrait;

appengine/php72/helloworld/README.md

@@ -1,8 +1,7 @@
 # Hello World on App Engine for PHP 7.2
 
-This sample application demonstrates how to access
-[Compute Metadata](https://cloud.google.com/compute/docs/storing-retrieving-metadata)
-from App Engine.
+This sample demonstrates how to deploy a *very* basic application to Google
+App Engine for PHP 7.2.
 
 ## Setup
 

appengine/php72/trace/.gcloudignore

@@ -0,0 +1,17 @@
+# This file specifies files that are *not* uploaded to Google Cloud Platform
+# using gcloud. It follows the same syntax as .gitignore, with the addition of
+# "#!include" directives (which insert the entries of the given .gitignore-style
+# file at that point).
+#
+# For more information, run:
+#   $ gcloud topic gcloudignore
+#
+.gcloudignore
+# If you would like to upload your .git directory, .gitignore file or files
+# from your .gitignore file, remove the corresponding line
+# below:
+.git
+.gitignore
+
+# PHP Composer dependencies:
+#vendor/

appengine/php72/trace/README.md

@@ -0,0 +1,45 @@
+# App Engine for PHP 7.2 Stackdriver Trace samples
+
+This app demonstrates how to set up Stackdriver Trace on App Engine for PHP 7.2.
+
+## Setup
+
+- Install [`composer`](https://getcomposer.org)
+- Install dependencies by running:
+
+    ```sh
+    composer install
+    ```
+
+- Install the [Google Cloud SDK](https://developers.google.com/cloud/sdk/).
+
+## Deploy
+
+### Run Locally
+
+You can run these samples locally using PHP's build-in web server:
+
+```
+# export environemnt variables locally which are set by app engine when deployed
+export GOOGLE_CLOUD_PROJECT=YOUR_PROJECT_ID
+
+# Run PHP's built-in web server
+php -S localhost:8000
+```
+
+You will then be able to see your application traces in the
+[Trace UI](https://console.cloud.google.com/traces/overview).
+
+### Deploy with gcloud
+
+Deploy the samples by doing the following:
+
+```
+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. Browse to `/` to execute a trace. You will then be able to see
+your traces in the [Trace UI](https://console.cloud.google.com/traces/overview).

appengine/php72/trace/app.yaml

@@ -0,0 +1,5 @@
+runtime: php72
+
+handlers:
+- url: /
+  script: index.php

appengine/php72/trace/composer.json

@@ -0,0 +1,8 @@
+{
+    "require": {
+        "opencensus/opencensus-exporter-stackdriver": "^0.1.0"
+    },
+    "require-dev": {
+        "google/cloud-tools": "^0.7"
+    }
+}