一步步编写PHP的Framework(十一)
- WBOYOriginal
- 2016-06-21 08:50:311023browse
之前讲了怎么让实现跳转和请求的转发，当然，也只是很简单的说了一下，更深的内容需要你自己去读一下具体框架的实现。
现在跳转和转发有了，对于模型的编写可以后面再来，那我就先说一下怎么讲数据从控制器传递到视图，之前我们的实现方式非常丑陋：
| 1 | $viewPath = dirname(__FILE__) . '/../views/index.php'; |
| 2 | if(file_exists($viewPath)) { |
| 3 | include $viewPath; |
| 4 | } else { |
| 5 | echo 'view does not exists'; |
| 6 | } |
现在我准备用更优雅一点的方式将数据传递到视图，现在先说一下怎么调用：
| 01 |
| 02 | class TestController extends Controller { |
| 03 | public function test() { |
| 04 | $this->_assign(array( |
| 05 | 'arr' => array( |
| 06 | 'test','test2' |
| 07 | ), |
| 08 | 'str' => 'it is a str' |
| 09 | )); |
| 10 | $this->_display('test'); |
| 11 | } |
| 12 | } |
这就是今天我写之后的调用方式，如果你学过smarty，那么你会发现这和smarty很相似，的确，我写toper的时候也是受了smarty的影响，最开始的想法是视图这一块就使用smarty，后面想了一下，既然号称是自己的框架，那么视图这一块儿肯定也要全部自己写，虽然如此，但是我后面还是保留了assign,display这种写法，并且只要配置文件修改，完全可以将视图切换到smarty而不使用框架本身的实现。
好像扯得有点远了，首先说一下，为了代码的简单，我将assign和display的实现简化，大家理解思路就好，真实的框架的实现要复杂一些。
首先assign，它的功能是为变量赋值，这里我假设传递的参数都是关联数组，也就是常说的HashTable，它不应该直接调用View的接口，这接口实现怎么赋值：
| 1 | protected function _assign(Array $arr) { |
| 2 | View::assign($arr); |
| 3 | } |
为了处理视图这一块的数据存储和展示，我定义了View.php这个文件，View::assign这个方法是它的一个静态方法，当然，实现的功能大家都懂的。。。
具体View.php中怎么实现的呢？
| 1 | private static $_data = array(); |
| 2 | public static function assign($arr) { |
| 3 | foreach($arr as $key => $val) { |
| 4 | if(!is_int($key)) { |
| 5 | //过滤掉如array('test','test2')这种数据 |
| 6 | self::$_data[$key] = $val; |
| 7 | } |
| 8 | } |
| 9 | } |
由于assign是静态方法，数据又需要存储到这个类，所以需要定义一个静态的成员变量$_data，这个变量存储控制器传递的数据。因为之前在控制器的assign中已经进行了类型提示，所以可以保证在View中的assign传递的形参都是数组，现在只需要一个foreach然后依次存储即可，那为什么不直接使用self::$_data = $arr呢，这样只有一句话呢？
首先，数组中的数据有些可能是不对的，比如array('test','test2')我就不懂数据test和test2到底代表了什么，这样的数据应该在assign中就被剔除掉，如果你要求比较严苛，也可以直接给用户提示警告。
其次，有可能用户多次调用assign，如果直接使用引用，那么第二次调用assign就会把第一次的数据弄丢，这样是不可容忍的。
好，赋值搞定，然后就是怎么显示的问题了，在控制器中，还是直接调用接口，而不负责内部实现，但是在调用接口之前需要进行一定的格式化：
| 01 | protected function _display($str) { |
| 02 | if(is_string($str)) { |
| 03 | $str = str_replace(array( |
| 04 | '.','#' |
| 05 | ),array( |
| 06 | '/','.' |
| 07 | ),$str); |
| 08 | View::display(MODULES_PATH . View::VIEW_BASE_PATH . $str . '.php'); |
| 09 | } |
| 10 | } |
为了视觉上的美观和其他一些XXX的原因，我们可以将表示路径的/在作为实参传递的时候变成.，这样假设要调用test/test2.php，那么只需要传递test.test2.php即可。当然，这样也存在一个问题，有时候需要使用.，就像刚才这个例子，实际上test.test2.php会被解析为test/test2/php，这样实际上是有问题的，那么怎么解决呢，我使用一个#代表.,这样刚才这个传递的时候就变成了test.test2#php。这样还有一个问题，.php基本上每个页面都有，那为什么还要传递进去呢，直接框架帮你加上就好了嘛，所以用户只需要输入test.test2就好，这样从逻辑上也容易理解，test模块下面的test2这个视图文件。如果你用过thinkphp，你会发现这和它的写法很类似，实际上我在最开始写的时候就是边看thinkphp源码边写的，所以很多东西都借鉴了它的思想。我个人比较讨厌使用#,所以我基本上在视图文件中没有使用过#，因为我觉得你自己不会这么无聊，去写类似于test.view.php这样的无意义的文件名，直接test.php就好了，这样的名字框架又帮你解决了一部分，所以基本上不存在这个问题了。
这儿还出现了一个常量View::VIEW_BASE_PATH，这个常量代表的含义是视图根目录的路径，这样传递进去的实际上是一个实际的绝对路径。
由于display是展示这个视图文件，那么肯定会使用include某一个文件，具体的实现如下：
| 1 | public static function display($file) { |
| 2 | if(file_exists($file)) { |
| 3 | extract(self::$_data); |
| 4 | include $file; |
| 5 | } else { |
| 6 | throw new ViewException(ViewException::NOT_EXISTS_TEMPLATE); |
| 7 | } |
| 8 | } |
extract就是讲数组打散，更多的请查询PHP手册。
这里由于可能这个视图文件不存在，所以需要判定一下，如果视图文件不存在，则直接抛出异常，注意，异常是使用了ViewException，这个类又是新定义的，传递的参数表示这个异常是因为视图模板不存在而引起的。
那我么来看看具体这个异常类的实现：
| 01 |
| 02 | class ViewException extends BaseException { |
| 03 | const NOT_EXISTS_TEMPLATE = 1; |
| 04 | public function __construct($code = 0) { |
| 05 | switch($code) { |
| 06 | case ViewException::NOT_EXISTS_TEMPLATE: |
| 07 | $msg = 'the template file is not exists'; |
| 08 | break; |
| 09 | default : |
| 10 | $msg = 'unknown exception'; |
| 11 | break; |
| 12 | } |
| 13 | parent::__construct($msg,$code); |
| 14 | } |
| 15 | } |
这个类它继承了BaseException，由于BaseException实现了debug模式开与关不同情况下展示内容不同，ViewException也具有这个特性，当debug关闭，抛出异常的时候，也只会跳转到错误页，不会直接展示异常，这样的处理更易维护。