Download the PHP package tcdev/macaw without Composer
On this page you can find all versions of the php package tcdev/macaw. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package macaw
Macaw
Macaw is a simple, open source PHP router. It's super small (~150 LOC), fast, and has some great annotated source code. This class allows you to just throw it into your project and start using it immediately.
Install
If you have Composer, just include Macaw as a project dependency in your composer.json
. If you don't just install it by downloading the .ZIP file and extracting it to your project directory.
Examples
First, use
the Macaw namespace:
Macaw is not an object, so you can just make direct operations to the class. Here's the Hello World:
You can specify a prefix which will be added to all of your routes. This is useful to prevent duplication if you know you're running behind a particular URL that isn't always defined by the directory you're executing from. For example, if you know your file is accessed at /subfolder/somewhere-else/
, you can:
Macaw also supports lambda URIs, such as:
You can also make requests for HTTP methods in Macaw, so you could also do:
You may want to stop execution once a matching route is found. Without the call to haltOnMatch()
below, if you requested /
, you would see both 'Hello world!' and 'I am further execution...' displayed. To prevent that, simply add the line:
If you need to overwrite the HTTP method that's being used for this request, you can set it:
Lastly, if there is no route defined for a certain location, you can make Macaw run a custom callback, like:
If you don't specify an error callback, Macaw will just echo 404
.
In order to let the server know the URI does not point to a real file, you may need to use one of the example configuration files.