Download the PHP package woodsandwalker/laravel-countries without Composer
On this page you can find all versions of the php package woodsandwalker/laravel-countries. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download woodsandwalker/laravel-countries
More information about woodsandwalker/laravel-countries
Files in woodsandwalker/laravel-countries
Package laravel-countries
Short Description Laravel Countries is a bundle for Laravel providing ISO 3166_2 codes for all countries along with a country model, cast and validation rule.
License MIT
Homepage https://github.com/woodsandwalker/laravel-countries
Informations about the package laravel-countries
Laravel Countries
Laravel Countries is a bundle for Laravel providing ISO 3166_2 codes for all countries along with a country model, cast and validation rule.
Getting Stated
Installation
Configuration
There is minimal config and the package can be used without any configuration. The only configuration option is an array of countries to exclude. This works by applying a global scope on the Country model.
To publish the configuration you can run this command:
To exclude a country simply add its ISO code to the exclude array:
Model
The package contains a calebporzio/sushi model which contains the iso_code
and name
for each country. Using this type of model also means there is no database migration required.
This model can be used like any other Laravel model.
Validation Rule
The package contains a validation rule which validates the ISO code.
You can override the default validation error message using the validation.country
key in your lang files.
Model Attribute Cast
The package contains a model attribute cast. The cast expects the ISO code as the original attribute.
You can use the following migration to add a country column to the users table.
Then add the cast to the user model:
Store a country against a user:
You can now access the ISO code and the name on the country attribute on the user model:
Localization
When accessing a country name the model will look for a translation string of countries.{ISO_CODE}
, for example, countries.GB
. If this translation string cannot be found it will fallback to the en
locale.
Installing New Locales
A command is included with the package to install new country locales from umpirsky/country-list. You can view all the available locales here. This command will create a new file in lang/{locale}/countries.php
. This command uses the file_get_contents
function which requires allow_url_fopen
to be on in your PHP config.
To install a new locale, for example Spanish (es), run the command:
License
Laravel Countries is released under the MIT License. See the bundled LICENSE.md file for details.
All versions of laravel-countries with dependencies
illuminate/database Version ^6.0|^7.0|^8.0|^9.0|^10.0|^11.0|^12.0
calebporzio/sushi Version ^2.5