一个请求的例子,看起来像这样:
<A href="http://example.com/index.php?module=login">http://example.com/index.php?module=login</A>
这看起来很简单,但是在实现的过程中却不是。这里是几个控制器能识别的argument部分:
module定义了使用哪一个模块,如users模块 class定义了使用哪一个功能类,如你想让用户login还是logout event定义了使用哪一个具体事件
这样一个更复杂的例子可以解释上面的各个argument最终组成的请求URL:
<A href="http://example.com/index.php?module=users&class=login">http://example.com/index.php?module=users&class=login</A>
这段请求告诉控制器应该载入users模块,然后是login类,最后因为没有定义具体事件,所以运行login::__default()默认事件。
以下是具体代码部分:
<?php /** * index.php * * @author Joe Stump <<A href="mailto:joe@joestump.net">joe@joestump.net</A>> * @copyright Joe Stump <<A href="mailto:joe@joestump.net">joe@joestump.net</A>> * @license <A href="http://www.opensource.org/licenses/gpl-license.php">http://www.opensource.org/licenses/gpl-license.php</A> * @package Framework */
require_once('config.php');
// {{{ __autoload($class) /** * __autoload * * Autoload is ran by PHP when it can't find a class it is trying to load. * By naming our classes intelligently we should be able to load most classes * dynamically. * * @author Joe Stump <<A href="mailto:joe@joestump.net">joe@joestump.net</A>> * @param string $class Class name we're trying to load * @return void * @package Framework */
function __autoload($class) { $file = str_replace('_','/',substr($class,2)).'.php'; require_once(FR_BASE_PATH.'/includes/'.$file); } // }}}
if (isset($_GET['module'])) { $module = $_GET['module']; if (isset($_GET['event'])) { $event = $_GET['event']; } else { $event = '__default'; }
if (isset($_GET['class'])) { $class = $_GET['class']; } else { $class = $module; }
$classFile = FR_BASE_PATH.'/modules/'.$module.'/'.$class.'.php'; if (file_exists($classFile)) { require_once($classFile); if (class_exists($class)) { try { $instance = new $class(); if (!FR_Module::isValid($instance)) { die("Requested module is not a valid framework module!"); }
$instance->moduleName = $module; if ($instance->authenticate()) { try { $result = $instance->$event(); if (!PEAR::isError($result)) { $presenter = FR_Presenter::factory($instance->presenter,$instance);
if (!PEAR::isError($presenter)) { $presenter->display(); } else { die($presenter->getMessage()); } } } catch (Exception $error) { die($error->getMessage()); } } else { die("You do not have access to the requested page!"); } } catch (Exception $error) { die($error->getMessage()); } } else { die("An valid module for your request was not found"); } } else { die("Could not find: $classFile"); } } else { die("A valid module was not specified");}
?>
接下来是以上代码具体的注释:
载入“config.php”
定义__autoload()函数。这是PHP5里面的一个新函数,方便动态地载入各个类。
如果一个argument被定义,那么载入相关的模块、类和具体事件
接下来就是一些判断以及错误的具体操作
最后一切无误后就载入表述层
【友好URL】
如果你觉得上面例子讲到的请求URL让你觉得不舒服的话,那么就用mod_rewrite来实现友好URL吧。接下来是作者给这个框架写的实际重写标准代码:
RewriteEngine On
# Change the URI here to whatever you want your homepage to be
RewriteRule ^/$ /index.php?module=welcome [L,QSA]
# Changes /index.php?module=welcome to /welcome
RewriteCond %{DOCUMENT_ROOT}/%{REQUEST_FILENAME} !-d
RewriteCond %{DOCUMENT_ROOT}/%{REQUEST_FILENAME} !-f
RewriteRule ^/([^/]*)$ /index.php?module=$1 [L,QSA]
# Changes /index.php?module=users&class=login to /users/login
RewriteCond %{DOCUMENT_ROOT}/%{REQUEST_FILENAME} !-d
RewriteCond %{DOCUMENT_ROOT}/%{REQUEST_FILENAME} !-f
RewriteRule ^/([^/]*)/([^/]*)$ /index.php?module=$1&class=$2 [L,QSA]
# Changes /index.php?module=users&class=login&event=foo
# to /users/login/foo.html
RewriteCond %{DOCUMENT_ROOT}/%{REQUEST_FILENAME} !-d
RewriteCond %{DOCUMENT_ROOT}/%{REQUEST_FILENAME} !-f
RewriteRule ^/([^/]*)/([^/]*)/([^/]*).html$ \
/index.php?module=$1&class=$2&event=$3 [L,QSA]
Extending the Controller
【扩展控制器】
拥有一个集中控制器的一点好处就是你加入一些功能后,马上就能通过控制器体现出来。以下是几个可以扩展一下这个控制器的点子,使这个框架的整体能力更加强大: 你可以使用PHP5里一个新东西SoapServer来自动检测一个请求是否为SOAP
你可以使用控制器来过滤所有的自动全局变量如$_GET和$_POST以防止恶意HTML代码等
你可以使用控制器即时地转换表述层,比如从默认的方式转到PDF方式
你可以直接在控制器中加入缓存机制,这样的好处是应用程序整体都能使用到缓存以提高效率
当然,需要注意一点的是,你在控制器中所增加的功能将体现在程序全局。如你想过滤所有的自动全局变量,但是很多应用程序的管理员需要使用到一些HTML代码,反而成为一件棘手的事情(译者注:本人的想法是可以加一个if条件语句,在加载特定模块时不应用过滤功能即可)。