Thinkphp环境搭建连接HGDB实现CRUD
1.环境搭建与配置
1.1.环境要求
-
PHP >= 7.1.0
-
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);
}