PHPackages                             paulogic/esios - 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. [API Development](/categories/api)
4. /
5. paulogic/esios

ActiveLibrary[API Development](/categories/api)

paulogic/esios
==============

Access library to Esios API

v1.0.0(8y ago)245MITPHPPHP >=5.6.0

Since Feb 23Pushed 8y ago1 watchersCompare

[ Source](https://github.com/paulogic/esios)[ Packagist](https://packagist.org/packages/paulogic/esios)[ RSS](/packages/paulogic-esios/feed)WikiDiscussions master Synced today

READMEChangelogDependencies (2)Versions (2)Used By (0)

Esios Access Library
====================

[](#esios-access-library)

This library offers some utilities to access the information from the *Esios* platform (*Sistema de información del operador del sistema*).

- Version 1.0

Set up
------

[](#set-up)

- Installation

    ```
      composer require paulogic/esios

    ```
- Dependencies

    - php >=5.6 with curl

How to use
----------

[](#how-to-use)

### Using an EsiosHelperFactory

[](#using-an-esioshelperfactory)

The simplest way to make a call and receive a formatted response (php array of dates-values) is by means of the included Helper Factory class:

```
#!php

    $token = 'AUTHENTICATION TOKEN';

    //Prepare the factory
    $factory = new Esios\EsiosHelperFactory($token);

    //Create a helper to issue calls to obtain the list of prices
    $helper = $factory->getEsiosCaller(Esios\EsiosCallTypes::PVPC_20A_PRICES);
    $params = [
         'start_date' => '2017-04-01T01:00',
         'end_date' => '2017-04-01T05:00'
    ];
    $data = $helper->get($params);

    //Create a helper to issue calls to obtain the list of indicators
    $helper = $factory->getEsiosCaller(Esios\EsiosCallTypes::INDICATORS_LIST);
    $params = [
        'text' => 'facturacion de energia'
    ];
    $data = $helper->get($params);

```

The list of possible call types is defined inside the abstract class EsiosCallTypes:

- PVPC\_20A\_PRICES
- PVPC\_20DHA\_PRICES
- PVPC\_20DHS\_PRICES
- PVPC\_20A\_PROFILES
- PVPC\_20DHA\_PROFILES
- PVPC\_20DHS\_PROFILES
- PVPC\_20A\_PEAJESACCESO
- PVPC\_20DHA\_PEAJESACCESO
- PVPC\_20DHS\_PEAJESACCESO
- INDICATORS\_LIST

New call types can be added to EsiosCallTypes along with the corresponding url paths.

### Direct call to the Esios REST API

[](#direct-call-to-the-esios-rest-api)

You can issue a direct call to the REST API with the utility class EsiosCallService:

```
#!php

    $token = 'AUTHENTICATION TOKEN';
    //optional config, may be empty
    $config = [
        'timeout' => 10,
        'timezone' => 'Atlantic/Canary'
    ];
    $callService = new Esios\Service\EsiosCallService($token, $config);

    $params = [
        'start_date' => '2017-04-23',
        'end_date' => '2017-04-24',
    ];

    //Direct call to indicator 1013 (prices of rate 20A)
    $data = $callService->getData('/indicators/1013', $params);

```

Examples
--------

[](#examples)

You may find a list of functional examples on how to use the classes separately:

- Creating the accessor to the API and return raw data
- Creating a formatter to format the raw data
- Using a custom logger

Check the examples file:

```
    examples/examples.php

```

Running tests
-------------

[](#running-tests)

```
    vendor/bin/phpunit

```

### Check API response tests

[](#check-api-response-tests)

There is a group of tests that check the response format of the actual Esios API calls. They require online connection and a valid authentication token. To activate these tests:

- Modify phpunit.xml :
    - Remove the exclude group 'onlinecheck'
    - Replace TOKEN with the authentication token issued by Esios

###  Health Score

27

—

LowBetter than 47% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity11

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

3048d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/28298476?v=4)[Pablo](/maintainers/paulogic)[@paulogic](https://github.com/paulogic)

---

Top Contributors

[![aptinova](https://avatars.githubusercontent.com/u/216700?v=4)](https://github.com/aptinova "aptinova (1 commits)")

---

Tags

api-clientesiosphpphp-libraryphpEsios

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/paulogic-esios/health.svg)

```
[![Health](https://phpackages.com/badges/paulogic-esios/health.svg)](https://phpackages.com/packages/paulogic-esios)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)