# TP8

**Repository Path**: uyevan/tp8

## Basic Information

- **Project Name**: TP8
- **Description**: 🦢 ThinkPHP8框架的基础使用与体验记录
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2024-06-13
- **Last Updated**: 2025-05-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: ThinkPHP, PHP, Redis, MySQL, Bootstrap

## README

睁眼间TP框架也更新到了第八个版本，今天去使用了一下，初期创建存在一些问题，这里记录一下，然后再根 PHP 、ThinkPHP 说声再见了。



### 1.环境要求

**PHP ≥ 8.0 (必须、建议不要再使用 8.0 一下版本)**

[PHP: Hypertext Preprocessor](https://www.php.net/)

**Composer ≥ 2.7.5 (非必须、建议用最新版本)**

Composer类似于Python的pip / Node的npm；

[Composer](https://getcomposer.org/)

### 2.创建一个TP8项目

- 创建：`composer create-project topthink/think MyProject`

- 更新（后期有需可更新）：`composer update topthink/framework`

🦢 问题1：不要高兴太早，此时 composer 可能会报错：）

**为什么：**版本不匹配，【php与composer与TP所需依赖版本不匹配或冲突】

**怎么办：** 分别执行`composer install --ignore-platform-reqs` 和 `composer update --ignore-platform-reqs`



### 3.配置多应用模式

您可以选择继续使用单应用模式，**默认是单应用模式；**但我一直以来使用的多应用模式，因为具有高扩展性、灵活性，可维护性等；

- 打开`config/app.php`应用配置目录修改成：`'auto_multi_app'   => true,`

- 删除`app`目录下的`controller、model、view`等文件夹【因为这些是单应用的默认目录，我们要改成多应用】

- 安装多应用模式扩展包，项目目录下终端执行：`composer require topthink/think-multi-app`

- 安装多应用模式View视图扩展包，项目终端执行：`composer require topthink/think-view`

- 创建一个应用，项目目录下终端执行：`php think build 应用名`

此时你完成多应用的配置与安装，此时您的目录结构为：

```SQL
MyProject  WEB部署目录（或者子目录）
├─app           应用目录
│  ├─app_1_name           应用目录
│  │  ├─common.php      函数文件
│  │  ├─controller      控制器目录
│  │  ├─model           模型目录
│  │  ├─view            视图目录
│  │  ├─config          配置目录
│  │  ├─route           路由目录
│  │  └─ ...            更多类库目录
│  ├─app_2_name           应用目录
│  │  ├─common.php      函数文件
│  │  ├─controller      控制器目录
│  │  ├─model           模型目录
│  │  ├─view            视图目录
│  │  ├─config          配置目录
│  │  ├─route           路由目录
│  │  └─ ...            更多类库目录
│  │
│  ├─common.php         公共函数文件
│  └─event.php          事件定义文件
│
├─config                全局配置目录
│  ├─app.php            应用配置
│  ├─cache.php          缓存配置
│  ├─console.php        控制台配置
│  ├─cookie.php         Cookie配置
│  ├─database.php       数据库配置
│  ├─filesystem.php     文件磁盘配置
│  ├─lang.php           多语言配置
│  ├─log.php            日志配置
│  ├─middleware.php     中间件配置
│  ├─route.php          URL和路由配置
│  ├─session.php        Session配置
│  ├─trace.php          Trace配置
│  └─view.php           视图配置
│
├─public                WEB目录（对外访问目录）
│  ├─index.php          入口文件
│  ├─router.php         快速测试文件
│  └─.htaccess          用于apache的重写
│
├─extend                扩展类库目录
├─runtime               应用的运行时目录（可写，可定制）
├─vendor                Composer类库目录
├─.example.env          环境变量示例文件
├─composer.json         composer 定义文件
├─LICENSE.txt           授权说明文件
├─README.md             README 文件
├─think                 命令行入口文件
```




### 4.启动应用

项目目录下终端执行`php think run`来启动项目，默认端口是：**8000，**您可以`php think run -p 80`来指定端口；浏览器访问`localhost:8000`或`localhost`即可；



### 5.Nginx配置

不配置也可以，但配置了UTR会不会很长，而且不需要每次都要带上`index.php`；

【配置前】：**域名/public/index.php/应用/控制器/操作函数/参数名/参数值**

【配置后】：**域名/控制器/操作函数**

进入`public/nginx.htaccess`写入如下规则：

```Nginx
location / {
   if (!-f $request_filename) {
   rewrite  ^(.*)$  /index.php?s=/$1  last;
    }
}
```




### 6.实例版本

**重要！重要！重要！ 没有实例解决不了的问题！**🧑‍💻

- 目录结构：一下是我的项目结构，目前就一个应用，其他应用也类似；

[]()https://flowus.cn/uyevan/e4a5a6dc-ae1f-49a7-be81-91443bac68e6

- MySQL数据库配置：config/database.php里配置数据库信息：

[]()https://flowus.cn/uyevan/e4a5a6dc-ae1f-49a7-be81-91443bac68e6

**问题2：此时可能会报错，因为你没开启PHP的数据库Dvice启动模块；**

**解决办法：进入PHP安装目录，找到**`php.ini`配置文件，找到`;extension=pdo_mysql`和`;extension=mysqli`把前面的`;`冒号删除保存退出即可；再重新`php think run -p 80`来启动项目；



- 应用结构：我的`api`应用的MVC结构大致如下，看不懂也没关系自己写一遍就一目了然了：

[]()https://flowus.cn/uyevan/e4a5a6dc-ae1f-49a7-be81-91443bac68e6

- 具体代码：这是我创建项目到完成增删改查的过程中写过的几个文件代码【其实完全可以缩小到2~3个文件，甚至一个文件，但我们要考虑**可维护，可测试，可扩展**】：

```PHP
<?php

namespace app\api\controller;

use app\api\service\impl\StudentServiceImpl;
use app\api\service\StudentService;
use app\Safe;
use think\App;
use think\facade\View;

/**
 * @package app\api\controller
 * @author Evan
 * @date 2024/5/12 21:15
 * @description Api控制器
 */
class Student extends Safe
{

    private StudentService $studentService;

    /**
     * 构造函数
     * @param StudentServiceImpl $studentServiceImpl
     * @param App $app
     */
    public function __construct(StudentServiceImpl $studentServiceImpl, App $app)
    {
        $this->studentService = $studentServiceImpl;
        parent::__construct($app);
    }

    /**
     * 返回View视图
     * @return string
     */
    public function index(): string
    {
        return View::fetch();
    }

    public function getAllStudent(): bool|string
    {
        return $this->studentService->getAllStudent();
    }

    public function getStudentById(): bool|string
    {
        return $this->studentService->getStudentById();
    }

    public function addStudent(): bool|string
    {
        return $this->studentService->addStudent();
    }

    public function updateStudent(): bool|string
    {
        return $this->studentService->updateStudent();
    }

    public function deleteStudent(): bool|string
    {
        return $this->studentService->deleteStudent();
    }
}
```


```PHP
<?php

namespace app\api\model;

use think\Model;

/**
 * Model模型定义
 * 模型类似于SpringBoot开发中的模型，但并不完全一样；模型的特点如下：
 * 1.Model模型会自动对应数据表
 * 2.通过Model模型可以快速进行增删改查操作
 * 3.Model模型是可复用
 * 4.Model模型是可继承
 * 5.Model模型是可扩展
 * 6.减少了代码量，配置即可入手
 */
class Student extends Model
{
    /**
     * @var string 模型名
     */
    protected $name = 'student';

    /**
     * @var string 数据表名
     */
    protected $table = 'student';

    /**
     * @var string 主键名
     */
    protected $pk = 'id';

    /**
     * @var string[] 数据表字段及类型
     */
    protected $schema = [
        'id' => 'int',
        'name' => 'varchar',
        'sex' => 'varchar',
        'birth' => 'int',
        'department' => 'varchar',
        'address' => 'varchar'
    ];
}
```


```PHP
<?php

namespace app\api\service;

use think\db\exception\DataNotFoundException;
use think\db\exception\DbException;
use think\db\exception\ModelNotFoundException;

interface StudentService
{
    /**
     * 获取所有学生信息
     * @return bool|string
     * @throws DataNotFoundException
     * @throws DbException
     * @throws ModelNotFoundException
     */
    public function getAllStudent(): bool|string;

    /**
     * 根据id获取学生信息
     * @return bool|string
     * @throws DataNotFoundException
     * @throws DbException
     * @throws ModelNotFoundException
     */
    public function getStudentById(): bool|string;

    /**
     * 添加学生信息
     * @return bool|string
     */
    public function addStudent(): bool|string;

    /**
     * 更新学生信息
     * @return bool|string
     * @throws DataNotFoundException
     * @throws DbException
     * @throws ModelNotFoundException
     */
    public function updateStudent(): bool|string;

    /**
     * 删除学生信息
     * @return bool|string
     */
    public function deleteStudent(): bool|string;
}
```


```PHP
<?php

namespace app\api\service\impl;

use app\api\model\Student;
use app\api\service\StudentService;

class StudentServiceImpl implements StudentService
{

    public function getAllStudent(): bool|string
    {
        // TODO: Implement getAllStudent() method.
        return SuccessJsonResult(Student::select());
    }

    public function getStudentById(): bool|string
    {
        // TODO: Implement getStudentById() method.
        $id = input('id') ?: null;
        return SuccessJsonResult(Student::find($id));
    }

    public function addStudent(): bool|string
    {
        // TODO: Implement addStudent() method.
        $studentParam = [
            'name' => input('name') ?: null,
            'sex' => input('sex') ?: null,
            'birth' => input('birth') ?: null,
            'department' => input('department') ?: null,
            'address' => input('address') ?: null
        ];
        $student = new Student();
        $student->save($studentParam);
        return CustomJsonResult(code: 200, msg: '添加成功');
    }

    public function updateStudent(): bool|string
    {
        // TODO: Implement updateStudent() method.
        $studentParam = [
            'id' => input('id') ?: null,
            'name' => input('name') ?: null,
            'sex' => input('sex') ?: null,
            'birth' => input('birth') ?: null,
            'department' => input('department') ?: null,
            'address' => input('address') ?: null
        ];
        $student = Student::find($studentParam['id']);
        $student->save($studentParam);
        return CustomJsonResult(code: 200, msg: '更新成功');
    }

    public function deleteStudent(): bool|string
    {
        // TODO: Implement deleteStudent() method.
        $id = input('id') ?: null;
        Student::destroy($id);
        return CustomJsonResult(code: 200, msg: '删除成功');
    }
}
```


```HTML
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Student</title>
</head>
<body>

<h1>Student Home</h1>

</body>
</html>
```


```PHP
<?php
/**
 * 公用方法
 */

/**
 * 成功状态
 * @param null $data
 * @return bool|string
 */
function SuccessJsonResult($data = null): bool|string
{
    try {
        $array = array(
            'code' => 200,
            'msg' => '请求成功',
            'data' => $data
        );

        return json_encode($array, JSON_THROW_ON_ERROR | JSON_UNESCAPED_UNICODE);
    } catch (JsonException $e) {
        return false;
    }
}


/**
 * Error状态
 * @return bool|string
 */
function ErrorJsonResult(): bool|string
{
    try {
        $array = array(
            'code' => 400,
            'msg' => '请求失败',
            'data' => null
        );

        return json_encode($array, JSON_THROW_ON_ERROR | JSON_UNESCAPED_UNICODE);
    } catch (JsonException $e) {
        return false;
    }
}

/**
 * Custom状态
 * @param int $code
 * @param string $msg
 * @param $data
 * @return bool|string
 */
function CustomJsonResult(int $code = 100, string $msg = '', $data = null): bool|string
{
    try {
        $array = array(
            'code' => $code,
            'msg' => $msg,
            'data' => $data
        );

        return json_encode($array, JSON_THROW_ON_ERROR | JSON_UNESCAPED_UNICODE);
    } catch (JsonException $e) {
        return false;
    }
}
```


```PHP
<?php

namespace app;

class Safe extends BaseController
{
    /**
     * 安全性检查
     * @return void
     */
    protected function initialize(): void
    {
        /**
         * 只允许GET/POST/DELETE/PUT
         */
        $method = $this->request->method() !== 'HEAD' &&
            $this->request->method() !== 'GET' &&
            $this->request->method() !== 'POST' &&
            $this->request->method() !== 'DELETE' &&
            $this->request->method() !== 'PUT';
        if ($method) {
            //TODO 违规请求
            die(CustomJsonResult(code: 405, msg: 'Method Not Allowed'));
        }
    }
}
```




### 7.效果预览

不搞个最后的结果，就不等于脱裤子放屁嘛，一下是访问方面`controller`层所有接口的效果；
[]()https://flowus.cn/uyevan/e4a5a6dc-ae1f-49a7-be81-91443bac68e6




### 8.项目

[LanApi](https://flowus.cn/2f2883a4-4b48-4238-b772-47ad03b1a16f)



### 9.总结

> 感谢`PHP`与`ThinkPHP`的陪伴吧，以后可能很少会解除了，**今天刚公布的世界语言排名当中PHP从第八名跌落到了第18名**，也许它不在是以前的那个**世界上最好的语言**了...

> 然而TP这类PHP框架的有点比Spring那一类JavaWeb框架也有不少的优点，虽然并发与性能可能有所够呛，但编译速度，代码量都比后者好。比如咱们写一个StudentModel就可以完全实现增删改查的所有操作，什么数据表字段，Mapper映射等从不关心，这就是TP的魅力吧...



Composer安装遇到的问题看这里 ⬇️

[developer.aliyun.com](https://developer.aliyun.com/composer)

Evan @2024/06/12 23:54 👨🏻‍💻





Evan @2024/06/12 23:54 👨🏻‍💻