嗷嗷答 - 嗷嗷好的公务员考试网络答题平台

typecho路由机制详解

作者：不烦恼 发布时间：April 16, 2011 分类：快乐学习

本文介绍的是typecho的路由机制
路由机制是typecho的核心，有很多功能都是基于路由功能设计的，理解并熟悉TE的路由机制将非常有助于插件的开发。
完整的路由表如下（由于代码较长，请进内页浏览）：

  2.   0 => 
  4.     'index' => 
  6.       'url' => '/',
  7.       'widget' => 'Widget_Archive',
  8.       'action' => 'render',
  9.       'regx' => '|^[/]?$|',
  10.       'format' => '/',
  11.       'params' => 
  13.       ),
  14.     ),
  15.     'do' => 
  17.       'url' => '/action/[action:alpha]',
  18.       'widget' => 'Widget_Do',
  19.       'action' => 'action',
  20.       'regx' => '|^/action/([_0-9a-zA-Z-]+)[/]?$|',
  21.       'format' => '/action/%s',
  22.       'params' => 
  24.         0 => 'action',
  25.       ),
  26.     ),
  27.     'post' => 
  29.       'url' => '/archives/[cid:digital]/',
  30.       'widget' => 'Widget_Archive',
  31.       'action' => 'render',
  32.       'regx' => '|^/archives/([0-9]+)[/]?$|',
  33.       'format' => '/archives/%s/',
  34.       'params' => 
  36.         0 => 'cid',
  37.       ),
  38.     ),
  39.     'attachment' => 
  41.       'url' => '/attachment/[cid:digital]/',
  42.       'widget' => 'Widget_Archive',
  43.       'action' => 'render',
  44.       'regx' => '|^/attachment/([0-9]+)[/]?$|',
  45.       'format' => '/attachment/%s/',
  46.       'params' => 
  48.         0 => 'cid',
  49.       ),
  50.     ),
  51.     'category' => 
  53.       'url' => '/category/[slug]/',
  54.       'widget' => 'Widget_Archive',
  55.       'action' => 'render',
  56.       'regx' => '|^/category/([^/]+)[/]?$|',
  57.       'format' => '/category/%s/',
  58.       'params' => 
  60.         0 => 'slug',
  61.       ),
  62.     ),
  63.     'tag' => 
  65.       'url' => '/tag/[slug]/',
  66.       'widget' => 'Widget_Archive',
  67.       'action' => 'render',
  68.       'regx' => '|^/tag/([^/]+)[/]?$|',
  69.       'format' => '/tag/%s/',
  70.       'params' => 
  72.         0 => 'slug',
  73.       ),
  74.     ),
  75.     'author' => 
  77.       'url' => '/author/[uid:digital]/',
  78.       'widget' => 'Widget_Archive',
  79.       'action' => 'render',
  80.       'regx' => '|^/author/([0-9]+)[/]?$|',
  81.       'format' => '/author/%s/',
  82.       'params' => 
  84.         0 => 'uid',
  85.       ),
  86.     ),
  87.     'search' => 
  89.       'url' => '/search/[keywords]/',
  90.       'widget' => 'Widget_Archive',
  91.       'action' => 'render',
  92.       'regx' => '|^/search/([^/]+)[/]?$|',
  93.       'format' => '/search/%s/',
  94.       'params' => 
  96.         0 => 'keywords',
  97.       ),
  98.     ),
  99.     'index_page' => 
  101.       'url' => '/page/[page:digital]/',
  102.       'widget' => 'Widget_Archive',
  103.       'action' => 'render',
  104.       'regx' => '|^/page/([0-9]+)[/]?$|',
  105.       'format' => '/page/%s/',
  106.       'params' => 
  108.         0 => 'page',
  109.       ),
  110.     ),
  111.     'category_page' => 
  113.       'url' => '/category/[slug]/[page:digital]/',
  114.       'widget' => 'Widget_Archive',
  115.       'action' => 'render',
  116.       'regx' => '|^/category/([^/]+)/([0-9]+)[/]?$|',
  117.       'format' => '/category/%s/%s/',
  118.       'params' => 
  120.         0 => 'slug',
  121.         1 => 'page',
  122.       ),
  123.     ),
  124.     'tag_page' => 
  126.       'url' => '/tag/[slug]/[page:digital]/',
  127.       'widget' => 'Widget_Archive',
  128.       'action' => 'render',
  129.       'regx' => '|^/tag/([^/]+)/([0-9]+)[/]?$|',
  130.       'format' => '/tag/%s/%s/',
  131.       'params' => 
  133.         0 => 'slug',
  134.         1 => 'page',
  135.       ),
  136.     ),
  137.     'author_page' => 
  139.       'url' => '/author/[uid:digital]/[page:digital]/',
  140.       'widget' => 'Widget_Archive',
  141.       'action' => 'render',
  142.       'regx' => '|^/author/([0-9]+)/([0-9]+)[/]?$|',
  143.       'format' => '/author/%s/%s/',
  144.       'params' => 
  146.         0 => 'uid',
  147.         1 => 'page',
  148.       ),
  149.     ),
  150.     'search_page' => 
  152.       'url' => '/search/[keywords]/[page:digital]/',
  153.       'widget' => 'Widget_Archive',
  154.       'action' => 'render',
  155.       'regx' => '|^/search/([^/]+)/([0-9]+)[/]?$|',
  156.       'format' => '/search/%s/%s/',
  157.       'params' => 
  159.         0 => 'keywords',
  160.         1 => 'page',
  161.       ),
  162.     ),
  163.     'archive_year' => 
  165.       'url' => '/[year:digital:4]/',
  166.       'widget' => 'Widget_Archive',
  167.       'action' => 'render',
  168.       'regx' => '|^/([0-9]{4})[/]?$|',
  169.       'format' => '/%s/',
  170.       'params' => 
  172.         0 => 'year',
  173.       ),
  174.     ),
  175.     'archive_month' => 
  177.       'url' => '/[year:digital:4]/[month:digital:2]/',
  178.       'widget' => 'Widget_Archive',
  179.       'action' => 'render',
  180.       'regx' => '|^/([0-9]{4})/([0-9]{2})[/]?$|',
  181.       'format' => '/%s/%s/',
  182.       'params' => 
  184.         0 => 'year',
  185.         1 => 'month',
  186.       ),
  187.     ),
  188.     'archive_day' => 
  190.       'url' => '/[year:digital:4]/[month:digital:2]/[day:digital:2]/',
  191.       'widget' => 'Widget_Archive',
  192.       'action' => 'render',
  193.       'regx' => '|^/([0-9]{4})/([0-9]{2})/([0-9]{2})[/]?$|',
  194.       'format' => '/%s/%s/%s/',
  195.       'params' => 
  197.         0 => 'year',
  198.         1 => 'month',
  199.         2 => 'day',
  200.       ),
  201.     ),
  202.     'archive_year_page' => 
  204.       'url' => '/[year:digital:4]/page/[page:digital]/',
  205.       'widget' => 'Widget_Archive',
  206.       'action' => 'render',
  207.       'regx' => '|^/([0-9]{4})/page/([0-9]+)[/]?$|',
  208.       'format' => '/%s/page/%s/',
  209.       'params' => 
  211.         0 => 'year',
  212.         1 => 'page',
  213.       ),
  214.     ),
  215.     'archive_month_page' => 
  217.       'url' => '/[year:digital:4]/[month:digital:2]/page/[page:digital]/',
  218.       'widget' => 'Widget_Archive',
  219.       'action' => 'render',
  220.       'regx' => '|^/([0-9]{4})/([0-9]{2})/page/([0-9]+)[/]?$|',
  221.       'format' => '/%s/%s/page/%s/',
  222.       'params' => 
  224.         0 => 'year',
  225.         1 => 'month',
  226.         2 => 'page',
  227.       ),
  228.     ),
  229.     'archive_day_page' => 
  231.       'url' => '/[year:digital:4]/[month:digital:2]/[day:digital:2]/page/[page:digital]/',
  232.       'widget' => 'Widget_Archive',
  233.       'action' => 'render',
  234.       'regx' => '|^/([0-9]{4})/([0-9]{2})/([0-9]{2})/page/([0-9]+)[/]?$|',
  235.       'format' => '/%s/%s/%s/page/%s/',
  236.       'params' => 
  238.         0 => 'year',
  239.         1 => 'month',
  240.         2 => 'day',
  241.         3 => 'page',
  242.       ),
  243.     ),
  244.     'comment_page' => 
  246.       'url' => '[permalink:string]/comment-page-[commentPage:digital]',
  247.       'widget' => 'Widget_Archive',
  248.       'action' => 'render',
  249.       'regx' => '|^(.+)/comment-page-([0-9]+)[/]?$|',
  250.       'format' => '%s/comment-page-%s',
  251.       'params' => 
  253.         0 => 'permalink',
  254.         1 => 'commentPage',
  255.       ),
  256.     ),
  257.     'feed' => 
  259.       'url' => '/feed[feed:string:0]',
  260.       'widget' => 'Widget_Archive',
  261.       'action' => 'feed',
  262.       'regx' => '|^/feed(.*)[/]?$|',
  263.       'format' => '/feed%s',
  264.       'params' => 
  266.         0 => 'feed',
  267.       ),
  268.     ),
  269.     'feedback' => 
  271.       'url' => '[permalink:string]/[type:alpha]',
  272.       'widget' => 'Widget_Feedback',
  273.       'action' => 'action',
  274.       'regx' => '|^(.+)/([_0-9a-zA-Z-]+)[/]?$|',
  275.       'format' => '%s/%s',
  276.       'params' => 
  278.         0 => 'permalink',
  279.         1 => 'type',
  280.       ),
  281.     ),
  282.     'page' => 
  284.       'url' => '/[slug].html',
  285.       'widget' => 'Widget_Archive',
  286.       'action' => 'render',
  287.       'regx' => '|^/([^/]+)\\.html[/]?$|',
  288.       'format' => '/%s.html',
  289.       'params' => 
  291.         0 => 'slug',
  292.       ),
  293.     ),
  294.   ),
  295.   'index' => 
  297.     'url' => '/',
  298.     'widget' => 'Widget_Archive',
  299.     'action' => 'render',
  300.   ),
  301.   'do' => 
  303.     'url' => '/action/[action:alpha]',
  304.     'widget' => 'Widget_Do',
  305.     'action' => 'action',
  306.   ),
  307.   'post' => 
  309.     'url' => '/archives/[cid:digital]/',
  310.     'widget' => 'Widget_Archive',
  311.     'action' => 'render',
  312.   ),
  313.   'attachment' => 
  315.     'url' => '/attachment/[cid:digital]/',
  316.     'widget' => 'Widget_Archive',
  317.     'action' => 'render',
  318.   ),
  319.   'category' => 
  321.     'url' => '/category/[slug]/',
  322.     'widget' => 'Widget_Archive',
  323.     'action' => 'render',
  324.   ),
  325.   'tag' => 
  327.     'url' => '/tag/[slug]/',
  328.     'widget' => 'Widget_Archive',
  329.     'action' => 'render',
  330.   ),
  331.   'author' => 
  333.     'url' => '/author/[uid:digital]/',
  334.     'widget' => 'Widget_Archive',
  335.     'action' => 'render',
  336.   ),
  337.   'search' => 
  339.     'url' => '/search/[keywords]/',
  340.     'widget' => 'Widget_Archive',
  341.     'action' => 'render',
  342.   ),
  343.   'index_page' => 
  345.     'url' => '/page/[page:digital]/',
  346.     'widget' => 'Widget_Archive',
  347.     'action' => 'render',
  348.   ),
  349.   'category_page' => 
  351.     'url' => '/category/[slug]/[page:digital]/',
  352.     'widget' => 'Widget_Archive',
  353.     'action' => 'render',
  354.   ),
  355.   'tag_page' => 
  357.     'url' => '/tag/[slug]/[page:digital]/',
  358.     'widget' => 'Widget_Archive',
  359.     'action' => 'render',
  360.   ),
  361.   'author_page' => 
  363.     'url' => '/author/[uid:digital]/[page:digital]/',
  364.     'widget' => 'Widget_Archive',
  365.     'action' => 'render',
  366.   ),
  367.   'search_page' => 
  369.     'url' => '/search/[keywords]/[page:digital]/',
  370.     'widget' => 'Widget_Archive',
  371.     'action' => 'render',
  372.   ),
  373.   'archive_year' => 
  375.     'url' => '/[year:digital:4]/',
  376.     'widget' => 'Widget_Archive',
  377.     'action' => 'render',
  378.   ),
  379.   'archive_month' => 
  381.     'url' => '/[year:digital:4]/[month:digital:2]/',
  382.     'widget' => 'Widget_Archive',
  383.     'action' => 'render',
  384.   ),
  385.   'archive_day' => 
  387.     'url' => '/[year:digital:4]/[month:digital:2]/[day:digital:2]/',
  388.     'widget' => 'Widget_Archive',
  389.     'action' => 'render',
  390.   ),
  391.   'archive_year_page' => 
  393.     'url' => '/[year:digital:4]/page/[page:digital]/',
  394.     'widget' => 'Widget_Archive',
  395.     'action' => 'render',
  396.   ),
  397.   'archive_month_page' => 
  399.     'url' => '/[year:digital:4]/[month:digital:2]/page/[page:digital]/',
  400.     'widget' => 'Widget_Archive',
  401.     'action' => 'render',
  402.   ),
  403.   'archive_day_page' => 
  405.     'url' => '/[year:digital:4]/[month:digital:2]/[day:digital:2]/page/[page:digital]/',
  406.     'widget' => 'Widget_Archive',
  407.     'action' => 'render',
  408.   ),
  409.   'comment_page' => 
  411.     'url' => '[permalink:string]/comment-page-[commentPage:digital]',
  412.     'widget' => 'Widget_Archive',
  413.     'action' => 'render',
  414.   ),
  415.   'feed' => 
  417.     'url' => '/feed[feed:string:0]',
  418.     'widget' => 'Widget_Archive',
  419.     'action' => 'feed',
  420.   ),
  421.   'feedback' => 
  423.     'url' => '[permalink:string]/[type:alpha]',
  424.     'widget' => 'Widget_Feedback',
  425.     'action' => 'action',
  426.   ),
  427.   'page' => 
  429.     'url' => '/[slug].html',
  430.     'widget' => 'Widget_Archive',
  431.     'action' => 'render',
  432.   ),
  433. )

详解见下页：

  1. 1
  2. 2
  3. 3

已有 4 条评论 »

  1. numen numen
    October 3rd, 2011 at 11:56 pm

    学习了。感谢楼主。

    回复
  2. 老康 老康
    May 19th, 2011 at 10:16 am

    恩。学习了。
    感谢分享经验。

    回复
  3. lee lee
    April 19th, 2011 at 09:16 pm

    插件的代码64行 给没有指定语言的设置个默认值就好了 哈哈

    $language = trim($matches[2]) ? trim($matches[2]): 'html';

    1. 不烦恼 不烦恼
      April 19th, 2011 at 09:47 pm

      谢谢Lee，不用我再去看改该动哪个地方的代码了，已经解决$language = $matches[2] ? trim($matches[2]): 'html';
      看了你的两个设计（主题站和电影站）之后很是羡慕，有理论没有实践的我真是惭愧
      一直没对TE的数据库结构做扩展，以后多多向你学习！

      回复
    回复

添加新评论 »