README

此包实现了一个调用REST API的服务。特性包括

• 调用REST API并接收解码后的json数组
• 调用REST API并接收未解码的json
• 可以自动传入参数http动词和json，它会自动发出请求

注意

该包已发布并可使用。然而，它正在积极开发中。

文档

此包允许调用REST API，并提供一个具有基本配置的实体来返回json。

要使用此包，首先必须使用DI中的服务，如下所示

$apiRest = $this->get('services.chiamatarest');

然后，您可以对该服务进行设置。默认情况下，服务将在REST API的json响应中搜索名为“message”的字段，该字段包含调用结果的消息，以及名为“success”的字段，用于调用结果（true或false）。如果这不满足您的需求，您可以按照这种方式更改名称

对于消息字段

$apiRest->setNomeCampoMessage("<your-field-name>");

对于成功字段

$apiRest->setNomeCampoSuccess("<your-field-name>");

您也可以选择不测试特定字段，通过设置此选项

$apiRest->setControlSuccess(false);

默认为true。

然后，您可以进行其他设置，例如

设置调用项目的名称，用于日志

$apiRest->setChiamante("<your-application>");

设置http动词

$apiRest->setTipoChiamata("<http-verb");

设置要调用的url

$apiRest->setUrl("<api-rest-url>");

您可以传递json输入，目前只有POST、PUT和GET HTTP动词接受json输入。您可以这样做

$apiRest->setJson("<your-json>");

对于每个请求，服务将测试返回的HTTP状态码。如果收到200、201或202，则一切正常。在其他情况下，它将引发一个异常，需要捕获。

现在，您可以发出api请求并接收一个数组，如下所示

$returnJsonAarray=$apiRest->chiamataRestDecodificata();

或者，您可以通过以下方式发出只接收json的api请求

$returnJson=$apiRest->chiamataRest();

然而，您可以通过这种方式查看请求返回的http状态码

$returnHttpCode=$apiRest->getHttpcode();

安装

步骤1：下载包

打开命令行，进入您的项目目录，并执行以下命令以下载此包的最新稳定版本

$ composer require brunopicci/call-rest-api

此命令要求您全局安装了Composer，如Composer文档中的00-intro.md部分所述。

步骤2：启用包

然后，通过将其添加到项目app/AppKernel.php文件中注册的包列表中启用该包

<?php
// app/AppKernel.php

// ...
class AppKernel extends Kernel
{
    public function registerBundles()
    {
        $bundles = array(
            // ...

            new Services\Bundle\Rest\ServicesRestBundle(),
        );

        // ...
    }

    // ...
}

然后在config.yml中导入包的services.yml：导入 ... - { resource: "@ServicesRestBundle/Resources/config/services.yml" }

许可证

此包采用MIT许可证。