# 快速入門（一）：基礎
> ### 號外
> * [ ThinkPHP V5.0RC3版本發(fā)布了！](http://www.thinkphp.cn/topic/38579.html)
> * [看云文檔定價和付費閱讀功能上線！](http://www.imay365.com/blog/notice/36712)
## 簡介
ThinkPHP是一個快速、簡單的基于MVC和面向對象的輕量級PHP開發(fā)框架，遵循Apache2開源協(xié)議發(fā)布，從誕生以來一直秉承簡潔實用的設計原則，在保持出色的性能和至簡的代碼的同時，尤其注重開發(fā)體驗和易用性，并且擁有眾多的原創(chuàng)功能和特性，為WEB應用開發(fā)提供了強有力的支持。
>[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`），開發(fā)人員可以在這個基礎之上靈活調整（目錄名稱和位置）。其中，`Application`和`Public`目錄下面都是空的，而`README.md`和`composer.josn`文件僅用于說明，實際部署的時候可以刪除。
其中，ThinkPHP為框架核心目錄，其目錄結構如下：
~~~
├─ThinkPHP 框架系統(tǒng)目錄（可以部署在非web目錄下面）
│ ├─Common 核心公共函數(shù)目錄
│ ├─Conf 核心配置目錄
│ ├─Lang 核心語言包目錄
│ ├─Library 框架類庫目錄
│ │ ├─Think 核心Think類庫包目錄
│ │ ├─Behavior 行為類庫目錄
│ │ ├─Org Org類庫包目錄
│ │ ├─Vendor 第三方類庫目錄
│ │ ├─ ... 更多類庫目錄
│ ├─Mode 框架應用模式目錄
│ ├─Tpl 系統(tǒng)模板目錄
│ ├─LICENSE.txt 框架授權協(xié)議文件
│ ├─logo.png 框架LOGO文件
│ ├─README.txt 框架README文件
│ └─index.php 框架入口文件
~~~
> 框架核心目錄的結構無需改變，但框架的目錄名稱（ThinkPHP）可以在應用入口文件中隨意更改。
## 入口文件
在開始之前，你需要一個Web服務器和PHP運行環(huán)境，如果你暫時還沒有，我們推薦使用集成開發(fā)環(huán)境[WAMPServer](http://www.wampserver.com/en/)（是一個集成了Apache、PHP和MySQL的開發(fā)套件，而且支持多個PHP版本、MySQL版本和Apache版本的切換）來使用ThinkPHP進行本地開發(fā)和測試。
3.2版本開始框架自帶了一個應用入口文件，默認內容如下：
~~~
define('APP_PATH','./Application/');
require './ThinkPHP/ThinkPHP.php';
~~~
這段代碼的作用就是定義應用目錄和加載ThinkPHP框架的入口文件，這是所有基于ThinkPHP開發(fā)應用的第一步。
然后，在瀏覽器中訪問運行后我們會看到歡迎頁面：
當你看到這個歡迎頁面的時候，系統(tǒng)已經在`Application`目錄下面自動生成了公共模塊`Common`、默認模塊`Home`和`Runtime`運行時目錄，如下所示：
~~~
Application
├─Common 應用公共模塊
│ ├─Common 應用公共函數(shù)目錄
│ └─Conf 應用公共配置文件目錄
├─Home 默認生成的Home模塊
│ ├─Conf 模塊配置文件目錄
│ ├─Common 模塊函數(shù)公共目錄
│ ├─Controller 模塊控制器目錄
│ ├─Model 模塊模型目錄
│ └─View 模塊視圖文件目錄
├─Runtime 運行時目錄
│ ├─Cache 模版緩存目錄
│ ├─Data 數(shù)據(jù)目錄
│ ├─Logs 日志目錄
│ └─Temp 緩存目錄模塊設計
~~~
3.2版本采用模塊化的設計架構，下面是一個典型的模塊目錄結構，每個模塊可以方便的卸載和部署，并且支持公共模塊（Runtime目錄非模塊目錄）。
~~~
Application 默認應用目錄（可以設置）
├─Common 公共模塊（不能直接訪問）
├─Home 前臺模塊
├─Admin 后臺模塊
├─... 其他更多模塊
├─Runtime 默認運行時目錄（可以設置）每個模塊是相對獨立的，其目錄結構如下：
├─Module 模塊目錄
│ ├─Conf 配置文件目錄
│ ├─Common 公共函數(shù)目錄
│ ├─Controller 控制器目錄
│ ├─Model 模型目錄
│ ├─Logic 邏輯目錄（可選）
│ ├─Service 服務目錄（可選）
│ ... 更多分層目錄可選
│ └─View 視圖目錄
~~~
由于采用多層的MVC機制，除了Conf和Common目錄外，每個模塊下面的目錄結構可以根據(jù)需要靈活設置和添加，所以并不拘泥于上面展現(xiàn)的目錄。
如果我要添加新的模塊，有沒有快速生成模塊目錄結構的辦法呢？只需要在入口文件中添加如下定義（假設要生成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支持調試模式，默認情況下是運行在部署模式下面。部署模式下面性能優(yōu)先，并且盡可能少地拋出錯誤信息，調試模式則以除錯方便優(yōu)先，關閉任何緩存，而且盡可能多的拋出錯誤信息，所以對性能有一定的影響。
部署模式采用了項目編譯機制，第一次運行會對核心和項目相關文件進行編譯緩存，由于編譯后會影響開發(fā)過程中對配置文件、函數(shù)文件和數(shù)據(jù)庫修改的生效（除非你修改后手動清空Runtime下面的緩存文件）。因此為了避免以上問題，我們強烈建議新手在使用ThinkPHP開發(fā)的過程中使用調試模式，這樣可以更好的獲取錯誤提示和避免一些不必要的問題和煩惱。
開啟調試模式很簡單，我們只需要在入口文件的開頭加上一行常量定義代碼：
~~~
define('APP_DEBUG', true); // 開啟調試模式
define('APP_PATH','./Application/');
require './ThinkPHP/ThinkPHP.php';
~~~
開發(fā)完成后，我們實際進行項目部署的時候，刪除這行常量定義代碼即可，或者改成：
~~~
define('APP_DEBUG',false); // 關閉調試模式
define('APP_PATH','./Application/');
require './ThinkPHP/ThinkPHP.php';
~~~
> 為了安全考慮，避免泄露你的服務器WEB目錄信息等資料，一定記得正式部署的時候關閉調試模式。
## 配置
每個應用模塊都有獨立的配置文件（位于模塊目錄的`Conf/config.php`），配置文件的定義格式支持**PHP/JSON/YAML/INI/XML**等方式，默認采用PHP數(shù)組定義，例如：
~~~
// 配置文件
return array(
'配置參數(shù)' => '配置值',
// 更多配置參數(shù)
//...
);
~~~
如果你需要為各個模塊定義公共的配置文件，可以在公共模塊中定義（通常位于 `Common/Conf/config.php`），定義格式是一樣。
一旦有需要，我們就可以在配置文件中添加相關配置項目。通常我們提到的添加配置項目，就是指在項目配置文件中添加：
~~~
'配置參數(shù)'=>'配置值',
~~~
配置值可以支持包括字符串、數(shù)字、布爾值和數(shù)組在內的數(shù)據(jù)，通常我們建議配置參數(shù)均使用大寫定義。
如果有需要，我們還可以為項目定義其他類型的配置文件，如果要使用其他格式的配置文件，可以在入口文件中定義**CONF_EXT**常量即可，例如：
~~~
define('CONF_EXT','.ini');
~~~
這樣，模塊的配置文件就變成了 `Conf/config.ini`，定義格式如下：
~~~
DEFAULT_MODULE = Index ;默認模塊
URL_MODEL = 2 ;URL模式
~~~
更多的配置定義請參考后續(xù)的內容。
## 控制器
需要為每個控制器定義一個控制器類，控制器類的命名規(guī)范是：
**控制器名+Controller.class.php （模塊名采用駝峰法并且首字母大寫）**
系統(tǒng)的默認控制器是Index，對應的控制器就是模塊目錄下面的`Controller/IndexController.class.php`，類名和文件名一致。默認操作是index，也就是控制器的一個public方法。初次生成項目目錄結構的時候，系統(tǒng)已經默認生成了一個默認控制器（就是之前看到的歡迎頁面），我們把index方法改成下面的代碼：
~~~
<?php
namespace Home\Controller;
use Think\Controller;
class IndexController extends Controller {
public function index(){
echo 'hello,thinkphp!';
}
}
~~~
再次訪問入口文件的時候，在瀏覽器中看到默認的歡迎頁面已經改成如下輸出：
`hello,thinkphp!`
可以為操作方法定義參數(shù)，例如：
~~~
<?php
namespace Home\Controller;
use Think\Controller;
class IndexController extends Controller {
public function hello($name='thinkphp'){
echo 'hello,'.$name.'!';
}
}
~~~
當我們帶name參數(shù)訪問入口文件地址（例如 `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采用單一入口模式訪問應用，對應用的所有請求都定向到應用的入口文件，系統(tǒng)會從URL參數(shù)中解析當前請求的模塊、控制器和操作，下面是一個標準的URL訪問格式：
`http://serverName/index.php/模塊/控制器/操作`
如果我們直接訪問入口文件的話，由于URL中沒有模塊、控制器和操作，因此系統(tǒng)會訪問默認模塊（Home）下面的默認控制器（Index）的默認操作（index），因此下面的訪問是等效的：
~~~
http://serverName/index.php
http://serverName/index.php/Home/Index/index
~~~
這種URL模式就是系統(tǒng)默認的PATHINFO模式，不同的URL模式獲取模塊和操作的方法不同，ThinkPHP支持的URL模式有四種：**普通模式、PATHINFO、REWRITE和兼容模式**。
**1 普通模式**
普通模式也就是使用傳統(tǒng)的GET傳參方式來指定當前訪問的模塊、控制器和操作，例如：
~~~
http://localhost/?m=home&c=index&a=hello&name=thinkphp
~~~
m參數(shù)表示模塊，c表示控制器，a表示操作（當然，這些參數(shù)名是可以配置的），后面的表示其他GET參數(shù)。
默認值可以不傳，因此下面的URL訪問是和上面的等效：
~~~
http://localhost/?a=hello&name=thinkphp
~~~
**2 PATHINFO模式**
PATHINFO模式是系統(tǒng)的默認URL模式，提供了最好的SEO支持，系統(tǒng)內部已經做了環(huán)境的兼容處理，所以能夠支持大多數(shù)的主機環(huán)境。
對應上面的URL模式，PATHINFO模式下面的URL訪問地址是：
~~~
http://localhost/index.php/home/index/hello/name/thinkphp/
~~~
PATHINFO地址的前三個參數(shù)分別表示模塊/控制器/操作。
PATHINFO模式下面，也可以用普通模式的參數(shù)方式傳入?yún)?shù)，例如：
~~~
http://localhost/index.php/home/index/hello?name=thinkphp
~~~
PATHINFO模式下面，URL參數(shù)分隔符是可定制的，例如，通過下面的配置：
~~~
'URL_PATHINFO_DEPR'=>'-',// 更改PATHINFO參數(shù)分隔符
~~~
我們可以支持下面的URL訪問：
~~~
http://localhost/index.php/home-index-hello-name-thinkphp
~~~
**3 REWRITE模式**
REWRITE模式是在PATHINFO模式的基礎上添加了重寫規(guī)則的支持，可以去掉URL地址里面的入口文件index.php，但是需要額外配置WEB服務器的重寫規(guī)則。
如果是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的特殊環(huán)境，URL地址是：
`http://localhost/?s=/home/index/hello/name/thinkphp`
> 兼容模式配合Web服務器重寫規(guī)則的定義，可以達到和REWRITE模式一樣的URL效果。
## 視圖
ThinkPHP內置了一個編譯型模板引擎，也支持原生的PHP模板，并且還提供了包括Smarty在內的模板引擎驅動。和Smarty不同，ThinkPHP在渲染模板的時候如果不指定模板，則會采用系統(tǒng)默認的定位規(guī)則，其定義規(guī)范默認是模塊目錄下面的 `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方法中我們沒有指定任何模板，所以按照系統(tǒng)默認的規(guī)則輸出了Index/hello.html模板文件。
接下來，我們在瀏覽器訪問輸出：
`hello,thinkphp!`
## 讀取數(shù)據(jù)
在開始之前，我們首先在數(shù)據(jù)庫thinkphp中創(chuàng)建一個think_data數(shù)據(jù)表（以mysql數(shù)據(jù)庫為例）：
~~~
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');
~~~
如果我們需要讀取數(shù)據(jù)庫中的數(shù)據(jù)，就需要在模塊配置文件中添加數(shù)據(jù)庫連接信息如下：
~~~
// 添加數(shù)據(jù)庫配置信息
'DB_TYPE'=>'mysql',// 數(shù)據(jù)庫類型
'DB_HOST'=>'127.0.0.1',// 服務器地址
'DB_NAME'=>'thinkphp',// 數(shù)據(jù)庫名
'DB_USER'=>'root',// 用戶名
'DB_PWD'=>'',// 密碼
'DB_PORT'=>3306,// 端口
'DB_PREFIX'=>'think_',// 數(shù)據(jù)庫表前綴
'DB_CHARSET'=>'utf8',// 數(shù)據(jù)庫字符集
~~~
接下來，我們修改下控制器方法，添加讀取數(shù)據(jù)的代碼：
~~~
namespace Home\Controller;
use Think\Controller;
class IndexController extends Controller{
public function index(){
$Data = M('Data');// 實例化Data數(shù)據(jù)模型
$result = $Data->find(1);
$this->assign('result',$result);
$this->display();
}
}
~~~
這里用到了M函數(shù)，是ThinkPHP內置的實例化模型的方法，而且用M方法實例化模型不需要創(chuàng)建對應的模型類，你可以理解為M方法是直接在操作底層的Model類，而Model類具備基本的CURD操作方法。
M('Data') 實例化后，就可以對`think_data`數(shù)據(jù)表（`think_` 是我們在項目配置文件中定義的數(shù)據(jù)表前綴）進行操作（包括CURD）了，M函數(shù)的用法還有很多，我們以后會深入了解。
定義好控制器后，我們修改模板文件，添加數(shù)據(jù)輸出標簽如下：
~~~
<html>
<head>
<title></title>
</head>
<body>
{$result.id}--{$result.data}
</body>
</html>
~~~
模板標簽的用法和Smarty類似，就是用于輸出數(shù)據(jù)的字段，這里就表示輸出`think_data`表的id和data字段的值。
我們訪問會輸出：
`1--thinkphp`
如果發(fā)生錯誤，檢查你是否開啟了調試模式或者清空Runtime目錄下面的緩存文件。
如果你看到了上面的輸出結果，那么恭喜你已經拿到了入門ThinkPHP的鑰匙！
## 總結
本篇我們學習了ThinkPHP的目錄結構、URL模式，如何創(chuàng)建項目的入口文件和開啟調試模式，以及控制器、模板和模型的基礎認識，后面會繼續(xù)了解對數(shù)據(jù)的CURD操作。
