編程學習網 > PHP技術 > ThinkPHP框架 > ThinkPHP3.1快速入門基礎
2014
12-25

ThinkPHP3.1快速入門基礎

簡介

ThinkPHP是一個快速、簡單的基于MVC和面向對象的輕量級PHP開發框架,遵循Apache2開源協議發布,從誕生以來一直秉承簡潔實用的設計原則,在保持出色的性能和至簡的代碼的同時,尤其注重開發體驗和易用性,并且擁有眾多的原創功能和特性,為WEB應用開發提供了強有力的支持。

目錄結構

ThinkPHP最新版本可以在官方網站(http://thinkphp.cn/down/framework.html)或者Github(https://github.com/liu21st/thinkphp/downloads)下載。
把下載后的壓縮文件解壓到你的WEB目錄(或者任何目錄都可以),框架的目錄結構為:
  1. ├─ThinkPHP.php     框架入口文件
  2.  ├─Common 框架公共文件
  3.  ├─Conf 框架配置文件
  4.  ├─Extend 框架擴展目錄
  5.  ├─Lang 核心語言包目錄
  6.  ├─Lib 核心類庫目錄
  7.    ├─Behavior 核心行為類庫
  8.    ├─Core 核心基類庫
  9.    ├─Driver 內置驅動
  10.      ├─Cache 內置緩存驅動
  11.      ├─Db 內置數據庫驅動
  12.      ├─TagLib 內置標簽驅動
  13.      └─Template 內置模板引擎驅動
  14.    └─Template 內置模板引擎
  15.  └─Tpl 系統模板目錄
復制代碼
注意,框架的公共入口文件ThinkPHP.php是不能直接執行的,該文件只能在項目入口文件中調用才能正常運行(后面會講到),這是很多新手很容易犯的一個錯誤。

入口文件

在開始之前,你需要一個Web服務器和PHP運行環境,如果你暫時還沒有,我們推薦使用集成開發環境WAMPServer(是一個集成了Apache、PHP和MySQL的開發套件,而且支持多個PHP版本、MySQL版本和Apache版本的切換)來使用ThinkPHP進行本地開發和測試。
接下來我們先在WEB根目錄下面創建一個app子目錄(這個app就是我們的項目名),然后在該目錄下面創建一個index.php文件,添加一行簡單的代碼:
  1. <?php
  2.  require '/ThinkPHP框架所在目錄/ThinkPHP.php';
復制代碼
這行代碼的作用就是加載ThinkPHP框架的入口文件ThinkPHP.php,這是所有基于ThinkPHP開發應用的第一步。
然后,在瀏覽器中訪問這個入口文件。
  1. http://localhost/app/
復制代碼
一般Web服務器的默認文件是index.php,所以我們可以不需要在URL地址中加上index.php。運行后我們會看到歡迎頁面,

而且已經自動生成了項目目錄,目錄結構如下:
  1. ├─index.php     項目入口文件
  2.  ├─Common 項目公共文件目錄
  3.  ├─Conf 項目配置目錄
  4.  ├─Lang 項目語言目錄
  5.  ├─Lib 項目類庫目錄
  6.    ├─Action Action類庫目錄
  7.    ├─Behavior 行為類庫目錄
  8.    ├─Model 模型類庫目錄
  9.    └─Widget Widget類庫目錄
  10.  ├─Runtime 項目運行時目錄
  11.    ├─Cache 模板緩存目錄
  12.    ├─Data 數據緩存目錄
  13.    ├─Logs 日志文件目錄
  14.    └─Temp 臨時緩存目錄
  15.  └─Tpl 項目模板目錄
復制代碼
如果你希望項目的入口文件移動到app目錄的外面,那么只需要修改入口文件index.php的內容為:
  1. <?php
  2. define('APP_NAME','app');
  3. define('APP_PATH','./app/');
  4.  require '/ThinkPHP框架所在目錄/ThinkPHP.php';
復制代碼
APP_NAME和APP_PATH分部用于定義項目名和項目目錄,項目名通常就是指項目的目錄名稱。
移動并修改完項目的入口文件后,我們就可以通過
  1. http://localhost/
復制代碼
訪問app項目了。當然你也可以在Web根目錄下面創建多個子目錄來部署多個項目。

調試模式

ThinkPHP的運行模式包括調試模式和部署模式,默認情況下是運行在部署模式下面。部署模式下面性能優先,并且盡可能少地拋出錯誤信息,調試模式則以除錯方便優先,關閉任何緩存,而且盡可能多的拋出錯誤信息,所以對性能有一定的影響。部署模式采用了項目編譯機制,第一次運行會對核心和項目相關文件進行編譯緩存,由于編譯后會影響開發過程中對配置文件、函數文件和數據庫修改的生效(除非你修改后手動清空Runtime下面的緩存文件)。因此為了避免以上問題,我們強烈建議新手在使用ThinkPHP開發的過程中使用調試模式,這樣可以更好的獲取錯誤提示和避免一些不必要的問題和煩惱。
開啟調試模式很簡單,我們只需要在入口文件的開頭加上一行常量定義代碼:
  1. <?php
  2. define('APP_DEBUG',TRUE); // 開啟調試模式
  3.  require '/ThinkPHP框架所在目錄/ThinkPHP.php';
復制代碼
開發完成后,我們實際進行項目部署的時候,刪除這行常量定義代碼即可,或者改成:
  1. define('APP_DEBUG',false); // 關閉調試模式
復制代碼

配置

每個項目都有一個獨立的配置文件(位于項目目錄的Conf/config.php),配置文件的定義格式均采用PHP返回數組的方式,例如:
  1. // 項目配置文件
  2.  return array(
  3.     '配置參數'     => '配置值', 
  4.     // 更多配置參數
  5.     //...
  6.  );
復制代碼
一旦有需要,我們就可以在項目配置文件中添加相關配置項目。通常我們提到的添加配置項目,就是指在項目配置文件中添加:
  1. '配置參數' => '配置值', 
復制代碼
配置值可以支持包括字符串、數字、布爾值和數組在內的數據,通常我們建議配置參數均使用大寫定義。如果有需要,我們還可以為項目定義其他的配置文件。

控制器

需要為每個模塊定義一個控制器類,控制器類的命名規范是:
模塊名+Action.class.php (模塊名采用駝峰法并且首字母大寫)
系統的默認模塊是Index,對應的控制器就是項目目錄下面的Lib/Action/IndexAction.class.php,類名和文件名一致。默認操作是index,也就是控制器的一個public方法。初次生成項目目錄結構的時候,系統已經默認生成了一個默認控制器(就是之前看到的歡迎頁面),我們把index方法改成下面的代碼:
  1. class IndexAction extends Action {
  2.     public function index(){
  3.         echo 'hello,world!';
  4.     }
  5.  }
復制代碼
控制器必須繼承Action類,一個模塊可以包括多個操作方法。如果你的操作方法是protected或者private類型的話,是無法直接通過URL訪問到該操作的。

URL請求

入口文件是項目的單一入口,對項目的所有請求都定向到項目的入口文件,系統會從URL參數中解析當前請求的模塊和操作,我們之前訪問的URL地址中沒有任何參數,因此系統會訪問默認模塊(Index)的默認操作(index),因此下面的訪問和之前是等效的:
  1. http://localhost/app/index.php/Index/index
復制代碼
這種URL模式就是系統默認的PATHINFO模式,不同的URL模式獲取模塊和操作的方法不同,ThinkPHP支持的URL模式有四種:普通模式、PATHINFO、REWRITE和兼容模式。

普通模式:也就是傳統的GET傳參方式來指定當前訪問的模塊和操作,例如:
  1. http://localhost/app/?m=module&a=action&var=value
復制代碼
m參數表示模塊,a操作表示操作(模塊和操作的URL參數名稱是可以配置的),后面的表示其他GET參數。

PATHINFO模式:是系統的默認URL模式,提供了最好的SEO支持,系統內部已經做了環境的兼容處理,所以能夠支持大多數的主機環境。對應上面的URL模式,PATHINFO模式下面的URL訪問地址是:
  1. http://localhost/app/index.php/module/action/var/value/
復制代碼
PATHINFO地址的第一個參數表示模塊,第二個參數表示操作。
PATHINFO模式下面,URL是可定制的,例如,通過下面的配置:
  1. 'URL_PATHINFO_DEPR'=>'-', // 更改PATHINFO參數分隔符
復制代碼
我們還可以支持下面的URL訪問:
  1. http://localhost/app/index.php/module-action-var-value/
復制代碼
REWRITE模式:是在PATHINFO模式的基礎上添加了重寫規則的支持,可以去掉URL地址里面的入口文件index.php,但是需要額外配置WEB服務器的重寫規則。
如果是Apache則需要在入口文件的同級添加.htaccess文件,內容如下:
  1. <IfModule mod_rewrite.c>
  2. RewriteEngine on
  3. RewriteCond %{REQUEST_FILENAME} !-d
  4. RewriteCond %{REQUEST_FILENAME} !-f
  5. RewriteRule ^(.*)$ index.php/$1 [QSA,PT,L]
  6.  </IfModule>
復制代碼
接下來,就可以用下面的URL地址訪問了:
  1. http://localhost/app/module/action/var/value/
復制代碼
兼容模式:是用于不支持PATHINFO的特殊環境,URL地址是:
  1. http://localhost/app/?s=/module/action/var/value/
復制代碼
兼容模式配合Web服務器重寫規則的定義,可以達到和REWRITE模式一樣的URL效果。

視圖

ThinkPHP內置了一個編譯型模板引擎,也支持原生的PHP模板,并且還提供了包括Smarty在內的模板引擎驅動。和Smarty不同,ThinkPHP在渲染模板的時候如果不指定模板,則會采用系統默認的定位規則,其定義規范是 Tpl/模塊名/操作名.html,所以,Index模塊的index操作的默認模板文件位于項目目錄下面的Tpl/Index/index.html。
例如:
  1. <html>
  2.  <head>
  3.    <title>hello {$name}</title>
  4.  </head>
  5.  <body>
  6.     hello, {$name}!
  7.  </body>
  8.  </html>
復制代碼
要輸出視圖,必須在控制器方法中進行模板渲染輸出操作,例如:
  1. class IndexAction extends Action {
  2.     public function index(){ 
  3.         $this->name = 'thinkphp'; // 進行模板變量賦值
  4.         $this->display();
  5.     }
  6.  }
復制代碼
display方法中我們沒有指定任何模板,所以按照系統默認的規則輸出了Index/index.html模板文件。
接下來,我們在瀏覽器中輸入
  1. http://localhost/app/
復制代碼
瀏覽器中會輸出
hello,thinkphp!

讀取數據

在開始之前,我們首先在數據庫thinkphp中創建一個think_data數據表(以mysql數據庫為例):
  1. CREATE TABLE IF NOT EXISTS `think_data` (
  2.   `id` int(8) unsigned NOT NULL AUTO_INCREMENT,
  3.   `data` varchar(255) NOT NULL,
  4.   PRIMARY KEY (`id`)
  5.  ) ENGINE=MyISAM  DEFAULT CHARSET=utf8 ;
  6. INSERT INTO `think_data` (`id`, `data`) VALUES
  7.  (1, 'thinkphp'),
  8.  (2, 'php'),
  9.  (3, 'framework');
復制代碼
如果我們需要讀取數據庫中的數據,就需要在項目配置文件中添加數據庫連接信息如下:
  1. // 添加數據庫配置信息
  2.  'DB_TYPE'   => 'mysql', // 數據庫類型
  3.  'DB_HOST'   => 'localhost', // 服務器地址
  4.  'DB_NAME'   => 'thinkphp', // 數據庫名
  5.  'DB_USER'   => 'root', // 用戶名
  6.  'DB_PWD'    => '', // 密碼
  7.  'DB_PORT'   => 3306, // 端口
  8.  'DB_PREFIX' => 'think_', // 數據庫表前綴
復制代碼
或者采用如下配置
  1. 'DB_DSN' => 'mysql://root@localhost:3306/thinkphp'
復制代碼
使用DB_DSN方式定義可以簡化配置參數,DSN參數格式為:
數據庫類型://用戶名:密碼@數據庫地址:數據庫端口/數據庫名
如果兩種配置參數同時存在的話,DB_DSN配置參數優先。

接下來,我們修改下控制器方法,添加讀取數據的代碼:
  1. class IndexAction extends Action {
  2.     public function index(){
  3.         $Data = M('Data'); // 實例化Data數據模型
  4.         $this->data = $Data->select();
  5.         $this->display();
  6.     }
  7.  }
復制代碼
這里用到了M函數,是ThinkPHP內置的實例化模型的方法,而且用M方法實例化模型不需要創建對應的模型類,你可以理解為M方法是直接在操作底層的Model類,而Model類具備基本的CURD操作方法。
M('Data') 實例化后,就可以對think_data數據表(think_ 是我們在項目配置文件中定義的數據表前綴)進行操作(包括CURD)了,M函數的用法還有很多,我們以后會深入了解。
定義好控制器后,我們修改模板文件,添加數據輸出標簽如下:
  1. <html>
  2.  <head>
  3.    <title>Select Data</title>
  4.  </head>
  5.  <body>
  6.     <volist name="data" id="vo">
  7.     {$vo.id}--{$vo.data}<br/>
  8.     </volist>
  9.  </body>
  10.  </html>
復制代碼
volist標簽是內置模板引擎用于輸出數據集的標簽。{$vo.id} 和 {$vo.data} 的用法和Smarty類似,就是用于輸出數據的字段,這里就表示輸出think_data表的id和data字段的值。
我們訪問
  1. http://localhost/app/
復制代碼
會輸出
  1. 1--thinkphp
  2.  2--php
  3.  3--framework
復制代碼
如果發生錯誤,檢查你是否開啟了調試模式或者清空Runtime目錄下面的緩存文件。
如果你看到了上面的輸出結果,那么恭喜你已經拿到了入門ThinkPHP的鑰匙!

總結

本篇我們學習了ThinkPHP的目錄結構、URL模式,如何創建項目的入口文件和開啟調試模式,以及控制器、模板和模型的基礎認識,后面會繼續了解對數據的CURD操作。

掃碼二維碼 獲取免費視頻學習資料

Python編程學習

查 看2022高級編程視頻教程免費獲取