chriskonnertz/addresses

Simple address validation

Address Validation

ATTENTION: This repository is no longer maintained!, _(*1)

This PHP class tries to validate user input (name and address)., _(*2)

Instanciate without auto loading

require __DIR__.'/src/ChrisKonnertz/Addresses/Addresses.php';
require __DIR__.'/src/ChrisKonnertz/Addresses/ResultInterface.php';
require __DIR__.'/src/ChrisKonnertz/Addresses/Result.php';

$addresses = new \ChrisKonnertz\Addresses\Addresses();

If you use auto loading via Composer you can skip the require statements., _(*3)

Set API key

$addresses->setApiKey('your-api-key');

Set language code

$addresses->setLanguage('de');

Validate data

$result = $addresses->validate();

The validatemethod returns an object that implements ReturnInterface. Per default this is a Result object., _(*4)

Check if result (data) is valid

$valid = $result->isValid();

If the data is not valid, the $result object contains an array of invalid values. Retrieve this array with $result->getData()., _(*5)

Check if address has been corrected

The Google Geocache API tries to correct addresses for instance if the street name contains a spelling mistake. Use these methods to check the address state: addressFound, addressNotFound and addressFoundAfterCorrection, _(*6)

Example HTML form

Example PHP code

if (isset($_POST['submit'])) {
    // Assuming Composer auto loading
    $addresses = new \ChrisKonnertz\Addresses\Addresses();

    $addresses->setAll($_POST);

    $result = $addresses->validate();

    if ($result->isValid()) {
        echo 'Data is valid.';
    } else {
        echo 'Data is invalid!';
    }
}