萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

ThinkPHP 3.x/5.x/6.x 快速上手與項目結構最佳實踐

版本選擇建議 (2024)

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
版本狀態建議
ThinkPHP 3.2停止維護僅維護老專案,勿新建
ThinkPHP 5.1安全維護中穩定專案可用,LTS 版本
ThinkPHP 6.0/6.1/8.0主流開發版新專案首選,PHP 8.0+、PSR-7/15、中間件、事件系統