PhalconCMS源码解析之多模块

2021-10-06 20:14:49

原文发表于：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
Phalcon玩家群：150237524

码农公寓

多模块文件加载

DI注册服务

私有服务

公用服务

注册多模块

相关文章