[Slim] Add Basic authentication middleware (#606)

* [Slim] Add Basic Authentication Middleware

User needs to add own implementation to verifyCredentials method in AuthBasic.php.

* [Slim] Update README template

I'm not sure about `middlewareSrcPath` variable. I'll fix it in following PRs
if path is broken.
Hope that notice in README catches attention and most of users will read it.

* Revert "[Slim] Update README template"

This reverts commit 204ee02.

* Revert "[Slim] Add Basic Authentication Middleware"

This reverts commit 6a8e030.

* [Slim] Add "tuupola/slim-basic-auth" package

Package "tuupola/slim-basic-auth" 3.1.0 requires PHP 7, that's why I
set it's version to ^3.0.0 in Composer. Minimum version will be
3.0.0-rc.1 which supports PHP 5.5. I've tested build with PHP 7, it
would be nice to check build with PHP 5.5 someday.

* [Slim] Update README template

Not sure about forward slash in path to SlimRouter class. I will fix it
in upcoming PRs if necessary.

* [Slim] Refresh samples

Author: ybelenko

modules/openapi-generator/src/main/resources/php-slim-server/README.mustache

@@ -7,4 +7,16 @@ is an example of building a PHP Slim server.
 
 This example uses the [Slim Framework](http://www.slimframework.com/).  To see how to make this your own, please take a look at the template here:
 
-[TEMPLATES](https://github.com/openapitools/openapi-generator/tree/master/modules/openapi-generator/src/main/resources/slim/)
+[TEMPLATES](https://github.com/openapitools/openapi-generator/tree/master/modules/openapi-generator/src/main/resources/php-slim-server/)
+
+{{#authMethods}}
+{{^hasMore}}
+## Authentication
+{{/hasMore}}
+{{/authMethods}}
+{{#authMethods}}
+{{#isBasic}}
+> Important! To make Basic Authentication work you need to implement `authenticator` function in [SlimRouter]({{srcBasePath}}/SlimRouter.php) class.  
+> Documentation [tuupola/slim-basic-auth](https://github.com/tuupola/slim-basic-auth)
+{{/isBasic}}
+{{/authMethods}}

modules/openapi-generator/src/main/resources/php-slim-server/SlimRouter.mustache

@@ -39,6 +39,7 @@ use {{apiPackage}}\{{classname}};
 use Slim\App;
 use Psr\Container\ContainerInterface;
 use InvalidArgumentException;
+use Tuupola\Middleware\HttpBasicAuthentication;
 
 /**
  * SlimRouter Class Doc Comment
@@ -66,10 +67,29 @@ class SlimRouter {
     public function __construct($container = []) {
         $app = new App($container);
 
+        $basicAuth = new HttpBasicAuthentication([
+            "secure" => false,
+            "authenticator" => function ($arguments) {
+                $user = $arguments["user"];
+                $password = $arguments["password"];
+                return false;
+            }
+        ]);
+
         {{#apis}}
         {{#operations}}
         {{#operation}}
-        $app->{{httpMethod}}('{{{basePathWithoutHost}}}{{{path}}}', {{classname}}::class . ':{{operationId}}');
+        $app->{{httpMethod}}(
+            '{{{basePathWithoutHost}}}{{{path}}}', {{classname}}::class . ':{{operationId}}'
+{{#hasAuthMethods}}
+{{#authMethods}}
+{{#isBasic}}
+        )->add(
+            $basicAuth
+{{/isBasic}}
+{{/authMethods}}
+{{/hasAuthMethods}}
+        );
         {{/operation}}
         {{/operations}}
         {{/apis}}

modules/openapi-generator/src/main/resources/php-slim-server/composer.mustache

@@ -2,7 +2,8 @@
   "minimum-stability": "RC",
   "require": {
     "php": ">=5.5",
-    "slim/slim": "3.*"
+    "slim/slim": "3.*",
+    "tuupola/slim-basic-auth": "^3.0.0"
   },
   "require-dev": {
     "phpunit/phpunit": "^4.8"

samples/server/petstore-security-test/php-slim/.openapi-generator/VERSION

@@ -1 +1 @@
-3.1.1-SNAPSHOT
+3.1.2-SNAPSHOT

samples/server/petstore-security-test/php-slim/README.md

@@ -7,4 +7,6 @@ is an example of building a PHP Slim server.
 
 This example uses the [Slim Framework](http://www.slimframework.com/).  To see how to make this your own, please take a look at the template here:
 
-[TEMPLATES](https://github.com/openapitools/openapi-generator/tree/master/modules/openapi-generator/src/main/resources/slim/)
+[TEMPLATES](https://github.com/openapitools/openapi-generator/tree/master/modules/openapi-generator/src/main/resources/php-slim-server/)
+
+## Authentication

samples/server/petstore-security-test/php-slim/composer.json

@@ -2,7 +2,8 @@
   "minimum-stability": "RC",
   "require": {
     "php": ">=5.5",
-    "slim/slim": "3.*"
+    "slim/slim": "3.*",
+    "tuupola/slim-basic-auth": "^3.0.0"
   },
   "require-dev": {
     "phpunit/phpunit": "^4.8"

samples/server/petstore-security-test/php-slim/index.php

@@ -1,7 +1,7 @@
 <?php
 /**
- * OpenAPI Petstore  &#39; \&quot; &#x3D;end -- \\r\\n \\n \\r
- * @version 1.0.0  &#39; \&quot; &#x3D;end -- \\r\\n \\n \\r
+ * OpenAPI Petstore *_/ &#39; \&quot; &#x3D;end -- \\r\\n \\n \\r
+ * @version 1.0.0 *_/ &#39; \&quot; &#x3D;end -- \\r\\n \\n \\r
  */
 
 require_once __DIR__ . '/vendor/autoload.php';

samples/server/petstore-security-test/php-slim/lib/AbstractApiController.php

@@ -11,11 +11,11 @@
  */
 
 /**
- * OpenAPI Petstore  ' \" =end -- \\r\\n \\n \\r
+ * OpenAPI Petstore *_/ ' \" =end -- \\r\\n \\n \\r
  *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\   ' \" =end --       
- * OpenAPI spec version: 1.0.0  ' \" =end -- \\r\\n \\n \\r
- * Contact: something@something.abc  ' \" =end -- \\r\\n \\n \\r
+ * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\  *_/ ' \" =end --
+ * OpenAPI spec version: 1.0.0 *_/ ' \" =end -- \\r\\n \\n \\r
+ * Contact: something@something.abc *_/ ' \" =end -- \\r\\n \\n \\r
  * Generated by: https://github.com/openapitools/openapi-generator.git
  */
 

samples/server/petstore-security-test/php-slim/lib/Api/FakeApi.php

@@ -11,11 +11,11 @@
  */
 
 /**
- * OpenAPI Petstore  ' \" =end -- \\r\\n \\n \\r
+ * OpenAPI Petstore *_/ ' \" =end -- \\r\\n \\n \\r
  *
- * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\   ' \" =end --       
- * OpenAPI spec version: 1.0.0  ' \" =end -- \\r\\n \\n \\r
- * Contact: something@something.abc  ' \" =end -- \\r\\n \\n \\r
+ * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\  *_/ ' \" =end --
+ * OpenAPI spec version: 1.0.0 *_/ ' \" =end -- \\r\\n \\n \\r
+ * Contact: something@something.abc *_/ ' \" =end -- \\r\\n \\n \\r
  * Generated by: https://github.com/openapitools/openapi-generator.git
  */
 
@@ -42,7 +42,7 @@ class FakeApi extends AbstractApiController {
 
     /**
      * PUT testCodeInjectEndRnNR
-     * Summary: To test code injection  ' \" =end -- \\r\\n \\n \\r
+     * Summary: To test code injection *_/ ' \" =end -- \\r\\n \\n \\r
      * Notes: 
      *
      * @param \Psr\Http\Message\ServerRequestInterface $request  Request

samples/server/petstore-security-test/php-slim/lib/Model/ModelReturn.php

@@ -9,7 +9,7 @@
  */
 class ModelReturn {
 
-    /** @var int $return property description   ' \" =end -- \\r\\n \\n \\r*/
+    /** @var int $return property description  *_/ ' \" =end -- \\r\\n \\n \\r*/
     private $return;
 
 }