README

使用或安装

composer require mamunur6286/currex

如何使用 Currex

作为开发者，我们为各种项目需要不同类型的货币兑换。针对这种情况，我开发了一个 Laravel 包来避免处理货币变化的问题。如果你正确使用，它将提高你的开发效率。以下是使用的先决条件和说明！

在本教程中，我将通过5个步骤向您展示如何使用 Currex Laravel 包。让我们开始吧。

1. 为我们的新包创建文件夹。

创建一个新的 Laravel 项目；

composer create-project laravel/laravel example-app

在新 Laravel 安装后，通过 cd example-app 进入项目目录内部。

2. 使用 Composer 安装 Currex 包。

在您的命令提示符中，导航到项目名称所在的文件夹。在我们的例子中：example-app，并运行以下命令

composer require mamunur6286/currex

这将初始化项目中的 Currex 包，并更新 composer.json 文件中的 composer 依赖项。

接下来，我们需要在我们的 config/app.php 中的 providers[] 数组中添加我们的新 Service Provider

'providers' => [

    /*
     * Laravel Framework Service Providers...
     */
    Illuminate\Auth\AuthServiceProvider::class,
    //.. Other providers
    
    Mamunur6286\Currex\Providers\CurrenryServiceProvider::class,

],

太棒了！我们的服务提供者已加载，我们的包准备就绪！但是，我们还没有任何功能...让我们通过添加一个控制器来解决我们的项目。

5. 基本用法

让我们首先在我们的项目控制器目录中创建一个新的 ConvertController，并添加以下代码

<?php
use Mamunur6286\Currex\Convert;

class ConvertController
{
    private $convert;
    // set convert instance in convert property
    public function __construct(Convert $convert) {
	$this->convert = $convert;
    }
}

然后，在我们的控制器中创建一个交换方法 exchange()，并执行以下代码

    public function exchange(Request $request) {
        try {
            $validator = Validator::make($request->all(), [
                'currency' => 'required',
                'amount' => 'required',
            ]);
        
            if ($validator->fails()) {
                return ([
                    'success' => false,
                    'errors' => $validator->errors()
                ]);
            }

            return  $this->convert->exchangeTo($request);

        } catch (\Exception $e) {
            return response([
                'success' => false,
                'message' => $e->getMessage()
            ]);
        }
    }

7. 使用 API 端点。

让我们看看如何在 API 端点中使用这个包。在运行您的项目后，您可以通过 API 端点使用以下参数来检查您的包的有效性

https://:8000/exchange?currency=USD&amount=100

结论。

这就是如何使用 Laravel 货币兑换包。感谢您使用 Currex。