这段时间学习了一下简单搭建一个api接口后端服务,现在记录一下。
本文主要内容 下载tp6打开错误调试隐藏入口文件解决跨域问题-(使用全局中间件处理)路由解决api版本控制jwt token验证-(使用路由中间件验证)统一的参数返回形式异常捕捉自动生成api文档(插件实现) 1、下载tp6
我使用的是集成环境phpstuday,安装了composer,通过composer安装tp6,thinkphp官网已经不再支持直接下载。
composer create-project topthink/think tp6
你也可以直接按照tp6看云文档的步骤来安装tp6
在下载好的tp6目录通过cmd命令窗口输入
php think run
在浏览器中输入127.0.0.1:8000,访问到如下页面就安装成功了
2、打开错误调试
在开始之间,我们先打开tp6的错误调试
1.找到config/app.php下的show_error_msg ,改成true
2.找到下面根目录下的.example.env文件,重命名此文件,把.example删掉
查看这里面的代码,会发现,它打开了app_debug调试
这样我们就能看到完整的报错信息了,例如:
3、隐藏入口文件
在第1节中,我们访问
:8000
实际访问的是
:8000/index.php/index/index
你也可以通过这样的方式访问
:8000/index/index
如果什么都不填,默认访问的就是index控制器,在config/app.php文件中有这样的定义,你也可以修改默认的控制器
还有,不管访问任何控制器,如果没有填方法,它都会访问控制器中的index方法,如果index方法不存在,则提示错误信息-方法不存在。
通过在项目根目录中运行的php think run开启的web服务,tp6帮我们做了隐藏入口文件的操作,所以你可以通过第三种方式访问。但是我们这一节要说的就是隐藏入口,怎么能用tp6自带的web服务呢。所以要自己来。
我们在开发时,往往会在本地搭建WNMP等这样的一套web解决方案,这就需要我们自己去隐藏入口文件index.php
为什么要隐藏入口文件?
因为像这样子:4321/index.php/index/index访问方法,这个index.php很不好看。多余。危险
我这里因为用的集成环境,选用的是apache服务器,所以我只找了apache的隐藏入口文件的方法,nginx的需要自己搜索了。
现在我启用apache服务器,开的端口是4321
当我想通过
:4321/index/index
去访问方法时,访问失败
而我加上入口文件访问时,访问成功
:4321/index.php/index/index
实现隐藏index.php很简单,只需要找到public目录下的.htaccess文件,添加如下代码就可以了。
<IfModule mod_rewrite.c> #如果mode_rewrite.c模块存在 则执行以下命令
Options +FollowSymlinks -Multiviews
RewriteEngine On #开启 rewriteEngine
# !-d 不是目录或目录不存在
RewriteCond %{REQUEST_FILENAME} !-d
# !-f 不是文件或文件不存在
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ index.php [QSA,PT,L]
# 参数解释
# ^(.*)$: 匹配所有的路口映射
# QSA: (Query String Appending)表示保留参数入get传值?xxx==xx;
# PT: 把这个URL交给Apache处理;
# L: 作为最后一条,遇到这条将不再匹配这条之后的规则
</IfModule>
现在访问
:4321/index/index
访问成功
需要注意,在第一节中我们看到,运行了php think run 后,我们的项目目录访问的是public目录
官方文档中也说在项目中应该只有public目录是可以被外界访问的,所以如果有什么需要访问的图片、视频等资源,应该放在此目录下
4、解决跨域问题
在应用开发中,前后端都是分开独立开发的,而前后端通常都会自己搭建一个web服务,运行在不同的端口上,在前端访问后端的接口时,会报跨域的错误。而这种跨域问题通常是要有后端来处理的,tp6有专门的中间件来做这个事情,真是太方便了,只需要在app目录下的middleware.php中添加该中间件,就实现了跨域访问。
<?php
// 全局中间件定义文件
return [
// 全局请求缓存
// thinkmiddlewareCheckRequestCache::class,
// 多语言加载
// thinkmiddlewareLoadLangPack::class,
// Session初始化
// thinkmiddlewareSessionInit::class
// 跨域解决
thinkmiddlewareAllowCrossDomain::class,
];
5、路由解决api版本控制
在app目录中的container控制器中新建两个文件夹v1,v2,在其中都创建User.php文件
v1/User.php
<?php
namespace appcontrollerv1;
use appBaseController;
class User extends BaseController
{
public function login()
{
return '我是v1';
}
}
v2/User.php
<?php
namespace appcontrollerv2;
use appBaseController;
class User extends BaseController
{
public function login()
{
return '我是v2';
}
}
注意上面两个文件的命名空间,就第一行代码,在哪个文件夹下,就写到哪里。
现在方法有了,我们还无法访问,需要使用路由,让路由帮我们找对应的方法。
至于路由的概念去文档自己看。我这里主要用路由组的方式,我觉得这个比资源路由好用,灵活。
在根目录下的route目录下的app.php文件代码如下:
<?php
// +----------------------------------------------------------------------
// | ThinkPHP [ WE CAN DO IT JUST THINK ]
// +----------------------------------------------------------------------
// | Copyright (c) 2006~2018 http://thinkphp.cn All rights reserved.
// +----------------------------------------------------------------------
// | Licensed ( http://www.apache.org/licenses/LICENSE-2.0 )
// +----------------------------------------------------------------------
// | Author: liu21st
// +----------------------------------------------------------------------
use thinkfacadeRoute;
// api版本控制
$v = request()->header('Api-Version');
// 默认api版本为v1
if ($v == null) $v = "v1";
// 用户
Route::group('user', function () {
Route::post('login', 'login');
})->prefix($v.'.user/')->pattern(['id' => 'd+']);
以上代码进行控制api版本的方式是,请求发起者在header中传递要访问的api的版本,这里获取到对应的版本,访问对应的方法。
鉴于以上我使用的是post请求,且要传递header,所以使用postman进行测试。
访问v1版本的接口时:
访问v12版本的接口时:
6、jwt token验证
我用的是tp6看云文档收录的插件
composer require thans/tp-jwt-auth
该插件的github地址-文档
在开始之前可以看看文档里是怎么操作的,我也是按照文档来的
安装完成后,该插件所在的位置在根目录下的vendor/thans/tp-jwt-auth
还会在根目录下的config目录下生成jwt.php文件来记录一些配置信息
看这里都是读取的env中的参数,所以咱也在根目录下的.env文件中配置参数。
在根目录下打开cmd窗口,执行
php think jwt:create
会帮你在.env文件中生成密钥secret,红色框中的是新增的内容
token的有效期为60秒,为了方便我们测试,我就不改了,如果你要改,可以在.env中添加,这样就改成了1小时
这个插件有三种方式【header,token,param】传递token,我就使用其中一个,也是最常用的一种,就是在【header】中传递token信息,这个插件默认验证header中的token信息需要传递的参数名为authorization,而在header中直接传递该参数tp6是获取不到的,需要做一些设置,
在根目录中的public目录下的.htacccess文件中添加
SetEnvIf Authorization .+ HTTP_AUTHORIZATION=$0
那么现在开始测试:
(1).生成token
我就在之前创建的v1/User.php控制器中写了
<?php
namespace appcontrollerv1;
use appBaseController;
// 引入jwt插件
use thansjwtfacadeJWTAuth;
class User extends BaseController
{
public function login()
{
// 生成token
$token = JWTAuth::builder(['uid' => 1,'name'=>'ceshi']);
return $token;
}
}
在postman中测试
(2).验证token
我使用的是路由中间件的方式验证token,
① 写一个中间件
在根目录下的app目录中创建middleware目录,在其下创建CheckToken.php文件
app/middleware/CheckToken.php
文件内容
<?php
namespace appmiddleware;
use thansjwtfacadeJWTAuth;
use thansjwtexceptionJWTException;
class CheckToken
{
public function handle($request, Closure $next)
{
// OPTIONS请求直接返回
if ($request->isOptions()) {
return response();
}
try {
JWTAuth::auth();
}catch (JWTException $e) {
return json($e->getMessage());
}
return $next($request);
}
}
② 起别名
给该中间件起个别名,在根目录下的config/middleware.php文件中
③ 在路由文件中使用中间件
④ 创建对应的方法
在第三步中我们创建了一个getUserInfo()方法,现在在User.php文件中创建
public function getUserInfo() {
return json(['id'=>1, 'name'=> '啦啦啦']);
}
⑤ 验证一下
刚刚创建的token必然过期了,咱重新获取一条
现在验证一下,请求userinfo方法,并在header中添加参数Authorization,
注意:token值需要加上bearer ,bearer后的空格也要的。
过了一分钟后,我们再来试一试
可以看到token验证提示,该通过过期了,这个插件成功了,并没有继续往下走,把之前的信息返回。
(3).注销token
这个插件在github中的文档中没有说到怎么注销或删除token,只有一个刷新refresh和拉黑invalidate,我看了一下它的代码,刷新方法中会调用拉黑方法,看到这个注释,让我激动了一下,鸡儿!原来拉黑就是注销
这个拉黑的具体操作就是把你要注销的token保存在本地的cookie中,默认的保存时间是14天,14天后cookie会自己删除的,你可以在根目录下的runtime目录下的cache目录中找到对应的文件,我就不测试这个方法了,我感觉这个操作好像没什么必要。
文件内容形似这样
至此token这节就结束了。
什么?
你想改默认的token名称?那你可得好好研究这个插件了,看看怎么改,改完了记得踢我一脚,让我也看看,虽然我觉得一个Authorization已经够用了。
7、统一的参数返回形式
实际开发中,后端返回给前端的参数往往都是这样的。
所以我们需要对参数返回形式做个统一的处理
在app目录下的common.php中定义的方法全局都可调用,所以在这个文件中定义此方法。
<?php
use thinkResponse;
// 应用公共文件
// 统一返回数据格式
function result($data = [], string $msg = 'error', int $code = 200, string $type = 'json'):Response {
$result = [
"code" => $code,
"msg" => $msg,
"data" => $data
];
// 调用Response的create方法,指定code可以改变请求的返回状态码
return Response::create($result, $type)->code($code);
}
唉,这个时候,经验的重要性就体现出来,我是个前端,而且在我自己看来,还算是个没有工作经验的前端,
不知道他们后端到底怎么处理这个状态码,网上的东西越看越乱,状态码可以分为业务状态码和请求返回的状态码,我这里就简单了,就只有请求返回的状态码,虽然在返回的数据中也传递了这个码,其实没什么用,小项目、不复杂的项目根本用不少业务状态码。我看别人还会单独分装成功和失败的方法,这个就看自己习惯了,我感觉好像没啥必要。终究是经验不足,网上能参考的代码太少,还千篇一律,最可气的是一篇文章居然可以在多个博客网站上出现,别人抄的、复制的就算了,作者自己也发这么多地方,真的搞笑,百度一下,跳出来全是同一个,标题也是一样,很迷~。
调用就很简单了,可以直接使用
我们还是改一下login方法
public function login()
{
$data = [
['id'=>1,'name'=>'杰森'],
['id'=>2,'name'=>'麦克']
];
$code = 200;
$msg = '获取成功';
return result($data, $msg, $code);
}
返回结果
这样好像没有体现我们修改的请求的状态码,那我们把$code改成500,再来看看结果如何
咱已经成功的将改请求状态变成了500
得嘞,现在再来回头看看我们之前写的检查jwt的中间件,把返回的结果封装一下
再去验证一下看看,看着返回的结果就舒服多了,这特么才是后端给前端返回的结果。
本小节结束,记录一下一些常见的状态码,我在自己写的时候就只用到了这些状态码
状态码描述
200
请求成功
204
请求成功,未返回实体,比如option请求,这玩意儿用不着呀
400
错误的请求
401
认证失败,这个一般在token验证那里
403
拒绝访问
404
请求的资源不存在
422
参数验证错误
500
服务器错误
7、异常捕捉
异常捕捉(看云文档)内容挺多的,自己去百度吧,我就把我遇到过的常见的错误进行捕捉,其它的异常我也爱莫能助,不懂啊 !>_>!
我也就不自定义类了,直接在它给的默认的异常处理文件里写了。
(1)参数验证错误捕捉
我们先写一个参数验证的类,在app目录下创建validate目录,创建User.php文件
app/validate/User.php
<?php
namespace appvalidate;
use thinkValidate;
class User extends Validate
{
protected $rule = [
'name' => 'require|max:25',
'age' => 'number|between:1,120',
'email' => 'email',
];
protected $message = [
'name.require' => '名称必须',
'name.max' => '名称最多不能超过25个字符',
'age.number' => '年龄必须是数字',
'age.between' => '年龄只能在1-120之间',
'email' => '邮箱格式错误',
];
}
tp6的异常捕捉分为两种,自动和手动的,手动的就是通过try{}catch{}捕捉。tp6的异常捕捉大多是自动的,不过,比如我们现在要操作的参数验证错误就需要自己去捕捉来抛出异常,我们此节的目的是统一捕捉这个错误,我就不用手动的了。
我们就在异常处理类的render方法中添加这个捕捉抛出就可以了。
// 1.参数验证错误
if ($e instanceof ValidateException) {
return result($e->getError(), '参数验证不通过', 422);
}
现在在方法中一下,看看能否捕获。
app/controller/v1/User.php
查看结果,成功被捕获到了,并抛出了错误内容
如果验证通过了,就会正常的走下去,则会显示我return的测试内容
(2)未匹配到资源或方法的异常捕获
我还没找到方法,在我的预想中这个应该要做到能够准确的反应未匹配到的原因。
// 2.方法(控制器、路由、http请求)、资源(多媒体文件,如视频、文件)未匹配到,
// 一旦在定义的路由规则中匹配不到,它就会直接去匹配控制器,但是因为在控制器中做了版本控制v1,v2这样的,所以它是无法获取对应控制器的
// 所以都会直接走了HttpException的错误
// 感觉好像也无所谓,反正是做api接口的,只不过这样就不好准确的提示信息了
// 到底这个请求时控制器找不到呢?还是方法找不到?还是请求类型(get,post)不对?
if(($e instanceof ClassNotFoundException || $e instanceof RouteNotFoundException) || ($e instanceof HttpException && $e->getStatusCode()==404)){
$data = [
'err_msg' => $e -> getMessage(),
'tips_1' => '请检查路径是否是否填写正确',
'tips_2' => '请检查请求类型是否正确',
];
return result($data, '方法或资源未找到,请检查', 404);
}
下面就不写了,太麻烦了,直接放全部代码
<?php
namespace app;
use ParseError; // 语法错误
use TypeError;
use InvalidArgumentException; // 参数错误
use thinkdbexceptionDataNotFoundException;
use thinkdbexceptionModelNotFoundException;
use thinkdbexceptionPDOException; // 数据库连接错误
use thinkdbexceptionDbException; // 数据库模型访问错误,比如方法不存在
use thinkexceptionRouteNotFoundException;
use thinkexceptionClassNotFoundException;
use thinkexceptionFuncNotFoundException;
use thinkexceptionFileException;
use thinkexceptionHandle;
use thinkexceptionHttpException;
use thinkexceptionHttpResponseException;
use thinkexceptionValidateException;
use thinkexceptionErrorException;
use thinkResponse;
use Throwable;
/**
* 应用异常处理类
*/
class ExceptionHandle extends Handle
{
/**
* 不需要记录信息(日志)的异常类列表
* @var array
*/
protected $ignoreReport = [
HttpException::class,
HttpResponseException::class,
ModelNotFoundException::class,
DataNotFoundException::class,
ValidateException::class,
];
/**
* 记录异常信息(包括日志或者其它方式记录)
*
* @access public
* @param Throwable $exception
* @return void
*/
public function report(Throwable $exception): void
{
// 使用内置的方式记录异常日志
parent::report($exception);
}
/**
* Render an exception into an HTTP response.
*
* @access public
* @param thinkRequest $request
* @param Throwable $e
* @return Response
*/
public function render($request, Throwable $e): Response
{
// 添加自定义异常处理机制
// 请求异常
if ($e instanceof HttpException && $request->isAjax()) {
return response($e->getMessage(), $e->getStatusCode());
}
// 使用了错误的数据类型 或 缺失参数
if ($e instanceof InvalidArgumentException || $e instanceof ErrorException) {
$fileUrlArr = explode(DIRECTORY_SEPARATOR, $e->getFile());
$data = [
'err_msg' => $e->getMessage(),
'file' => $fileUrlArr[count($fileUrlArr) - 1],
'line' => $e->getLine()
];
return result($data, '参数错误', 413);
}
// 1.参数验证错误
if ($e instanceof ValidateException) {
return result($e->getError(), '参数验证不通过', 422);
}
// 2.方法(控制器、路由、http请求)、资源(多媒体文件,如视频、文件)未匹配到,
// 一旦在定义的路由规则中匹配不到,它就会直接去匹配控制器,但是因为在控制器中做了版本控制v1,v2这样的,所以它是无法获取对应控制器的
// 所以都会直接走了HttpException的错误
// 感觉好像也无所谓,反正是做api接口的,只不过这样就不好准确的提示信息了
// 到底这个请求时控制器找不到呢?还是方法找不到?还是请求类型(get,post)不对?
if(($e instanceof ClassNotFoundException || $e instanceof RouteNotFoundException) || ($e instanceof HttpException && $e->getStatusCode()==404)){
$data = [
'err_msg' => $e -> getMessage(),
'tip_1' => '请检查路径是否是否填写正确',
'tips_2' => '请检查请求类型是否正确',
];
return result($data, '方法或资源未找到,请检查', 404);
}
// 3.语法错误
if ($e instanceof ParseError) {
$fileUrlArr = explode(DIRECTORY_SEPARATOR, $e->getFile());
$data = [
'err_msg' => $e->getMessage(),
'file' => $fileUrlArr[count($fileUrlArr) - 1],
'line' => $e->getLine()
];
return result($data, '服务器异常-语法错误', 411);
}
// 4.数据库错误
if ($e instanceof PDOException || $e instanceof DbException) {
$fileUrlArr = explode(DIRECTORY_SEPARATOR, $e->getFile());
$data = [
'err_msg' => $e->getMessage(),
'file' => $fileUrlArr[count($fileUrlArr) - 1],
'line' => $e->getLine()
];
return result($data, '服务器异常-数据库错误', 412);
}
// 其他错误交给系统处理
return parent::render($request, $e);
}
}
本节结束,这里面用的错误处理都是我在平常练习中遇到的错误,至于其他的没有处理是因为我还没碰到,碰到再说吧。为了给前端好的反馈,我们应该处理所有的异常的返回形式,不然,tp6默认返回页面形式的,前端等于得不到相应了。至于这个自定义异常捕获,应该有相应的插件的吧,你要是感兴趣可以去找找。
7、自动生成api文档
之前我还很好奇,后端是怎么搞出接口文档的,都是自己录入数据套模板的吗?原来他么的都是插件做的,真他么方便!!!
(1)安装插件
composer require hg/apidoc
// 文档
// https://hgthecode.github.io/thinkphp-apidoc/guide/install/
你就照着插件的文档来就好了,不用跟着我。
(2)下载对应的前端页面
下载最新的,放在public目录下
(3)使用
具体配置你还得看文档,我就直接照着最简单的做了,
我就试一个,将app/controller/v1/User.php写了注释,它会读注释生成接口文档
① 引入注释
app/controller/v1/User.php
<?php
namespace appcontrollerv1;
use appBaseController;
// 添加这句,注释写法为 @Apidoc参数名(...)
use hgapidocannotation as Apidoc;
/**
* @ApidocTitle("V1")
* @ApidocGroup("base")
*/
class User extends BaseController
{
/**
* @ApidocTitle("登录")
* @ApidocUrl("v1.user/login")
* @ApidocTag("测试 基础")
* @ApidocParam("username", type="string",require=true, desc="用户名" )
* @ApidocParam("password", type="string",require=true, desc="密码" )
* @ApidocReturned("id", type="int", desc="新增用户的id")
*/
public function login()
{
return result(null, '成功', 200);
}
}
② 查看效果
这个接口文档这里有点小问题,因为我们前面使用在header中添加api版本的方式控制请求的api版本,所以如果直接用/user/login是无法访问到控制器的,也就访问不到方法,必须得加上控制器所在位置的信息,就在前面加上了v1,变成了v1.user/login。这种形式是通过控制器去访问的方法,显然不理想,我想要达到的目标是不需要再里面加上v1,这个还得好好研究研究,不然前面定义的路由不是跟这个接口文档对不上了吗?你们要是研究到了,记得踢我一脚哈 >_>!
#后记:当时只是练习一下我,我也没深究,but其实这个apidoc它的官方文档里有设置项的,关于这个多应用/多版本的配置项,去去看吧,在config/apidoc.php修改apps的配置就可以了,然后就可以通过右上角的选择框切换版本了
// 设置应用/版本(必须设置)
'apps' => [
[
'title'=>'演示示例',
'path'=>'app',
'folder'=>'controller',
'items'=>[
['title'=>'V1.0','path'=>'appcontrollerv1','folder'=>'v1'],
['title'=>'V2.0','path'=>'appcontrollerv2','folder'=>'v2']
]
],
],
总结
一个简单的后端接口这样应该就够用了,以我之前做过的学校的课程设计的经验来说的哈。我没有用过别的后端语言,不过就现在感觉,php真好用,不亏是世界上最好的语言。
/ 狗头 / 手动滑稽 /
一个多月了,用平时的碎片时间学习了一下搭建tp6api服务,花了几天把之前的内容做了一次回顾,写了这篇博客,发现了自己之前疏漏的地方,收获很大。也发现了一些新的问题,不过,我不打算把时间浪费在这里了,现在的感觉真的就少壮不努力,老大徒伤悲,但是奈何冰冻三尺非一日之寒。要学习想学习的东西太多,但是时间太少,痛恨之前学生阶段浪费时间的自己。
作为一名前端程序员(不要疑惑我为什么在搞后端,千金难买我高兴,傲娇!),我的前端的能力很薄弱,最近在公司遇到的问题就让我搞了好久,我其实可以算是没有工作经验的,
毕业已经快一年了,第一份工作在一家5个人的小外包公司上班,过去就是顶梁柱,没有设计图,也没有明确的需求,就是按着我的想法来做,再按照客户的想法改,真的是很烦,为了能快速完成项目,都是找ui库,套模板,一个人把前后端都敢了。让我现在去看之前的项目,我不要看的,什么垃圾玩意儿。干了四个月,只有每天都在加班加点的干,没有时间去沉淀和学习,让我觉得实在浪费时间,工资只拿了1.2w。
第二份工资没入职干了一个月不到,又跑了,还是同样的工资,还是同样的加班方式,跟老板提了一下,老板说这是我主动加班的,并不是他要求,接着跟我扯什么仁义道德,我一个大学生看的鸡汤还少吗,还要听你讲这些?大家都是成年人,不会不懂我提这个什么意思,你就装傻吧,我不陪你玩了。过来人的经验,小微公司去不得,钱少活多。
第三份工作我来到了杭州,进了一家100+人的企业,工资有上涨,双休,还交五险,虽然没一金,可比前两份工资好太多了,前面的工作还没这些呢。虽然要六个月的试用期,但是4.30分下班,每天有很多的时间的去学习。这对于进入行业初期的小白来说,非常重要,非常有价值。不过难受的是,在这里我也是一样连个问的人都没有,有些方面没有前人的经验真的难搞,完全就是自己摸索,如果每个程序员没事儿都能写写博客就好了,要不对我这样的小白可太难受了。
人呐,出来工作都是为了钱,现在回想一下我为什么会走上前端开发的道路呢,因为学校教的专业课就是开发相关,结果大学毕业,发现自己就会这个。。。这难道就是他么的船到桥头自然直。其实我到现在都不知道,我学的专业有什么用,拿着管理学的学位,做着开发的工作。
一个毕业近一年的大学生,他的工资应该有多少呢,我现在的试用期工资还不及我一个大学室友测试的工资,我另一个大学室友做直播运营的,工资竟是我现在的两倍,明明听他的描述就是做做ppt,玩玩手机,而且他上课也不去的,毕设还是我给他的,怎么工资就能这么高呢,唉~!假如我没有见过光明,我本可以忍受黑暗。 看到他们的工资,我心里痒痒,不平衡,我花费的牺牲的时间比他们要多得多,得到的却差这么多。这他么就是在刺激我呀,我都已经24岁了,月薪不足5k, 我怎么敢在奋斗的年纪玩游戏啊,操蛋!
后端的学习得放一放了,还是要回到我的职业,去学前端的东西了,毕竟我只会一个vue,说出来真他么的惭愧啊,本来我还想去学three.js玩3dMax的,现在在工作中遇到了问题,被ui看不起了,我可不想这么快就被迫离开这么清闲的工作,谁知道下一份工作忙不忙呢?
暂无评论内容