PHPackages                             renins/api-client-link-auto - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. renins/api-client-link-auto

ActiveLibrary[API Development](/categories/api)

renins/api-client-link-auto
===========================

PHP client for Renaissance Auto Integration API

01PHP

Since Feb 28Pushed 8y agoCompare

[ Source](https://github.com/ReninsDeveloper/renins-api-client)[ Packagist](https://packagist.org/packages/renins/api-client-link-auto)[ RSS](/packages/renins-api-client-link-auto/feed)WikiDiscussions master Synced 3d ago

READMEChangelogDependenciesVersions (1)Used By (0)

Как развернуть проект для тестирования
======================================

[](#как-развернуть-проект-для-тестирования)

- Установите [composer](https://getcomposer.org/download/)
- Установите php версии не ниже 7.1
- Клонируйте репозиторий

```
git clone https://github.com/ReninsDeveloper/renins-api-client.git
```

- Выполните в папке проекта:

```
composer install
```

- Скопируйте phpunit.xml.dist в phpunit.xml. Укажите настройки сервисов в <php></php>
- Выполняйте команды "phpunit". Подробнее в разделе "Тестирование".

Клиент
======

[](#клиент)

Может быть создан через фабрику ReninsApi\\Factory или напрямую как экземпляр класса ReninsApi\\Client\\ApiVersion2.

Клиент использует REST-запросы и SOAP-запросы. REST для получения некоторых справочных данных. Например: список марок и моделей авто. SOAP используется для расчетов, для импорта полисов, для получения печатных форм.

Контейнеры
==========

[](#контейнеры)

Основная логика приложения построена на контейнерах - классах унаследованных от ReninsApi\\Request\\Container. Контейнер может иметь свойства любого типа, в т.ч. другие контейнеры и коллекцию контейнеров.

- Контейнер может проверить сам себя на валидность. Для этого он содержит защищенное свойство $rules. Валидация запускается явным образом (методы validate() или validateThrow()). Валидация проводится рекурсивно по всем вложенным контейнерам и коллекциям
- После проверки можно запросить массив ошибок (метод getErrors())
- Контейнер может быть сериализован в XML или массив (методы toXml() и toArray()). Это также производится рекурсивно.
- Контейнер может быть создан из XML (метод fromXml() или стат. метод createFromXml()). Конечно контейнер создаст все вложенные контейнеры и коллекции
- Аналогично контейнер может быть создан из объектов stdClass (метод fromXml() или стат. метод createFromXml()).

Если контейнер предназначен для составления запроса в формате XML, он должен правильно сериализоваться в XML. По умолчанию все совйства сохраняются как отдельные тэги, если вам нужно другое поведение, то следует переунаследовать метод toXml(). Подобным образом может понадобится переунаследование метода toArray().

Контейнеры, которые служат для парсинга ответов, как правило переунаследуют метод fromXml().

Правила валидации
-----------------

[](#правила-валидации)

$rules представляет собой массив, ассоц. по именам свойств. Каждое свойство обязательно должно быть указано в $rules, но можно указать пустой массив правил для свойства. Правила для каждого свойства можно указывать в виде строки через запятую или в виде массива.

Пример правил:

```
    protected $rules = [
        'IsIP' => ['toLogical'],
        'FirstName' => ['toString', 'notEmpty'],
        'MiddleName' => ['toString', 'notEmpty'],
        'LastName' => ['toString', 'notEmpty'],
        'BirthDate' => ['toString', 'date'],
        'Gender' => ['toString', 'in:M|F'],
        'MaritalStatus' => ['toInteger', 'between:1|4'],
        'HasChildren' => ['toLogical'],
        'DriveExperience' => ['toString', 'date'],
        'Documents' => ['containerCollection:' . Document::class],
    ];
```

Правила, начинающиеся на 'to', являются фильтрами. Они служат только для конвертации значения при записи в свойство. Остальные правила являются валидаторами и проверяют значение свойства. Правила фильтрации обрабатываются ReninsApi\\Request\\Filter, правила валидации - ReninsApi\\Request\\Validator.

Некоторые правила должны(могут) иметь параметры, указанные после двоеточия. Подробнее о правилах см. в ReninsApi\\Request\\Validator

Процесс валидации
-----------------

[](#процесс-валидации)

После вызова validate() можно запросить список ошибок методом getErrors(). Метод вернет плоский массив ошибок, ассоц. по названию свойств.

```
[
    'Policy.Vehicle.Manufacturer' => '... текст ошибки ...'
    'Policy.Vehicle.Model' => '... текст ошибки ...'
    'Policy.Covers.0.code' => '... текст ошибки ...'
    'Policy.Covers.1.code' => '... текст ошибки ...'
]
```

Как видно из примера коллекция (Policy.Covers) также проверяются и результаты её проверки также собираются в список ошибок.

Метод validateThrow() создаст исключение ReninsApi\\Request\\ValidatorMultiException. Это исключение имеет метод getErrors(), которое вернет тот самый массив ошибок. Метод validateThrow() вызывается перед каждым SOAP или REST запросом, а также после получения ответа и конвертации его в соотв. контейнер.

Тестирование
============

[](#тестирование)

Тесты разделены на 3 части (--testsuite): client, request, response.

1. client - тестирование взаимодействия с soap и rest сервисами.
2. request - внутренние тесты сериализаций в xml и array
3. response - внутренние тесты десериализаций
4. casco-full - тестирование полного цикла по КАСКО
5. casco-full-multidrive - тестирование полного цикла по КАСКО (мультидрайв)
6. casco-full-multidrive-jur - тестирование полного цикла по КАСКО (мультидрайв, страхователь - юр. лицо)
7. osago-full - тестирование полного цикла по ОСАГО
8. osago-full-multidrive - тестирование полного цикла по ОСАГО (мультидрайв)
9. osago-full-multidrive-jur - тестирование полного цикла по ОСАГО (мультидрайв, страхователь - юр. лицо)
10. casco-prolongation - тестирование пролонгации по КАСКО

Часть client разделена на группы calculation-casco, calculation-osago, import-casco, import-osago, printing-casco, printing-osago, rest.

Если мы хотим запустить тест только для client и толко для расчета каско, то необходимо выполнить

```
phpunit --testsuite client --group calculation-casco --debug
```

В папке tests/logs будут созданы логи тестирования в формате Html (Monolog).

В папке tests/data/temp будут созданы временные файлы для обмена между тестами и печатные формы в PDF.

Некоторые тесты зависимы друг от друга. Можно было бы использовать функцию dependency phpunit, но такие тесты получились бы слишком длительные по времени, поэтому удобнее запускать тесты по отдельности. Тесты обмениваются между собой данными через временные файлы.

Например: Тест по расчету КАСКО сохраняет номер ктировки, который потом нужен для теста импорта и теста печатных форм.

Поэтому удобно запустить тесты по очереди:

```
phpunit --testsuite client --group calculation-casco --debug
phpunit --testsuite client --group import-casco --debug
phpunit --testsuite client --group printing-casco --debug
```

casco-full проверяет сразу все операции по КАСКО:

- Расчет с созданием котировки
- Печать результатов расчета
- Получение номера полиса по котировке
- Импорт полиса по котировке
- Печать оригинала полиса - окончательное подтверждение договора

```
phpunit --testsuite casco-full --debug
```

casco-full-multidrive проверяет сразу все операции по КАСКО (мультидрайв):

```
phpunit --testsuite casco-full-multidrive --debug
```

casco-full-multidrive-jur проверяет сразу все операции по КАСКО (мультидрайв, страхователь - юр. лицо):

```
phpunit --testsuite casco-full-multidrive-jur --debug
```

osago-full проверяет сразу все операции по ОСАГО:

- Расчет с созданием котировки
- Печать доп. данных расчета
- Импорт полиса по котировке
- Печать оригинала полиса - окончательное подтверждение договора

```
phpunit --testsuite osago-full --debug
```

osago-full-multidrive проверяет сразу все операции по ОСАГО (мультидрайв):

```
phpunit --testsuite osago-full-multidrive --debug
```

osago-full-multidrive-jur проверяет сразу все операции по ОСАГО (мультидрайв, страхователь - юр. лицо):

```
phpunit --testsuite osago-full-multidrive-jur --debug
```

###  Health Score

18

—

LowBetter than 8% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity1

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/011fa840baf400918658fee227c3bbed5d25e760251fca4032ad76152b0a40ce?d=identicon)[AndreyTCR](/maintainers/AndreyTCR)

### Embed Badge

![Health badge](/badges/renins-api-client-link-auto/health.svg)

```
[![Health](https://phpackages.com/badges/renins-api-client-link-auto/health.svg)](https://phpackages.com/packages/renins-api-client-link-auto)
```

###  Alternatives

[stripe/stripe-php

Stripe PHP Library

4.0k143.3M480](/packages/stripe-stripe-php)[twilio/sdk

A PHP wrapper for Twilio's API

1.6k92.9M272](/packages/twilio-sdk)[knplabs/github-api

GitHub API v3 client

2.2k15.8M187](/packages/knplabs-github-api)[facebook/php-business-sdk

PHP SDK for Facebook Business

90121.9M34](/packages/facebook-php-business-sdk)[meilisearch/meilisearch-php

PHP wrapper for the Meilisearch API

73813.7M114](/packages/meilisearch-meilisearch-php)[google/gax

Google API Core for PHP

263103.1M454](/packages/google-gax)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)