# 快速入门（一）：基础
> ### 号外
> * [ ThinkPHP V5.0RC3版本发布了！](http://www.thinkphp.cn/topic/38579.html)
> * [看云文档定价和付费阅读功能上线！](http://ihavenolimitations.xyz/blog/notice/36712)
## 简介
ThinkPHP是一个快速、简单的基于MVC和面向对象的轻量级PHP开发框架，遵循Apache2开源协议发布，从诞生以来一直秉承简洁实用的设计原则，在保持出色的性能和至简的代码的同时，尤其注重开发体验和易用性，并且拥有众多的原创功能和特性，为WEB应用开发提供了强有力的支持。
>[info] 本快速入门教程针对3.2.3最新版本制作，虽然大部分特性3.2版本同样存在，但是强烈建议你使用3.2.3版本来学习本入门教程。
## 下载
ThinkPHP最新版本可以在官方网站（[http://thinkphp.cn/down/framework.html](http://thinkphp.cn/down/framework.html)）下载。
最新的3.2.3版本下载地址：[http://www.thinkphp.cn/down/610.html](http://www.thinkphp.cn/down/610.html)。
如果你希望保持最新的更新，可以通过github获取当前最新的版本（完整版）。
Git获取地址列表（你可以选择一个最快的地址）：
* Github： https://github.com/liu21st/thinkphp
* Oschina： http://git.oschina.net/liu21st/thinkphp.git
* Code： https://code.csdn.net/topthink2011/ThinkPHP
* Coding： https://git.coding.net/liu21st/thinkphp.git
## 目录结构
把下载后的压缩文件解压到你的WEB目录（或者任何子目录都可以），框架的目录结构为：
~~~
www WEB部署目录（或者子目录）
├─index.php 入口文件
├─README.md README文件
├─composer.json Composer定义文件
├─Application 应用目录
├─Public 资源文件目录
└─ThinkPHP 框架目录
~~~
3.2版本开始相比之前的版本自带了一个完整的应用目录结构（`Application`）和默认的应用入口文件（`index.php`），开发人员可以在这个基础之上灵活调整（目录名称和位置）。其中，`Application`和`Public`目录下面都是空的，而`README.md`和`composer.josn`文件仅用于说明，实际部署的时候可以删除。
其中，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 框架入口文件
~~~
> 框架核心目录的结构无需改变，但框架的目录名称（ThinkPHP）可以在应用入口文件中随意更改。
## 入口文件
在开始之前，你需要一个Web服务器和PHP运行环境，如果你暂时还没有，我们推荐使用集成开发环境[WAMPServer](http://www.wampserver.com/en/)（是一个集成了Apache、PHP和MySQL的开发套件，而且支持多个PHP版本、MySQL版本和Apache版本的切换）来使用ThinkPHP进行本地开发和测试。
3.2版本开始框架自带了一个应用入口文件，默认内容如下：
~~~
define('APP_PATH','./Application/');
require './ThinkPHP/ThinkPHP.php';
~~~
这段代码的作用就是定义应用目录和加载ThinkPHP框架的入口文件，这是所有基于ThinkPHP开发应用的第一步。
然后，在浏览器中访问运行后我们会看到欢迎页面：
当你看到这个欢迎页面的时候，系统已经在`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 服务目录（可选）
│ ... 更多分层目录可选
│ └─View 视图目录
~~~
由于采用多层的MVC机制，除了Conf和Common目录外，每个模块下面的目录结构可以根据需要灵活设置和添加，所以并不拘泥于上面展现的目录。
如果我要添加新的模块，有没有快速生成模块目录结构的办法呢？只需要在入口文件中添加如下定义（假设要生成Admin模块）：
~~~
define('APP_PATH','./Application/');
// 绑定入口文件到Admin模块访问
define('BIND_MODULE','Admin');
require './ThinkPHP/ThinkPHP.php';
~~~
BIND_MODULE常量定义表示绑定入口文件到某个模块，由于并不存在Admin模块，所以会在第一次访问的时候自动生成。重新访问入口文件后，就会再次看到欢迎页面，这个时候在Application下面已经自动生成了Admin模块及其目录结构。
> 注意：生成以后，你需要删除（或者注释掉）刚才添加的那段常量定义才能正常访问Home模块，否则就只能访问Admin模块（因为应用入口中已经绑定了Admin模块）。
~~~
define('APP_PATH','./Application/');
// 注释掉绑定模块的定义
// define('BIND_MODULE','Admin');
require './ThinkPHP/ThinkPHP.php';
~~~
有些情况下，我们需要更改应用目录、运行时目录和框架的位置，那么可以修改入口文件如下：
~~~
// 定义应用目录
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_DEBUG', true); // 开启调试模式
define('APP_PATH','./Application/');
require './ThinkPHP/ThinkPHP.php';
~~~
开发完成后，我们实际进行项目部署的时候，删除这行常量定义代码即可，或者改成：
~~~
define('APP_DEBUG',false); // 关闭调试模式
define('APP_PATH','./Application/');
require './ThinkPHP/ThinkPHP.php';
~~~
> 为了安全考虑，避免泄露你的服务器WEB目录信息等资料，一定记得正式部署的时候关闭调试模式。
## 配置
每个应用模块都有独立的配置文件（位于模块目录的`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模式
~~~
更多的配置定义请参考后续的内容。
## 控制器
需要为每个控制器定义一个控制器类，控制器类的命名规范是：
**控制器名+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!';
}
public function test(){
echo '这是一个测试方法!';
}
protected function hello2(){
echo '只是protected方法!';
}
private function hello3(){
echo '这是private方法!';
}
}
~~~
当我们访问hello2和hello3操作方法后的结果都会显示非法操作：
## 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和兼容模式**。
**1 普通模式**
普通模式也就是使用传统的GET传参方式来指定当前访问的模块、控制器和操作，例如：
~~~
http://localhost/?m=home&c=index&a=hello&name=thinkphp
~~~
m参数表示模块，c表示控制器，a表示操作（当然，这些参数名是可以配置的），后面的表示其他GET参数。
默认值可以不传，因此下面的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效果。
## 视图
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!`
## 读取数据
在开始之前，我们首先在数据库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的钥匙！
## 总结
本篇我们学习了ThinkPHP的目录结构、URL模式，如何创建项目的入口文件和开启调试模式，以及控制器、模板和模型的基础认识，后面会继续了解对数据的CURD操作。
