2017
01-05

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/KevinJay/PhalconCMS
github:https://github.com/KevinJay/PhalconCMS

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

最后,欢迎大家加入QQ群交流讨论:

  • 广州PHP高端交流群:158587573 广州PHP高端交流
  • Phalcon玩家群:150237524 Phalcon玩家
「真诚赞赏,手留余香」
您的支持将鼓励我继续创作 :)