Add query example and test CLI/CGI environment

Author: clue

examples/query.php

@@ -0,0 +1,28 @@
+<?php
+
+// $ php examples/query.php "INSERT INTO user (name) VALUES ('Bob'),('Carol')"
+// $ php examples/query.php "DELETE FROM user WHERE name = ?" "Carol"
+
+require __DIR__ . '/../vendor/autoload.php';
+
+$factory = new Clue\React\SQLite\Factory();
+$db = $factory->openLazy(__DIR__ . '/users.db');
+
+$query = isset($argv[1]) ? $argv[1] : 'SELECT 42 AS value';
+$args = array_slice(isset($argv) ? $argv : [], 2);
+
+$db->query($query, $args)->then(function (Clue\React\SQLite\Result $result) {
+    if ($result->columns !== null) {
+        echo implode("\t", $result->columns) . PHP_EOL;
+        foreach ($result->rows as $row) {
+            echo implode("\t", $row) . PHP_EOL;
+        }
+    } else {
+        echo "changed\tid". PHP_EOL;
+        echo $result->changed . "\t" . $result->insertId . PHP_EOL;
+    }
+}, function (Exception $e) {
+    echo 'Error: ' . $e->getMessage() . PHP_EOL;
+});
+
+$db->quit();

tests/FunctionalExampleTest.php

@@ -0,0 +1,43 @@
+<?php
+
+namespace Clue\Tests\React\SQLite;
+
+use PHPUnit\Framework\TestCase;
+
+class FunctionalExampleTest extends TestCase
+{
+    public function testQueryExampleReturnsDefaultValue()
+    {
+        $output = $this->execExample(escapeshellarg(PHP_BINARY) . ' query.php');
+
+        $this->assertEquals('value' . PHP_EOL . '42' . PHP_EOL, $output);
+    }
+
+    public function testQueryExampleReturnsCalculatedValueFromPlaceholderVariables()
+    {
+        $output = $this->execExample(escapeshellarg(PHP_BINARY) . ' query.php "SELECT ?+? AS result" 1 2');
+
+        $this->assertEquals('result' . PHP_EOL . '3' . PHP_EOL, $output);
+    }
+
+    public function testQueryExampleExecutedWithCgiReturnsDefaultValueAfterContentTypeHeader()
+    {
+        $code = 1;
+        $null = DIRECTORY_SEPARATOR === '\\' ? 'NUL' : '/dev/null';
+        system("php-cgi --version >$null 2>$null", $code);
+        if ($code !== 0) {
+            $this->markTestSkipped('Unable to execute "php-cgi"');
+        }
+
+        $output = $this->execExample('php-cgi query.php');
+
+        $this->assertStringEndsWith("\r\n\r\n" . 'value' . PHP_EOL . '42' . PHP_EOL, $output);
+    }
+
+    private function execExample($command)
+    {
+        chdir(__DIR__ . '/../examples/');
+
+        return shell_exec($command);
+    }
+}