在當今眾多的MVC框架中,ThinkPHP是一個快速、簡單的基於MVC和面向對象的輕量級PHP開發框架,其遵循Apache2開源協議發布,自從誕生以來一直秉承簡潔實用的設計原則,在保持出色的性能和至簡的代碼的同時,尤其注重開發體驗及易用性,並且擁有眾多的原創功能和特性,為WEB應用開發提供了強有力的支持。是眾多PHP開發人員的首選。本文就ThinkPHP3.1基礎知識做一簡述。
1.目錄結構
ThinkPHP最新版本可以在官方網站(http://thinkphp.cn/down/framework.html)或者Github(https://github.com/liu21st/thinkphp/downloads)下載。
把下載後的壓縮文件解壓到你的WEB目錄(或者任何目錄都可以),框架的目錄結構為:
├─ThinkPHP.php 框架入口文件 ├─Common 框架公共文件 ├─Conf 框架配置文件 ├─Extend 框架擴展目錄 ├─Lang 核心語言包目錄 ├─Lib 核心類庫目錄 │ ├─Behavior 核心行為類庫 │ ├─Core 核心基類庫 │ ├─Driver 內置驅動 │ │ ├─Cache 內置緩存驅動 │ │ ├─Db 內置數據庫驅動 │ │ ├─TagLib 內置標簽驅動 │ │ └─Template 內置模板引擎驅動 │ └─Template 內置模板引擎 └─Tpl 系統模板目錄
注意,框架的公共入口文件ThinkPHP.php是不能直接執行的,該文件只能在項目入口文件中調用才能正常運行(後面會講到),這是很多新手很容易犯的一個錯誤。
2.入口文件
在開始之前,你需要一個Web服務器和PHP運行環境,如果你暫時還沒有,我們推薦使用集成開發環境WAMPServer(是一個集成了Apache、PHP和MySQL的開發套件,而且支持多個PHP版本、MySQL版本和Apache版本的切換)來使用ThinkPHP進行本地開發和測試。
接下來我們先在WEB根目錄下面創建一個app子目錄(這個app就是我們的項目名),然後在該目錄下面創建一個index.php文件,添加一行簡單的代碼:
<?php require '/ThinkPHP框架所在目錄/ThinkPHP.php';
這行代碼的作用就是加載ThinkPHP框架的入口文件ThinkPHP.php,這是所有基於ThinkPHP開發應用的第一步。
然後,在浏覽器中訪問這個入口文件。
http://localhost/app/
一般Web服務器的默認文件是index.php,所以我們可以不需要在URL地址中加上index.php。運行後我們會看到歡迎頁面,
而且已經自動生成了項目目錄,目錄結構如下:
├─index.php 項目入口文件 ├─Common 項目公共文件目錄 ├─Conf 項目配置目錄 ├─Lang 項目語言目錄 ├─Lib 項目類庫目錄 │ ├─Action Action類庫目錄 │ ├─Behavior 行為類庫目錄 │ ├─Model 模型類庫目錄 │ └─Widget Widget類庫目錄 ├─Runtime 項目運行時目錄 │ ├─Cache 模板緩存目錄 │ ├─Data 數據緩存目錄 │ ├─Logs 日志文件目錄 │ └─Temp 臨時緩存目錄 └─Tpl 項目模板目錄
如果你希望項目的入口文件移動到app目錄的外面,那麼只需要修改入口文件index.php的內容為:
<?php define('APP_NAME','app'); define('APP_PATH','./app/'); require '/ThinkPHP框架所在目錄/ThinkPHP.php';
APP_NAME和APP_PATH分部用於定義項目名和項目目錄,項目名通常就是指項目的目錄名稱。
移動並修改完項目的入口文件後,我們就可以通過
http://localhost/
訪問app項目了。當然你也可以在Web根目錄下面創建多個子目錄來部署多個項目。
3.調試模式
ThinkPHP的運行模式包括調試模式和部署模式,默認情況下是運行在部署模式下面。部署模式下面性能優先,並且盡可能少地拋出錯誤信息,調試模式則以除錯方便優先,關閉任何緩存,而且盡可能多的拋出錯誤信息,所以對性能有一定的影響。部署模式采用了項目編譯機制,第一次運行會對核心和項目相關文件進行編譯緩存,由於編譯後會影響開發過程中對配置文件、函數文件和數據庫修改的生效(除非你修改後手動清空Runtime下面的緩存文件)。因此為了避免以上問題,我們強烈建議新手在使用ThinkPHP開發的過程中使用調試模式,這樣可以更好的獲取錯誤提示和避免一些不必要的問題和煩惱。
開啟調試模式很簡單,我們只需要在入口文件的開頭加上一行常量定義代碼:
<?php define('APP_DEBUG',TRUE); // 開啟調試模式 require '/ThinkPHP框架所在目錄/ThinkPHP.php';
開發完成後,我們實際進行項目部署的時候,刪除這行常量定義代碼即可,或者改成:
define('APP_DEBUG',false); // 關閉調試模式
4.配置
每個項目都有一個獨立的配置文件(位於項目目錄的Conf/config.php),配置文件的定義格式均采用PHP返回數組的方式,例如:
// 項目配置文件 return array( '配置參數' => '配置值', // 更多配置參數 //... );
一旦有需要,我們就可以在項目配置文件中添加相關配置項目。通常我們提到的添加配置項目,就是指在項目配置文件中添加:
'配置參數' => '配置值',
配置值可以支持包括字符串、數字、布爾值和數組在內的數據,通常我們建議配置參數均使用大寫定義。如果有需要,我們還可以為項目定義其他的配置文件。
5.控制器
需要為每個模塊定義一個控制器類,控制器類的命名規范是:
模塊名+Action.class.php (模塊名采用駝峰法並且首字母大寫)
系統的默認模塊是Index,對應的控制器就是項目目錄下面的Lib/Action/IndexAction.class.php,類名和文件名一致。默認操作是index,也就是控制器的一個public方法。初次生成項目目錄結構的時候,系統已經默認生成了一個默認控制器(就是之前看到的歡迎頁面),我們把index方法改成下面的代碼:
class IndexAction extends Action { public function index(){ echo 'hello,world!'; } }
控制器必須繼承Action類,一個模塊可以包括多個操作方法。如果你的操作方法是protected或者private類型的話,是無法直接通過URL訪問到該操作的。
6.URL請求
入口文件是項目的單一入口,對項目的所有請求都定向到項目的入口文件,系統會從URL參數中解析當前請求的模塊和操作,我們之前訪問的URL地址中沒有任何參數,因此系統會訪問默認模塊(Index)的默認操作(index),因此下面的訪問和之前是等效的:
http://localhost/app/index.php/Index/index
這種URL模式就是系統默認的PATHINFO模式,不同的URL模式獲取模塊和操作的方法不同,ThinkPHP支持的URL模式有四種:普通模式、PATHINFO、REWRITE和兼容模式。
普通模式:也就是傳統的GET傳參方式來指定當前訪問的模塊和操作,例如:
http://localhost/app/?m=module&a=action&var=value
m參數表示模塊,a操作表示操作(模塊和操作的URL參數名稱是可以配置的),後面的表示其他GET參數。
PATHINFO模式:是系統的默認URL模式,提供了最好的SEO支持,系統內部已經做了環境的兼容處理,所以能夠支持大多數的主機環境。對應上面的URL模式,PATHINFO模式下面的URL訪問地址是:
http://localhost/app/index.php/module/action/var/value/
PATHINFO地址的第一個參數表示模塊,第二個參數表示操作。
PATHINFO模式下面,URL是可定制的,例如,通過下面的配置:
'URL_PATHINFO_DEPR'=>'-', // 更改PATHINFO參數分隔符
我們還可以支持下面的URL訪問:
http://localhost/app/index.php/module-action-var-value/
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/app/module/action/var/value/
兼容模式:是用於不支持PATHINFO的特殊環境,URL地址是:
http://localhost/app/?s=/module/action/var/value/
兼容模式配合Web服務器重寫規則的定義,可以達到和REWRITE模式一樣的URL效果。
7.視圖
ThinkPHP內置了一個編譯型模板引擎,也支持原生的PHP模板,並且還提供了包括Smarty在內的模板引擎驅動。和Smarty不同,ThinkPHP在渲染模板的時候如果不指定模板,則會采用系統默認的定位規則,其定義規范是 Tpl/模塊名/操作名.html,所以,Index模塊的index操作的默認模板文件位於項目目錄下面的Tpl/Index/index.html。
例如:
<html> <head> <title>hello {$name}</title> </head> <body> hello, {$name}! </body> </html>
要輸出視圖,必須在控制器方法中進行模板渲染輸出操作,例如:
class IndexAction extends Action { public function index(){ $this->name = 'thinkphp'; // 進行模板變量賦值 $this->display(); } }
display方法中我們沒有指定任何模板,所以按照系統默認的規則輸出了Index/index.html模板文件。
接下來,我們在浏覽器中輸入
http://localhost/app/
浏覽器中會輸出
hello,thinkphp!
8.讀取數據
在開始之前,我們首先在數據庫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_DSN方式定義可以簡化配置參數,DSN參數格式為:
數據庫類型://用戶名:密碼@數據庫地址:數據庫端口/數據庫名
如果兩種配置參數同時存在的話,DB_DSN配置參數優先。
接下來,我們修改下控制器方法,添加讀取數據的代碼:
class IndexAction extends Action { public function index(){ $Data = M('Data'); // 實例化Data數據模型 $this->data = $Data->select(); $this->display(); } }
這裡用到了M函數,是ThinkPHP內置的實例化模型的方法,而且用M方法實例化模型不需要創建對應的模型類,你可以理解為M方法是直接在操作底層的Model類,而Model類具備基本的CURD操作方法。
M('Data') 實例化後,就可以對think_data數據表(think_ 是我們在項目配置文件中定義的數據表前綴)進行操作(包括CURD)了,M函數的用法還有很多,我們以後會深入了解。
定義好控制器後,我們修改模板文件,添加數據輸出標簽如下:
<html> <head> <title>Select Data</title> </head> <body> <volist name="data" id="vo"> {$vo.id}--{$vo.data}<br/> </volist> </body> </html>
volist標簽是內置模板引擎用於輸出數據集的標簽。{$vo.id} 和 {$vo.data} 的用法和Smarty類似,就是用於輸出數據的字段,這裡就表示輸出think_data表的id和data字段的值。
我們訪問
http://localhost/app/
會輸出
1--thinkphp 2--php 3--framework
如果發生錯誤,檢查你是否開啟了調試模式或者清空Runtime目錄下面的緩存文件。
如果你看到了上面的輸出結果,那麼至此你已經掌握了ThinkPHP入門的基礎知識!
總結:
本篇我們學習了ThinkPHP的目錄結構、URL模式,如何創建項目的入口文件和開啟調試模式,以及控制器、模板和模型的基礎認識。