簡介
ThinkPHP是一個快速、簡單的基於MVC和面向對象的輕量級PHP開發框架,遵循Apache2開源協議發布,從誕生以來一直秉承簡潔實用的設計原則,在保持出色的性能和至簡的代碼的同時,尤其注重開發體驗和易用性,並且擁有眾多的原創功能和特性,為WEB應用開發提供了強有力的支持。
目錄結構
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是不能直接執行的,該文件只能在項目入口文件中調用才能正常運行(後面會講到),這是很多新手很容易犯的一個錯誤。
入口文件
在開始之前,你需要一個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根目錄下面創建多個子目錄來部署多個項目。
調試模式
ThinkPHP的運行模式包括調試模式和部署模式,默認情況下是運行在部署模式下面。部署模式下面性能優先,並且盡可能少地拋出錯誤信息,調試模式則以除錯方便優先,關閉任何緩存,而且盡可能多的拋出錯誤信息,所以對性能有一定的影響。部署模式采用了項目編譯機制,第一次運行會對核心和項目相關文件進行編譯緩存,由於編譯後會影響開發過程中對配置文件、函數文件和數據庫修改的生效(除非你修改後手動清空Runtime下面的緩存文件)。因此為了避免以上問題,我們強烈建議新手在使用ThinkPHP開發的過程中使用調試模式,這樣可以更好的獲取錯誤提示和避免一些不必要的問題和煩惱。
開啟調試模式很簡單,我們只需要在入口文件的開頭加上一行常量定義代碼:
<?php
define('APP_DEBUG',TRUE); // 開啟調試模式
require '/ThinkPHP框架所在目錄/ThinkPHP.php';
復制代碼
開發完成後,我們實際進行項目部署的時候,刪除這行常量定義代碼即可,或者改成:
define('APP_DEBUG',false); // 關閉調試模式
復制代碼
配置
每個項目都有一個獨立的配置文件(位於項目目錄的Conf/config.php),配置文件的定義格式均采用PHP返回數組的方式,例如:
// 項目配置文件
return array(
'配置參數' => '配置值',
// 更多配置參數
//...
);
復制代碼
一旦有需要,我們就可以在項目配置文件中添加相關配置項目。通常我們提到的添加配置項目,就是指在項目配置文件中添加:
'配置參數' => '配置值',
復制代碼
配置值可以支持包括字符串、數字、布爾值和數組在內的數據,通常我們建議配置參數均使用大寫定義。如果有需要,我們還可以為項目定義其他的配置文件。
控制器
需要為每個模塊定義一個控制器類,控制器類的命名規范是:
模塊名+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訪問到該操作的。
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效果。
視圖
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!
讀取數據
在開始之前,我們首先在數據庫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模式,如何創建項目的入口文件和開啟調試模式,以及控制器、模板和模型的基礎認識,後面會繼續了解對數據的CURD操作。