Download the PHP package mindplay/timber without Composer
On this page you can find all versions of the php package mindplay/timber. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package timber
mindplay/timber
Timber is a router library with regular expression support, high performance, and a developer-friendly, human-readable API.
Installation
Install the latest version with composer require mindplay/timber
Introduction
This package provides a minimal router facility: a place to register path patterns, and a means of resolving these to controller names.
Usage
In the examples below, we assume that handlers (attached using get(), post(), etc.)
are controller class-names - in your application, they might be component IDs for a DI
container, file-names, or whatever else you like.
Basic usage of the router looks like this:
If you're building a set of routes under the same parent route, you can continue building from a parent route - for example:
This example will route /admin to AdminMenu, and /admin/users to AdminUserList, etc.
This also feature enables modular reuse of route definitions - for example:
This example creates two identical sets of routes for displaying and posting comments for two different parent routes.
Optimization
You can save and restore the defined routes:
The point is, you can serialize/unserialize the routes that have been built, and store them in a cache somewhere, to avoid the initialization overhead. For most projects, this would be considered a micro-optimization - the overhead of building an extremely high number of routes (hundreds or thousands) may make this worthwhile in a very large modular project.
Hacking
To run the test-suite, navigate to the project root folder and type:
php test/test.phpDesign Notes
During the development of this library, a design problem was identified, which required us to make a trade-off. This library did at one point have URL creation as a feature, but after carefully weighing the pros and cons, it was decided to forego this feature, in favor of simpler implementation and support for caching.
Use-cases for three different approaches were explored and evaluated - our whiteboard summarizes the pros and cons as we saw them, and the approach without URL creation was unanimously our favorite, as it leads to the greatest simplicity, both in the library and in the use-case, and supports caching.
The first trade-off is that we don't get to use closures (which can't be serialized) and thereby do not
get any direct static coupling between the route and controller/action/params - we do get static coupling
to the controller class-name, by using the ::class constant.
The other trade-off is that we can't have a URL creation feature within the router itself, as this leads to either complexity (with the addition of a named route registry as per case 1) or prevents caching (as per case 2 - after some discussion, we decided URL creation provides only a small benefit, guaranteeing that URL creation is consistent with defined patterns; but also, we value the freedom to fully customize URL creation on a case-by-case basis using simpler code (as per case 3) and as such the absence of URL creation can actually be seen as a benefit.
Acknowledgements
Timber started as a fork of TreeRoute by Vadim Baryshev, the API and feature-set quickly grew into something else entirely. What does carry over from the original fork, is great performance.
