PHP Classes

How Can a PHP Simple Router Class Can Process HTTP Request Invoking Callback Functions Using the Class mu: Handle HTTP requests using callback functions

Recommend this page to a friend!
     
  Info   Example   View files Files   Install with Composer Install with Composer   Download Download   Reputation   Support forum   Blog    
Last Updated Ratings Unique User Downloads Download Rankings
2024-08-02 (8 days ago) RSS 2.0 feedNot yet rated by the usersTotal: 22 This week: 21All time: 11,229 This week: 3Up
Version License PHP version Categories
mu 1.0.0MIT/X Consortium ...5HTTP, PHP 5, Design Patterns
Description 

Author

This package can handle HTTP requests using callback functions.

It provides a class that can associate an HTTP method and request URL paths to given callback functions.

The class can process the current request by calling the registered callback functions depending on the HTTP method and URL path.

Picture of Stefano Azzolini
  Performance   Level  
Name: Stefano Azzolini <contact>
Classes: 5 packages by
Country: Italy Italy
Innovation award
Innovation award
Nominee: 3x

Example

<?php

/**
 * µ PHP microframework
 *
 * @author Stefano Azzolini <lastguest@gmail.com>
 */


include 'mu.php';

/**
*
* Define routes callbacks with this syntax :
* µ::METHOD('ROUTE',CALLBACK);
*
* - METHOD can be GET,POST,PUT,DELETE,HEAD or some custom HTTP verb
* - ROUTE is the URL path fragment
* - CALLBACK is a callable object () invoked by the router.
*/


µ::GET('/',function(){
    echo
'What is your name?';
    echo
'<form method=post><input type=text name=username><input type=submit></form>';
});

/**
* This is executed only when the browser call a POST on '/' route
*/

µ::POST('/',function(){
    echo
'Hello ',$_POST['username'],', how are you?';
});


/**
* Invoke the phpinfo function on /php/info route
*/

µ::GET('/php/info','phpinfo');


/**
* Run the application
*/

µ::_();


Details

µ

a PHP micro URL router in only 140 bytes. (99 bytes in hardcore branch)

Scrutinizer Quality Score

Warning: This is a pure proof of concept of a tweet-sized URL router

DO NOT USE IT IN PRODUCTION!

class µ{static function __callStatic($n,$a){static$r;$n==@_?($_=@$r[getenv(REQUEST_METHOD).getenv(REQUEST_URI)])&&$_():$r[$n.$a[0]]=$a[1];}}

How to use

Step 1: Define routes callbacks

µ::GET('/',function(){
    echo 'What is your name?';
    echo '<form method=post><input type=text name=username><input type=submit></form>';
});

µ::POST('/',function(){
    echo 'Hello ',$_POST['username'],', how are you?';
});

Step 2: Run the app


µ::_();

Step 3: Breath.

Thanks

celtric

David Pennington (Xeoncross)

Tyler Romeo (Parent5446)

Commented source


class µ {
    public static function __callStatic($functionName,$functionParameters){
        static $callbackMap;
        
        // Check if we must resolve the request
        if($functionName == '_'){
        
            // Compose the method+uri key and
            // invoke the callback (silence failures)
        
            ($callback = @$callbackMap[getenv(REQUEST_METHOD).getenv(REQUEST_URI)]) && $callback();
        
        } else {
        
            // Add the route handler to the callbackMap
            // $functionName is the Request HTTP Method
            // $functionParameters[0] is the route
            // $functionParameters[1] is the callback
        
            $callbackMap[$functionName.$functionParameters[0]] = $functionParameters[1];
        }
    }
}

License (MIT)

Copyright (c) 2012 Stefano Azzolini

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Bitdeli Badge


  Files folder image Files (5)  
File Role Description
Accessible without login Plain text file composer.json Data Auxiliary data
Accessible without login Plain text file htaccess.txt Doc. Documentation
Accessible without login Plain text file index.php Example Example script
Plain text file mu.php Class Class source
Accessible without login Plain text file README.md Doc. Documentation

The PHP Classes site has supported package installation using the Composer tool since 2013, as you may verify by reading this instructions page.
Install with Composer Install with Composer
 Version Control Unique User Downloads Download Rankings  
 100%
Total:22
This week:21
All time:11,229
This week:3Up