Download the PHP package signdeer/world without Composer

On this page you can find all versions of the php package signdeer/world. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of signdeer/world

Informations about the package world

This fork is maintained by Signdeer, a secure, modern platform for e-signatures, approvals, and digital document workflows built for African teams and global standards.

The World is a Laravel package that provides a comprehensive list of countries, states, cities, timezones, currencies, and languages. You can access the data using the World Facade or through defined API routes.

Table of Contents

First, set your application environment to local:

Then, install the package via composer:

Optionally, set the WORLD_DB_CONNECTION environment variable to your desired database connection.

Automated Installation

Run the following Artisan command to automate the installation process:

Manual Installation

If you prefer to install the package manually, follow these steps:

  1. Publish the package configuration file:

  2. Run the migrations:

  3. Seed the database:

`

Upgrading

If you're upgrading from a previous version, you may want to re-publish the config file:

What's new in v1.1.35?

Changelog

For detailed information on recent changes, please see the CHANGELOG.

Contributing

We welcome contributions! For details on how to get started, please review our CONTRIBUTING guidlines.

Examples

Explore the API examples on our live site:

List all countries:
https://world.bmbc.cloud/api/countries
Search for a country:
https://world.bmbc.cloud/api/countries?search=rom
Get states by country code:
https://world.bmbc.cloud/api/states?filters[country_code]=RO&fields=cities

Usage

List all the countries

Use the World facade:

Use the API countries endpoint:

Fetch a country with its states and cities.

Use the World facade:

Response:

Use the API countries endpoint:

List all the cities by country id

Use the API cities endpoint:

Available actions

Name Description
countries lists all the world countries
states lists all the states
cities lists all the cities
timezones lists all the timezones
currencies lists all the currencies
languages lists all the languages

An action response is formed as below:

Countries action

States action

Cities action

Timezones action

Currencies action

Languages action

Available API routes

All routes can be prefixed by any string. Ex.: admin, api...

Countries
Method GET
Route /{prefix}/countries
Parameters* comma seperated fields (countries table fields in addition to states, cities, currency and timezones), array filters, string search
Example /api/countries?fields=iso2,cities&filters[phone_code]=44
response success, message, data

States
Method GET
Route /{prefix}/states
Parameters* comma seperated fields (states table fields in addition to country and cities), array filters, string search
Example /api/states?fields=country,cities&filters[country_code]=RO
response success, message, data

Cities
Method GET
Route /{prefix}/cities
Parameters* comma seperated fields (cities table fields in addition to country and state), array filters, string search
Example /api/cities?fields=country,state&filters[country_code]=RO
response success, message, data

Timezones
Method GET
Route /{prefix}/timezones
Parameters* comma seperated fields (timezones table fields in addition to the country), array filters, string search
Example /api/timezones?fields=country&filters[country_code]=RO
response success, message, data

Currencies
Method GET
Route /{prefix}/currencies
Parameters* comma seperated fields (currencies table fields in addition to the country), array filters, string search
Example /api/currencies?fields=code&filters[country_code]=RO
response success, message, data

Languages
Method GET
Route /{prefix}/languages
Parameters* comma seperated fields, string search
Example /api/languages?fields=dir
response success, message, data

Localization

The available locales are

The default locale is en.

Header option

Alternatively, you can use specific locale with the World Facade setLocale('locale') helper method. Example:

Schema

Configuration

The configuration for the World package is located in the world.php file.
If you're upgrading from a previous version, you may want to re-publish the config file:

Customizing database connection

By default, this package uses the default database connection, but it's possible to customize it using the WORLD_DB_CONNECTION variable in your .env file.

Countries restrictions

Countries can be restricted while seeding the database either by adding the ISO2 country codes in the allowed_countries or disallowed_countries array lists.

Supported Locales

A list of the accepted locales which relate to the localized lang/ files.

Modules enablement

The states, cities, timezones, currencies and languages modules can be optionally disabled.
Please note that the cities module depends on the states module.

Routes

If you don't wish to use the packages as an API service, you can disable all the routes by assigning false to routes.

Migrations

It offers the ability to enable or disable the database fields.
When changing this configuration the database should be dropped and the seeder should be re-run.

Testing

Requirements

Browse to the package root folder and run:

* optional

All versions of world with dependencies

PHP Build Version
Package Version
Requires php Version >=7.4
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package signdeer/world contains the following files

Loading the files please wait ....