README

bedouin

A file-based PHP routing system.

Two files:

• cartograph.php script that generates the map file
• bedouin.php script that routes according to the map file

installation

composer require mark-veres/bedouin

example setup

# index.php
require_once "bedouin.php";

$router = new \Bedouin\Router;
$router->loadMap("map.json");
$route = $router->currentRoute();
if (isset($route->file)) include $route->file;

# gen_map.php
require_once "./cartograph.php";
$cart = new \Bedouin\Cartograph;
$cart->root_dir = __DIR__;
$cart->route_folders = ["./routes", "./api"];
$cart->printMap("map.json");

usage

• copy the bedouin.php and cartograph.php files in the desired directory
• create the routes and static directory
• create an index.php file will handle all requests
• redirect all requests to index.php
• create another PHP file that will use the cartograph API to generate the map

directory structure

404 pages

• create a 404.php file in the routes folder
• this file does not support custom HTTP methods

static files

• put all your static files in the static directory
• access these files at the /static/* url
• file names are case- and extension-sensitive

accessing route parameters

• given a route /posts/[slug]
• and an url /posts/test

$router = new \Bedouin\Router;
// ...
print_r($router->params);
/*
  Array ( [slug] => test )
*/

middleware

• create a file ending in .mw.php or .mw.get.php (or any HTTP method for that matter)
• the middleware will be "bound" to the index handler of the directory it is placed in

Note

coming soon:

• map splits (performance optimization when dealing with many routes)
• templates

Tip

Redirecting all requests to bedouin.php on an Apache server.

RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)＄ index.php

Tip

Redirecting all requests to bedouin.php with the PHP built-in server

php -S localhost:8080 bedouin.php

Tip

Regenerating the map by accessing a specific route.

# index.php
require_once "bedouin.php";

if ($_SERVER["REQUEST_URI"] == "/your/custom/path") {
  require_once "./cartograph.php";
  $cart = new \Bedouin\Cartograph;
  $cart->printMap("map.json");
}

$router = new \Bedouin\Router;
$router->loadMap("map.json");
$route = $router->currentRoute();
if (isset($route->file)) include $route->file;