2.3.26 2022-08-05 04:42 UTC

This package is auto-updated.

Last update: 2022-08-05 04:51:01 UTC


This is a Composer plugin that provides an automated version of Country Codes database.

This database is include: country iso codes, country names, country names with phone codes, phone codes as well as admin page to manage your list of data.


What you can do?

  • Get users country names
  • Get users phone numbers
  • Send OTP codes
  • Send message on messangers

Usage of this package are vary, those were just small examples of what you can do.

Also my main reason to build this package was to send WhatsApp message (specifically OTP codes).

Table Of Contents


Source Version
Composer ^2.0
PHP ^7.4/^8.0


The only thing you need to do to make this work is adding this package as a dependency to your project:

composer require irando/country-codes


  1. Add following line in your config/app.php file
'providers' => [
    // ...
  1. Run either of commands below to publish package files
php artisan vendor:publish

And select id referred to:



php artisan vendor:publish --tag=country-codes
  1. Run php artisan migrate to add countries table into your database
  2. Run php artisan db:seed --class=CountryCodesTableSeeder to seed countries data into countries table.

Note: In case of error after this command run composer dumpautoload and try again to seed database

Now visit your_url.tld/country-codes and you are set.


If you need (probably you do!) to customize the look, routing, functionality etc. of this package, at stage 2 of installation we deployed CountryCodes.php which is your table model, as well as view files at resources/views/vendor/irando/country-codes you can edit those files and create your own.


All feedback / bug reports / pull requests are welcome.

You can support me for more open source projects by sponsoring this package


This code is released under the MIT license.

For the full copyright and license information, please view the LICENSE file distributed with this source code.

Developed by Robert Nicjoo at CV. IRANDO