PHPackages                             laymont/venezuelan-foreign-exchanges - 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. laymont/venezuelan-foreign-exchanges

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

laymont/venezuelan-foreign-exchanges
====================================

Laravel package for fetching and managing Venezuelan foreign exchange rates

1.0.0(1y ago)11131MITPHPPHP ^8.2

Since Apr 6Pushed 1y ago1 watchersCompare

[ Source](https://github.com/laymont/venezuelan-foreign-exchanges)[ Packagist](https://packagist.org/packages/laymont/venezuelan-foreign-exchanges)[ RSS](/packages/laymont-venezuelan-foreign-exchanges/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (9)Versions (3)Used By (0)

laymont/venezuelan-foreign-exchanges
====================================

[](#laymontvenezuelan-foreign-exchanges)

[![Latest Version on Packagist](https://camo.githubusercontent.com/0bcd33fe368656c4849804cc497afd2bed3fc85636285da74622dc1533a950d5/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6c61796d6f6e742f76656e657a75656c616e2d666f726569676e2d65786368616e6765732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/laymont/venezuelan-foreign-exchanges)[![GitHub Tests Action Status](https://camo.githubusercontent.com/0040121f0aea127b10f2c97554e35ceb5a62f86cec519d0ececd04036d528bd7/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6c61796d6f6e742f76656e657a75656c616e2d666f726569676e2d65786368616e6765732f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473)](https://github.com/laymont/venezuelan-foreign-exchanges/actions?query=workflow%3Arun-tests)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/541b88556e27b9c6364a35c1b815e4399119215b63b2b121ad17ea8208129daf/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6c61796d6f6e742f76656e657a75656c616e2d666f726569676e2d65786368616e6765732f7068702d63732d66697865722e796d6c3f6272616e63683d6d61696e266c6162656c3d636f64652532307374796c65)](https://github.com/laymont/venezuelan-foreign-exchanges/actions?query=workflow%3Aphp-cs-fixer)[![Total Downloads](https://camo.githubusercontent.com/3cf50b5e334d70ebdbbc68e7286d97f4e781b31f3b36c8e60e40fdd6179b2f90/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6c61796d6f6e742f76656e657a75656c616e2d666f726569676e2d65786368616e6765732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/laymont/venezuelan-foreign-exchanges)

Este paquete de Laravel proporciona una manera sencilla de obtener los tipos de cambio de divisas extranjeras de uso oficial en Venezuela, directamente desde la página del Banco Central de Venezuela (BCV).

Funcionalidades
---------------

[](#funcionalidades)

- **Scraping del BCV:** Obtiene de forma automatizada los tipos de cambio desde la página del BCV.
- **Tipos de Cambio:** Extrae los valores de cambio para las principales divisas de uso oficial en Venezuela (dólar, euro, yuan, lira, rublo).
- **Formato de Datos:** Devuelve la fecha, la hora de la consulta, el nombre de la divisa y el valor en un formato array de fácil uso.

Ventajas
--------

[](#ventajas)

- **Fácil Integración:** Se integra fácilmente en cualquier proyecto Laravel.
- **Datos Actualizados:** Obtiene los datos de cambio directamente de la fuente oficial, asegurando que sean lo más actualizados posibles.
- **Centralización:** Centraliza la lógica para la obtención de datos, facilitando su uso y mantenimiento.
- **Flexibilidad:** Devuelve los datos en un formato plano, lo cual es más flexible para integrarse en cualquier vista, API, etc.
- **Hora de la Consulta**: Se incluye la hora de la consulta para mayor precisión.
- **Testable**: Los servicios tienen pruebas unitarias.
- **Autodescubrimiento**: El paquete autodescubre el service provider de Laravel.

Requisitos
----------

[](#requisitos)

- PHP 8.2 o superior
- Laravel 11 o superior

### Instalación

[](#instalación)

1. **Instala el paquete via Composer:**

    ```
    composer require laymont/venezuelan-foreign-exchanges
    ```
2. **Publicar la configuración del paquete (Opcional):**

    ```
     php artisan vendor:publish --tag=config
    ```

    Esto crea un archivo `config/bcv.php` donde puedes personalizar la url de la consulta.
3. **Configura las variables de entorno** En el archivo `.env` de tu proyecto puedes definir la variable `BCV_URL`.

    ```
    BCV_URL=https://www.bcv.org.ve/
    ```

    ```

    ```

Cómo Usar el Paquete
--------------------

[](#cómo-usar-el-paquete)

Existen dos maneras principales de usar el paquete para obtener los datos de los tipos de cambio.

1. **Acceder a la Ruta Web:**

    La manera más sencilla de obtener los tipos de cambio es visitando la ruta que el paquete define, abre tu navegador y visita la URL:

    ```
    http://tuproyecto.test/bcv/rates

    ```

Esto mostrará los tipos de cambio en formato JSON, reemplaza `http://tuproyecto.test` con la URL de tu proyecto. 2. **Usar el servicio `BcvService` directamente en tu código:**Puedes usar el servicio directamente en tu controlador o en otra clase para tener mas control sobre la obtencion de datos.

```
```php