1 <?php
  2 
  3 #######################################################################################
  4 ####
  5 ####    MAGRATHEA PHP
  6 ####    v. 1.0
  7 ####
  8 ####    Magrathea by Paulo Henrique Martins
  9 ####    Platypus technology
 10 ####
 11 #######################################################################################
 12 ####    
 13 ####    created: 2012-12 by Paulo Martins
 14 ####
 15 #######################################################################################
 16 
 17 /**
 18  * Can define routes and gives main paths for controllers and actions
 19  */
 20 class MagratheaRoute {
 21 
 22     private $defaultControl = "Home";
 23     private $defaultAction = "Index";
 24     private $routes = null;
 25     private $controllers = array();
 26 
 27     protected static $inst = null;
 28     public static function Instance(){
 29         if(!isset(self::$inst)){
 30             self::$inst = new MagratheaRoute();
 31         }
 32         return self::$inst;
 33     }
 34     /**
 35      * private constructor for singleton
 36      */
 37     private function MagratheaRoute(){}
 38 
 39     /**
 40      * Set an array of routes
 41      * @param   array   $routes     routes to follow
 42      * @return  itself
 43      */
 44     public function SetRoute($routes){
 45         $this->routes = array_change_key_case( array_map('strtolower', $routes), CASE_LOWER );
 46         foreach ($this->routes as $key => $value) {
 47             $r = explode("/", $key);
 48             if(empty($r[1]))
 49                 $this->controllers[$r[0]][0] = $value;
 50             else
 51                 $this->controllers[$r[0]][$r[1]] = $value;
 52         }
 53         return $this;
 54     }
 55 
 56     /**
 57      * Set default control and action
 58      * @param string $control default control
 59      * @param string $action  default action
 60      * @return  itself
 61      */
 62     public function Defaults($control="Home", $action="Index"){
 63         $this->defaultControl = $control;
 64         $this->defaultAction = $action;
 65         return $this;
 66     }
 67 
 68     /**
 69      * Creates the route
 70      * @param   *string     &$control       var to control
 71      * @param   *string     &$action        var to action
 72      * @param   *array      &$params        var to parameters
 73      * @return  itself
 74      */
 75     public function Route(&$control, &$action, &$params=null){
 76         $params = array();
 77         if(!@empty($_GET["magrathea_control"])) $control = $_GET["magrathea_control"];
 78         if(!@empty($_GET["magrathea_action"])) $action = $_GET["magrathea_action"];
 79         if(!@empty($_GET["magrathea_params"])) $params = $_GET["magrathea_params"];
 80         $control = strtolower($control);
 81         $action = strtolower($action);
 82         $this->LookForRoute($control, $action, $params);
 83         if(empty($control)) $control = strtolower($this->defaultControl);
 84         if(empty($action)) $action = strtolower($this->defaultAction);
 85         return $this;
 86     }
 87 
 88     /**
 89      * Look for sent route and check if there's an alternative
 90      * @param   string  $control    control
 91      * @param   string  $action     action
 92      * @param   array   $params     params
 93      * @todo so far we are only accepting full routes. I want this to accept controls, action and everything else!
 94      */
 95     private function LookForRoute(&$control, &$action, &$params){
 96 //      $url = $this->RebuildUrl($control, $action, $params);
 97         if( empty($this->controllers[$control]) ) return;
 98         if( !empty($this->controllers[$control][$action]) ){
 99             $newRoute = $this->UnbuildUrl($this->controllers[$control][$action]);
100         } else {
101             if( !empty($this->controllers[$control][0]) )
102                 $newRoute = $this->UnbuildUrl($this->controllers[$control][0]);
103             else
104                 return;
105         }
106         if(!empty($newRoute["control"])) $control = $newRoute["control"];
107         if(!empty($newRoute["action"])) $action = $newRoute["action"];
108         if(!empty($newRoute["params"])) $params = $newRoute["params"];
109     }
110 
111     /**
112      * gets data and rebuilds the sent url
113      * @param   string  $control    control
114      * @param   string  $action     action
115      * @param   array   $params     params
116      * @return  string  url rebuilt
117      */
118     public function RebuildUrl($control="", $action="", $params=""){
119         $url = $control;
120         if(empty($action)) return $url;
121         $url .= "/".$action;
122         if(empty($params)) return $url;
123         $url .= "/".$params;
124         return $url;
125     }
126 
127     /**
128      * gets an url, splits it and returns an array with control, action and params
129      * @param   string      $url        url to be parsed
130      * @return  array       array("control" => ..., "action" => ..., "params" => ...);
131      * @todo  test this further...
132      */
133     public function UnbuildUrl($url){
134         $parse = explode("/", $url);
135         $ret = array();
136         $ret["control"] = $parse[0];
137         if(!empty($parse[1])) $ret["action"] = $parse[1];
138         if(!empty($parse[2])) $ret["params"] = $parse[2];
139         return $ret;
140     }
141 
142 
143 }
144 
145 
146 ?>