php自己实现 framework,一步步编写PHP的Framework(十一)_php

本文介绍了如何在自定义PHP框架中优雅地将数据从控制器传递到视图,通过assign和display方法实现。文章详细阐述了assign方法的实现,用于为变量赋值,并过滤不合规的数据;display方法则处理视图文件的显示,包括路径的规范化和文件存在的检查。此外,还提到了异常处理和视图文件不存在时的错误处理。整个过程参考了Smarty框架,并兼容了ThinkPHP的部分设计理念。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

之前讲了怎么让实现跳转和请求的转发,当然,也只是很简单的说了一下,更深的内容需要你自己去读一下具体框架的实现。

现在跳转和转发有了,对于模型的编写可以后面再来,那我就先说一下怎么讲数据从控制器传递到视图,之前我们的实现方式非常丑陋:

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关闭,抛出异常的时候,也只会跳转到错误页,不会直接展示异常,这样的处理更易维护。

欢迎大家阅读《一步步编写PHP的Framework(十一)_php》,跪求各位点评,若觉得好的话请收藏本文,by 搞代码

e7ce419cf2d6ad34d01da2ceb8829eed.png

微信 赏一包辣条吧~

023a57327877fb4402bcc76911ec18ea.png

支付宝 赏一听可乐吧~

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值