PHPackages                             sima-land/delivery-calculator - 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. [Utility & Helpers](/categories/utility)
4. /
5. sima-land/delivery-calculator

ActiveLibrary[Utility & Helpers](/categories/utility)

sima-land/delivery-calculator
=============================

Delivery calculator for sima-land.ru

2.0.1(9y ago)56.4k↑71.9%2BSD-3PHPPHP >=7.0

Since Nov 21Pushed 8y ago5 watchersCompare

[ Source](https://github.com/sima-land/delivery-php-calculator)[ Packagist](https://packagist.org/packages/sima-land/delivery-calculator)[ Docs](https://github.com/sima-land/delivery-php-calculator)[ RSS](/packages/sima-land-delivery-calculator/feed)WikiDiscussions master Synced yesterday

READMEChangelog (10)Dependencies (4)Versions (31)Used By (0)

Расчет стоимости доставки [www.sima-land.ru](https://www.sima-land.ru)
======================================================================

[](#расчет-стоимости-доставки-wwwsima-landru)

[![Build Status](https://camo.githubusercontent.com/7376f0035dad1e20bfcb34d6216d7251f6d122160944724daf1d64273a151688/68747470733a2f2f7472617669732d63692e6f72672f73696d612d6c616e642f64656c69766572792d7068702d63616c63756c61746f722e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/sima-land/delivery-php-calculator)[![StyleCI](https://camo.githubusercontent.com/81c2e7532cdb7fbb54d846808bc2242dc53c2fa885ef6825100b2911a85b53a4/68747470733a2f2f7374796c6563692e696f2f7265706f732f37333730313338372f736869656c643f6272616e63683d6d6173746572)](https://styleci.io/repos/73701387)

Основным способом расчета стоимости доставки является использование API [https://www.sima-land.ru/api/v3/help/#Стоимость-доставки](https://www.sima-land.ru/api/v3/help/#%D0%A1%D1%82%D0%BE%D0%B8%D0%BC%D0%BE%D1%81%D1%82%D1%8C-%D0%B4%D0%BE%D1%81%D1%82%D0%B0%D0%B2%D0%BA%D0%B8)

Однако в ряду случаев предпочтительно рассчитывать стоимость доставки без использования API. Например:

- Количество запросов к API не укладывается в установленные лимиты.
- Требуемая скорость работы не позволяет ожидать ответа от API.

В описанных выше случаях рекомендуется использовать данный компонент, который позволяет вычислять стоимость доставки "на лету".

Для расчета стоимости доставки товара необходимо три сущности:

- Точка доставки - объект, реализующий [PointInterface](src/PointInterface.php)
- Товар - объект, реализующий [ItemInterface](src/ItemInterface.php)
- Источник данных о коэффициентах упаковки - объект, реализующий [VolumeFactorSourceInterface](src/VolumeFactorSourceInterface.php)

Для того, чтобы произвести расчёт стоимости доставки товара, необходимо создать объект класса калькулятора с указанием точки доставки и коэффициентов упаковки.

```
$calc = new Calculator($defaultVolumeFactor, $point, false)
```

Третий аргумент обозначает признак "локальности" точки по отношению к складу. Если `true`, то доставка будет считаться бесплатной для всех товаров кроме тех, у которых метод `isPaidDeliveryLocal()` возвращает `true`

Для добавления товара к расчёту стоимости доставки используется функция `addItem($item, $qty)`, для получения результатов - `getResult()`. Для того, чтобы обнулить результат, используйте `reset()`. В случае ошибки метод `addItem($item, $qty)` вернет false. Информацию об ошибках после этого можно посмотреть с помощью метода `getErrors()`.

Пример:

```
$calc->addItem($item1, 10)
$calc->addItem($item2, 1000)
echo $calc->getResult();  // вывод стоимости доставки item1 10 шт. и item2 1000 шт.

$calc->reset();
$calc->addItem($item3, 1)
echo $calc->getResult(); // вывод стоимости доставки item3 1 шт.

// $item4->getWeight() = 0
if (!$calc->addItem($item4, 1000)) {
	return $calc->getErrors() // ['Weight must be positive, weight=0']
}
```

Точка доставки
--------------

[](#точка-доставки)

Точку доставки представляет объект, реализующий [PointInterface](src/PointInterface.php), данные по большинству городов доставки можно получить по API [https://www.sima-land.ru/api/v3/help/#Города-доставки](https://www.sima-land.ru/api/v3/help/#%D0%93%D0%BE%D1%80%D0%BE%D0%B4%D0%B0-%D0%B4%D0%BE%D1%81%D1%82%D0%B0%D0%B2%D0%BA%D0%B8)

Особые случаи:

- Расчёт стоимости доставки до пункта самовывоза в г. Москва осуществляется с помощью класса [MoscowPointAbstract](src/models/MoscowPointAbstract.php). Нужно расширить этот класс, переопределив метод `hasDiscount`
- При расчёте доставки в г. Екатеринбург признак "локальности" должен быть `true`

Товар
-----

[](#товар)

Все данные для реализации [ItemInterface](src/ItemInterface.php) можно получить по API [https://www.sima-land.ru/api/v3/help/#Товар](https://www.sima-land.ru/api/v3/help/#%D0%A2%D0%BE%D0%B2%D0%B0%D1%80)

Данные о коэффициентах упаковки
-------------------------------

[](#данные-о-коэффициентах-упаковки)

Данные о коэффициентах упаковки представляет объект, реализующий [VolumeFactorSourceInterface](src/VolumeFactorSourceInterface.php). Можно воспользоваться готовой реализацией модели [DefaultVolumeFactorSource](src/models/DefaultVolumeFactorSource.php)

###  Health Score

36

—

LowBetter than 79% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity28

Limited adoption so far

Community15

Small or concentrated contributor base

Maturity69

Established project with proven stability

 Bus Factor1

Top contributor holds 51.1% of commits — single point of failure

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.

###  Release Activity

Cadence

Every ~45 days

Recently: every ~100 days

Total

12

Last Release

3008d ago

Major Versions

1.0.1 → 2.0.02017-02-10

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/3016130?v=4)[Evgeny Gavrilov](/maintainers/EvgenyGavrilov)[@EvgenyGavrilov](https://github.com/EvgenyGavrilov)

---

Top Contributors

[![pahanini](https://avatars.githubusercontent.com/u/898663?v=4)](https://github.com/pahanini "pahanini (24 commits)")[![danilfromekb](https://avatars.githubusercontent.com/u/3324850?v=4)](https://github.com/danilfromekb "danilfromekb (18 commits)")[![pastuhov](https://avatars.githubusercontent.com/u/7937221?v=4)](https://github.com/pastuhov "pastuhov (4 commits)")[![pelmennoteam](https://avatars.githubusercontent.com/u/3477725?v=4)](https://github.com/pelmennoteam "pelmennoteam (1 commits)")

---

Tags

archivesdeprecatedobseletecalculatordeliverysimaland

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/sima-land-delivery-calculator/health.svg)

```
[![Health](https://phpackages.com/badges/sima-land-delivery-calculator/health.svg)](https://phpackages.com/packages/sima-land-delivery-calculator)
```

###  Alternatives

[markrogoyski/ipv4-subnet-calculator

Network calculator for subnet mask and other classless (CIDR) network information.

175852.6k14](/packages/markrogoyski-ipv4-subnet-calculator)[ballen/distical

A distance (Lat/Long) calculation library for PHP

40199.2k2](/packages/ballen-distical)[sylius/shipping

Flexible shipping component for PHP e-commerce projects.

13225.7k12](/packages/sylius-shipping)[appwilio/russianpost-sdk

Russian Post (pochta.ru) SDK

4515.7k](/packages/appwilio-russianpost-sdk)

PHPackages © 2026

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