Thinkphp环境搭建连接HGDB实现CRUD

1.环境搭建与配置

1.1.环境要求

1. PHP >= 7.1.0

2. 6.0版本开始，ThinkPHP必须通过Composer方式安装和更新

1.2.php集成环境

phpEnv官网：https://www.phpenv.cn/

使用phpEnv软件快捷生成TP6所需的集成环境，包含了PHP7.4语言，Apache web服务器，Nginx web服务器， MySQL数据库，Composer管理工具及phpMyAdmin Web端、MySQL管理工具。

打开phpEnv集成环境的网站目录，之后安装下载的ThinkPHP框架文件即生成于此文件夹之中，初始只有localhost一个文件夹。

打开命令行终端


执行composer -v命令，查询到composer版本为2.2.12

1.3.安装thinkphp6

composer create-project topthink/think tp-demo

待下载完成后，phpEnv网站目录中就会出现一个tp-demo文件夹，也就是ThinkPHP框架的根目录了

1.4.网站测试

ThinkPHP6的安装结束后，我们可以用phpEnv设置好站点来进行测试。

配置下phpEnv的设置：应用软件=>设置=>高级

此设置是为了随后在网站管理中配置本地域名做hosts映射做准备。

启动服务=>打开主页

自动跳转浏览器，展示PHP信息

打开phpEnv网站，增加站点

新增的网站域名为本地域名，在外网是没用的，就是为了本地测试方便。

站点根目录选择ThinkPHP框架所在根目录tp-demo文件夹中的public文件夹。

确认新增站点后，启动phpEnv服务

启动网站服务后，打开浏览器，在地址栏输入我们设置的www.thinkphp.com本地域名即可测试连接情况

1.5.伪静态配置

phpEnv的nginx站点管理支持主流框架的伪静态配置。

如果使用默认Web服务是Nginx，那么你的网站可能需要配置URL重写（伪静态）。

常见的PHP框架，如Laravel、Thinkphp规则都内置好了。

重写方法，网站=>站点=>配置=>URL重写=>选择thinkphp=>保存。

设置伪静态规则后可以隐藏项目的入口文件而使链接地址看起来更加简洁规范。

例如： http://demo.com/index.php/index/index

添加伪静态规则后变为：http://demo.com/index/index

1.6.加载pgsql

配置=>php=>7.4-php.ini

文件路径：D:\phpEnv\php\php-7.4\php.ini

去掉扩展pdo_pgsql、pgsql所在行前面的分号 “;”

启动服务=>打开主页

php已加载pdo_pgsql和pgsql

2.开发规范

2.1.什么是PSR

PSR 规范是 PHP Standard Recommendations，是一种编写规范，而不是一种标准，通过规范的代码编写将会使代码清晰且简洁。

2.2.PSR 规范遵循

详细的PSR 规范参考网址

https://learnku.com/docs/psr/basic-coding-standard

函数、方法、类、属性命名规范：
    函数使用小写字母和下划线命名法;
    方法以及属性使用首字母小写的驼峰命名法;
    类使用首字母大写的驼峰命名法;

常量与配置命名规范：
    常量、环境相关变量以全大写及下划线命名法;
    参数使用小写和下划线命名法;

数据库相关命名规范：
    数据表、字段使用小写及下划线命名法;

目录、文件命名规范：
    目录名小写及下划线命名法;
    类文件使用首字母大写的驼峰命名法;
    类目和文件名保持一致;
    类文件名以命名空间定义，命名空间的路径和类库所在路径保持一致;

3.目录结构

单应用模式

www  WEB部署目录（或者子目录）
├─app           应用目录
│  ├─controller      控制器目录
│  ├─model           模型目录
│  ├─ ...            更多类库目录
│  │
│  ├─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           视图配置
│
├─view            视图目录
├─route                 路由定义目录
│  ├─route.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.入口文件

默认的应用入口文件位于public/index.php，默认内容如下

// [ 应用入口文件 ]
namespace think;
require __DIR__ . '/../vendor/autoload.php';
// 执行HTTP应用并响应
$http = (new App())->http;
$response = $http->run();
$response->send();
$http->end($response);

5.开发手册

https://www.kancloud.cn/manual/thinkphp6_0/content

6.开发工具

常用的编辑器有：VS Code、editplus、ultraedit等。

推荐使用 VS Code，下载地址：https://code.visualstudio.com/download

7.调试

在开发阶段，咱们需要通过报错信息或一些其他的信息处理报错和bug，在默认情况下，tp6.0 的调试模式时关闭的，我们需要对其进行打开。

在开发手册中提到，“根目录自带一个.example…env文件，你可以直接更名为.env文件。”，这个文件如下图所示：

此时直接命名为 .env 即可，随后打开这个文件设置调试模式开启即可

8.路由

要使用 Route 类注册路由必须首先在路由定义文件开头添加引用

use think\facade\Route;

基础的路由定义方法如下，需编辑route/app.php进行路由注册

Route::rule('路由表达式', '路由地址', '请求类型');

例如，注册路由到Index控制器的hello操作

Route::rule('hello/:name', 'Index/hello');

我们访问

http://serverName/hello/zhangsan

会自动路由到

http://serverName/Index/hello/name/zhangsan

快捷注册方法的用法为

Route::快捷方法名('路由表达式', '路由地址');

Route::get('new/<id>','News/read'); // 定义GET请求路由规则
Route::post('new/<id>','News/update'); // 定义POST请求路由规则
Route::put('new/:id','News/update'); // 定义PUT请求路由规则
Route::delete('new/:id','News/delete'); // 定义DELETE请求路由规则
Route::any('new/:id','News/read'); // 所有请求都支持的路由规则

9.控制器

控制器文件通常放在controller下面，类名和文件名保持大小写一致，并采用驼峰命名（首字母大写）。

如果要改变controller目录名，需要在route.php配置文件中设置：

'controller_layer'    =>    'controllers',

单应用模式，控制器的类的定义如下

<?php
namespace app\controller;

class User 
{
    
    public function login()
    {
    
        return 'login';
    }
}

访问URL地址是（假设没有定义路由的情况下）

http://localhost/user/login

10.HGDB进行CRUD

10.1.数据库准备

create user thinkphp password 'Qwer@1234';
create database thinkphp owner thinkphp;
create database thinkphp2 owner thinkphp;

psql -U thinkphp -d thinkphp
CREATE TABLE student(
    id serial,
    name character varying(20),
    height character varying(12),
    nickname character varying(12),
    method character varying(20),
    PRIMARY KEY (id)
);
insert into student(name,height,nickname,method) values ('zhangsan','170','zhangsan',null);
insert into student(name,height,nickname,method) values ('lisi','170','lisi',null);

psql -U thinkphp -d thinkphp2
CREATE TABLE student(
    id serial,
    name character varying(20),
    height character varying(12),
    PRIMARY KEY (id)
);
insert into student(name,height) values ('zhangsan','170');
insert into student(name,height) values ('lisi','170');

10.2.连接数据库

在全局或者应用配置目录config下面的database.php中配置下面的数据库参数：

return [
    // 默认使用的数据库连接配置
    'default'         => env('database.driver', 'hgdb'),
    ......

    // 数据库连接配置信息
    'connections'     => [
        'hgdb' => [
            // 数据库类型
            'type'            => env('database.type', 'pgsql'),
            // 服务器地址
            'hostname'        => env('database.hostname', '192.168.100.160'),
            // 数据库名
            'database'        => env('database.database', 'thinkphp'),
            // 用户名
            'username'        => env('database.username', 'thinkphp'),
            // 密码
            'password'        => env('database.password', '******'),
            // 端口
            'hostport'        => env('database.hostport', '5866'),
             ........
        ],
        // 更多的数据库配置信息
    ],
];

app\controller\Index.php文件中添加conn方法

<?php
namespace app\controller;

use app\BaseController;
use think\facade\Db;        //此处添加Db引用

class Index extends BaseController
{
    
    public function conn()
    {
    
        $res = Db::table('student')->select();
        return json($res);
    }

}

启动服务，页面访问http://www.thinkphp.com/Index/conn

报错，不支持认证方式13，需替换php的libpq

将下图文件替换到D:\phpEnv\php\php-7.4

重启服务，再次访问，报错table_msg函数不存在，原因为，thinkphp在连接pgsql时需要自定义table_msg函数。

数据库需要执行脚本在tp-demo\vendor\topthink\think-orm\src\db\connector\pgsql.sql中有提供，但table_msg函数的定义和瀚高4.5版本不兼容，需要做如下调整。

CREATE OR REPLACE FUNCTION pgsql_type(a_type varchar) RETURNS varchar AS
$BODY$
DECLARE
     v_type varchar;
BEGIN
     IF a_type='int8' THEN
          v_type:='bigint';
     ELSIF a_type='int4' THEN
          v_type:='integer';
     ELSIF a_type='int2' THEN
          v_type:='smallint';
     ELSIF a_type='bpchar' THEN
          v_type:='char';
     ELSE
          v_type:=a_type;
     END IF;
     RETURN v_type;
END;
$BODY$
LANGUAGE PLPGSQL;

CREATE TYPE public.tablestruct AS (
  fields_key_name varchar(100),
  fields_name VARCHAR(200),
  fields_type VARCHAR(20),
  fields_length BIGINT,
  fields_not_null VARCHAR(10),
  fields_default VARCHAR(500),
  fields_comment VARCHAR(1000)
);

CREATE OR REPLACE FUNCTION public.table_msg (a_schema_name varchar, a_table_name varchar) RETURNS SETOF public.tablestruct AS
$body$
DECLARE
     v_ret tablestruct;
     v_oid oid;
     v_sql varchar;
     v_rec RECORD;
     v_key varchar;
BEGIN
     SELECT
           pg_class.oid  INTO v_oid
     FROM
           pg_class
           INNER JOIN pg_namespace ON (pg_class.relnamespace = pg_namespace.oid AND lower(pg_namespace.nspname) = a_schema_name)
     WHERE
           pg_class.relname=a_table_name;
     IF NOT FOUND THEN
         RETURN;
     END IF;

     v_sql='
     SELECT
           pg_attribute.attname AS fields_name,
           pg_attribute.attnum AS fields_index,
           pgsql_type(pg_type.typname::varchar) AS fields_type,
           pg_attribute.atttypmod-4 as fields_length,
           CASE WHEN pg_attribute.attnotnull  THEN ''not null''
           ELSE ''''
           END AS fields_not_null,
           pg_get_expr(pg_attrdef.adbin, pg_attrdef.adrelid) AS fields_default, 
           pg_description.description AS fields_comment
     FROM
           pg_attribute
           INNER JOIN pg_class  ON pg_attribute.attrelid = pg_class.oid
           INNER JOIN pg_type   ON pg_attribute.atttypid = pg_type.oid
           LEFT OUTER JOIN pg_attrdef ON pg_attrdef.adrelid = pg_class.oid AND pg_attrdef.adnum = pg_attribute.attnum
           LEFT OUTER JOIN pg_description ON pg_description.objoid = pg_class.oid AND pg_description.objsubid = pg_attribute.attnum
     WHERE
           pg_attribute.attnum > 0
           AND attisdropped <> ''t''
           AND pg_class.oid = ' || v_oid || '
     ORDER BY pg_attribute.attnum' ;

     FOR v_rec IN EXECUTE v_sql LOOP
         v_ret.fields_name=v_rec.fields_name;
         v_ret.fields_type=v_rec.fields_type;
         IF v_rec.fields_length > 0 THEN
            v_ret.fields_length:=v_rec.fields_length;
         ELSE
            v_ret.fields_length:=NULL;
         END IF;
         v_ret.fields_not_null=v_rec.fields_not_null;
         v_ret.fields_default=v_rec.fields_default;
         v_ret.fields_comment=v_rec.fields_comment;
         SELECT constraint_name INTO v_key FROM information_schema.key_column_usage WHERE table_schema=a_schema_name AND table_name=a_table_name AND column_name=v_rec.fields_name;
         IF FOUND THEN
            v_ret.fields_key_name=v_key;
         ELSE
            v_ret.fields_key_name='';
         END IF;
         RETURN NEXT v_ret;
     END LOOP;
     RETURN ;
END;
$body$
LANGUAGE 'plpgsql' VOLATILE CALLED ON NULL INPUT SECURITY INVOKER;

COMMENT ON FUNCTION public.table_msg(a_schema_name varchar, a_table_name varchar) IS '获得表信息';

---重载一个函数
CREATE OR REPLACE FUNCTION public.table_msg (a_table_name varchar) RETURNS SETOF public.tablestruct AS
$body$
DECLARE
    v_ret tablestruct;
BEGIN
    FOR v_ret IN SELECT * FROM table_msg('public',a_table_name) LOOP
        RETURN NEXT v_ret;
    END LOOP;
    RETURN;
END;
$body$
LANGUAGE 'plpgsql' VOLATILE CALLED ON NULL INPUT SECURITY INVOKER;

COMMENT ON FUNCTION public.table_msg(a_table_name varchar) IS '获得表信息';

页面再次访问http://www.thinkphp.com/Index/conn

10.3.多个数据源

return [
    // 默认使用的数据库连接配置
    'default'         => env('database.driver', 'hgdb'),
    ......    
    // 数据库连接配置信息
    'connections'     => [
        'hgdb' => [
           ......
        ],
        'hgdb2' => [
            // 数据库类型
            'type'            => env('database.type', 'pgsql'),
            // 服务器地址
            'hostname'        => env('database.hostname', '192.168.100.160'),
            // 数据库名
            'database'        => env('database.database', 'thinkphp2'),
            // 用户名
            'username'        => env('database.username', 'thinkphp'),
            // 密码
            'password'        => env('database.password', '******'),
            // 端口
            'hostport'        => env('database.hostport', '5866'),
        ],
        // 更多的数据库配置信息
    ],
];

app\controller\Index.php文件中添加hgdb2方法

<?php
namespace app\controller;

use app\BaseController;
use think\facade\Db;

class Index extends BaseController
{
    
       public function conn()
    {
    
        $res = Db::table('student')
                        ->select();
        return json($res);
    }

    public function hgdb2()
    {
    
        $res = Db::connect('hgdb2')
                ->table('student')
                ->select();
        return json($res);
    }

}

访问http://www.thinkphp.com/Index/hgdb2

10.4.模型

框架制定了一个模型类让我们对其使用，通过模型类可以减少重复的代码，并且更加简洁的对数据库进行操作，使用模型对数据库表进行操作时，这个模型即代表了所需要操作的数据库表。

在 controller 同级目录下创建一个 model文件夹，在其中创建对应数据库的模型文件。

app\controller\Index.php文件中添加stuModel方法

<?php
namespace app\controller;

use app\BaseController;
use think\facade\Db;
use app\model\Student;

class Index extends BaseController
{
    
    public function conn()
    {
    
        $res = Db::table('student')
                ->select();
        return json($res);
    }

    public function hgdb2()
    {
    
        $res = Db::connect('hgdb2')
                ->table('student')
                ->select();
        return json($res);
    }

    public function stuModel()
    {
    
        $stu=Student::select();
        return json($stu);
    }
}

访问http://www.thinkphp.com/Index/stuModel

10.5.查询构造器

    public function selectById()
    {
    
        $stu=Db::table('student')
                ->where('id', 1)
                ->find();
        return json($stu);
    }

    public function insert()
    {
    
        $data = ['name' => 'wangwu', 'height' => '180','nickname' => 'wangwu','method' => 'insert'];
        $res=Db::table('student')
                ->save($data);
        dump($res);
    }

    public function update()
    {
    
        $res= Db::name('student')
                ->where('id', 1)
                ->update(['method' => 'update']);
        dump($res);
    }
    public function deleteById()
    {
    
        $res= Db::table('student')
                ->delete(1);
        dump($res);
    }
    public function deleteByWhere()
    {
    
        $res= Db::table('student')
                ->where('name','wangwu')
                ->delete();
        dump($res);
    }
     

10.6.原生查询

     public function selectBySql()
    {
    
        $res= Db::query("select * from student where id=:id", ['id' => 2], true);
        return json($res);
    }

    public function updateBySql()
    {
    
        $res= Db::execute("update student set name='thinkphp' where id=2");
        dump($res);
    }