【Phalcon】路由拆分

写在前

去年使用过PHP的Flight框架编写api，Flight框架非常简单，只需要花一点点时间看官方文档即可上手写代码，原生支持Restful风格。刚开始没觉得什么，只要有需求则加一个路由，由于项目不大，总共也不超过10个。

最近在使用Phalcon，项目规模中等，在路由（routes.php）那里遇到了本文所关注的痛点，几十个路由放在一个文件中，而且还会继续往里加，当达到一定的数量级，如果有一天，我想改其中某一个路由（名称忘了或者记不清），则需要滚动鼠标刷半天才找到。代码混乱，所有的controller/action都放在这里管理。

如下

/**
 * 首页
 */
$router->add(
    "/",
    [
        "controller" => "index",
        "action"     => "index",
    ]
);

/**
 * 用户信息
 */
$router->add(
    "/user/info",
    [
        "controller" => "user",
        "action"     => "info",
    ]
);

/**
 * 添加商品到购物车
 */
$router->add(
    "/shopcart/add",
    [
        "controller" => "shopcart",
        "action"     => "add",
    ]
);

...

正文

既然有痛点，那就想解决办法

Phalcon通常的项目结构大概是这样的

app/                                   #应用程序
     cache/                            #缓存文件
          data/                             #缓存数据
          metaData/                         #缓存元数据
          models/                           #缓存模型
          views/                            #缓存视图
          volt/                             #缓存volt模版文件
     config/                           #配置文件
          config.example.php                #配置文件（加载环境配置，返回所有配置）
          development.example.php           #开发环境配置（定义debug模式等）
          env.php                           #配置文件（定义基路径，定义全局变量，设置环境异常模式）      
          nginx.example.conf                #nginx配置
          routes.php                        #返回路由配置
          timezones.php                     #返回时区配置
     controllers/                           #控制器
     library/                               #类库文件（工具类，启动文件）
          Badges/                           #
          Github/                           #
          Http/                             #
          Mail/                             #
          Markdown/                         #
          Mvc/                              #
          Notifications/                    #
          Paginator/                        #
          Queue/                            #
          Search/                           #
          Utils/                            #
          Bootstrap.php                     #启动文件
     logs/                                  #日志文件
     models/                                #模型类
     views/                                 #视图（volt模版）
docs/                                  #项目说明文档 
opsfiles/                              #运维工具配置文件
public/                                #公共目录
     css/                              #样式文件
     fonts/                            #字体文件
     icon/                             #图标文件
     js/                               #javascript脚本
     .htaccess                         #路由重写规则（指向该目录下的index.php）
     505.html                          #服务器异常展示文件
     index.php                         #引导文件（框架先从这里开始执行）
schemas/                               #sql文件
scripts/                               #服务器脚本
test/                                  #单元测试
.env.example                           #用户专属环境配置
.htaccess                              #路由重写规则（指向public目录下的index.php）
.htrouter.php                          #与.htaccess文件功能一样，包含public目录下的index.php
composer.json                          #依赖管理文件

加载流程：

1./public/index.php
use app\library\Bootstrap;
使用命名空间的方式，划分程序块

include_once realpath(dirname(dirname(__FILE__))) . '/app/config/env.php';
include_once BASE_DIR . 'app/library/Bootstrap.php';
第一行，包含配置文件，配置文件中有BASE_DIR的定义，APPLICATION_ENV的定义
第二行，包含引导文件

$bootstrap = new Bootstrap();

if (APPLICATION_ENV == ENV_TESTING) {
    return $bootstrap->run();
} else {
    echo $bootstrap->run();
}
声明Bootstrap对象，开始执行

找到Bootstrap.php，初始化路由的代码如下

/**
     * Initialize the Router.
     */
    protected function initRouter()
    {
        ...
        $router = include BASE_DIR . 'app/routes/routes.php';
        ...
    }

可以发现，路由是这样包含进框架的，去到我们的routes.php，把原来的路由拆分成各自模块的文件，然后包含进routes.php，这样做的好处是，模块化管理，便于查找和修改。

routes.php

<?php


use Phalcon\Mvc\Router;

$router = new Router(false);
$router->removeExtraSlashes(true);


/**
 * loader the urls
 */
$urls = [
    'index',
    'shopcart',
    'user',
];
foreach ($urls as $url){
    include BASE_DIR.'app/routes/'.$url.'.php';
}

return $router;

user.php

<?php

/**
 * 用户信息
 */
$router->add(
    "/user/info",
    [
        "controller" => "user",
        "action"     => "info",
    ]
);