Dutch address parser is a library to parse address lines into the segments street, number and suffix.

Example: Plein 1926 12 A

Will be parsed to:

Composer is used to install this package

composer require noxxienl/nladdressparser

use noxxienl\nladdresslexer\Parser;

$parser = new Parser;
$parser->evaluate('Plein 1926 12 A');

echo $parser->getStreet() . "\r\n"; // Plein 1926
echo $parser->getNumber() . "\r\n"; // 12
echo $parser->getSuffix() . "\r\n"; // A

echo $parser->getOriginalString();

Sometimes you may have address that does not have the format street, number & suffix. To let the parser correctly do its work you need to split the string on your own before the parser can do its work.

For example: 50 A, Ringweg Zuid / Rijksweg A20

use noxxienl\nladdresslexer\Parser;

$parser = new Parser;

list($number, $street) = explode(', ', '50 A, Ringweg Zuid / Rijksweg A20');
$parser->evaluate($street, $number);

echo $parser->getStreet() . "\r\n"; // Ringweg Zuid / Rijgsweg A20
echo $parser->getNumber() . "\r\n"; // 50
echo $parser->getSuffix() . "\r\n"; // A

echo $parser->getOriginalString();

Sometimes you may wish to split only the number and suffix. You can do so by setting the formatting of the parser to the following before executing the parsing:

Parser::setAddressFormat([
    Parser::T_NUMBER,
    Parser::T_SUFFIX,
]);

Be carefull: When setting the address format, it is changed for every parsing to beyond that point. Reset the format to its original state when you want to parse a full address:

Parser::setAddressFormat([
    Parser::T_STREET,
    Parser::T_NUMBER,
    Parser::T_SUFFIX,
]);

Testing is done using pestphp. (https://pestphp.com/)

./vendor/bin/pest

To run the tests.

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

Submit a issue to the github repository and if you can find the fix be sure to also submit a pull request!

MIT