在了解了项目的结构之后,接下来就该实战操作了。对大多数网站而言,登录注册的功能是不可或缺的,这也是许多网站开始的第一步。今天就做一个简单版的登录功能,来了解一下PHP与Web是如何实现交互的。
在开始之前,我们需要先理一下思路。一个登录的逻辑大概是这样:用户输入用户名与密码->网页校验数据->把数据发给后端->后端从数据库中查询后给出响应,成功则跳转,失败给出失败原因。
关联Controller与View
根据以上分析,我们在写具体登录的逻辑前,需要一个静态的网页,还需要一份数据库,用以承载数据。静态的网页是必须的,但是不属于讨论的范畴,所以可以从网上寻找模板,这个网上有很多,当然如果自己会写html,手打自然是最好不过了。
不管是从网上下载的模板,还是自己写的HTML,其结构都与下图类似:
按照上文说的,我们最好应该把 css、js、images等文件放到\Public\Home\相应的文件夹下,那么HTML文件应该放在哪里呢?这里就需要掌握一下TP框架是如何把我们的代码与所请求的链接对应起来的。在TP中(至少在TP3.2.3版本中),TP通过访问 http://域名:端口号/模块名/控制器名/方法名 的规则建立了请求链接与实际代码的对应关系。例如,在第一篇文章中,我们曾经在\Application\Home\Controller\IndexController.class.php中,将框架自动生成的代码替换成了:
echo 'Hello PHP!';
在浏览器中输入http://localhost/thinkphp_3.2.3_full/就看到了这句输出。而在浏览器中输入http://localhost/thinkphp_3.2.3_full/,TP框架实际上做的是:试图寻找跟随在域名和端口号后的模块名、控制器名与方法名。而在这个请求中没有找到这些,TP就会用默认的控制器名和方法名来解析这个请求,所以实际上我们输入http://localhost/thinkphp_3.2.3_full/时,TP就会解析成http://localhost/thinkphp_3.2.3_full/Home/Index/index,也就是它会去寻找项目中位于Home模块下名称为Index的控制器下的定义为index的那个方法,也就是执行了我们替换的那句:
echo 'Hello PHP!';
那么,到底HTML文件应该放在哪里呢?要知道,在TP中,是用MVC模式组织代码的。刚刚的IndexController属于控制器层,而HTML显然应该属于View层,所以我们应该把它放在View文件夹下,并要注意把引用的css、js、images等的相对路径指定到\Public\Home\下对应的路径,修改后类似于下图:
现在,还有另外一个问题,HTML代码被放在了View层里,那么我们应该怎么去访问它呢?刚刚说了,链接里包含的是控制器名,并没有包含View,所以只能是由Controller来调用View。这里直接给出代码:
class IndexController extends Controller {
public function index(){
$this->display();
}
}
就是把刚刚那句打印,换成:
$this->display();
IndexController就会去寻找位于\View\Index\下的index.html文件。display()方法是在TP框架内部定义的,它有几个默认的参数,可以直接看框架中的定义:
/**
* 模板显示 调用内置的模板引擎显示方法,
* @access protected
* @param string $templateFile 指定要调用的模板文件
* 默认为空 由系统自动定位模板文件
* @param string $charset 输出编码
* @param string $contentType 输出类型
* @param string $content 输出内容
* @param string $prefix 模板缓存前缀
* @return void
*/
protected function display($templateFile='',$charset='',$contentType='',$content='',$prefix='') {
$this->view->display($templateFile,$charset,$contentType,$content,$prefix);
}
这些参数都可以灵活选用,默认情况下,如果HTML文件的名称与控制器对应(和控制器名称相同但全部小写),我们可以不传递任何参数。例如我们把HTML文件的名称改为'index1.html',就把
$this->display();
替换成
$this->display('index1');
就可以正常工作了。
然而,做完这些工作后,当我们尝试在浏览器中去访问时,就出现了下面的问题:
稍微了解一点前端,都能看出来是css等文件没有加载出来,而仅仅在HTML文件中定义的其他代码显示出来了,这是在初学时常见的事情。
那么,原因是什么呢?由于我们使用的是Apache服务器,Apache服务器的根路径实际上是www,而我们写相对路径时想当然的把项目的根目录作为根路径了,所以Apache服务器自然找不到我们指定的代码。知道了这点之后,我们就可以想到两种解决方案:给每个路径都增加一个层级,让它相对于www开始;另一种就是,想办法让Apache服务器的根路径和项目的一致。
给每个路径增加层级,把路径写的死死的这种做法是不推荐的,这为我们以后修改或迁移造成了很大的麻烦,所以这里优先采用第二种方法。要实现这种方案,就需要配置vhost,并建立域名映射。具体步骤是:打开wamp安装目录下的\bin\apache\apache2.4.23\conf\extra\httpd-vhosts.conf文件,默认内容如下:
其中的ServerName就是我们访问的地址,DocumentRoot就是指定的根目录。这也是访问http://localhost/时将使用的路径。现在我们把这段代码复制一份,把信息改成自己的项目,如下所示:
这里的DocumentRoot就是我们项目的目录,因为我要把项目同步到git,所以路径改了一下名字,相当于之前的/www/thinkphp_3.2.3_full。
除此之外,还需要在C:\Windows\System32\drivers\etc\hosts文件中,为刚刚配置的域名添加本地映射,内容如下:
然后重启Apache服务器,再打开浏览器就可以看到正确的页面了:
关联数据库
页面显示正常后,开始写业务逻辑了。我们需要在MySQL中建立数据库、数据表,并插入几条数据(由于做的功能是登录,必须先有账号才行),并且把建立的数据库和项目关联起来。
首先,可以通过点击wamp运行起来的图标,选择MySQL->MySQL console,打开mysql控制台,在显示Enter password时直接按回车。或者通过Windows的命令行,进入到wamp安装目录下的\bin\mysql\mysql5.7.14\bin目录,然后输入:
mysql -hlocalhost -uroot -p
按回车,也可以进入到mysql的控制台。其中-h表示服务器名,localhost表示本地;-u为数据库用户名,root是mysql默认用户名;-p为密码,如果设置了密码,可直接在-p后链接输入,如:-p123456,用户没有设置密码,显示Enter password时,直接回车即可。默认情况下是没有设置密码的,所以直接按回车,就会进入下图的页面,等待输入:
接下来需要掌握一些MySQL的命令才能继续下去。首先,可以通过
show databases;
显示现在已有的数据库,如图所示:
然后通过命令创建一个名为tplearn的数据库:
create database tplearn;
要使用创建的数据库,需要使用命令:
use tplearn;
现在,我们就有了项目需要的数据库,然后需要建一张名为user的表,用来存储账号信息。在控制台输入以下代码:
create table if not exists user(
id int unsigned auto_increment,
user_name varchar(50) not null,
user_pass varchar(50) not null,
user_phone varchar(20) not null,
user_email varchar(50) not null,
user_sex tinyint unsigned not null default 0 comment '0 男 1 女',
create_time int unsigned not null default 0,
primary key (id)
)engine=InnoDB default charset=utf8;
这段代码创建了一张名为user的表,字段有id,姓名、密码、手机号、邮箱、性别,还有创建时间等字段,其中id是主键,comment是给字段添加注释。创建好后,可以用
show create table user;
或
desc user;
来显示创建的表结构,示意图如下:
然后,创建几个测试用的账号,添加到数据表中,执行以下两条语句:
insert into user (user_name,user_pass,user_phone,user_email,user_sex,create_time)
values ('test1','123456','13122223333','test1@qq.com',0,0);
insert into user (user_name,user_pass,user_phone,user_email,user_sex,create_time)
values ('test2','654321','13133334444','test2@qq.com',1,0);
完成后,可以通过
select * from user;
查看数据库中所有的数据:
现在,就要把数据库与项目关联在一起。在TP中,这步操作十分简单。只需要从\ThinkPHP\Conf\convention.php中找到注释为“数据库设置”的一段代码,复制到\Application\Common\Conf\config.php中,然后配置一些字段即可,配置后代码如下:
/* 数据库设置 */
'DB_TYPE' => 'mysql', // 数据库类型
'DB_HOST' => '127.0.0.1', // 服务器地址
'DB_NAME' => 'tplearn', // 数据库名
'DB_USER' => 'root', // 用户名
'DB_PWD' => '', // 密码
'DB_PORT' => '3306', // 端口
'DB_PREFIX' => '', // 数据库表前缀
'DB_PARAMS' => array(), // 数据库连接参数
'DB_DEBUG' => TRUE, // 数据库调试模式 开启后可以记录SQL日志
'DB_FIELDS_CACHE' => true, // 启用字段缓存
'DB_CHARSET' => 'utf8', // 数据库编码默认采用utf8
'DB_DEPLOY_TYPE' => 0, // 数据库部署方式:0 集中式(单一服务器),1 分布式(主从服务器)
'DB_RW_SEPARATE' => false, // 数据库读写是否分离 主从式有效
'DB_MASTER_NUM' => 1, // 读写分离后 主服务器数量
'DB_SLAVE_NO' => '', // 指定从服务器序号
在当前阶段,只需要配置前7项即可,其中数据库表前缀指的是创建数据表时,名称前加的前缀,比如创建的数据表为lp_user,前缀就是'lp_',这里没有前缀,保持空即可。现在,数据库就和当前的项目关联在一起了。
关联在一起后,又怎样写SQL语句,来实现业务呢?在TP中,有两种方式来操作数据库,一种是创建一个与数据表对应的Model,Model的名称是数据表名去掉前缀,比如数据表为tp_user,Model名称就定义为UserModel,在Model中就可以进行增删改查等操作了。另外一种,则是通过M()方法直接操作数据表。同时,TP中还定义了一系列函数,用以支持MySQL使用时的连贯操作,这些在手册中都有详细介绍。
第一种方法需要创建Model类,在\Application\Home\Model下新建一个名为UserModel.class.php的php文件,内容如下:
<?php
namespace Home\Model;
use Think\Model;
class UserModel extends Model{
}
namespace为命名空间,定义Model或Controller时都需要指定命名空间,在自动生成的IndexController中也有这个字段。然后在UserModel中写一个测试方法,获取数据库中所有的账号。
public function getUsers(){
return $this->select();
}
这个方法的效果,就等同于"select * from user;"。然后在Controller中就可以这样引用它:
$User = D("User");
$res = $User->getUsers();
D()方法等同于 new UserModel();它是用来简化实例化类的操作的。通过获取UserModel的实例再调用方法就可以得到结果了。
这种方法由于需要实例化类,会消耗部分性能,也因为要实例化类,所以要多写很多代码,适合用于操作比较频繁、语句比较复杂的情况。当仅需要对数据表进行基本的CURD(增删改查)时,还可以使用第二种方法,就是使用M()方法与建立数据表的关联。M()方法和D()方法功能类似,只是它不实例化类,性能较好,所有的CURD操作都需要直接进行,即使定义了UserModel类,M()方法也不会使用它。使用M()方法实现刚才的实例,如下所示:
$User = M("User");
$res = $User->select();
可以想象,当数据操作较为复杂时,使用M()方法会使得Controller类比较臃肿,因此具体使用哪种方法需要权衡考虑。
完成这些工作后,终于可以写具体的逻辑了。由于最初接触,有许多东西需要了解,所以从零到一显得比较复杂,但是掌握了之后,写起代码来还是蛮轻松的。剩余的内容,请参考《ThinkPHP初学者:写一个简单登录页面(二)》。