PHPackages                             snipershady/egon - 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. snipershady/egon

ActiveLibrary[API Development](/categories/api)

snipershady/egon
================

Egon API PHP Library

v1.0.3(5mo ago)2670↓62.7%GPL-3.0-or-laterPHPPHP >=8.2

Since Jul 29Pushed 5mo agoCompare

[ Source](https://github.com/snipershady/egon)[ Packagist](https://packagist.org/packages/snipershady/egon)[ Docs](https://www.spinfo.it)[ RSS](/packages/snipershady-egon/feed)WikiDiscussions main Synced today

READMEChangelog (4)Dependencies (4)Versions (5)Used By (0)

Egon
====

[](#egon)

Egon API PHP Library

A lightweight and modern PHP library for seamless integration with the Egon API. Fully compatible with PHP 8.2 and above, it provides a clean and efficient interface to interact with Egon’s services, simplifying authentication, data retrieval, and request handling.

Egon website:

API implementation
------------------

[](#api-implementation)

- v4/validation/address
- balance

LICENSE
-------

[](#license)

This is an unofficial package provided with a GPL3 license for helping in the implementation of Egon service.

Copyright (C) 2022 Stefano Perrini  aka La Matrigna

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License long with this program. If not, see .

Basic usage
-----------

[](#basic-usage)

```
composer require snipershady/egon
```

```
use Egon\Dto\RequestValidationV4\Address;
use Egon\Dto\RequestValidationV4\Parameter;
use Egon\Dto\ResponseValidationV4\ValidationV4Mapper;
use Egon\Dto\ResponseValidationV4\ValidationV4Response;
use Egon\Enum\CountryCodeAlpha3Enum;
use Egon\Enum\OutputGeoCodingEnum;
use Egon\Service\ValidationV4;
use Exception;
use Throwable;

$address = new Address();
$address->setStreet("Via Pacinotti 4b")->setCity("Verona");
$parameter = new Parameter(CountryCodeAlpha3Enum::ITALY, OutputGeoCodingEnum::GEOCODING_ON);

$token = "YOUR_API_TOKEN";
$v = new ValidationV4($token);
$arrayContent = $v->getValidAddress($address, $parameter);

// You can request a full mapped object as response
$response = ValidationV4Mapper::fromArray($arrayContent);
```

Get Mapped Object with valid address
------------------------------------

[](#get-mapped-object-with-valid-address)

```
use Egon\Dto\RequestValidationV4\Address;
use Egon\Dto\RequestValidationV4\Parameter;
use Egon\Dto\ResponseValidationV4\ValidationV4Mapper;
use Egon\Dto\ResponseValidationV4\ValidationV4Response;
use Egon\Enum\CountryCodeAlpha3Enum;
use Egon\Enum\OutputGeoCodingEnum;
use Egon\Service\ValidationV4;
use Exception;
use Throwable;

$address = new Address();
$address->setStreet("Via Pacinotti 4b")->setCity("Verona");
$parameter = new Parameter(CountryCodeAlpha3Enum::ITALY, OutputGeoCodingEnum::GEOCODING_ON);

$token = "YOUR_API_TOKEN";
$v = new ValidationV4($token);

// You can request a full mapped object as response
$validateResponse = $v->getValidAddressMapped($address, $parameter);
```

Balance
-------

[](#balance)

```
use Egon\Dto\ResponseValidationV4\ValidationV4Mapper;
use Egon\Dto\ResponseValidationV4\ValidationV4Response;
use RuntimeException;
use Throwable;

$token = "YOUR_API_TOKEN";
$b = new Balance($token);
$balanceValue = $b->getBalance(); //this method returns a float value with number of credits
```

###  Health Score

40

—

FairBetter than 86% of packages

Maintenance70

Regular maintenance activity

Popularity19

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity52

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

Every ~56 days

Total

4

Last Release

172d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/160662d52c89da3351e2a94b3d354074bf30137477fc7586eeacc52e3cb44462?d=identicon)[snipershady](/maintainers/snipershady)

---

Top Contributors

[![snipershady](https://avatars.githubusercontent.com/u/20489856?v=4)](https://github.com/snipershady "snipershady (27 commits)")

---

Tags

apivalidationaddresssuggestionegon

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan, Rector

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/snipershady-egon/health.svg)

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

###  Alternatives

[jcf/geocode

Google Geocoding API for Laravel

50162.8k](/packages/jcf-geocode)[adrenalinkin/swagger-resolver-bundle

Provides possibility for validate data according to Swagger documentation

1013.3k](/packages/adrenalinkin-swagger-resolver-bundle)

PHPackages © 2026

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