ThinkPHP 3.2.3快速入门
简单一些大概内容如下:
1. index.php文件的了解;
2. 调试模式;
3. 配置;
4. 控制器;
5. Url请求;
6. 视图;
7. 读取数。
- 学习参考资料: ThinkPHP3.2.3快速入门;
- 本内容属于方便自己复习的以及得瑟的记录。
- 建议学习方式: 大脑CPU无法超负荷运作,上帝倒是想给你灵感,问题是你给淌出休息的时间啊。
I 、入口文件index.php
首先是index.php(入口文件)的代码内容:
<?php
/* 应用入口文件 */
// 检测PHP环境
if(version_compare(PHP_VERSION,'5.3.0','<')) die('require PHP > 5.3.0 !');
// 开启调试模式 建议开发阶段开启 部署阶段注释或者设为false
define('APP_DEBUG',True);
// 定义应用目录
define('APP_PATH','./Application/');
// 引入ThinkPHP入口文件
require './ThinkPHP/ThinkPHP.php';
// 亲^_^ 后面不需要任何代码了 就是如此简单
ThinkPHP默认目录结构: –+
Direcotry:
Application (应用目录)
Public (资源目录)
ThinkPHP (框架目录)
Files:
.htaccess((略))
.composer.json (略)
ReadMe.md (略)
index.php (入口文件)
- 3.2版本开始相比之前的版本自带了一个完整的应用目录结构(Application)和默认的应用入口文件(index.php),开发人员可以在这个基础之上灵活调整(目录名称和位置)。
- 其中,Application和Public目录下面都是空的,而README.md和composer.josn文件仅用于说明,实际部署的时候可以删除。
- 框架核心目录的结构无需改变,但框架的目录名称(ThinkPHP)可以在应用入口文件中随意更改。
3.2 版本开始框架自带了一个应用入口文件,默认内容如下(可以参考上面的index.php):
// 代码的作用就是定义应用目录和加载ThinkPHP框架的入口文件,这是所有基于ThinkPHP开发应用的第一步。
define('APP_PATH','./Application/');
require './ThinkPHP/ThinkPHP.php';
先不要去管上面这些内容!打开浏览器 `http://locahost/thinkphp/index.php
,会出现下面的内容:
忘记说了,之前Application是没有任何内容的,当运行了在浏览器运行了index.php,Application就自动生成了一些内容:
Application
├─Common 应用公共模块
│ ├─Common 应用公共函数目录
│ └─Conf 应用公共配置文件目录
├─Home 默认生成的Home模块
│ ├─Conf 模块配置文件目录
│ ├─Common 模块函数公共目录
│ ├─Controller 模块控制器目录
│ ├─Model 模块模型目录
│ └─View 模块视图文件目录
├─Runtime 运行时目录
│ ├─Cache 模版缓存目录
│ ├─Data 数据目录
│ ├─Logs 日志目录
│ └─Temp 缓存目录模块设计
- 由于采用多层的MVC机制,除了Conf和Common目录外,每个模块下面的目录结构可以根据需要灵活设置和添加,所以并不拘泥于上面展现的目录。
如果我要添加新的模块,有没有快速生成模块目录结构的办法呢?只需要在入口文件中添加如下定义(假设要生成Admin模块):
define('APP_PATH','./Application/'); //绑定入口文件到Admin模块访问
define('BIND_MODULE','Admin');//如果有需要请将代码注释掉,具体理由见下2注意。
require './ThinkPHP/ThinkPHP.php'
- BIND_MODULE常量定义表示绑定入口文件到某个模块,由于并不存在Admin模块,所以会在第一次访问的时候自动生成。重新访问入口文件后,就会再次看到欢迎页面,这个时候在Application下面已经自动生成了Admin模块及其目录结构。
- 注意:生成以后,你需要删除(或者注释掉)刚才添加的那段常量定义才能正常访问Home模块,否则就只能访问Admin模块(因为应用入口中已经绑定了Admin模块)。
有些情况下,我们需要更改应用目录、运行时目录和框架的位置,那么可以修改入口文件如下:
define('APP_PATH','./Apps/'); //定义应用目录
define('RUNTIME_PATH','./Runtime/'); //定义运行时目录
require './Think/ThinkPHP.php'; //更名框架目录名称,并载入框架入口文件
以及该段代码产生的效果:
WWW WEB部署目录(或者子目录)
├─index.php 应用入口文件
├─Apps 应用目录
├─Public 资源文件目录
├─Runtime 运行时目录
└─Think 框架目录
II、调试模式 :
ThinkPHP支持调试模式,默认情况下是运行在部署模式下面。部署模式下面性能优先,并且尽可能少地抛出错误信息,调试模式则以除错方便优先,关闭任何缓存,而且尽可能多的抛出错误信息,所以对性能有一定的影响。
部署模式采用了项目编译机制,第一次运行会对核心和项目相关文件进行编译缓存,由于编译后会影响开发过程中对配置文件、函数文件和数据库修改的生效(除非你修改后手动清空Runtime下面的缓存文件)。因此为了避免以上问题,我们强烈建议新手在使用ThinkPHP开发的过程中使用调试模式,这样可以更好的获取错误提示和避免一些不必要的问题和烦恼。
开启调试模式很简单,我们只需要在入口文件(index.php)的开头加上一行常量定义代码:
define('APP_DEBUG', true); // 开启调试模式
define('APP_PATH','./Application/');
require './ThinkPHP/ThinkPHP.php';
1). 开发完成后,我们实际进行项目部署的时候,删除这行常量定义代码即可,或者改成:define('APP_DEBUG', false);
。
2). 为了安全考虑,避免泄露你的服务器WEB目录信息等资料,一定记得正式部署的时候关闭调试模式。
III、配置 :
每个应用模块都有独立的配置文件 (位于模块目录的Conf/config.php ),配置文件的定义格式支持PHP/JSON/YAML/INI/XML
等方式,默认采用PHP数组定义,例如:
// 配置文件
return array(
'配置参数' => '配置值',
// 更多配置参数
//...
);
- 如果需要为各个模块定义公共的配置文件,可以在公共模块中定义(通常位于 Common/Conf/config.php),定义格式是一样。
- 一旦有需要,我们就可以在配置文件中添加相关配置项目。通常我们提到的添加配置项目,就是指在项目配置文件中添加:
'配置参数'=>'配置值'
。 - 配置值可以支持包括字符串、数字、布尔值和数组在内的数据,通常我们建议配置参数均使用大写定义。
- 如果有需要,我们还可以为项目定义其他类型的配置文件,如果要使用其他格式的配置文件,可以在入口文件中定义CONF_EXT常量即可,例如:
define('CONF_EXT','.ini');
。 - 这样,模块的配置文件就变成了 Conf/config.ini,定义格式如下:
DEFAULT_MODULE = Index ;默认模块
URL_MODEL = 2 ;URL模式
- 更多的配置定义请参考后续的内容。
IV、控制器 :
需要为每个控制器定义一个控制器类,控制器类的命名规范是:
控制器名+Controller.class.php (模块名采用驼峰法并且首字母大写)
系统的默认控制器是Index,对应的控制器就是模块目录下面的Controller/IndexController.class.php
,类名和文件名一致。默认操作是index,也就是控制器的一个public方法。初次生成项目目录结构的时候,系统已经默认生成了一个默认控制器(就是之前看到的欢迎页面), 把index方法改成下面的代码:
<?php
namespace Home\Controller;
use Think\Controller;
class IndexController extends Controller {
public function index(){
echo 'hello,thinkphp!';
}
}
再次访问入口文件的时候, 在浏览器中看到默认的欢迎页面已经改成如下输出:
hello,thinkphp!
可以为操作方法定义参数, 例如:
<?php
namespace Home\Controller;
use Think\Controller;
class IndexController extends Controller {
public function hello($name='thinkphp'){
echo 'hello,'.$name.'!';
}
}
当带name参数访问入口文件地址 (例如:http://localhost/index.php/home/index/hello/name/baby
)的时候,在浏览器中可以看到如下输出:
hello,baby!
一个模块可以包括多个操作方法,但如果你的操作方法是protected或者private类型的话,是无法直接通过URL访问到该操作的。
我们修改Index控制器类的方法如下:
<?php
namespace Home\Controller;
use Think\Controller;
class IndexController extends Controller {
public function hello(){ echo 'hello,thinkphp!';}
protected function hello2(){ echo '只是protected方法!';}
private function hello3(){ echo '这是private方法!';}
}
当我们访问hello2和hello3操作方法后的结果都会显示非法操作:
V、URL请求 :
ThinkPHP采用单一入口模式访问应用,对应用的所有请求都定向到应用的入口文件,系统会从URL参数中解析当前请求的模块、控制器和操作。标准的URL访问格式:
http://serverName/index.php/模块/控制器/操作
直接访问入口文件index.php,(由于URL中没有模块、控制器和操作,因此系统会访问默认模块(Home)下面的默认控制器(Index)的默认操作(index)),所以以下访问是等效的:
http://serverName/index.php
http://serverName/index.php/Home/Index/index
这种URL模式就是系统默认的PATHINFO模式, 不同的URL模式获取模块和操作的方法不同。ThinkPHP支持的URL模式有四种:{
普通模式、
PathInfo、
ReWrite
兼容模式。
} *注: {}的所有字母为大写,我是稍微完美控的强迫症。
1 普通模式
普通模式也就是使用传统的GET传参方式来指定当前访问的模块、控制器和操作,例如:
/*m参数表示模块,c表示控制器,a表示操作(当然,这些参数名是可以配置的),后面的表示其他GET参数。*/
http://localhost/?m=home&c=index&a=hello&name=thinkphp。
/* 默认值可以不传,因此下面的URL访问是和上面的等效:*/
http://localhost/?a=hello&name=thinkphp
2 PathInfo模式
PATHINFO模式是系统的默认URL模式,提供了最好的SEO支持,系统内部已经做了环境的兼容处理,所以能够支持大多数的主机环境。
对应上面的URL模式,PATHINFO模式下面的URL访问地址是:
http://localhost/index.php/home/index/hello/name/thinkphp/
PathInfo地址的前三个参数分别表示模块/控制器/操作。
PATHINFO模式下面,也可以用普通模式的参数方式传入参数,例如:
http://localhost/index.php/home/index/hello?name=thinkphp
PATHINFO模式下面,URL参数分隔符是可定制的,例如,通过下面的配置:
'URL_PATHINFO_DEPR'=>'-',// 更改PATHINFO参数分隔符
可以支持下面的URL访问:
http://localhost/index.php/home-index-hello-name-thinkphp
3 ReWrite模式
REWRITE模式是在PATHINFO模式的基础上添加了重写规则的支持,可以去掉URL地址里面的入口文件index.php,但是需要额外配置WEB服务器的重写规则。
如果是Apache则需要在入口文件的同级添加.htaccess文件, 内容如下:
<IfModule mod_rewrite.c>
RewriteEngine on
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ index.php/$1 [QSA,PT,L]
</IfModule>
接下来就可以使用下面的URL地址访问了:
http://localhost/home/index/hello/name/thinkphp/
4 兼容模式
兼容模式是用于不支持PATHINFO的特殊环境 ,URL地址是:
http://localhost/?s=/home/index/hello/name/thinkphp
兼容模式配合Web服务器重写规则的定义,可以达到和REWRITE模式一样的URL效果。
VI、视图 View :
ThinkPHP内置了一个编译型模板引擎,也支持原生的PHP模板,并且还提供了包括Smarty在内的模板引擎驱动。
和Smarty不同, ThinkPHP在渲染模板的时候如果不指定模板, 则会采用系统默认的定位规则。
其定义规范默认是模块目录下面的 View/控制器名/操作名.html
,所以,
Index模块的hello操作的默认模板文件位于Home模块目录下面的View/Index/hello.html
,
我们添加模板内容如下:
html>
<head>
<title>hello {$name}</title>
</head>
<body>
hello, {$name}!
</body>
</html>
要输出视图,必须在控制器方法中进行模板渲染输出操作,例如:
<?php
namespace Home\Controller;
use Think\Controller;
class IndexController extends Controller {
public function hello($name='thinkphp'){
$this->assign('name',$name);
$this->display();
}
}
display方法中我们没有指定任何模板,所以按照系统默认的规则输出了Index/hello.html模板文件。接下来,我们在浏览器访问输出:
hello,thinkphp!
VII、读取数据 :
在开始之前,我们首先在数据库thinkphp中创建一个think_data数据表 (以mysql数据库为例):
CREATE TABLE IF NOT EXISTS `think_data`(
`id`int(8)unsigned NOT NULL AUTO_INCREMENT,
`data` varchar(255) NOT NULL,
PRIMARY KEY (`id`)
) ENGINE=MyISAM DEFAULT CHARSET=utf8 ;
INSERT INTO `think_data`(`id`,`data`) VALUES
(1,'thinkphp'),
(2,'php'),
(3,'framework');
如果我们需要读取数据库中的数据,就需要在模块配置文件中添加数据库连接信息如下:
// 添加数据库配置信息
'DB_TYPE'=>'mysql',// 数据库类型
'DB_HOST'=>'127.0.0.1',// 服务器地址
'DB_NAME'=>'thinkphp',// 数据库名
'DB_USER'=>'root',// 用户名
'DB_PWD'=>'',// 密码
'DB_PORT'=>3306,// 端口
'DB_PREFIX'=>'think_',// 数据库表前缀
'DB_CHARSET'=>'utf8',// 数据库字符集
接下来,我们修改下控制器方法,添加读取数据的代码:
namespace Home\Controller;
use Think\Controller;
class IndexController extends Controller{
public function index(){
$Data = M('Data');// 实例化Data数据模型
$result = $Data->find(1);
$this->assign('result',$result);
$this->display();
}
}
这里用到了M函数,是ThinkPHP内置的实例化模型的方法,而且用M方法实例化模型不需要创建对应的模型类,你可以理解为M方法是直接在操作底层的Model类,而Model类具备基本的CURD操作方法。
M(‘Data’) 实例化后,就可以对 think_data
数据表( think_ 是我们在项目配置文件中定义的数据表前缀 ) 进行操作(包括CURD)了,
M函数的用法还有很多,我们以后会深入了解。
定义好控制器后,我们修改模板文件,添加数据输出标签如下:
<html>
<head>
<title></title>
</head>
<body>
{$result.id}--{$result.data}
</body>
</html>
模板标签的用法和Smarty类似,就是用于输出数据的字段,这里就表示输出think_data表的id和data字段的值。
我们访问会输出:
1–thinkphp
- 如果发生错误,检查你是否开启了调试模式或者清空Runtime目录下面的缓存文件。
- 如果你看到了上面的输出结果,那么恭喜你已经拿到了入门ThinkPHP的钥匙!
base note one 1 end.