标签 router 下的文章

上一节

时光匆匆,我们终于来到路由工作的地方。几乎每个MVC框架都不会缺少路由功能,因为他实在太重要了。

路由的功能简单的说就是根据请求找到对应业务代码,请求来自外部,业务由系统提供,路由器为二者建立了可靠的链接。

typecho和thinkphp都有路由模块,虽然实现方式不同,但用法却惊人的相似!

thinkphp:

Dispatcher::dispatch();

typecho:

Typecho_Router::dispatch();

typecho的路由实现是保存在数据库中的路由表,使用正则匹配路径,这一点和Django框架有点像,thinkphp则是基于自己设定的一套规则,详见官方文档

typecho的路由表如下数组组成,路由器类会使用子数组中的regx正则式逐个匹配pathinfo中的路径,如果匹配成功,立即初始化并执行该类对应的action。

以index为例,如果使用正则表达式匹配成功,系统就会新建Widget_Archive类并执行其render方法,看他的名字就知道执行的是渲染页面的方法,也就是之前说的业务

Array
(
    [index] => Array
        (
            [url] => /
            [widget] => Widget_Archive
            [action] => render
            [regx] => |^[/]?$|
            [format] => /
            [params] => Array
                (
                )

        )

    [archive] => Array
        (
            [url] => /blog/
            [widget] => Widget_Archive
            [action] => render
            [regx] => |^/blog[/]?$|
            [format] => /blog/
            [params] => Array
                (
                )

        )
    # ....

有的同学可能会说,typecho的路由表写在数据库里,不够灵活。其实作者也考虑到了,大家可以自由扩展路由表。有兴趣的同学可以去看看Helper类中addRoute和removeRoute的用法。举个例子,如果你需要自定义一个URL,比如www.phpgao.com/robots.txt,就可以在路由表加入如下路由:

[robots] => Array
        (
            [url] => /robots.txt
            [widget] => Robots_Action
            [action] => render
        )

需要注意的是:

  • 新建路由时只需要url widget action 三个参数就够了
  • 如果url中包含参数,需要在url体现,具体实现请看var/Typecho/Router/Parser.php中的parse方法
  • 不需要担心widget方法找不到你的类,因为插件的安装路径已经在config.inc.php文件中加入了包含路径
  • 路由的参数和正则表达式系统自动生成
  • 在初始化阶段,Widget_Options类做了一个优化,具体在execute方法的最后,动作是将解析后的路由表保存在键值为0的数组里,以后初始化的时候先看看有没有缓存,这个缓存在路由删除或新建的时候会被删除,可参考var/Helper.php中的addRoute和removeRoute。

URL中如果有参数,以page为例,使用规则如下:

[page] => Array
        (
            [url] => /[slug].html
            [widget] => Widget_Archive
            [action] => render
        )

其中[]里的slug即参数名称,此处没有限定参数格式,默认为char,如果想要限定格式,就必须参照Typecho_Router_Parser类的_defaultRegx属性,即:

$this->_defaultRegx = array(
            'string' => '(.%s)',
            'char'   => '([^/]%s)',
            'digital'=> '([0-9]%s)',
            'alpha'  => '([_0-9a-zA-Z-]%s)',
            'alphaslash'  => '([_0-9a-zA-Z-/]%s)',
            'split'  => '((?:[^/]+/)%s[^/]+)',
        );

如果想限定参数为数字,那么[url] => /[slug].html需要改为[url] => /[slug:digital].html

如果需要精确限定次数,即4个数字,格式为[url] => /[slug:digital:4].html

如果需要限定次数在某个范围,即1-4个数字,格式为[url] => /[slug:digital:1:4].html

其他格式同理。

如果要某个插件要添加action而不需要绑定到某个URL怎么办?

如默认文章发布提交的地址为

/action/contents-post-edit?_=XXX

现在我想扩充这个地址,想要系统能够处理图片的发布怎么办?

/action/picture-post-edit?_=XXX

答:

我们可以注意到Helper::addAction方法,该方法接收两个参数,action名字和执行action使用的类名。

也就是说我们绑定某个action到插件的action.php文件的action()方法中去,当Widget_Do在处理从Dispatcher::dispatch()接收到的参数后,Widget_Do会在自己的MAP属性(系统默认)和数据库(插件添加)中找到合适的处理此请求的类。

找到这个类后,Widget_Do会使用PHP中ReflectionClass反射技术处理并调用目标类的action方法!

这样就完成了原先系统无法处理的请求,扩展性得到了很大的提高!

系统通过路由找到了真正的业务逻辑,比如首页或文章的展示,feed输出等具体业务,我们下回抓几个典型讲讲。

2015年01月17日更新:

增加action的小节。

下一节

码字不易,转载请注明出处。