如何使用MixPHP来开发API接口-php教程-PHP中文网

如何使用MixPHP来开发API接口

不言

发布： 2018-07-11 14:11:23

原创

3469人浏览过

这篇文章主要介绍了关于如何使用mixphp来开发api接口，有着一定的参考价值，现在分享给大家，有需要的朋友可以参考一下

MixPHP 是一款基于 Swoole 的常驻内存型 PHP 高性能框架，框架的高性能特点非常适合开发 API 接口，而且 MixPHP 非常接近传统 MVC 框架，所以开发接口时非常简单。

下面做一个开发 API 接口的简单实例：

从 articles 表，通过 id 获取一篇文章。

访问该接口的 URL：

http://www.e.com/articles/details?id=1

登录后复制

数据库表结构如下：

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 文件。

5710806-4a17c84d4593b668[1].png

第二步

修改应用配置文件:

修改 Response 组件默认输出格式为 JSON 格式。
修改 404/500 错误输出格式为 JSON 格式。

1579415720-5b0cc3e20ac7f_articlex[1].png

框架默认的 404/500 响应是网页，而 API 服务需要响应 JSON 数据，通常其他传统 MVC 框架需要修改很多地方才可完成这个需求，MixPHP 本身就提供该种配置，只需修改一下配置即可。

MixPHP 的默认 Web 应用中有两个配置文件，分别为：

main.php ：部署在 mix-httpd 时使用。
main_compatible.php ：部署在 Apache/PHP-FPM 时使用。

开发 API 时我们推荐在 Apache/PHP-FPM 下开发，上线再部署至 mix-httpd 即可，反正是无缝切换的。

现在我们修改 response 键名下的 defaultFormat 键为 mix\http\Error::FORMAT_JSON，如下：

// 响应
&#39;response&#39; => [
    // 类路径
    &#39;class&#39;         => &#39;mix\http\compatible\Response&#39;,
    // 默认输出格式
    &#39;defaultFormat&#39; => mix\http\Response::FORMAT_JSON,
    // json
    &#39;json&#39;          => [
        // 类路径
        &#39;class&#39; => &#39;mix\http\Json&#39;,
    ],
    // jsonp
    &#39;jsonp&#39;         => [
        // 类路径
        &#39;class&#39; => &#39;mix\http\Jsonp&#39;,
        // callback键名
        &#39;name&#39;  => &#39;callback&#39;,
    ],
    // xml
    &#39;xml&#39;           => [
        // 类路径
        &#39;class&#39; => &#39;mix\http\Xml&#39;,
    ],
],

登录后复制

然后修改 main_compatible.php 文件中 error 键名下的 format 键为 mix\http\Error::FORMAT_JSON，如下：

// 错误
&#39;error&#39;    => [
    // 类路径
    &#39;class&#39;  => &#39;mix\http\Error&#39;,
    // 输出格式
    &#39;format&#39; => mix\http\Error::FORMAT_JSON,
],

登录后复制

第三步

创建控制器：

apps/index/controllers/ArticlesController.php

登录后复制

<?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(&#39;actionDetails&#39;);
        if (!$model->validate()) {
            return [&#39;code&#39; => ErrorCode::INVALID_PARAM];
        }
        // 获取数据
        $data = $model->getDetails();
        if (!$data) {
            return [&#39;code&#39; => ErrorCode::ERROR_ID_UNFOUND];
        }
        // 响应
        return [&#39;code&#39; => ErrorCode::SUCCESS, &#39;data&#39; => $data];
    }

}

登录后复制

创建错误码类：

apps/index/messages/ErrorCode.php

登录后复制

<?php

namespace apps\index\messages;

class ErrorCode
{

    const SUCCESS = 0;
    const INVALID_PARAM = 100001;
    const ERROR_ID_UNFOUND = 200001;

}

登录后复制

创建表单验证模型：

apps/index/models/ArticlesForm.php

登录后复制

<?php

namespace apps\index\models;

use mix\validators\Validator;
use apps\common\models\ArticlesModel;

class ArticlesForm extends Validator
{

    public $id;

    // 规则
    public function rules()
    {
        return [
            &#39;id&#39; => [&#39;integer&#39;, &#39;unsigned&#39; => true, &#39;maxLength&#39; => 10],
        ];
    }

    // 场景
    public function scenarios()
    {
        return [
            &#39;actionDetails&#39; => [&#39;required&#39; => [&#39;id&#39;]],
        ];
    }

    // 获取详情
    public function getDetails()
    {
        return (new ArticlesModel())->getRowById($this->id);
    }

}

登录后复制

创建数据表模型：

apps/common/models/ArticlesModel.php

登录后复制

<?php

namespace apps\common\models;

use mix\facades\RDB;

class ArticlesModel
{

    const TABLE = &#39;articles&#39;;

    // 获取一行数据通过id
    public function getRowById($id)
    {
        $sql = "SELECT * FROM `" . self::TABLE . "` WHERE id = :id";
        $row = RDB::createCommand($sql)->bindParams([
            &#39;id&#39; => $id,
        ])->queryOne();
        return $row;
    }

}

登录后复制

以上就是全部代码的编写。