| 版本 | 狀態 | 建議 |
| ThinkPHP 3.2 | 停止維護 | 僅維護老專案,勿新建 |
| ThinkPHP 5.1 | 安全維護中 | 穩定專案可用,LTS 版本 |
| ThinkPHP 6.0/6.1/8.0 | 主流開發版 | 新專案首選,PHP 8.0+、PSR-7/15、中間件、事件系統 |
ThinkPHP 6/8 現代化安裝 (Composer)
# 1. 建立專案
composer create-project topthink/think tp6
# 2. 進入目錄
cd tp6
# 3. 啟動內建服務器測試
php think run
# 訪問 https://localhost:8000
目錄結構解析 (TP6/8)
tp6/
├── app/ # 應用核心目錄
│ ├── controller/ # 控制器
│ ├── model/ # 模型
│ ├── validate/ # 驗證器
│ ├── middleware/ # 中間件
│ ├── event/ # 事件
│ ├── service/ # 服務層
│ └── common.php # 公共函數
├── config/ # 配置文件
│ ├── app.php # 應用配置
│ ├── database.php # 數據庫配置
│ ├── cache.php # 快取配置
│ └── ...
├── route/ # 路由定義
│ ├── app.php # 應用路由
│ └── ...
├── public/ # Web 根目錄 (入口文件 index.php)
├── extend/ # 擴展類庫
├── vendor/ # Composer 依賴
├── runtime/ # 運行時緩存 (日誌、編譯緩存)
├── .env # 環境變量 (敏感配置)
└── composer.json
核心配置與啟動
環境變量 .env
APP_DEBUG = true
APP_DEFAULT_TIMEZONE = Asia/Shanghai
DATABASE_TYPE = mysql
DATABASE_HOSTNAME = 127.0.0.1
DATABASE_DATABASE = tp6_demo
DATABASE_USERNAME = root
DATABASE_PASSWORD = 123456
DATABASE_HOSTPORT = 3306
DATABASE_CHARSET = utf8mb4
DATABASE_PREFIX = tp_
資料庫配置 config/database.php
return [
'type' => Env::get('DATABASE_TYPE', 'mysql'),
'hostname' => Env::get('DATABASE_HOSTNAME', '127.0.0.1'),
'database' => Env::get('DATABASE_DATABASE', ''),
'username' => Env::get('DATABASE_USERNAME', ''),
'password' => Env::get('DATABASE_PASSWORD', ''),
'hostport' => Env::get('DATABASE_HOSTPORT', '3306'),
'charset' => Env::get('DATABASE_CHARSET', 'utf8mb4'),
'prefix' => Env::get('DATABASE_PREFIX', ''),
'ssl' => false,
];
快速構建 CRUD 示例
1. 建立模型 app/model/User.php
<?php
namespace app\model;
use think\Model;
class User extends Model
{
protected $table = 'tp_user';
protected $pk = 'id';
protected $autoWriteTimestamp = 'datetime';
protected $createTime = 'created_at';
protected $updateTime = 'updated_at';
}
2. 建立控制器 app/controller/User.php
<?php
namespace app\controller;
use app\BaseController;
use app\model\User;
use think\facade\Validate;
use think\facade\Db;
class User extends BaseController
{
public function index()
{
$list = User::paginate(15);
return view('user/index', ['list' => $list]);
}
public function create()
{
return view('user/form');
}
public function save()
{
$data = $this->request->post();
$validate = Validate::rule([
'name' => 'require|max:50',
'email' => 'require|email',
]);
if (!$validate->check($data)) {
return json(['code' => 0, 'msg' => $validate->getError()]);
}
$user = User::create($data);
return json(['code' => 1, 'msg' => '新增成功', 'data' => $user]);
}
}
3. 定義路由 route/app.php
use think\facade\Route;
Route::group('user', function () {
Route::get('/', 'User/index')->name('user.index');
Route::get('create', 'User/create')->name('user.create');
Route::post('save', 'User/save')->name('user.save');
})->prefix('user');
進階特性速覽
- 中間件:
php think make:middleware AuthCheck,攔截請求 (認證、日誌、限流)
- 事件/監聽:解耦業務邏輯 (用戶註冊 → 發送歡迎郵件、初始化配置)
- 任務調度:
php think schedule:run 配合 Crontab,定時任務優雅管理
- 多應用模式:
app/admin、app/api、app/wap 隔離後台/接口/移動端
- 資源庫/服務層:複雜業務下沉至
app/service、app/repository,控制器保持輕量
遷移/升級注意
- TP3.2 → TP5/6:命名空間化、Facade 靜態代理、路由重寫、模型事件機制變更
- TP5 → TP6/8:PHP 7.1+ → 8.0+、移除助手函數依賴 Facade、中間件管道、PSR 規範對齊
copyright ©
萬盛學電腦網 all rights reserved