Download the PHP package juniorov/bccr-sdde-exchange-rate without Composer

On this page you can find all versions of the php package juniorov/bccr-sdde-exchange-rate. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of juniorov/bccr-sdde-exchange-rate

Informations about the package bccr-sdde-exchange-rate

juniorov/bccr-sdde-exchange-rate

Cliente PHP 8.1+ para consultar el tipo de cambio USD compra y venta del SDDE del BCCR. Funciona en PHP puro, Laravel y WordPress; no depende de ninguno de esos frameworks.

Requisitos

Instalación

Cuando esté publicado en Packagist:

Para probarlo antes de publicar, en el composer.json de su aplicación agregue un repositorio local. Cambie la ruta si su aplicación no está junto a este repo:

Después ejecute composer update juniorov/bccr-sdde-exchange-rate.

Primer programa PHP

  1. Cree un archivo .env que no vaya a Git:

  2. Cargue esa variable con el mecanismo habitual de su proyecto. Para una prueba rápida en terminal puede usar export BCCR_SDDE_TOKEN='...'.

  3. Cree tipo-cambio.php:

  4. Ejecute php tipo-cambio.php.

API del cliente

dollarRates()

Obtiene compra y venta. Por defecto busca los últimos 10 días y devuelve el último valor disponible de cada indicador.

Para consultar con fecha de referencia y una ventana distinta:

series()

Devuelve todos los puntos de un indicador en un intervalo:

Códigos configurables

Si el BCCR confirma códigos distintos para su cuenta:

Laravel

  1. Instale el paquete con Composer.
  2. En .env agregue BCCR_SDDE_TOKEN=....

  3. En config/services.php agregue:

  4. En app/Providers/AppServiceProvider.php, registre un singleton:

  5. Inyéctelo en un controlador y use caché para no consultar el BCCR en cada solicitud:

WordPress

Instale Composer dentro de su plugin personalizado. No añada el token al tema, porque podría terminar en un repositorio o una copia pública.

  1. Cree wp-content/plugins/mi-tipo-cambio/.
  2. Copie el ejemplo de examples/wordpress/bccr-sdde-example.php como archivo principal del plugin.
  3. Desde esa carpeta ejecute Composer y asegúrese de que vendor/ exista.

  4. En wp-config.php, antes de la línea “That's all”, agregue:

  5. Active el plugin y agregue [bccr_tipo_cambio] a una página.

El ejemplo usa un transient de una hora: protege el token y reduce llamadas al API. Para forzar actualización, borre el transient bccr_usd_rates.

Manejo de errores

La librería lanza BccrException. Revise el código HTTP para informar una acción útil al usuario o registrar el incidente:

Los códigos comunes son 401 (token), 403 (suscripción), 404 (URL/configuración), 429 (demasiadas solicitudes) y 500 (problema del BCCR).

Pruebas

Desde esta carpeta ejecute:

La prueba no contacta al BCCR ni requiere token real.

All versions of bccr-sdde-exchange-rate with dependencies

PHP Build Version
Package Version
Requires php Version ^8.1
ext-curl Version *
ext-json Version *
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package juniorov/bccr-sdde-exchange-rate contains the following files

Loading the files please wait ...