Add Debugger samples (GoogleCloudPlatform#507)

chingor13 · bshaffer · commit 5f849a310663 · 2018-01-25T10:11:18.000-08:00
diff --git a/debugger/README.md b/debugger/README.md
@@ -0,0 +1,55 @@
+# Google Stackdriver Debugger PHP Sample Application
+
+## Description
+
+This simple [Silex][silex] application demonstrates how to
+install and run the Stackdriver Debugger Agent for PHP.
+
+## Build and Run
+
+1. Add the Stackdriver Debugger composer package to your `composer.json`:
+```
+    $ composer require google/cloud-debugger:^0.1
+```
+2. Install the composer package:
+```
+    $ composer install
+```
+3. Install the PHP extension from [PECL][pecl]:
+```
+    $ pecl install stackdriver_debugger-alpha
+```
+4. Run the Stackdriver Debugger daemon:
+```
+    $ vendor/bin/google-cloud-debugger .
+```
+5. Run the AsyncBatchDaemon daemon:
+```
+    $ vendor/bin/google-cloud-batch daemon
+```
+6. Run the application:
+```
+    $ IS_BATCH_DAEMON_RUNNING=true php -S localhost:8000 -t web/
+```
+7. Navigate to the [Google Cloud Debugger console][debug-console] and [Select Source Code][select-source-code]
+8. [Set a snapshot][snapshots] or [set a logpoint][logpoints].
+
+See [Setting Up Stackdriver Debugger for PHP](https://cloud.google.com/debugger/docs/setup/php)
+for more information.
+
+## Contributing changes
+
+* See [CONTRIBUTING.md][contributing]
+
+## Licensing
+
+* See [LICENSE][license]
+
+[silex]: https://silex.symfony.com/
+[pecl]: https://pecl.php.net/
+[debug-console]: https://console.cloud.google.com/debug
+[select-source-code]: https://cloud.google.com/debugger/docs/source-options]
+[snapshots]: https://cloud.google.com/debugger/docs/using/snapshots
+[logpoints]: https://cloud.google.com/debugger/docs/using/logpoints
+[contributing]: ../../CONTRIBUTING.md
+[license]: ../../LICENSE
diff --git a/debugger/composer.json b/debugger/composer.json
@@ -0,0 +1,13 @@
+{
+    "name": "google/debugger-sample",
+    "type": "project",
+    "require": {
+        "php": ">= 7.0",
+        "google/cloud-debugger": "^0.1.0",
+        "silex/silex": "~2.0",
+        "twig/twig": "^2.3"
+    },
+    "require-dev": {
+        "phpunit/phpunit": "~4"
+    }
+}
diff --git a/debugger/views/hello.html.twig b/debugger/views/hello.html.twig
@@ -0,0 +1,9 @@
+<!doctype html>
+<html>
+  <head>
+    <title>Hello from Silex {{ constant('Silex\\Application::VERSION') }}</title>
+  </head>
+  <body>
+    <h1>Hello {{ name }} from Silex {{ constant('Silex\\Application::VERSION') }}</h1>
+  </body>
+</html>
diff --git a/debugger/web/index.php b/debugger/web/index.php
@@ -0,0 +1,40 @@
+<?php
+/**
+ * Copyright 2017 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 debugger_agent]
+require_once __DIR__ . '/../vendor/autoload.php';
+
+use Google\Cloud\Debugger\Agent;
+
+$agent = new Agent(['sourceRoot' => realpath('../')]);
+# [END debugger_agent]
+$app = new Silex\Application();
+
+$app->register(new Silex\Provider\TwigServiceProvider(), array(
+    'twig.path' => __DIR__ . '/../views',
+));
+
+$app->get('/', function () {
+    return 'Silex version ' . Silex\Application::VERSION;
+});
+
+$app->get('/hello/{name}', function ($name) use ($app) {
+    return $app['twig']->render('hello.html.twig', [
+        'name' => $name
+    ]);
+});
+
+$app->run();

-Original file line number
+Diff line change
@@ @@ -0,0 +1,9 @@ @@
++
 +<html>
 +  <head>
 +    <title>Hello from Silex {{ constant('Silex\\Application::VERSION') }}title>
 +  head>
 +  <body>
 +    <h1>Hello {{ name }} from Silex {{ constant('Silex\\Application::VERSION') }}h1>
 +  body>
 +html>