adds http examples using curl, curlite, and guzzle (GoogleCloudPlatform#101)

* adds http examples using curl, curlite, and guzzle

* adds README

Author: bshaffer

appengine/standard/http/README.md

@@ -0,0 +1,45 @@
+# HTTP Requests & Google App Engine
+
+This sample application demonstrates how to make [HTTP Requests with Google App Engine](https://cloud.google.com/appengine/docs/php/outbound-requests).
+
+## 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 to App Engine
+
+**Run Locally**
+
+Run the sample with [`dev_appserver.py`](https://cloud.google.com/appengine/docs/php/tools/using-local-server):
+
+```
+cd /path/to/php-docs-samples/appengine/standard/http
+dev_appserver.py .
+```
+
+Now browse to `http://localhost:8080` to view the sample.
+
+**Deploy with gcloud**
+
+```
+gcloud config set project YOUR_PROJECT_ID
+gcloud preview app deploy
+gcloud preview app browse
+```
+
+The last command will open `https://{YOUR_PROJECT_ID}.appspot.com/`
+in your browser.
+
+## Using the App
+
+This app shows you how to make http requests in Google App Engine. To use cURL,
+modify the `php.ini` file in the root of this project and uncomment one of the
+valid cURL extensions. [Read our documentation] to understand the difference
+between using cURL and cURLite.

appengine/standard/http/app.php

@@ -30,27 +30,92 @@
     return $twig->render('http.html.twig');
 });
 
-$app->post('/http_request', function () use ($app) {
+$app->post('/request/file', function () use ($app) {
     /** @var Twig_Environment $twig */
     $twig = $app['twig'];
 
     # [START http_bin]
+    $url = 'http://httpbin.org/post?query=update';
     $data = ['data' => 'this', 'data2' => 'that'];
-    $postData = http_build_query($data);
+    $headers = "accept: */*\r\n" .
+        "Content-Type: application/x-www-form-urlencoded\r\n" .
+        "Custom-Header: custom-value\r\n" .
+        "Custom-Header-Two: custom-value-2\r\n";
+
     $context = [
         'http' => [
             'method' => 'POST',
-            'header' => "accept: */*\r\n" .
-                        "content-type: application/x-www-form-urlencoded\r\n" .
-                        "custom-header: custom-value\r\n" .
-                        "custom-header-two: custom-value-2\r\n",
-            'content' => $postData
+            'header' => $headers,
+            'content' => http_build_query($data),
         ]
     ];
     $context = stream_context_create($context);
-    $result = file_get_contents('http://httpbin.org/post?query=update', false, $context);
+    $result = file_get_contents($url, false, $context);
     # [END http_bin]
-    return $twig->render('http.html.twig', ['result' => $result]);
+    return $twig->render('http.html.twig', ['file_result' => $result]);
+});
+
+$app->post('/request/curl', function () use ($app) {
+    /** @var Twig_Environment $twig */
+    $twig = $app['twig'];
+
+    // make sure one of the extensions is installed
+    if (!function_exists('curl_init')) {
+        throw new \Exception('You must enable cURL or cURLite in php.ini');
+    }
+
+    # [START curl_request]
+    $url = 'http://httpbin.org/post?query=update';
+    $data = ['data' => 'this', 'data2' => 'that'];
+    $headers = [
+        'Accept: */*',
+        'Content-Type: application/x-www-form-urlencoded',
+        'Custom-Header: custom-value',
+        'Custom-Header-Two: custom-value-2'
+    ];
+
+    // open connection
+    $ch = curl_init();
+
+    // set curl options
+    $options = [
+        CURLOPT_URL => $url,
+        CURLOPT_POST => count($data),
+        CURLOPT_POSTFIELDS => http_build_query($data),
+        CURLOPT_HTTPHEADER => $headers,
+        CURLOPT_RETURNTRANSFER => true,
+    ];
+    curl_setopt_array($ch, $options);
+
+    // execute
+    $result = curl_exec($ch);
+
+    // close connection
+    curl_close($ch);
+    # [END curl_request]
+    return $twig->render('http.html.twig', ['curl_result' => $result]);
+});
+
+$app->post('/request/guzzle', function () use ($app) {
+    /** @var Twig_Environment $twig */
+    $twig = $app['twig'];
+
+    # [START guzzle_request]
+    $url = 'http://httpbin.org/post?query=update';
+    $data = ['data' => 'this', 'data2' => 'that'];
+    $headers = [
+        'Accept' => '*/*',
+        'Content-Type' => 'application/x-www-form-urlencoded',
+        'Custom-Header' => 'custom-value',
+        'Custom-Header-Two' => 'custom-value',
+    ];
+
+    $guzzle = new GuzzleHttp\Client;
+    $request = new GuzzleHttp\Psr7\Request('POST', $url, $headers, http_build_query($data));
+    $result = $guzzle->send($request);
+    # [END guzzle_request]
+
+    return $twig->render('http.html.twig', ['guzzle_result' => $result->getBody()]);
 });
 
 return $app;

appengine/standard/http/composer.json

@@ -2,7 +2,8 @@
     "require": {
         "twig/twig": " ~1.8|~2.0",
         "symfony/twig-bridge": " ~2.7|3.0.*",
-        "silex/silex": " ^1.3"
+        "silex/silex": " ^1.3",
+        "guzzlehttp/guzzle": "^6.2"
     },
     "require-dev": {
         "symfony/browser-kit": "^3.0"

appengine/standard/http/composer.lock

@@ -7,12 +7,40 @@
   <body>
     <h1>Http Example</h1>
 
-    <form action="/http_request" method="post">
-        <input type="submit" value="Make an HTTP Request" />
-    </form>
+    <div>
+      <h3>Request with <code>file_get_contents</code></h3>
 
-    {% if result is defined %}
-        <pre>{{ result }}</pre>
-    {% endif %}
+      <form action="/request/file" method="post">
+          <input type="submit" value="Make an HTTP Request" />
+      </form>
+
+      {% if file_result is defined %}
+        <pre>{{ file_result }}</pre>
+      {% endif %}
+    </div>
+
+    <div>
+      <h3>Request with Curl</h3>
+
+      <form action="/request/curl" method="post">
+          <input type="submit" value="Make an HTTP Request" />
+      </form>
+
+      {% if curl_result is defined %}
+        <pre>{{ curl_result }}</pre>
+      {% endif %}
+    </div>
+
+    <div>
+      <h3>Request with Guzzle</h3>
+
+      <form action="/request/guzzle" method="post">
+          <input type="submit" value="Make an HTTP Request" />
+      </form>
+
+      {% if guzzle_result is defined %}
+        <pre>{{ guzzle_result }}</pre>
+      {% endif %}
+    </div>
   </body>
 </html>

appengine/standard/http/http.html.twig

@@ -0,0 +1,11 @@
+; App Engine Standard supports both cURL and cURLite.
+; Both cannot be enabled at the same time.
+; @see https://cloud.google.com/appengine/docs/php/runtime#PHP_cURL_support
+
+; To enable cURLite, uncomment the following line:
+;
+;google_app_engine.enable_curl_lite = "true"
+
+; To enable cURL, uncomment the following line:
+;
+;extension = "curl.so"

appengine/standard/http/php.ini

@@ -18,6 +18,44 @@
 
 class httpTest extends WebTestCase
 {
+    private $expected;
+
+    public function setup()
+    {
+        parent::setup();
+
+        $this->expected = '{
+  "args": {
+    "query": "update"
+  },
+  "data": "",
+  "files": {},
+  "form": {
+    "data": "this",
+    "data2": "that"
+  },
+  "headers": {
+    "Accept": "*/*",
+    "Content-Length": "20",
+    "Content-Type": "application/x-www-form-urlencoded",
+    "Custom-Header": "custom-value",
+    "Custom-Header-Two": "custom-value-2",
+    "Host": "httpbin.org"
+  },
+  "json": null,
+  "origin": "ORIGIN_IP_ADDRESS",
+  "url": "http://httpbin.org/post?query=update"
+}';
+        // fix issue where there are trailing spaces after the commas
+        $this->expected = str_replace(',', ', ', $this->expected);
+
+        // escape for regex
+        $this->expected = '#' . preg_quote(htmlspecialchars($this->expected), '#') . '#';
+
+        // allow for any IP address
+        $this->expected = str_replace('ORIGIN_IP_ADDRESS', '.*', $this->expected);
+    }
+
     public function createApplication()
     {
         $app = require __DIR__ . '/../app.php';
@@ -41,47 +79,39 @@ public function testHome()
         $this->assertTrue($client->getResponse()->isOk());
     }
 
-    public function testHttpRequest()
+    public function testFileRequest()
     {
         $client = $this->createClient();
 
-        $crawler = $client->request('POST', '/http_request');
+        $crawler = $client->request('POST', '/request/file');
 
         $this->assertTrue($client->getResponse()->isOk());
-        $result = <<<EOF
-{
-  "args": {
-    "query": "update"
-  },
-  "data": "",
-  "files": {},
-  "form": {
-    "data": "this",
-    "data2": "that"
-  },
-  "headers": {
-    "Accept": "*/*",
-    "Content-Length": "20",
-    "Content-Type": "application/x-www-form-urlencoded",
-    "Custom-Header": "custom-value",
-    "Custom-Header-Two": "custom-value-2",
-    "Host": "httpbin.org"
-  },
-  "json": null,
-  "origin": "ORIGIN_IP_ADDRESS",
-  "url": "http://httpbin.org/post?query=update"
-}
-EOF;
-        // fix issue where there are trailing spaces after the commas
-        $result = str_replace(',', ', ', $result);
 
-        // escape for regex
-        $result = '#' . preg_quote(htmlspecialchars($result), '#') . '#';
+        // test the regex exists
+        $this->assertRegExp($this->expected, (string) $client->getResponse());
+    }
 
-        // allow for any IP address
-        $result = str_replace('ORIGIN_IP_ADDRESS', '.*', $result);
+    public function testCurlRequest()
+    {
+        $client = $this->createClient();
+
+        $crawler = $client->request('POST', '/request/curl');
+
+        $this->assertTrue($client->getResponse()->isOk());
+
+        // test the regex exists
+        $this->assertRegExp($this->expected, (string) $client->getResponse());
+    }
+
+    public function testGuzzleRequest()
+    {
+        $client = $this->createClient();
+
+        $crawler = $client->request('POST', '/request/curl');
+
+        $this->assertTrue($client->getResponse()->isOk());
 
         // test the regex exists
-        $this->assertRegExp($result, (string) $client->getResponse());
+        $this->assertRegExp($this->expected, (string) $client->getResponse());
     }
 }