limenius/filesystem-router-bundle

Symfony router for static pages

dev-master 2020-06-24 12:46 UTC

This package is auto-updated.

Last update: 2024-10-24 22:38:56 UTC


README

This bundle provides a Symfony chained router that adds routes for static files in a directory.

Use case: You may want to integrate the product of a static content generator engine (Sphinx, Jekyll, you name it), or you simply have some html files in a directory and you want them to be a route in your Symfony app, because you want, for instance, to...

  • Embed a bunch of static html documents into a Twig template, with a menu, a sidebar.
  • Generate routes to them.
  • Preprocess them extracting for instance the title.
  • ...

Usage

Installation

Open a command console, enter your project directory and execute the following command to download the latest stable version of this bundle:

$ composer require limenius/filesystem-router-bundle

Configuration

This bundle uses the Symfony CMF Dynamic router, so we need to configure it in our app/config.yml file:

cmf_routing:
    chain:
        routers_by_id:
            router.default: 200
            cmf_routing.dynamic_router: 100
    dynamic:
        route_provider_service_id: limenius_filesystem_router.route_provider
        templates_by_class:
            Limenius\Bundle\FilesystemRouterBundle\Document\ContentDocument: MyBundle:MyController:my_template.html.twig

Where in the last line, we have specified the template that will deal with the static content.

Also, we add some lines to confgure the bundle

limenius_filesystem_router:
    collections:
        Docs:
            path: "%kernel.root_dir%/Resources/my_static_directory/"
            prefix: doc

collections is a list of directories that you want to route. Every collection have a required path and an optional prefix. This bundle will create a route for every html file found recursively in the path.

The template that we have specified will have a contentDocument available:

{{ contentDocument |raw }}    

Custom controller

We can specify the controller that will receive the document with configuring the dynamic router with:

cmf_routing:
    chain:
        routers_by_id:
            router.default: 200
            cmf_routing.dynamic_router: 100
    dynamic:
        route_provider_service_id: limenius_filesystem_router.route_provider
        controllers_by_type:
            filesystem_route: Acme\MyBundle\Controller\MyController::myAction

Where in the last line, we have specified the action that will deal with the static content.

The action will receive the contents of the file in the variable $contentDocument.

It can be as simple as:

/**
 * @Template()
 */
public function docsAction($contentDocument)
{
    return array('content' => $contentDocument);
}

With a template containing:

{{ content | raw }}    

Of course you can preprocess the document dealing with $contentDocument, for instance crawling it to extract the title or other information.

Check out your new routes with the app/console router:debug command.

Route generation

Use the path of your file as in <a href="{{ url('manual/index.html')}}">Documentation</a>

Files exposed

By default, this bundle will only expose files with the extension html. You can configure it with the option extensions_exposed:

limenius_filesystem_router:
    collections:
        Docs:
            path: "%kernel.root_dir%/Resources/my_docs/_build/html"
            prefix: docs
            extensions_exposed: ['html', 'txt']

License

This bundle is under the MIT license. See the complete license in the file:

LICENSE.md