⼩爱⾳响调⽤php接⼝_MixPHP开发API接⼝简单实例
注意:这个是 MixPHP V1 的范例
MixPHP 是⼀款基于 Swoole 的常驻内存型 PHP ⾼性能框架,框架的⾼性能特点⾮常适合开发 API 接⼝,⽽且⾮常接近传统 MVC 框架,所以开发接⼝时⾮常简单。
下⾯做⼀个开发 API 接⼝的简单实例:
从 articles 表,通过 id 获取⼀篇⽂章。
访问该接⼝的 URL:
数据库表结构如下:
CREATE TABLE `articles` (
`id` int(10) unsigned NOT NULL AUTO_INCREMENT,
`title` varchar(255) NOT NULL,
`content` varchar(255) NOT NULL,
`dateline` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;
第⼀步
修改数据库配置⽂件,MixPHP 的应⽤配置⽂件中,关于数据库的信息都引⽤了 common/config/database.php ⽂件。
第⼆步
修改应⽤配置⽂件:
修改 Response 组件默认输出格式为 JSON 格式。
修改 404/500 错误输出格式为 JSON 格式。
框架默认的 404/500 响应是⽹页,⽽ API 服务需要响应 JSON 数据,通常其他传统 MVC 框架需要修改很多地⽅才可完成这个需求,MixPHP 本⾝就提供该种配置,只需修改⼀下配置即可。
MixPHP 的默认 HTTP 应⽤中有两个配置⽂件,分别为:
http_permanent.php : 部署在 mix-httpd 的常驻同步模式时使⽤。
http_compatible.php :部署在 Apache/PHP-FPM 时使⽤。
开发 API 时我们推荐在 Apache/PHP-FPM 下开发,上线再部署⾄ mix-httpd 即可,反正是⽆缝切换的。
现在我们修改 response 键名下的 defaultFormat 键为 mix\http\Error::FORMAT_JSON,如下:
// 响应
'response' => [
// 类路径
'class' => 'mix\http\compatible\Response',
// 默认输出格式
'defaultFormat' => mix\http\Response::FORMAT_JSON,
// json
'json' => [
// 类路径
'class' => 'mix\http\Json',
],
// jsonp
'jsonp' => [
// 类路径
'class' => 'mix\http\Jsonp',
// callback键名
'name' => 'callback',
]
,
// xml
'xml' => [
// 类路径
'class' => 'mix\http\Xml',
],
],
然后修改 main_compatible.php ⽂件中 error 键名下的 format 键为 mix\http\Error::FORMAT_JSON,如下:// 错误
'error' => [
// 类路径
'class' => 'mix\http\Error',
// 输出格式
'format' => mix\http\Error::FORMAT_JSON,
],
第三步
创建控制器:
apps/index/controllers/ArticlesController.php
namespace apps\index\controllers;
use mix\facades\Request;
use mix\http\Controller;
use apps\index\messages\ErrorCode;
use apps\index\models\ArticlesForm;
class ArticlesController extends Controller
{
public function actionDetails()
{
// 使⽤模型
$model = new ArticlesForm();
$model->attributes = Request::get();
$model->setScenario('actionDetails');
if (!$model->validate()) {
return ['code' => ErrorCode::INVALID_PARAM];
}
/
/ 获取数据
$data = $model->getDetails();
if (!$data) {
return ['code' => ErrorCode::ERROR_ID_UNFOUND];
}
// 响应
return ['code' => ErrorCode::SUCCESS, 'data' => $data]; }
}
创建错误码类:
apps/index/messages/ErrorCode.php
namespace apps\index\messages;
class ErrorCode
{
const SUCCESS = 0;
const INVALID_PARAM = 100001;
const ERROR_ID_UNFOUND = 200001;
}
创建表单验证模型:
apps/index/models/ArticlesForm.php
namespace apps\index\models;
简单网页use mix\validators\Validator;
use apps\common\models\ArticlesModel;
class ArticlesForm extends Validator
{
public $id;
// 规则
public function rules()
{
return [
'id' => ['integer', 'unsigned' => true, 'maxLength' => 10],
];
}
// 场景
public function scenarios()
{
return [
'actionDetails' => ['required' => ['id']],
];
}
// 获取详情
public function getDetails()
{
return (new ArticlesModel())->getRowById($this->id);
}
}
创建数据表模型:
apps/common/models/ArticlesModel.php
namespace apps\common\models;
use mix\facades\PDO;
class ArticlesModel
{
const TABLE = 'articles';
// 获取⼀⾏数据通过id
public function getRowById($id)
{
$sql = "SELECT * FROM `" . self::TABLE . "` WHERE id = :id";
$row = PDO::createCommand($sql)->bindParams([ 'id' => $id,
])->queryOne();
return $row;
}
}
以上就是全部代码的编写。
第四步
使⽤ Postman 测试,如下:
接⼝开发与测试完成,是不是很简单呀。
MixPHP
版权声明:本站内容均来自互联网,仅供演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198,我们将在24小时内删除。
发表评论