Oauth2 support is currently available but not fully tested and documented. We need to improve the test cases and code coverage. Also we must provide a chapter in the manual howto enable oauth authentication for an API endpoint.

When I hit 127.0.0.1:8080/tool/swagger I get

{ success: false, title: "PSX\Http\Exception\NotFoundException", message: "Invalid resource in /Applications/MAMP/htdocs/test/vendor/psx/framework/src/Controller/Generator/SwaggerController.php on line 69", trace: "#0 /Applications/MAMP/htdocs/test/vendor/psx/framework/src/Filter/ControllerExecutor.php(52): PSX\Framework\Controller\Generator\SwaggerController->onGet() #1 /Applications/MAMP/htdocs/test/vendor/psx/framework/src/Filter/FilterChain.php(79): PSX\Framework\Filter\ControllerExecutor->handle(Object(PSX\Http\Request), Object(PSX\Http\Response), Object(PSX\Framework\Filter\FilterChain)) #2 /Applications/MAMP/htdocs/test/vendor/psx/framework/src/Loader/Loader.php(158): PSX\Framework\Filter\FilterChain->handle(Object(PSX\Http\Request), Object(PSX\Http\Response)) #3 /Applications/MAMP/htdocs/test/vendor/psx/framework/src/Loader/Loader.php(126): PSX\Framework\Loader\Loader->executeController(Object(PSX\Framework\Controller\Generator\SwaggerController), Object(PSX\Http\Request), Object(PSX\Http\Response)) #4 /Applications/MAMP/htdocs/test/vendor/psx/framework/src/Dispatch/Dispatch.php(121): PSX\Framework\Loader\Loader->load(Object(PSX\Http\Request), Object(PSX\Http\Response), Object(PSX\Framework\Loader\Context)) #5 /Applications/MAMP/htdocs/test/public/index.php(33): PSX\Framework\Dispatch\Dispatch->route(Object(PSX\Http\Request), Object(PSX\Http\Response)) #6 /Applications/MAMP/htdocs/test/public/server.php(35): require_once('/Applications/M...') #7 {main}", context: "65 66 $this->setHeader('Content-Type', 'application/json'); 67 $this->setBody($swagger); 68 } else { 69 throw new HttpException\NotFoundException('Invalid resource'); 70 } 71 } 72 } " }

I'm following the instructions here: http://phpsx.org/get-started

I can get the /documentation but the root / and api /population return errors.

{
    "success": false,
    "title": "ReflectionException",
    "message": "Class Sample\\Api\\Index does not exist in \/home\/vagrant\/code\/x\/psx\/vendor\/psx\/framework\/src\/Dependency\/ObjectBuilder.php on line 70",
    "trace": "#0 \/home\/vagrant\/code\/x\/psx\/vendor\/psx\/framework\/src\/Dependency\/ObjectBuilder.php(70): ReflectionClass->__construct('Sample\\\\Api\\\\Inde...')\n#1 \/home\/vagrant\/code\/x\/psx\/vendor\/psx\/framework\/src\/Dispatch\/ApplicationStackFactory.php(47): PSX\\Framework\\Dependency\\ObjectBuilder->getObject('Sample\\\\Api\\\\Inde...', Array, 'PSX\\\\Framework\\\\A...')\n#2 \/home\/vagrant\/code\/x\/psx\/vendor\/psx\/framework\/src\/Loader\/CallbackResolver\/DependencyInjector.php(59): PSX\\Framework\\Dispatch\\ApplicationStackFactory->getController('Sample\\\\Api\\\\Inde...', Object(PSX\\Http\\Request), Object(PSX\\Http\\Response), Object(PSX\\Framework\\Loader\\Context))\n#3 \/home\/vagrant\/code\/x\/psx\/vendor\/psx\/framework\/src\/Loader\/Loader.php(115): PSX\\Framework\\Loader\\CallbackResolver\\DependencyInjector->resolve(Object(PSX\\Http\\Request), Object(PSX\\Http\\Response), Object(PSX\\Framework\\Loader\\Context))\n#4 \/home\/vagrant\/code\/x\/psx\/vendor\/psx\/framework\/src\/Dispatch\/Dispatch.php(121): PSX\\Framework\\Loader\\Loader->load(Object(PSX\\Http\\Request), Object(PSX\\Http\\Response), Object(PSX\\Framework\\Loader\\Context))\n#5 \/home\/vagrant\/code\/x\/psx\/vendor\/psx\/framework\/src\/Environment\/WebServer\/Engine.php(47): PSX\\Framework\\Dispatch\\Dispatch->route(Object(PSX\\Http\\Request), Object(PSX\\Http\\Response))\n#6 \/home\/vagrant\/code\/x\/psx\/vendor\/psx\/framework\/src\/Environment\/Environment.php(67): PSX\\Framework\\Environment\\WebServer\\Engine->serve(Object(PSX\\Framework\\Dispatch\\Dispatch), Object(PSX\\Framework\\Config\\Config))\n#7 \/home\/vagrant\/code\/x\/psx\/public\/index.php(28): PSX\\Framework\\Environment\\Environment->serve()\n#8 \/home\/vagrant\/code\/x\/psx\/public\/server.php(35): require_once('\/home\/vagrant\/c...')\n#9 {main}",
    "context": "66      }\n67  \n68      public function getObject($className, array $constructorArguments = array(), $instanceOf = null)\n69      {\n<b>70          $class = new ReflectionClass($className);\n<\/b>71  \n72          if ($class-&gt;getConstructor() === null) {\n73              $object = $class-&gt;newInstanceArgs([]);\n74          } else {\n"
}

{
    "success": false,
    "title": "ReflectionException",
    "message": "Class Sample\\Api\\Population\\Collection does not exist in \/home\/vagrant\/code\/x\/psx\/vendor\/psx\/framework\/src\/Dependency\/ObjectBuilder.php on line 70",
    "trace": "#0 \/home\/vagrant\/code\/x\/psx\/vendor\/psx\/framework\/src\/Dependency\/ObjectBuilder.php(70): ReflectionClass->__construct('Sample\\\\Api\\\\Popu...')\n#1 \/home\/vagrant\/code\/x\/psx\/vendor\/psx\/framework\/src\/Dispatch\/ApplicationStackFactory.php(47): PSX\\Framework\\Dependency\\ObjectBuilder->getObject('Sample\\\\Api\\\\Popu...', Array, 'PSX\\\\Framework\\\\A...')\n#2 \/home\/vagrant\/code\/x\/psx\/vendor\/psx\/framework\/src\/Loader\/CallbackResolver\/DependencyInjector.php(59): PSX\\Framework\\Dispatch\\ApplicationStackFactory->getController('Sample\\\\Api\\\\Popu...', Object(PSX\\Http\\Request), Object(PSX\\Http\\Response), Object(PSX\\Framework\\Loader\\Context))\n#3 \/home\/vagrant\/code\/x\/psx\/vendor\/psx\/framework\/src\/Loader\/Loader.php(115): PSX\\Framework\\Loader\\CallbackResolver\\DependencyInjector->resolve(Object(PSX\\Http\\Request), Object(PSX\\Http\\Response), Object(PSX\\Framework\\Loader\\Context))\n#4 \/home\/vagrant\/code\/x\/psx\/vendor\/psx\/framework\/src\/Dispatch\/Dispatch.php(121): PSX\\Framework\\Loader\\Loader->load(Object(PSX\\Http\\Request), Object(PSX\\Http\\Response), Object(PSX\\Framework\\Loader\\Context))\n#5 \/home\/vagrant\/code\/x\/psx\/vendor\/psx\/framework\/src\/Environment\/WebServer\/Engine.php(47): PSX\\Framework\\Dispatch\\Dispatch->route(Object(PSX\\Http\\Request), Object(PSX\\Http\\Response))\n#6 \/home\/vagrant\/code\/x\/psx\/vendor\/psx\/framework\/src\/Environment\/Environment.php(67): PSX\\Framework\\Environment\\WebServer\\Engine->serve(Object(PSX\\Framework\\Dispatch\\Dispatch), Object(PSX\\Framework\\Config\\Config))\n#7 \/home\/vagrant\/code\/x\/psx\/public\/index.php(28): PSX\\Framework\\Environment\\Environment->serve()\n#8 \/home\/vagrant\/code\/x\/psx\/public\/server.php(35): require_once('\/home\/vagrant\/c...')\n#9 {main}",
    "context": "66      }\n67  \n68      public function getObject($className, array $constructorArguments = array(), $instanceOf = null)\n69      {\n<b>70          $class = new ReflectionClass($className);\n<\/b>71  \n72          if ($class-&gt;getConstructor() === null) {\n73              $object = $class-&gt;newInstanceArgs([]);\n74          } else {\n"
}

Currently we generate Swagger 1.2 specification. Since 2.0 is becoming the standard we also need support for this spec. This includes roughly the following tasks;

• Add a new Swagger2 model to the psx/model component
• Add a Swagger2 generator to the psx/api component

It would be great to have a way to specify dynamic types inside a model. I.e. we have a model class like this:

class Collection
{
    /**
     * @Type("array<?>")
     */
    protected $entry;
}

In our controller we can then use this model to specify the dynamic type i.e.:

@Outgoing(code=200, schema="Collection<Sample\Model\Population>")

Then we could use the same collection with different classes. This would greatly increase the reusability of such models so we dont need to create a collection model for every type.

At the moment the HTML representation of the data is a simple <dl> with some CSS styling. We could use a more fancy JSON viewer i.e.: https://github.com/Lapple/react-json-inspector

If we have a redirect route i.e. ~/api/posts the ?format=json parameter does not work. Probably the parameters are not correctly redirected to the destination route.

It would be possible to create a JSONRpc (http://www.jsonrpc.org/specification) proxy controller which receives JSONRpc calls and redirects them to the appropriated controller and returns the reponse.

It should be possible to configure global middlewares in the configuration which are applied for every controller. Probably we should have a "pre" and "post" option so pre middlewares are applied before the controller is called and post after the controller was called.

At the moment we can validate incoming data in the scope of the JsonSchema spec. It should be possible to add a custom validator to the schema visitor so that we can add more complex validation rules i.e. check whether a value exists in a table. It should be possible to attach a validator object to the schema visitor. The validator applies then all validation rules.

At the moment it is not possible to define an value which contains different types. It is only possible to set one specific type. This could be implemented by JsonSchema with "oneOf" and by XSD with "xsd:choice".