Z-Blog PHP页面路由系统

摘要

Z-Blog PHP 1.7版本引入的页面路由系统，用于处理网站URL的映射与访问。该系统通过注入路由规则数组并匹配URL，将请求导向指定的处理函数（如ViewSearch、ViewPost），实现功能如搜索伪静态化、文章专属下载页、内容分页、路由跳转和301重定向等。它支持rewrite、active、default等多种路由类型，是Z-Blog插件开发中实现自定义URL和页面功能的核心机制。

核心要点

• 通过向系统注入路由规则数组来定义URL模式与处理函数的映射关系
• 路由匹配成功后，系统将包含匹配参数的数组传入call指定的处理函数
• 支持rewrite、active、default等多种路由类型以实现不同功能
• 可用于实现搜索伪静态化、文章专属下载页、内容分页、路由跳转和网站改版301重定向
• 插件开发需挂载Filter_Plugin_Zbp_PreLoad等接口来注册自定义路由

关键实体

- Z-Blog PHP (product) ⚠️建议建页

- 页面路由 (concept) ⚠️建议建页

• 路由系统 (concept)
• 路由规则 (concept)

- 伪静态化 (concept) ⚠️建议建页

建议新建页面

• [[Z-Blog PHP插件开发]] — 作为上下文基础，涵盖插件生命周期、接口系统和开发规范
• [[URL重写与伪静态化]] — 作为核心概念，解释其原理、实现方式及在各系统（如Apache, Nginx）中的配置

---

> 编译时间: 2026-06-20 04:33 | 来源: `zblog-docs/dev-30-route.md`