APF架构

What is APF

APF是某网站的后端php架构

APF特点

• Intercepetor
• Config
• Component
• Compressed JS/CSS
• Multi Application
• Debugger
• Logger

工作流程

以访问一个页面为例
浏览器发起一次页面请求，后台服务器新开一个线程，处理这次请求。在当前线程中，只维护一个实例，用于处理接下去的所有工作，如请求资源文件等。

system/classes/APF.php是APF框架的核心，线程会调用run方法执行工作流程

• run APF主入口，实例化请求类、响应类

function run() {
    $this->prepare();
    $this->dispatch();
}

• prepare 实例化后面流程需要用到的请求类、响应类、路由类等

function prepare(){
    $this->request = new $this->request_class();
    $this->response = new $this->response_class();
    $this->router = new $this->router_class();
}

• dispatch 真正框架执行方法，依次执行各个拦截器before方法、控制器方法、页面方法、拦截器逆序after方法以及清理工作
  基本流程：
  1.取得controller类 --> $controller
  2.取得inteceptor类 --> $inteceptor(可能有多个拦截器)
  3.执行各个拦截器before方法 --> $step (存储拦截器的结果) 拦截器的作用用于访问页面前的权限校验以及分配城市等工作
  4.If $step != EXIT 执行控制器方法和页面方法

1.执行$controller->handle_request()
(handle_request作用是对页面属性的设置，一般返回页面类字符串，供后面页面类实例化以及执行页面类方法)
2.执行$this->page()方法  实例化页面现实逻辑
     1>$this->register_resources()
     2>$page = $this->load_component()
     3>$page->execute()

5.执行拦截器逆序after方法

dispatch方法伪代码

function dispatch() {
    $class = $this->router->mapping();  // 读取路由配置文件
    $controller = $this->get_controller($class);
    $interceptor = $this->get_config($class, "interceptor");
    $step = $interceptor->before();
    if($step != STEP_EXIT) {
        $result = $controller->handle_request();
        $this->page($result);
    }
    $interceptor->after()
}

Intecerptor类

拦截器的作用是在页面访问前校验其权限或预处理任务。每个拦截器类都会提供before方法，返回一些特定的标志位。

    const STEP_CONTINUE = 1;
    const STEP_BREAK    = 2;
    const STEP_EXIT     = 3;   // 退出标志，表示校验不通过等，那么就不再执行controller

Controller类

每个页面都配有一个controller类，一般每个页面controller类都继承自BrokerBaseController
每个页面controller必须实现handle_request_internal方法，该方法返回页面类名

abstract class BrokerBaseController extends BrokerController{
    // APF中dispatch方法会调用
    function handle_request(){
        ...
        return $this->handle_request_internal();
    }  
    abstract function handle_request_internal(); // 该方法子类必须实现，返回页面类名
}

Component类

如何定义
1.在component文件夹内定义组件，一般一个组件由以下四个文件组成：

A.js
A.css
A.php
A.phtml

2.每一个组件类都继承自APF组件类(APF_Component)，在APF_Component类中定义了execute()方法，作用载入组件显示页面

如何调用
1.在使用组件的页面中调用

// 实例化组件类，并执行set_params() 和 execute()方法
$this->component('Broker_NavTabGJ', 参数list)

2.资源载入
APF.php中的方法register_resources()会在$this->page()中被调用
register_resources()会依次调用use系方法，这样会把页面需要使用的组件资源文件和页面资源文件进行打包或输出在html文件中。这也是APF能够打包资源特定的原因。

Page类

我们可以将page看作是特殊的Component，每个page类可能有以下几个方法（俗称use系方法）：
1.use_boundable_styles()
2.use_boundable_javascripts()
3.use_component()
4....
每个page类都继承一些基类，基类中定义一些基本方法，这些基本方法都可以在子类中覆写，以实现自定义功能。
在最后的基类中（APF_Component）中定义了execute()方法，加载装饰器以及渲染页面（所谓渲染，其实就是include(xxx.phtml)）
至于页面一些变量的设置，自有方法去完成，如下：
每个页面类对应一定有一个同名的controller类，例如page/Set.php,在controller文件夹中一定能找到同名的controller/Set.php文件。如上面controller类的解释，不光是返回页面类名，同时会获取到单例中的$request属性。$request是一个对象，PHP中对象是引用的,所以可以在$request中调用$request->set_attribute()方法添加变量。由于是单例模式，所以页面类中获取$request对象时，就可以得到controller中定义的变量。这就是页面添加变量的原理。

请求顺序

请求顺序