Sloth Framework

Lazy Routes learned from Sinatra Routes!

The context of route callback handler is the called. Commonly, it is the \Sloths\Application\Application. So every properties, methods of the context is available within the callback handler.

Routes are matched in the order they are defined. The first route that matches the request is invoked unless you call pass() within the route callback, the process will be matching the next route.

Route patterns can be static pattern:

    $this->get('/foo', function() {
        # matches "GET /foo" but not "GET /bar"
    });

Or includes named parameters:

    $this->get('/hello/:name', function($name) {
        # matches "GET /hello/foo" and "GET /hello/bar"
        # $name is 'foo' or 'bar'
    });

Or named parameters with double colon:

Named parameters with double colon only matches the numeric value.

    $this->get('/posts/::id', function($id) {
        # matches "GET /posts/123"
        # $id is 123
    });

Or Includes wildcard parameters:

    $this->get('/say/*/to/*', function($splat) {
        # matches "GET /say/hello/to/world"
        $splat # => ['hello', 'world']
    });

    $this->get('/download/*.*', function($splat) {
        # matches "GET /download/path/to/file.zip"
        $splat # => ['path/to/file', 'zip']
    });

Or With Regular Expressions: (Regex pattern should start with # character)

    $this->get('#/hello/(\w+)', function($name) {
        # matches "GET /hello/foo"
        # $name is 'foo'
    };

Route patterns may have optional parameters:

    $this->get('/posts.?:format?', function($format) {
        # matches "GET /posts" and any extension "GET /posts.xml", "GET /posts.json" etc.
        # $format is "null" or "xml" or "json"
    });

Access to request parameters:

    $this->get('/posts', function() {
        # matches "GET /posts?author=foo"
        $author = $this->params->author; # => "foo"
        $author = $this->param('author'); # => "foo"
    });

Return Values

Most commonly, this is a string. But other values are also accepted.

The return values will be send to response body. It mean if return values is an array or object, the response object will be send it as json string and the content type header is application/json.

    $this->get('/posts?.format?', function($format) {
        $posts = Post::all();

        if ('json' == $format) {
            return $posts;
        }

        return $this->render('/posts/list', ['posts' => $posts]);
    });

Simple CRUD Routes

application\routes\posts.php

    # GET /posts
    $this->get('/', function() {
        $posts = Post::all();

        return $this->render('posts/list', [
            'posts' => $posts
        ]);
    });

    # GET /posts/123
    $this->get('/::id', function($id) {
        $post = Post::first($id);
        $post || $this->notFound();

        return $this->render('posts/view', [
            'post' => $post
        ]);
    });

    # GET /posts/new
    $this->get('/new', function() {
        return $this->render('posts/new');
    });

    # POST /posts
    $this->post('/', function() {
        $post = Post::create($this->post);
        $post->save();

        $this->redirectTo('/posts/' . $post->id);
    });

    # GET /posts/123/edit
    $this->get('/::id/edit', function($id) {
        //...
    });

    # PUT /posts/123
    $this->put('/::id', function($id) {
        $post = Post::first($id);
        $post || $this->notFound();

        $post->fromArray($this->post);
        $post->save();

        $this->redirectBack();
    });

    # DELETE /posts/123
    $this->delete('/::id', function($id) {
        $post = Post::first($id);
        $post || $this->notFound();

        $post->delete();
        $this->redirectTo('/posts');
    });

Routing

Access to request parameters:

Return Values

Simple CRUD Routes