pragmarx/countries-laravel

Countries for Laravel

Countries for Laravel

, _(*1)

, _(*2)

, _(*3)

What does it gives you?

This package has all sorts of information about countries:, _(*4)

Validation

The validation is extending Laravel's validation, so you can use it like any other validation rules, like, _(*5)

/**
 * Store a new blog post.
 *
 * @param  Request  $request
 * @return Response
 */
public function store(Request $request)
{
    $this->validate($request, [
        'title' => 'required|unique:posts|max:255',
        'body' => 'required',
        'country' => 'country' //Checks if valid name.common
    ]);

    // The blog post is valid, store in database...
}

Which validation rules there is and what there name should be, can all be configured in the configuration file., _(*6)

'validation' => [
    'rules' => [
        'countryCommon' => 'name.common'
    ]
]

By changing the configuration like this, we can now access the property name.common, by the validation rule countryCommon, _(*7)

You have to define all the validations rules in settings, only a few is defined by default, the default is, _(*8)

'rules'     => [
    'country'           => 'name.common',
    'cca2',
    'cca3',
    'ccn3',
    'cioc',
    'currencies'            => 'ISO4217',
    'language',
    'language_short'    => 'ISO639_3',
]

Documentation

This package is a Laravel bridge, please refer to the main package repository for more information and docs., _(*9)

Requirements

• PHP 7.0+
• Laravel 5.5+

Installing

Use Composer to install it:, _(*10)

composer require pragmarx/countries-laravel

Publishing assets

You can publish configuration by doing:, _(*11)

php artisan vendor:publish --provider=PragmaRX\\CountriesLaravel\\Package\\ServiceProvider

Usage

After installing you'll have access to the Countries Façade, and the package is based on Laravel Collections, so you basically have access to all methods in Collections, like, _(*12)

$france = Countries::where('name.common', 'France');

Flag routes

You can refer directly to an SVG flag by linking, _(*13)

/pragmarx/countries/flag/download/<cca3-code>.svg
/pragmarx/countries/flag/file/<cca3-code>.svg

Examples:, _(*14)

https://laravel.com/pragmarx/countries/flag/download/usa.svg
https://laravel.com/pragmarx/countries/flag/file/usa.svg

http://pragmarx.test/pragmarx/countries/flag/file/usa.svg, _(*15)

These routes can be turned off in the configuration file:, _(*16)

'routes' => [
    'enabled' => false,
]

Author

Antonio Carlos Ribeiro, _(*17)

License

Countries is licensed under the MIT License - see the LICENSE file for details, _(*18)

Contributing

Pull requests and issues are more than welcome., _(*19)