PhalconCMS源码解析之多模块

原文发表于： PhalconCMS源码解析之多模块

在2016年的最后一天里，把PhalconCMS 1.0版完成开发、封版并上线部署以后，我一直在想是否须要整理一个源码解析类的系列教程。虽然PhalconCMS的源码组织并非很复杂，稍微有点Phalcon基础的同窗就能看明白，可是不少刚入门的同窗对于Phalcon的知识点都是只知其一;不知其二的状态，并无一个系统的认知。因此我仍是决定写PhalconCMS源码解析这个系列教程，跟你们分享我在学习使用Phalcon以及开发PhalconCMS的过程当中的一些经验和总结。一方面呢，我自身对于Phalcon知识点的理解和总结，也不是很是的系统和全面，也是但愿借助这个机会，能和更多的Phalcon爱好者互相交流学习；另外一方面也是但愿能给刚接触Phalcon的同窗一些启发，帮助他们少走弯路。但愿不会是误人歧途 :)

这一篇跟你们分享一下PhalconCMS多模块的代码组织。在PhalconCMS中有“前台（app/frontend目录）”和“后台（app/backend目录）”两个模块，分别对应着访客和管理员的用户群体。下面直接经过代码来分析。

多模块文件加载

在“app/core/loader.php”文件中，对“前台模块”和“后台模块”的“controllers”、“models”文件目录进行加载。这里是用的命名空间加载（registerNamespaces）方式，也能够用自动加载（registerDirs）来处理。

DI注册服务

私有服务

在“app/frontend/FrontendModule.php”和“app/Backend/BackendModule.php”文件中分别向DI注册前台和后台模块所需的"dispathcer调度器服务"、“url服务”以及“view模板服务”。这里须要注意的是，先后台的“dispatcher调度器服务”中设置的“默认调度器”是不同的：

//app/frontend/FrontendModule.php中默认设置为前台的调度器
$dispatcher->setDefaultNamespace('Marser\\App\\Frontend\\Controllers');
        
//app/Backend/BackendModule.php默认设置为后台的调度器
$dispatcher -> setDefaultNamespace('Marser\\App\\Backend\\Controllers');

同理，先后台的“url服务”中设置的"URL前缀"也是不同的。这是为了在程序中调用生成URL的方法（$url->get("test/test"); ）时，自动根据当前模块来设置URL的前缀：

//app/frontend/FrontendModule.php中设置的前台URL前缀
$url -> setBaseUri('/');
//会生成"/test/test"的URL
$url -> get('test/test');
    
//app/Backend/BackendModule.php中设置的后台URL前缀
$url -> setBaseUri('/admin/');
//会生成“/admin/test/test”的URL
$url -> get('test/test');

公用服务

在 “app/core/services.php” 文件中向DI注册多模块共用的公用服务，如路由服务、数据库链接服务、缓存服务、日志服务等等。
多模块的路由服务以下：

$di -> set('router', function(){
    $router = new \Phalcon\Mvc\Router();
    //默认路由到前台模块
    $router -> setDefaultModule('frontend');

    //后台模块经过路由规则指定
    $routerRules = new \Phalcon\Config\Adapter\Php(ROOT_PATH . "/app/config/routers.php");
    foreach ($routerRules->toArray() as $key => $value){
        $router->add($key,$value);
    }

    return $router;
});

"app/config/routes.php"中设置的路由规则以下：

//后台路由规则
'/admin/:controller/:action/:params' => array(
    'module' => 'backend',
    'controller'=>1,
    'action'=>2
),

注册多模块

以上步骤完成以后，最后在"app/public/index.php"中注册多模块：

$application -> registerModules(array(
    'frontend' => array(
        'className' => 'Marser\App\Frontend\FrontendModule',
        'path' => ROOT_PATH . '/app/frontend/FrontendModule.php',
    ),
    'backend' => array(
        'className' => 'Marser\App\Backend\BackendModule',
        'path' => ROOT_PATH . '/app/backend/BackendModule.php',
    ),
));

至此，PhalconCMS的多模块就能正常运行了。在浏览器中访问带有“/admin/” 前缀的URL，"dispatcher调度服务"就能将请求URL分发到后台的控制器中（"app/backend/controllers"），其余的URL请求，就默认分发到前台控制器（"app/frontend/controllers"）。
以上贴的都是代码片段，具体代码能够参考PhalconCMS的源码：
码云： http://git.oschina.net/KevinJ...
github：https://github.com/KevinJay/P...

同时，我也抽取了一份phalcon的示例代码仓库，phalcon多模块的示例代码已经提交上去了，后续教程的demo也会提交上去，欢迎你们star和fork：
https://github.com/KevinJay/m...

最后，欢迎你们加入QQ群交流讨论：

• 广州PHP高端交流群：158587573
• Phalcon玩家群：150237524