vvinners/vapi

API JSON 返回响应的增强版本。旨在标准化返回的 API 数据格式。

v2.1.0 2022-12-22 22:14 UTC

This package is auto-updated.

Last update: 2024-09-23 02:05:58 UTC


README

###[重要] VAPI 的 V2 版本有破坏性更改,应从配置文件夹中删除 msgcode.php 并发布配置文件

目录

贡献

贡献使这样的惊人社区和项目成为可能。相互学习、启发和创造。您所做的任何贡献都 非常受欢迎

安装

composer require vvinners/vapi

发布配置文件到 app/config

php artisan vendor:publish --provider="VVinners\Vapi\VapiServiceProvider" --tag=config

如果包不是自动发现,请将其放入 config/app.php
VVinners\Vapi\VapiServiceProvider::class

演示

use VVinners\Vapi\Api;

$api = new Api;
return $api->response(["result" => true], "OK");

上面的代码将数据转换为以下 JSON 格式 并以 HTTP 200 状态 返回

{msg_code: "OK", msg: "Success", result: true}

第二个参数 "OK" 可以在下面的 msgcode.php 中更新。以下是该文件的示例数据

<?php

return [

    'response_status' => [
        // HTTP_INTERNAL_SERVER_ERROR
        '500' => [
            'ERROR' => 'Error encountered'
        ],
    
        // HTTP_OK
        '200' => [
            'OK' => 'Success',
            'USER_NOT_FOUND' => 'User not found',
        ],
    
        // HTTP_BAD_REQUEST
        '400' => [
            'INVALID_DATA_INPUT' => 'Invalid data pass to server',
            'VALIDATION_ERROR' => 'Validation error',
        ],
    
        // HTTP_UNAUTHORIZED
        '401' => [
    
        ],
    
        // HTTP_FORBIDDEN
        '403' => [
    
        ]
    ],
    'msg_code_name' => 'msg_code',
    'msg_name' => 'msg',

];

V2

  • 能够在返回响应中自定义 msg_code 和 msg 列
  • 更新 msgcode.php 格式

许可证

MIT 许可证 (MIT)

版权所有 (c) 2020 VVinners

特此授予任何人免费获得此软件及其相关文档文件(以下简称“软件”)的副本的权利,无限制地处理该软件,包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或销售软件副本,并允许获得软件的人这样做,前提是符合以下条件

上述版权声明和本许可声明应包含在软件的所有副本或主要部分中。

软件按“原样”提供,不提供任何形式的保证,无论是明示的、暗示的,还是与特定目的和侵权无关的保证。在任何情况下,作者或版权所有者均不对任何索赔、损害或其他责任负责,无论是基于合同、侵权或其他方式,无论是源于、因之或与此软件或软件的使用或其他交易有关。