README

VinDecoder是一个使用NHTSA VIN解码API解码车辆VIN的Yii2组件。该组件验证VIN格式是否正确以及校验码是否正确，然后将VIN提交到API，并以关联数组的形式返回结果。

安装

您可以使用以下命令使用Composer安装VinDecoder组件：

composer require gertexllc/yii2-vin-decoder

使用方法

要在您的Yii2应用程序中使用VinDecoder组件，您首先需要在其应用程序配置文件（config/main.php）中对其进行配置

'components' => [
    'vinDecoder' => [
        'class' => 'gertexllc\vindecoder\VinDecoder',
    ],
],

然后您可以在应用程序代码中使用VinDecoder组件来解码VIN。以下是一个示例

try {
    $vin = '1GNKVJED9CJ211239';
    $vinData = Yii::$app->vinDecoder->decode($vin);
    echo "Make: {$vinData->make}\n";
    echo "Model: {$vinData->model}\n";
    echo "Year: {$vinData->year}\n";
    echo "Trim: {$vinData->trim}\n";
    echo "Body Type: {$vinData->bodyType}\n";
    echo "Engine Type: {$vinData->engineType}\n";
    echo "Drive Type: {$vinData->driveType}\n";
    echo "Fuel Type: {$vinData->fuelType}\n";
    echo "Plant Country: {$vinData->plantCountry}\n";
    echo "Plant State: {$vinData->plantState}\n";
} catch (\Exception $e) {
    echo "Error: {$e->getMessage()}\n";
}

在此示例中，我们首先定义要解码的VIN（$vin）。然后我们调用vinDecoder组件的decode()方法来解码VIN，它返回一个包含解码数据的VinData对象。然后我们可以通过VinData对象的属性访问解码数据。

VinData对象

VinData对象是一个包含解码VIN数据的基础数据对象。该对象具有以下属性

• make - 车辆的制造商。
• model - 车辆的型号。
• year - 车辆的型号年份。
• trim - 车辆的型号级别。
• bodyType - 车辆的车身类型。
• engineType - 车辆的发动机类型。
• driveType - 车辆的驱动类型。
• fuelType - 车辆的主要燃料类型。
• plantCountry - 车辆的制造国家。
• plantState - 车辆的制造州或省。

需求

VinDecoder组件需要PHP 7.1或更高版本以及Yii2框架版本2.0或更高版本。

许可

VinDecoder组件是开源软件，许可协议为MIT许可。

作者

VinDecoder由GerTex, LLC开发和提供，免费使用。