nanoblocktech/shipping-calculator
Composer 安装命令:
composer require nanoblocktech/shipping-calculator
包简介
PHP class to determines shipping fee based on origin latitude and lonitude of customer from business location.
README 文档
README
Determines the shipping fee based on the customer's longitude and latitude to the business location.
Functions
- Calculates the distance between business and customer locations
- Determines the shipping fee based on the provided charge per distance.
- Determines the estimated traveling time based on distance and speed
Installation Guide via Composer:
composer require nanoblocktech/shipping-calculator
Usages
use Luminova\ExtraUtils\ShippingCalculator; $calculator = new ShippingCalculator(); // Set business and customer locations $calculator->setOrigin(6.47427, 7.56196); // Business location (Enugu Airport Nigeria) $calculator->setDestination(6.51181, 7.35535); // Customer location (Udi Nigeria) $calculator->setCharge(100); // Initial shipping cost per distance km, or ml // Calculate distance and return new ShippingDistance instance class $distance = $calculator->getDistance(); // Get the estimated time information $time = $calculator->getTime(); // Get your calculated information echo "Distance: $distance->toDistance() \n"; echo "Distance[km|ml]: $distance->toString() \n"; echo "Shipping Fee: $distance->getCurrency(2)\n"; echo "Shipping Fee: $distance->getCharges()\n";
Methods
ShippingCalculator
Setting up your calculations $calculator = new ShippingCalculator(ShippingCalculator::KM);
| Methods And Param | Descriptions |
|---|---|
| setOrigin(float latitude, float longitude): self | Set the origin location latitude and longitude |
| setDestination(float latitude, float longitude): self | Set the destination location latitude and longitude |
| setCharge(float amount): self | Set initial shipping charge per calculation distance |
| setSpeed(int speed): self | Set speed in units per hour, to calculate estimated time. |
| getDistance(): ShippingDistance | Calculate the distance between the origin/destination and return distance instance. |
ShippingDistance
The method which $distance = $calculator->getDistance(); is returned
| Methods And Param | Descriptions |
|---|---|
| toDistance(): float | Get the calculated distance between the origin and destination latitude and longitude. |
| toString(): string | Get the distance as a string (e.g., '10km'). |
| toCurrency(int decimals = 2, string symbol): string | Convert the distance to currency format with optional currency symbol and decimal places. |
| toMile(): float | Convert the distance from kilometer to miles. |
| toKilometer(): float | Convert the distance from miles to kilometers. |
| getCurrency(int decimal = 2): string | Get the calculated currency value based on the distance and initial amount. |
| getCharges(): float | Get the calculated charges |
| getTime(): ShippingTime | Get distance time instance |
ShippingTime
The method which $time = $distance->getTime(); is returned
| Methods And Param | Descriptions |
|---|---|
| toTime(): float | Get the calculated time required to cover the distance. |
| toHours(): int | Convert the total time to hours. |
| toSeconds(): int | Get the total time in seconds. |
| toMinutes(): int | Convert the total time to minutes. |
| toDays(): int | Convert the total time to days. |
| toString(): string | Get a formatted string representation of the total time. |
| toObject(): object | Get an object representation of the total time. |
nanoblocktech/shipping-calculator 适用场景与选型建议
nanoblocktech/shipping-calculator 是一款 基于 PHP 开发的 Composer 扩展包,目前已累计 36 次下载、GitHub Stars 达 0, 最近一次更新时间为 2023 年 11 月 15 日, 在 PHP 生态内属于活跃度较高的组件。
它主要适用于以下技术方向: 「php」 「luminova」 「distance calculation」 「shipping calculation」 等业务场景。在实际项目中,围绕这些方向常见需要落地的问题包括:接口对接、性能调优、并发安全、与既有框架(Laravel / ThinkPHP / Yii / Webman 等)的兼容适配,以及生产环境的日志埋点与稳定性保障。
我们在过去多个企业项目中使用过 nanoblocktech/shipping-calculator 或与其功能相近的方案,如果你在选型或落地过程中遇到问题,例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查,欢迎联系我们协助评估。
基于 nanoblocktech/shipping-calculator 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。
线上偶发问题、内存泄漏、慢查询、并发异常等排查修复;针对高流量场景做缓存、队列、索引层面的调优。
承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维;也可按月提供技术保姆服务。
与 nanoblocktech/shipping-calculator 相关的其它包
同方向 / 同关键字的高下载量 PHP Composer 包推荐,方便对比选型:
Get distance between two locations using PHP.
Simple class for basic google maps distance calculations.
Alfabank REST API integration
PHP class to check the similarity between two items
Luminova is a fast, modular PHP framework designed for simplicity, performance, and modern web application development.
PHP parsedown plugin to allow video and table of content.
统计信息
- 总下载量: 36
- 月度下载量: 0
- 日度下载量: 0
- 收藏数: 0
- 点击次数: 28
- 依赖项目数: 0
- 推荐数: 0
其他信息
- 授权协议: MIT
- 更新时间: 2023-11-15