README

使用 UnitConvert.io 的 Laravel 包装器，您可以快速方便地程序化地比较和转换测量单位。

此包由 DevSquared 创建和开发，DevSquared 是一家位于美国堪萨斯州皮特堡的顾问和开发机构。 查看我们的网站 了解更多信息。

安装

UnitConvert 需要一个 API 密钥来使用此包装器。您今天可以 免费注册账户 并开始使用。此包可以通过 Composer 安装。

composer require devsquared/unitconvert-laravel

在 Laravel 5.5 及以上版本中，此包将自动注册提供者和别名。对于 Laravel 5.4 及以下版本，您必须安装提供者和别名。

// config/app.php
'providers' => [
    ...
    DevSquared\UnitConvert\UnitConvertProvider::class,
    ...
];

'aliases' => [
    ...
    'UnitConvert' => DevSquared\UnitConvert\UnitConvertFacade::class,
    ...
];

接下来，您需要将您的 API 密钥添加到配置中。您可以将它添加到您的 .env 文件中，如下所示

UNITCONVERT_API_KEY=

可选地，您可以使用此命令发布此包的配置文件

php artisan vendor:publish --provider="DevSquared\UnitConvert\UnitConvertServiceProvider"

用法

UnitConvert 数据库包含用户使用系统时产生的变体。除了测量值外，常见的拼写错误、缩写和完整单词都被视为字符串。以下是如何比较和转换测量单位（s）的示例。

use UnitConvert;

// Get Information for a Unit of Measurement
$response = UnitConvert::getMeasurementInfo('20 miles');
$response->getSuccess(); // Returns true
$response->getError(); // Returns the response error message, if success is false
$response->getAmount(); // Returns 20
$response->getUnit(); // Returns "Miles"
$response->getDisplay(); // Returns "20 Miles"
$response->getCategory(); // Returns "Length"
$response->getVariants(); // Returns ["Mile","Miles","mi"]
$response->getConvertableTo(); // Returns ["Centimeters","Millimeters","Meters","Inches","Feet","Yards","Miles","Decimeters","Kilometers","Astronomical Units","Light Years","Parsecs","Nautical Miles"]

// Comparing a Measurement
$response = UnitConvert::compare('10mg', '==', '10 pounds');
$response->getSuccess(); // Returns true
$response->getError(); // Returns the response error message, if success is false
$response->getResult(); // Returns false

// Converting a Measurement
$response = UnitConvert::convert('20 miles', 'kilometers');
$response->getSuccess(); // Returns true
$response->getError(); // Returns the response error message, if success is false
$response->getAmount(); // Returns 32.1868
$response->getUnit(); // Returns "Kilometers"
$response->getDisplay(); // Returns "32.18680 Kilometers"

以下是如何使用 convert 函数的示例用例

$response = UnitConvert::convert('20 miles', 'gallons');
if ($response->getSuccess() == false) {
    return $response->getError();
}

return $response->getDisplay();

更新日志

请参阅 更新日志 了解最近更改的更多信息。

在使用吗？告诉我们吧！

我们非常高兴看到我们的工作在生产环境中被使用。如果您决定实施此包装器，请随时告诉我们并分享您的工作。您可以通过我们的网站发送电子邮件： https://dev-squared.com

许可

MIT 许可证（MIT）。有关更多信息，请参阅 许可文件。