Yesterday I was finally able to release a new version of Disco which comes with 4 major changes that I want to highlight briefly in this blog post.
When it comes to reading and returning the contents of a file in a PSR-7 middleware most developers seem use code that does the following: Read the file first, then write it to the response body.
When I came up with the idea to build a PSR-7 based flat-file CMS I thought that it must be fairly trivial to build a static page exporter by simply "faking" requests and storing the resulting responses. Turns out I was right and this an quick recap of what I did ;)
I was looking for a way to show how our libraries like Adrenaline, Pathfinder and Disco work in a "real world" application. I came up with the idea to build just another simple flat-file CMS. AddItEasy might be the first flat-file CMS based on a PSR-7 implementation which adds a nice touch: We can easily create a static file export from the content. That means that you do not need to upload addItEasy to your server, you can simply export the files and e.g. let GitHub host the static HTML pages.
In the course of polishing the Adroit v.0.4.0 release we realized that it would totally make sense to turn Adroit into an own separate (micro) web framework to be able to set up projects quickly. Whilst the focus of Adroit was to provide a PSR-7 compatible middleware for ADR we came up with the idea to create a separate package which we named Adrenaline.
Over the course of the last few months we worked hard to improve our Adroit middleware. The result is the recently released version v0.4.0 which turned Adroit into a "real" ADR / PSR-7 middleware. We extracted the routing component into a separate package called Pathfinder and splitted "monolithic" middleware into smaller components. In addition to that we introduced the concept of several hooks to be able to add "custom logic" in between the execution of the different steps in the ADR workflow.
In our attempt to convert parts of our own internal company framework into a set of open-source components we did not find a routing package that was fully PSR-7 compatible and was able to also generate uris based on the routing definitions. Initially the routing component was part of our Adroit middleware, a middleware focused on PSR-7 as well as the ADR pattern. During our attempt to turn Adroit into a (micro) web framework called Adrenaline we also extracted the routing component into a separate package.
One problem with releasing open-source components is that code is not the only thing you should care about. Without a decent documentation no one is able to use your component. Sad to say we are guilty as well, e.g. the documentation for Disco our annotation-based PHP Dependency Injection container lacks in in-depth documentation.
Am 31.05.2016 trifft sich die PHP Usergroup Rheinhessen zum 41. Mal. Ich freue mich nach langer Abwesenheit wieder einmal dabei sein zu können und meinen Vortrag "Microservices: Klein, aber oho!" präsentieren zu dürfen.
If you run the command: