ThinkPHP控制器学习(一)

494 阅读5分钟

星空

多层控制器的使用

TP3.23对控制器做了更加细致的分层,除了默认的Controller层,还可以自定义事件控制层Event

建立的方法是:

  • 在模块第一级目录,即Controller层的同级目录,新建文件夹Event
  • Event文件夹中,新建文件 AdminEvent.class.php
  • 在新建文件中输入代码
namespace Admin\Event;
// use Think\Controller;  
// 如果不使用到controller的功能 
// 可以不用添加该命名空间引用 也不用继承controller
class AdminEvent extents Controller {
    public function test() {
        echo 'Hello World !';
    }
}

系统默认的控制器(即访问控制器)是Controller,因此在浏览器输入http://localhost/forum/index.php/Admin/admin/test是无法进行访问的,Event控制器仅在内部方法方法中进行访问。当然可以通过DEFAULT_C_LAYER来修改访问控制器的名称。但建议不这么做。

定义了事件控制器,对系统模块的构建有很大的好处。可以将浏览器的请求与内部事件处理相隔离,使整个业务逻辑看上去更为简洁明了。

如一个后台系统,有多个页面,都需要对用户是否登录进行检测,如果这个检测都在Controller进行的话,整个业务逻辑会显得很混乱,而且可能会有代码冗余。 这时可以通过Event事件控制器来定义一个检测方法,然后在Controller层进行调用,这样代码不仅更为简练,业务逻辑也更为清晰。

Event控制器

namespace Admin\Event;
use Think\Controller;      
class AdminEvent extents Controller {
    /**
     *  登录检测  检测session中用户
     *  @param    类型    参数名 含义
     *  @return 类型  
     */
    function checkLogin() {
        $value = session('UserName');
        if(!isset($value)) {
            $this->error('请登录后访问' , U('admin/login'));
        }
    }
}

Controller控制器

namespace Admin\Controller;
use Think\Controller;
class AdminController extends Controller {

    /** 
     *  后台首页面
     */
    public function index(){

        A('Admin' , 'Event')->checkLogin();
        
        $this->assign('title','后台');   
        $this->display();   
    }

    /**
     -  文章显示控制
     -  @param  
     -  @return 
     */
    public function article() {
         
        A('Admin' , 'Event')->checkLogin();

        $this->assign('title','文章-后台');             
        $this->display();
    }
}

这样无论是从那种链接登入后台,都会进行用户检测,不仅提高了安全性,而且代码逻辑清晰。

我们可以将数据库添加操作在Event控制器中完成,在Controller控制器只进行模板输出,接受表单提交。 以上。

初始化操作

Think\Controller.class.php的构造方法中进行视图类实例化后,会检测是否存在一个_initialize方法。如果存在,就会事先调用该方法。

这就是控制器的初始化操作。在控制器类中定义_initialize方法,在操作其他方法之前都会先执行该方法。

如:

namespace Admin\Controller;
use Think\Controller;
class AdminController extends Controller {

    # 初始化操作
    public function _initialize() {
        echo '页面初始化,请等待<br/>';
    }

    # 主页
    public function index() {
        echo 'index';
    }
}

在浏览器输入http://localhost/forum/index.php/Admin,则会输出

页面初始化,请等待 index

有了这个方法,我们上面所讲的登录检测就能够再次进行简化了。即在_initialize方法中进行是否登录的检测。但在_initialize添加了登录检测后,我们不能够将与登录有关的内容放入AdminController控制器中了,否则会不停的跳转到error页面,而无法显示登陆页面。

我们可以将登录注册同时拿出,新建一个控制器,名字叫UserController。在这个页面进行登陆与注册功能,而error页面跳转到该页面。

UserController

namespace Admin\Controller;
use Think\Controller;
class UserController extends Controller {
    
    /**
     *  用户登录
     */
     public function login() {
        echo '用户登录';
     }

    /**
     *  用户注册
     */
    public function register() {
        echo '用户注册';
    }
}   

AdminController

namespace Admin\Controller;
use Think\Controller;
class AdminController extends Controller {

    # 初始化操作
    public function _initialize() {
        A('Admin' , 'Event')->checkLogin();
    }

    /** 
     *  后台首页面
     */
    public function index(){           
        
        $this->assign('title','后台');   
        $this->display();   
    }

    /**
     -  文章显示控制
     -  @param  
     -  @return 
     */
    public function article() {            

        $this->assign('title','文章-后台');             
        $this->display();
    }
}

AdminEvent

namespace Admin\Event;
use Think\Controller;      
class AdminEvent extents Controller {
    /**
     *  登录检测  检测session中用户
     *  @param    类型    参数名 含义
     *  @return 类型  
     */
    function checkLogin() {
        $value = session('UserName');
        if(!isset($value)) {
            $this->error('请登录后访问' , U('user/login'));
        }
    }
}

这样一个比较完善的后台登陆就完成了(当然还未实现具体的业务逻辑),比较最原始的方法,代码简洁清晰了很多,也完全符合MVC设计思想。

前置与后置

与初始化设置类似,TP提供了前置与后置操作,要进行前后置操作需要真实的方法,系统在执行该方法前会进行检测,如果定义了前后置操作,则会安照顺序进行。定义的方法是在执行方法前加入_before__after_,如

namespace Admin\Controller;
use Think\Controller;
class AdminController extends Controller {
    public function _before_index() {}
    public function index() {}
    public function _after_index() {}
}

在访问http://localhost/forum/index.php/Admin的时候,就会先执行_before_index,在执行index,最后执行_after_index。注意的是如果在index中定义了断点方法,如dieexit,跳转方法errorsuccess就不会继续执行_after_index

这个前后置方法,我暂时还未想到有什么比较有用的地方,先写出来,以后想到了,在进行添加。

空操作与空控制器

按照ThinkPHPURL命名规则(pathinfo模式),入口文件之后的操作成为

模块 控制器 操作

http://servername/index.php/模块/控制器/操作/[参数名/参数值…]

空操作 就是指系统找不到url指定的操作方法,此时就会报错,可以使用定义空操作方法来进行避免。如:

namespace Admin\Controller;
use Think\Controller;
class AdminController extends Controller {

    /** 
     *  后台首页面
     */
    public function index(){           
        
        $this->assign('title','后台');   
        $this->display();   
    }
    
    /**
     -  空操作防止
     -  @param    无
     -  @return   无   
     */
    public function _empty() {
        $this->display('404');
    }
}

定义后,在输入错误的操作方法时,就会显示_empty中的内容。你可以定义一个404页面,在_empty中进行跳转。

空控制器

与空操作类似,访问不存在的控制器就会产生空控制器操作,避免该错误的方法是,在Controller中定义一个EmptyController控制器,在该控制器中同样定义_empty方法。

namespace Admin\Controller;
use Think\Controller;
class EmptyController extends Controller {
       
    /**
     -    空操作防止
     -    @param    无
     -    @return   无   
     */
    public function _empty() {
         $this->display('admin/404');
    }
}

404页面 对于404页面的定制,如果没有特殊需求的同学,建议使用腾讯的404公益页面,只要嵌入一小段JS代码,就会跳转到腾讯的寻找失踪儿童的404页面。虽然可能和你的网站风格不统一,但是每多一个看见该页面的人,就可能加大找回一个失踪儿童的几率。一小段代码,献出一段爱心,你值得拥有。

// 腾讯404页面
<script type="text/javascript" src="http://www.qq.com/404/search_children.js" charset="utf-8" homePageUrl="http://yoursite.com/yourPage.html" homePageName="回到我的主页"></script>

20160529162719.png

Action参数绑定

在说Action参数绑定前,先说说与之相关的问题。在学习Action参数绑定之前,我获取GET参数的方式是怎么样? 自然是利用$_GET来获取URL上的参数,如:

# 我要点击一个文章链接,来进行文章编辑 url如下
http://localhost/forum/index.php/Admin/admin/article/act/edit/aid/2
# 然后通过$_GET来获取act aid得到参数,来判断进行的操作以及操作的文章id
if($_GET['act'] == 'edit') {
    # 文章编辑  利用 aid从数据库取出文章进行编辑
}

这种方式虽然可行,却不够优雅,作为一个立志成为攻城狮的程序员来说,要想尽方法使你的代码更加简洁,更加优雅。

这时来看看Action参数绑定,什么是Action参数绑定

Action参数绑定是通过直接绑定URL地址中的变量作为操作方法的参数, 可以简化方法的定义甚至路由的解析。

说的还挺绕,其实就是把GET形式传递的参数直接绑定到你的操作方法上,你就能够直接访问,而不用通过$_GET。 举个例子,还是上面的链接http://localhost/forum/index.php/Admin/admin/article/act/edit/aid/2。 定义操作方法如下:

namespace Admin\Controller;
use Think\Controller;
class AdminController extends Controller {

    /** 
     *  文章显示控制器
     *  @param:$act   string   进行的文章操作  默认值空 -> 显示所有文章
     *  @param:$aid   int      文章的主键id    默认值0  -> 显示所有文章
     */
    public function article($act='' , $aid = 0) {
        
        if(empty($act) || empty($aid) ) {

            # 显示所有文章

        } else {
            
            # 进行想要的操作
            echo '你要进行的操作是'.$act.',你想要'.$act.'的文章id是'.$aid;

        }
    }
}

访问上面的链接,结果为

你要进行的操作是edit,你想要edit的文章id是2

这就是Action参数绑定。要使用这种方式需要开启URL_PARAMS_BIND设置(默认设置true)。

Action参数绑定有两种形式

按照变量名绑定 按照变量顺序绑定

URL_PARAMS_BIND_TYPE的值设置成0,按照变量名绑定,设置成1,按照变量顺序绑定。

按照字面意思也可以理解,按照变量名绑定即寻找get参数时,按照操作方法中定义的变量名去寻找相应的值。如果没有就报错。这也是最常用的方式。

按照变量顺序绑定,即按照url上get参数的顺序去给操作方法上的变量赋值,这样在url上的参数就能够随意变换位置,同时url上get参数也可以隐藏变量名。

举例说明一下:

按照变量名绑定 链接 http://localhost/forum/index.php/Admin/admin/article/act/edit/aid/2 那么打印出来的结果

你要进行的操作是edit,你想要edit的文章id是2

链接 http://localhost/forum/index.php/Admin/admin/article/aid/2/act/edit 那么打印出来的结果

你要进行的操作是edit,你想要edit的文章id是2

可以看出无论怎么变换位置,得到的结果是一样的。

按照变量顺序绑定 链接 http://localhost/forum/index.php/Admin/admin/article/edit/2 那么打印出来的结果

你要进行的操作是edit,你想要edit的文章id是2

链接 http://localhost/forum/index.php/Admin/admin/article/2/edit 那么打印出来的结果

你要进行的操作是2,你想要edit的文章id是edit

因此如果采用变量顺序绑定时,一定要确保url上的get参数顺序与操作方法上的参数顺序一致。

值得注意的是按照变量名绑定仅对类似于pathinfo方式的地址有效。如pathinfo模式兼容模式

伪静态

伪静态是相对于静态页面来说的,主要是为了更好的SEO效果,并不是真正的静态,而是在URL的结尾添加了类似htmlhtm等的后缀。在TP中默认是开启伪静态的。可以通过URL_HTML_SUFFIX来设置静态的后缀名,如:

'URL_HTML_SUFFIX'=>'shtml'

访问:

http://localhost/forum/index.php/Admin/admin/article/2/edit.shtml 

就是有效的,而访问.html则会报错。也可以设置多个静态后缀,使用**|**来进行分割。

// 多个伪静态后缀设置 用|分割
'URL_HTML_SUFFIX' => 'html|shtml|htm' 

也可以对某些后缀进行禁止访问,利用URL_DENY_SUFFIX

'URL_HTML_SUFFIX' => 'html' 

设置后就不能访问任何以html为后缀的url。可以将URL的模式改成rewrite模式来配合伪静态,否则一个链接上既有.php,也有.html看上去很别扭。

注意:使用伪静态模式必须开启httpd.confmod_rewrite.so模块。

rewire模式切换

开启rewrite模式需要配合修改apache的重写内容。

打开httpd.conf文件,搜索mod_rewrite.so,将该模块前面的#删除。然后新建.htaccess,放入如下代码:

<IfModule mod_rewrite.c>
    RewriteEngine on
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteRule ^(.*)$ index.php/$1 [QSA,PT,L]
</IfModule>

保存到项目入口文件同级目录。重启apache即可。

apache的部分重写规则

实现伪静态多数是利用apache的URL重写规则(RewriteRule),我不是很懂RewriteRule,只是从网上找来了一些资料。 上述代码中,RewriteEngine表示是否开启重写引擎,RewriteCond重写应用条件,RewriteRule表示重写规则。从代码中明显看出,利用了正则表达式的功能。

正则表达式含义

表达式 含义 表达式 含义
0-1个字符 $ 段落结束字符
. 1个字符 \ 转移字符
* 0-x个字符 取反
+ 1-x个字符 () 内存限定传值
^ 段落开始字符 [0-9] 所有数字字符
[a-z] 所有小写字母 [A-Z] 所有大写字母
{n} 重复n次 {n,} 重复n次或更多次
{n,m} 重复n到m次

在被匹配的字符串中$N表示与表达式中第一个()进行匹配,上述代码中RewriteRule中的$1就表示与表达式中的第一个()进行匹配,这样所有index.php/都会被其他字符或空字符匹配。

RewriteRule我确实不怎么懂,网上的资料也很乱,就不多写了,英语好的同学去看官方文档吧。

总结

今天关于控制器的学习就写到这里,还有很多想要说的,但没必要都一一赘述。下次会将阅读源码的一些想法写出来。最后想吐槽一下,简书关于PHP的程序员好像很少,每次找很长时间才能看见一篇关于PHP的,醉了醉了。