Initial commit

Author: gnrfan

.gitignore

@@ -0,0 +1,7 @@
+## generic files to ignore
+*~
+*.lock
+*.DS_Store
+*.swp
+*.swo
+*.out

.htaccess

@@ -0,0 +1,4 @@
+RewriteEngine On
+RewriteCond %{REQUEST_FILENAME} !-f
+RewriteCond %{REQUEST_FILENAME} !-d
+RewriteRule ^(.+)$ index.php/$1

README.md

@@ -0,0 +1,40 @@
+Stradlin
+========
+
+Severely minimal PHP routing microframework inspired by Sinatra that is specially useful for prototyping RESTful APIs.
+
+Usage example:
+
+```php
+
+require_once('stradlin.php');
+
+route('/hello/(?P<name>\w+)/?', all_verbs(), function($params) {
+  $name = $params['name'];
+  if (is_numeric($name)) {
+    set_status_code(400); /* Bad Request */
+    $doc = array(
+      "status" => "error",
+      "errors" => array(
+        "Come on! Your name can't be numeric! Are you a clone trooper or what?"
+      )
+    );
+  } else {
+    $doc = array(
+      "status" => "ok",
+      "data" => array(
+        "greeting" => "Hello Mr. or Mrs. $name!!! Welcome to Stradlin :)"
+      )
+    );
+  }
+  serve_json($doc, JSON_PRETTY_PRINT);
+});
+```
+
+In order to have the clean URLs working please use the provided .htaccess file for Apache and write/include your controllers from index.php or simple adapt it to suit your needs.
+
+Speaking of controllers, this microframework should have been called 'Axl', that's a real control freak! :)
+
+For more information please read the freaking sources and please stay tuned.
+
+(c) 2012 - Bit Zeppelin S.A.C. - Developed by Antonio Ognio a.k.a @gnrfan

stradlin.php

@@ -0,0 +1,117 @@
+<?php
+
+function serve_json($doc, $options = 0) {
+  set_content_type('application/json');
+  $doc = json_encode($doc, $options);
+  if (array_key_exists('HTTP_JSONP_CALLBACK', $_SERVER) && strlen($_SERVER['HTTP_JSONP_CALLBACK'])>0) {
+    $callback = $_SERVER['HTTP_JSONP_CALLBACK'];
+    printf("%s(\"%s\");\n", $callback, addslashes($doc));
+  } else {
+    echo $doc;
+  }
+}
+
+function get_request_uri() {
+  return $_SERVER['REDIRECT_URL'];
+}
+
+function request_method_matches($methods) {
+  return in_array($_SERVER['REQUEST_METHOD'], $methods);
+}
+
+function route($regexp, $methods, $callback) {
+
+  /* Sanitize regexp */
+  if (!preg_match('/^\^(.)+$/', $regexp)) {
+    $regexp = sprintf("^%s", $regexp);
+  }
+  if (!preg_match('/^(.)+\$$/', $regexp)) {
+    $regexp = sprintf("%s$", $regexp);
+  }
+  $regexp = str_replace("/", "\/", $regexp);
+  $regexp = sprintf("/%s/", $regexp);
+
+  /* Create array of accepted HTTP methods */
+  $methods = split(",", $methods) ;
+  foreach($methods as $k=>$v) {
+    $methods[$k] = trim(strtoupper($v));
+  } 
+
+  /* Match */
+  $uri = get_request_uri();
+  if (request_method_matches($methods) && preg_match($regexp, $uri, $params)) {
+    $callback($params);
+  }
+
+}
+
+function status_code_map() {
+  return array(
+    200 => 'OK',
+    201 => 'Created',
+    202 => 'Accepted',
+    203 => 'Non',
+    204 => 'No Content',
+    205 => 'Reset Content',
+    206 => 'Partial Content',
+    300 => 'Multiple Choices',
+    301 => 'Moved Permanently',
+    302 => 'Found',
+    303 => 'See Other',
+    304 => 'Not Modified',
+    305 => 'Use Proxy',
+    307 => 'Temporary Redirect',
+    400 => 'Bad Request',
+    401 => 'Unauthorized',
+    402 => 'Payment Required',
+    403 => 'Forbidden',
+    404 => 'Not Found',
+    405 => 'Method Not Allowed',
+    406 => 'Not Acceptable',
+    407 => 'Proxy Authentication Required',
+    408 => 'Request Timeout',
+    409 => 'Conflict',
+    410 => 'Gone',
+    411 => 'Length Required',
+    412 => 'Precondition Failed',
+    413 => 'Request Entity Too Large',
+    414 => 'Request',
+    415 => 'Unsupported Media Type',
+    416 => 'Requested Range Not Satisfiable',
+    417 => 'Expectation Failed',
+    500 => 'Internal Server Error',
+    501 => 'Not Implemented',
+    502 => 'Bad Gateway',
+    503 => 'Service Unavailable',
+    504 => 'Gateway Timeout',
+    505 => 'HTTP Version Not Supported',
+  );
+}
+
+function set_content_type($content_type) {
+  header("Content-Type: $content_type");
+}
+
+function set_status_code($status_code) {
+  $map = status_code_map();
+  header(sprintf("HTTP/1.1 %d %s", $status_code, strtoupper($map[$status_code])));
+}
+
+function all_verbs_array() {
+  return array(
+    "OPTIONS",
+    "GET",
+    "HEAD",
+    "POST",
+    "PUT",
+    "DELETE",
+    "TRACE",
+    "CONNECT"
+  );
+}
+
+function all_verbs() {
+  return implode(", ", all_verbs_array());
+}
+
+?>