Download the PHP package estratos/sie-banxico without Composer
On this page you can find all versions of the php package estratos/sie-banxico. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download estratos/sie-banxico
More information about estratos/sie-banxico
Files in estratos/sie-banxico
Package sie-banxico
Short Description Banxico SIE REST API Client for Symfony Framework
License MIT
Informations about the package sie-banxico
sie-banxico
Cliente Symfony para la API REST del Sistema de Información Económica (SIE) del Banco de México (Banxico).
Requisitos
| Componente | Versiones soportadas |
|---|---|
| PHP | 8.1, 8.2, 8.3, 8.4 |
Symfony (config, dependency-injection, http-kernel) |
6.4, 7.x, 8.x |
| Cliente HTTP | Cualquiera conforme a PSR-18 (y una fábrica PSR-17) |
Symfony 7.4 requiere PHP >= 8.2 y Symfony 8.x requiere PHP >= 8.4; el paquete sólo declara php: >=8.1 y deja que Composer elija la combinación válida para tu plataforma.
El paquete no impone un cliente HTTP: declara php-http/guzzle7-adapter en require-dev para poder ejecutar sus pruebas y en suggest como recomendación. Si tu aplicación todavía no tiene un cliente PSR-18, instálalo:
Instalación
Configuración
Registra el bundle en config/bundles.php:
Y define tu token:
El nodo raíz es estratos_sie_banxico, el alias convencional para la clase Estratos\SieBanxico\SieBanxico. El registro del bundle y la configuración por YAML son nuevos en esta versión: las versiones 0.1.x sólo permitían usar las clases como librería (ver "Uso directo"), porque su extensión no leía configuración alguna.
Con el token configurado, el bundle registra dos servicios:
| Servicio | Descripción |
|---|---|
sie_banxico.client |
Estratos\SieBanxico\SieBanxicoClient con el token inyectado. |
Estratos\SieBanxico\SieBanxicoClient |
Alias del anterior, para inyección por tipo. |
Si tu proyecto tiene más de un cliente PSR-18, indica cuál debe usarse:
Si no configuras token, el bundle no registra servicios y puedes seguir usando las clases como librería (ver más abajo).
Uso
Inyección de dependencias (recomendado)
Uso directo (compatible con versiones anteriores)
El flujo de las versiones 0.1.x sigue funcionando sin cambios:
ClientInit() es idempotente y opcional: si se omite, el cliente se crea la primera vez que se consulta un tipo de cambio.
Métodos disponibles
| Método | Serie Banxico | Descripción |
|---|---|---|
getExchangeRate() |
SF60653 |
Tipo de cambio USD (liquidación). |
getFixEchangeRate() |
SF43718 |
Tipo de cambio USD (determinación). Nombre con errata conservado por compatibilidad. |
getFixExchangeRate() |
SF43718 |
Alias con la errata corregida. |
getEuroExchangeRate() |
SF46410 |
Tipo de cambio EUR (determinación). |
En SieBanxicoClient están disponibles los métodos heredados de xint0/banxico-php:
| Método | Descripción |
|---|---|
exchangeRateUsdLiquidation(?string $startDate = null, ?string $endDate = null) |
Serie SF60653. |
exchangeRateUsdDetermination(?string $startDate = null, ?string $endDate = null) |
Serie SF43718. |
exchangeRateEuroDetermination(?string $startDate = null, ?string $endDate = null) |
Serie SF46410. |
fetchSeries(string $series, ?string $startDate = null, ?string $endDate = null) |
Cualquier serie del SIE. |
Sin fechas se consulta el dato más reciente (oportuno). Con fechas se consulta el rango indicado. El resultado es un string cuando hay un solo dato y un arreglo ['YYYY-MM-DD' => valor] cuando hay varios.
Desarrollo
Probar contra varias versiones de Symfony
El directorio .compat/ (ignorado por git) contiene ambientes aislados con una versión concreta de Symfony. tests/bootstrap.php respeta la variable de entorno SIE_BANXICO_COMPAT_VENDOR para cargar las dependencias de esos ambientes:
En Windows (PowerShell):
La matriz completa de PHP y Symfony se ejecuta en GitHub Actions (.github/workflows/symfony.yml), incluyendo Symfony 8.0 sobre PHP 8.4.
Compatibilidad hacia atrás
Se conserva la API pública de las versiones publicadas (0.1.0 y 0.1.1), que era la única que se podía usar realmente:
- Clases
Estratos\SieBanxico\SieBanxicoyEstratos\SieBanxico\SieBanxicoClientcon sus nombres y métodos. - Constructor
new SieBanxico($token)(el argumento ahora es opcional) yClientInit(). - Métodos
getExchangeRate(),getFixEchangeRate()(con la errata original) ygetEuroExchangeRate(). - Constante
SieBanxicoClient::SERIES_EURO_EXCHANGE_RATE_DETERMINATION.
Cambios que pueden requerir atención:
Configuration::ROOT_NAMEpasa deEstratos_how_toaestratos_sie_banxicoy se eliminaConfiguration::NODE_TESTjunto con el nodotest_node. Eran restos del andamiaje de la plantilla: la extensión teníaload()vacío, así que la configuración nunca se leyó. Si tenías un bloqueEstratos_how_to:en tu aplicación, puedes borrarlo (nunca tuvo efecto) y usar el nuevo si quieres registrar los servicios del bundle.- Las clases ahora declaran
declare(strict_types=1)y tipos de retorno (mixed) en los métodos de consulta. tests/App/AppKernel.phpse eliminó: su única prueba se cubre con pruebas de la extensión y del contenedor.
Licenciamiento
Este paquete implementa el paquete xint0/banxico-php, los derechos de autor de este software pertenecen a su autor Rogelio Jacinto. Copyright 2018-2021 Rogelio Jacinto. Todos los derechos reservados. https://github.com/Xint0/banxico-php
El autor de este paquete es software libre, algunos derechos reservados por Estratos Electronics SAS de CV. Este paquete se puede distribuir y/o modificarse bajo los términos de la Licencia MIT.
All versions of sie-banxico with dependencies
symfony/config Version ^6.4 || ^7.0 || ^8.0
symfony/dependency-injection Version ^6.4 || ^7.0 || ^8.0
symfony/http-kernel Version ^6.4 || ^7.0 || ^8.0
xint0/banxico-php Version ^2.0