# 快速入門（一）：基礎 > ### 號外 > * [ ThinkPHP V5.0RC3版本發布了！](http://www.thinkphp.cn/topic/38579.html) > * [看云文檔定價和付費閱讀功能上線！](http://www.hmoore.net/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操作。