wessama / php-bin-lookup
A PHP package for looking up BIN numbers.
Requires
- php: ^8.1
- ext-curl: *
- ext-pdo: *
- vlucas/phpdotenv: ^5.5
Requires (Dev)
- laravel/pint: ^1.10.1
- pestphp/pest: ^2.6.3
- phpstan/phpstan: ^1.10.18
- rector/rector: ^0.15.25
- symfony/var-dumper: ^6.3.0
Suggests
- illuminate/contracts: ^10.0.0
- illuminate/support: ^10.0.0
README
php-bin-lookup
is a versatile package designed for looking up bank information using BIN (Bank Identification Number). It can be used as a standalone package or within a Laravel project.
Installation
With Composer
-
Install the package via Composer:
composer require wessama/php-bin-lookup
Manual Installation
-
Clone the repository into your project:
git clone https://github.com/wessama/php-bin-lookup.git
-
Navigate to the package directory and install the dependencies:
cd php-bin-lookup composer install
Configuration
Environment Variables
php-bin-lookup
can utilize environment variables from a .env
file. If used within a Laravel project, it will automatically use the Laravel project’s .env
file. For non-Laravel projects, you need to load the .env
file manually if it's located in a different directory.
To load a custom .env
file, use the loadEnv
method:
WessamA\BinLookup\ConfigLoader::loadEnv('/path/to/your/env/directory');
Laravel Service Provider and Configuration Publishing
If you are using this package within a Laravel project, register the service provider in your config/app.php:
'providers' => [ // ... WessamA\BinLookup\Providers\BinLookupServiceProvider::class, ],
Then, publish the package’s configuration file to your application’s config directory:
php artisan vendor:publish --provider="WessamA\BinLookup\BinLookupServiceProvider"
Support
For support, please open an issue on the GitHub repository.
License
PHP-BIN-Lookup is open-sourced software licensed under the MIT license.