Download the PHP package jdavidbakr/address-verification without Composer
On this page you can find all versions of the php package jdavidbakr/address-verification. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download jdavidbakr/address-verification
More information about jdavidbakr/address-verification
Files in jdavidbakr/address-verification
Package address-verification
Short Description A service that performs address verification using the API at https://www.intelligentsearch.com/
License MIT
Informations about the package address-verification
AddressVerification
Upgrading from version 1.x
The following changes happened between 1.x and 2.0:
- The config information is not added to the
config/services.php
file instead of having its own file - The package now throws exceptions and events instead of expecting you to handle it.
How to use
A Laravel Service that uses intelligentsearch.com to validate mailing addresses.
This class sends an address to https://www.intelligentsearch.com/ via their API and updates the address with the most relevant result. It is built to run within Laravel.
Note that in its current state it does not return multiple results.
To install:
The package is auto-discovered in Laravel.
Add the following section to config/services.php
:
There will be a file now located at config/address-verification.php to set your intelligentsearch.com username and password.
To use:
Create an object of type \jdavidbakr\AddressVerification\AddressRequest and fill in the appropriate values. Then call \jdavidbakr\AddressVerification\AddressVerificationService::Verify(\$request) with the cerated request. You will receive back an object of type \jdavidbakr\AddressVerification\AddressVerificationResponse.
The request defaults to ca_codes of McRy which returns mixed case and enables street address parsing for no-match addresses.
You will receive an AddressResponse
object if successful. The main properties you'll likely use in the response are:
- DeliveryLine1
- City
- State
- ZipAddon
Exceptions
The following exceptions can be thrown (all namespaced to the package):
VerificationFailedException
- you should watch for this exception and decide how to handle it. Basically it means that you are not getting any data from the response.MissingIntelligentSearchCredentialsException
- Fired if you haven't included credentials.
Events
AddressVerificationCompleted
- this is an event that is fired every time an address verification is completed. Use it to check theSearchesLeft
attribute, if you want to send a notification that it's running low. It receives in its payload theAddressResponse
.
View the IntelligentSearch documentation for details about what all the returned fields are, as well as the request attributes.
All versions of address-verification with dependencies
guzzlehttp/guzzle Version ~5.8|~6.0.1|~6.1|7.*