ochi51/cybozu-http-bundle

Symfony2 HTTP client bundle for cybozu.com API (kintone API and User API)

CybozuHttpBundle

, _(*1)

Symfony bundle that integrates the Cybozu HTTP by providing easy-to-use services and configuration., _(*2)

cybozu.com API Documentation

Japanese English, _(*3)

Requirements

• PHP >=5.5
• Composer
• Symfony >=3.1

Installation

The recommended way to install Cybozu HTTP is with Composer. Composer is a dependency management tool for PHP that allows you to declare the dependencies your project needs and installs them into your project., _(*4)

```{.bash} $ curl -sS https://getcomposer.org/installer | php $ mv composer.phar /usr/local/bin/composer, <sub>(*5)</sub>

You can add Cybozu HTTP as a dependency using the composer

```{.bash}
    $ composer require ochi51/cybozu-http-bundle

Alternatively, you can specify Cybozu HTTP as a dependency in your project's existing composer.json file:, <sub>(*6)</sub>

```{.json} { "require": { "ochi51/cybozu-http-bundle": "^1.0" } }, <sub>(*7)</sub>

After installing, you need to register the bundle in your application.

```{.php}
    // app/AppKernel.php
    class AppKernel extends Kernel
    {
        // ...
        public function registerBundles()
        {
            $bundles = array(
                // ...
                new CybozuHttpBundle\CybozuHttpBundle()
            );
        }
    }

Configuration

There are two ways that configure cybozu.com account information., <sub>(*8)</sub>

1. User entity has it.

```{.yml} # app/config.yml cybozu_http: cert_dir: /path/to/cert_dir logfile: /path/to/logfile.log, <sub>(*9)</sub>

```{.php}
    use CybozuHttpBundle\Entity\UserInterface;

    class User implements UserInterface
    {
        public function getCybozuHttpConfig()
        {
            return [
                "domain" =>         "cybozu.com",
                "subdomain" =>      "changeMe",
                "use_api_token" =>    false,
                "login" =>          "changeMe",
                "password" =>       "changeMe",
                "token" =>          null,
                "use_basic" =>       false,
                "basic_login" =>     null,
                "basic_password" =>  null,
                "use_client_cert" =>  false,
                "cert_file" =>       "cert.pem",
                "cert_password" =>   null
            ];
        }

        public function getDebugMode()
        {
            return true;
        }
    }

Quick example

```{.php} <?php // AppBundle\Controller\MyCybozuHttpController, <sub>(*10)</sub>

public function getRecordAction($appId, $recordId)
{
    $api = $this->get('cybozu_http.kintone_api_client');
    $record = $api->record()->get($appId, $recordId);
    // do something
}

Testing
------------

To run the tests, Run the following command from the project folder.

```{.bash}
    $ php ./bin/phpunit

TODO

• Japanese documentation.

License

The MIT License (MIT). Please see LICENSE for more information., <sub>(*11)</sub>