简介
ThinkPHP是一个快速、简单的基于MVC和面向对象的轻量级PHP开发框架,遵循Apache2开源协议发布,从诞生以来一直秉承简洁实用的设计原则,在保持出色的性能和至简的代码的同时,尤其注重开发体验和易用性,并且拥有众多的原创功能和特性,为WEB应用开发提供了强有力的支持。
目录结构
ThinkPHP最新版本可以在官方网站(http://thinkphp.cn/down/framework.html)或者Github(https://github.com/liu21st/thinkphp/downloads)下载。
把下载后的压缩文件解压到你的WEB目录(或者任何目录都可以),框架的目录结构为:
3.2版本相比之前的版本自带了一个完整的应用目录结构(Application)和默认的应用入口文件(index.php),开发人员可以在这个基础之上灵活调整(目录名称和位置)。其中,Application和Public目录下面都是空的,而README.md文件仅用于说明,实际部署的时候可以删除。
其中,ThinkPHP为框架核心目录,其目录结构如下:
入口文件
在开始之前,你需要一个Web服务器和PHP运行环境,如果你暂时还没有,我们推荐使用集成开发环境WAMPServer(是一个集成了Apache、PHP和MySQL的开发套件,而且支持多个PHP版本、MySQL版本和Apache版本的切换)来使用ThinkPHP进行本地开发和测试。
3.2版本开始框架自带了一个应用入口文件,默认内容如下:
这段代码的作用就是定义应用目录和加载ThinkPHP框架的入口文件,这是所有基于ThinkPHP开发应用的第一步。
然后,在浏览器中访问运行后我们会看到欢迎页面,
这个页面比3.1版本多了一个当前访问的控制器提示,因为3.2版本支持多模块自动生成,暂且不表。
当你看到这个欢迎页面的时候,系统已经在Application下面自动生成了公共模块Common、默认的Home模块和Runtime运行时目录的目录结构:
3.2版本采用模块化的设计架构,下面是一个典型的模块目录结构,每个模块可以方便的卸载和部署,并且支持公共模块(Runtime目录非模块目录)。
如何生成其他模块的目录结构呢?只需要在入口文件中添加如下定义:
在Application下面已经自动生成了Admin模块及其目录机构。
注意:生成以后,你需要删除刚才那段常量定义才能正常访问Home模块。
有些情况下,我们需要更改应用目录、运行时目录和框架的位置,那么可以修改入口文件如下:
调试模式
ThinkPHP支持调试模式,默认情况下是运行在部署模式下面。部署模式下面性能优先,并且尽可能少地抛出错误信息,调试模式则以除错方便优先,关闭任何缓存,而且尽可能多的抛出错误信息,所以对性能有一定的影响。部署模式采用了项目编译机制,第一次运行会对核心和项目相关文件进行编译缓存,由于编译后会影响开发过程中对配置文件、函数文件和数据库修改的生效(除非你修改后手动清空Runtime下面的缓存文件)。因此为了避免以上问题,我们强烈建议新手在使用ThinkPHP开发的过程中使用调试模式,这样可以更好的获取错误提示和避免一些不必要的问题和烦恼。
开启调试模式很简单,我们只需要在入口文件的开头加上一行常量定义代码:
配置
每个应用模块都有独立的配置文件(位于模块目录的Conf/config.php),配置文件的定义格式支持PHP/JSON/YAML/INI/XML等方式,默认采用PHP数组定义,例如:
一旦有需要,我们就可以在配置文件中添加相关配置项目。通常我们提到的添加配置项目,就是指在项目配置文件中添加:
配置值可以支持包括字符串、数字、布尔值和数组在内的数据,通常我们建议配置参数均使用大写定义。如果有需要,我们还可以为项目定义其他的配置文件。
如果要使用其他格式的配置文件,可以在入口文件中定义CONF_EXT常量即可,例如:
控制器
需要为每个模块定义一个控制器类,控制器类的命名规范是:
模块名+Controller.class.php (模块名采用驼峰法并且首字母大写)
系统的默认模块是Index,对应的控制器就是模块目录下面的Controller/IndexController.class.php,类名和文件名一致。默认操作是index,也就是控制器的一个public方法。初次生成项目目录结构的时候,系统已经默认生成了一个默认控制器(就是之前看到的欢迎页面),我们把index方法改成下面的代码:
再次访问入口文件的时候,在浏览器中看到默认的欢迎页面已经改成如下输出:
一个模块可以包括多个操作方法,但如果你的操作方法是protected或者private类型的话,是无法直接通过URL访问到该操作的。
URL请求
ThinkPHP采用单一入口模式访问应用,对应用的所有请求都定向到应用的入口文件,系统会从URL参数中解析当前请求的模块、控制器和操作,下面是一个标准的URL访问格式:
如果我们直接访问入口文件的话,由于URL中没有模块、控制器和操作,因此系统会访问默认模块(Home)下面的默认控制器(Index)的默认操作(index),因此下面的访问是等效的:
普通模式:也就是传统的GET传参方式来指定当前访问的模块和操作,例如:
m参数表示模块,c表示控制器,a表示操作(当然,这些参数名是可以配置的),后面的表示其他GET参数。
PATHINFO模式:是系统的默认URL模式,提供了最好的SEO支持,系统内部已经做了环境的兼容处理,所以能够支持大多数的主机环境。对应上面的URL模式,PATHINFO模式下面的URL访问地址是:
PATHINFO地址的前三个参数分别表示模块/控制器/操作。PATHINFO模式下面,URL是可定制的,例如,通过下面的配置:
我们可以支持下面的URL访问:
REWRITE模式:是在PATHINFO模式的基础上添加了重写规则的支持,可以去掉URL地址里面的入口文件index.php,但是需要额外配置WEB服务器的重写规则。
如果是Apache则需要在入口文件的同级添加.htaccess文件,内容如下:
接下来就可以使用下面的URL地址访问了
兼容模式:是用于不支持PATHINFO的特殊环境,URL地址是:
兼容模式配合Web服务器重写规则的定义,可以达到和REWRITE模式一样的URL效果。
视图
ThinkPHP内置了一个编译型模板引擎,也支持原生的PHP模板,并且还提供了包括Smarty在内的模板引擎驱动。和Smarty不同,ThinkPHP在渲染模板的时候如果不指定模板,则会采用系统默认的定位规则,其定义规范默认是模块目录下面的 View/控制器名/操作名.html,所以,Index模块的index操作的默认模板文件位于Home模块目录下面的View/Index/index.html,我们添加模板内容如下:
要输出视图,必须在控制器方法中进行模板渲染输出操作,例如:
display方法中我们没有指定任何模板,所以按照系统默认的规则输出了Index/index.html模板文件。
接下来,我们在浏览器访问输出:
hello,thinkphp!
读取数据
在开始之前,我们首先在数据库thinkphp中创建一个think_data数据表(以mysql数据库为例):
如果我们需要读取数据库中的数据,就需要在模块配置文件中添加数据库连接信息如下:
或者采用如下配置
使用DB_DSN方式定义可以简化配置参数,DSN参数格式为:
数据库类型://用户名:密码@数据库地址:数据库端口/数据库名
如果两种配置参数同时存在的话,DB_DSN配置参数优先。
接下来,我们修改下控制器方法,添加读取数据的代码:
这里用到了M函数,是ThinkPHP内置的实例化模型的方法,而且用M方法实例化模型不需要创建对应的模型类,你可以理解为M方法是直接在操作底层的Model类,而Model类具备基本的CURD操作方法。
M('Data') 实例化后,就可以对think_data数据表(think_ 是我们在项目配置文件中定义的数据表前缀)进行操作(包括CURD)了,M函数的用法还有很多,我们以后会深入了解。
定义好控制器后,我们修改模板文件,添加数据输出标签如下:
我们访问会输出:
如果发生错误,检查你是否开启了调试模式或者清空Runtime目录下面的缓存文件。
如果你看到了上面的输出结果,那么恭喜你已经拿到了入门ThinkPHP的钥匙!
总结
本篇我们学习了ThinkPHP的目录结构、URL模式,如何创建项目的入口文件和开启调试模式,以及控制器、模板和模型的基础认识,后面会继续了解对数据的CURD操作。
ThinkPHP是一个快速、简单的基于MVC和面向对象的轻量级PHP开发框架,遵循Apache2开源协议发布,从诞生以来一直秉承简洁实用的设计原则,在保持出色的性能和至简的代码的同时,尤其注重开发体验和易用性,并且拥有众多的原创功能和特性,为WEB应用开发提供了强有力的支持。
目录结构
ThinkPHP最新版本可以在官方网站(http://thinkphp.cn/down/framework.html)或者Github(https://github.com/liu21st/thinkphp/downloads)下载。
把下载后的压缩文件解压到你的WEB目录(或者任何目录都可以),框架的目录结构为:
www WEB部署目录(或者子目录) ├─index.php 入口文件 ├─README.md README文件 ├─Application 应用目录 ├─Public 资源文件目录 └─ThinkPHP 框架目录
3.2版本相比之前的版本自带了一个完整的应用目录结构(Application)和默认的应用入口文件(index.php),开发人员可以在这个基础之上灵活调整(目录名称和位置)。其中,Application和Public目录下面都是空的,而README.md文件仅用于说明,实际部署的时候可以删除。
其中,ThinkPHP为框架核心目录,其目录结构如下:
├─ThinkPHP 框架系统目录(可以部署在非web目录下面) │ ├─Common 核心公共函数目录 │ ├─Conf 核心配置目录 │ ├─Lang 核心语言包目录 │ ├─Library 框架类库目录 │ │ ├─Think 核心Think类库包目录 │ │ ├─Behavior 行为类库目录 │ │ ├─Org Org类库包目录 │ │ ├─Vendor 第三方类库目录 │ │ ├─ ... 更多类库目录 │ ├─Mode 框架应用模式目录 │ ├─Tpl 系统模板目录 │ ├─LICENSE.txt 框架授权协议文件 │ ├─logo.png 框架LOGO文件 │ ├─README.txt 框架README文件 │ └─index.php 框架入口文件
入口文件
在开始之前,你需要一个Web服务器和PHP运行环境,如果你暂时还没有,我们推荐使用集成开发环境WAMPServer(是一个集成了Apache、PHP和MySQL的开发套件,而且支持多个PHP版本、MySQL版本和Apache版本的切换)来使用ThinkPHP进行本地开发和测试。
3.2版本开始框架自带了一个应用入口文件,默认内容如下:
define('APP_PATH','./Application/'); require './ThinkPHP/ThinkPHP.php';
这段代码的作用就是定义应用目录和加载ThinkPHP框架的入口文件,这是所有基于ThinkPHP开发应用的第一步。
然后,在浏览器中访问运行后我们会看到欢迎页面,
这个页面比3.1版本多了一个当前访问的控制器提示,因为3.2版本支持多模块自动生成,暂且不表。
当你看到这个欢迎页面的时候,系统已经在Application下面自动生成了公共模块Common、默认的Home模块和Runtime运行时目录的目录结构:
Application ├─Common 应用公共模块 │ ├─Common 应用公共函数目录 │ └─Conf 应用公共配置文件目录 ├─Home 默认生成的Home模块 │ ├─Conf 模块配置文件目录 │ ├─Common 模块函数公共目录 │ ├─Controller 模块控制器目录 │ ├─Model 模块模型目录 │ └─View 模块视图文件目录 ├─Runtime 运行时目录 │ ├─Cache 模版缓存目录 │ ├─Data 数据目录 │ ├─Logs 日志目录 │ └─Temp 缓存目录模块设计
3.2版本采用模块化的设计架构,下面是一个典型的模块目录结构,每个模块可以方便的卸载和部署,并且支持公共模块(Runtime目录非模块目录)。
Application 默认应用目录(可以设置) ├─Common 公共模块(不能直接访问) ├─Home 前台模块 ├─Admin 后台模块 ├─... 其他更多模块 ├─Runtime 默认运行时目录(可以设置)每个模块是相对独立的,其目录结构如下:
├─Module 模块目录 │ ├─Conf 配置文件目录 │ ├─Common 公共函数目录 │ ├─Controller 控制器目录 │ ├─Model 模型目录 │ ├─Logic 逻辑目录(可选) │ ├─Service Service目录(可选) │ ... 更多分层目录可选 │ └─View 视图目录由于采用多层的MVC机制,除了Conf和Common目录外,每个模块下面的目录结构可以根据需要灵活设置和添加,所以并不拘泥于上面展现的目录。
如何生成其他模块的目录结构呢?只需要在入口文件中添加如下定义:
define('APP_PATH','./Application/'); // 绑定入口文件到Admin模块访问 define('BIND_MODULE','Admin'); require './ThinkPHP/ThinkPHP.php';BIND_MODULE常量定义表示绑定入口文件到某个模块,由于并不存在Admin模块,所以会在第一次访问的时候自动生成。重新访问入口文件后,就会看到Admin模块的欢迎页面:
在Application下面已经自动生成了Admin模块及其目录机构。
注意:生成以后,你需要删除刚才那段常量定义才能正常访问Home模块。
有些情况下,我们需要更改应用目录、运行时目录和框架的位置,那么可以修改入口文件如下:
// 定义应用目录 define('APP_PATH','./Apps/'); // 定义运行时目录 define('RUNTIME_PATH','./Runtime/'); // 更名框架目录名称,并载入框架入口文件 require './Think/ThinkPHP.php';这样最终的应用目录结构如下:
www WEB部署目录(或者子目录) ├─index.php 应用入口文件 ├─Apps 应用目录 ├─Public 资源文件目录 ├─Runtime 运行时目录 └─Think 框架目录
调试模式
ThinkPHP支持调试模式,默认情况下是运行在部署模式下面。部署模式下面性能优先,并且尽可能少地抛出错误信息,调试模式则以除错方便优先,关闭任何缓存,而且尽可能多的抛出错误信息,所以对性能有一定的影响。部署模式采用了项目编译机制,第一次运行会对核心和项目相关文件进行编译缓存,由于编译后会影响开发过程中对配置文件、函数文件和数据库修改的生效(除非你修改后手动清空Runtime下面的缓存文件)。因此为了避免以上问题,我们强烈建议新手在使用ThinkPHP开发的过程中使用调试模式,这样可以更好的获取错误提示和避免一些不必要的问题和烦恼。
开启调试模式很简单,我们只需要在入口文件的开头加上一行常量定义代码:
define('APP_PATH','./Application/'); define('APP_DEBUG', true); // 开启调试模式 require './ThinkPHP/ThinkPHP.php';开发完成后,我们实际进行项目部署的时候,删除这行常量定义代码即可,或者改成:
define('APP_PATH','./Application/'); define('APP_DEBUG',false); // 关闭调试模式 require './ThinkPHP/ThinkPHP.php';
配置
每个应用模块都有独立的配置文件(位于模块目录的Conf/config.php),配置文件的定义格式支持PHP/JSON/YAML/INI/XML等方式,默认采用PHP数组定义,例如:
// 配置文件 return array( '配置参数' => '配置值', // 更多配置参数 //... );如果你需要为各个模块定义公共的配置文件,可以在公共模块中定义 Conf/config.php,定义格式是一样。
一旦有需要,我们就可以在配置文件中添加相关配置项目。通常我们提到的添加配置项目,就是指在项目配置文件中添加:
'配置参数'=>'配置值',
配置值可以支持包括字符串、数字、布尔值和数组在内的数据,通常我们建议配置参数均使用大写定义。如果有需要,我们还可以为项目定义其他的配置文件。
如果要使用其他格式的配置文件,可以在入口文件中定义CONF_EXT常量即可,例如:
define('CONF_EXT','.ini');这样,模块的配置文件就变成了 Conf/config.ini,定义如下:
DEFAULT_MODULE = Index ;默认模块 URL_MODEL = 2 ;URL模式更多的配置定义请参考后续的内容。
控制器
需要为每个模块定义一个控制器类,控制器类的命名规范是:
模块名+Controller.class.php (模块名采用驼峰法并且首字母大写)
系统的默认模块是Index,对应的控制器就是模块目录下面的Controller/IndexController.class.php,类名和文件名一致。默认操作是index,也就是控制器的一个public方法。初次生成项目目录结构的时候,系统已经默认生成了一个默认控制器(就是之前看到的欢迎页面),我们把index方法改成下面的代码:
<?php namespace Home\Controller; use Think\Controller; class IndexController extends Controller { public function hello(){ echo 'hello,thinkphp!'; } }
再次访问入口文件的时候,在浏览器中看到默认的欢迎页面已经改成如下输出:
hello,thinkphp!
一个模块可以包括多个操作方法,但如果你的操作方法是protected或者private类型的话,是无法直接通过URL访问到该操作的。
URL请求
ThinkPHP采用单一入口模式访问应用,对应用的所有请求都定向到应用的入口文件,系统会从URL参数中解析当前请求的模块、控制器和操作,下面是一个标准的URL访问格式:
http://serverName/index.php/模块/控制器/操作
如果我们直接访问入口文件的话,由于URL中没有模块、控制器和操作,因此系统会访问默认模块(Home)下面的默认控制器(Index)的默认操作(index),因此下面的访问是等效的:
http://serverName/index.php http://serverName/index.php/Home/Index/index这种URL模式就是系统默认的PATHINFO模式,不同的URL模式获取模块和操作的方法不同,ThinkPHP支持的URL模式有四种:普通模式、PATHINFO、REWRITE和兼容模式。
普通模式:也就是传统的GET传参方式来指定当前访问的模块和操作,例如:
http://localhost/?m=home&c=user&a=login&var=value
m参数表示模块,c表示控制器,a表示操作(当然,这些参数名是可以配置的),后面的表示其他GET参数。
PATHINFO模式:是系统的默认URL模式,提供了最好的SEO支持,系统内部已经做了环境的兼容处理,所以能够支持大多数的主机环境。对应上面的URL模式,PATHINFO模式下面的URL访问地址是:
http://localhost/index.php/home/user/login/var/value/
PATHINFO地址的前三个参数分别表示模块/控制器/操作。PATHINFO模式下面,URL是可定制的,例如,通过下面的配置:
'URL_PATHINFO_DEPR'=>'-',// 更改PATHINFO参数分隔符
我们可以支持下面的URL访问:
http://localhost/index.php/home-user-login-var-value
REWRITE模式:是在PATHINFO模式的基础上添加了重写规则的支持,可以去掉URL地址里面的入口文件index.php,但是需要额外配置WEB服务器的重写规则。
如果是Apache则需要在入口文件的同级添加.htaccess文件,内容如下:
<IfModulemod_rewrite.c> RewriteEngine on RewriteCond %{REQUEST_FILENAME} !-d RewriteCond %{REQUEST_FILENAME} !-f RewriteRule ^(.*)$ index.php/$1 [QSA,PT,L] </IfModule>
接下来就可以使用下面的URL地址访问了
http://localhost/app/module/action/var/value/
兼容模式:是用于不支持PATHINFO的特殊环境,URL地址是:
http://localhost/?s=/home/user/login/var/value
兼容模式配合Web服务器重写规则的定义,可以达到和REWRITE模式一样的URL效果。
视图
ThinkPHP内置了一个编译型模板引擎,也支持原生的PHP模板,并且还提供了包括Smarty在内的模板引擎驱动。和Smarty不同,ThinkPHP在渲染模板的时候如果不指定模板,则会采用系统默认的定位规则,其定义规范默认是模块目录下面的 View/控制器名/操作名.html,所以,Index模块的index操作的默认模板文件位于Home模块目录下面的View/Index/index.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(){ $this->assign('name','thinkphp'); $this->display(); } }
display方法中我们没有指定任何模板,所以按照系统默认的规则输出了Index/index.html模板文件。
接下来,我们在浏览器访问输出:
hello,thinkphp!
读取数据
在开始之前,我们首先在数据库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'=>'localhost',// 服务器地址 'DB_NAME'=>'thinkphp',// 数据库名 'DB_USER'=>'root',// 用户名 'DB_PWD'=>'',// 密码 'DB_PORT'=>3306,// 端口 'DB_PREFIX'=>'think_',// 数据库表前缀
或者采用如下配置
'DB_DSN'=>'mysql://root@localhost:3306/thinkphp', 'DB_PREFIX'=>'think_',// 数据库表前缀
使用DB_DSN方式定义可以简化配置参数,DSN参数格式为:
数据库类型://用户名:密码@数据库地址:数据库端口/数据库名
如果两种配置参数同时存在的话,DB_DSN配置参数优先。
接下来,我们修改下控制器方法,添加读取数据的代码:
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>volist标签是内置模板引擎用于输出数据集的标签。{$vo.id} 和 {$vo.data} 的用法和Smarty类似,就是用于输出数据的字段,这里就表示输出think_data表的id和data字段的值。
我们访问会输出:
1--thinkphp
如果发生错误,检查你是否开启了调试模式或者清空Runtime目录下面的缓存文件。
如果你看到了上面的输出结果,那么恭喜你已经拿到了入门ThinkPHP的钥匙!
总结
本篇我们学习了ThinkPHP的目录结构、URL模式,如何创建项目的入口文件和开启调试模式,以及控制器、模板和模型的基础认识,后面会继续了解对数据的CURD操作。
- 本文固定链接: https://zxbcw.cn/post/3445/
- 转载请注明:必须在正文中标注并保留原文链接
- QQ群: PHP高手阵营官方总群(344148542)
- QQ群: Yii2.0开发(304864863)