Керування глобальними даними у Laravel за допомогою пакета World

Якщо ви працюєте над додатком і шукаєте повний перелік країн, штатів, міст, часових зон, валют і мов, зверніть увагу на корисний пакет Laravel під назвою World.

# Ключові функції

• Широке охоплення даних: Отримуйте детальну інформацію про країни, їх підрозділи, міста, часові зони, валюти та мови в одному пакеті.
• Гнучке отримання даних: Використовуйте фасад World або попередньо визначені API маршрути для отримання даних відповідно до потреб вашого додатку.
• Підтримка локалізації: Налаштуйте відображення даних відповідно до різних регіональних налаштувань, покращуючи користувацький досвід.
• Конфігурація з'єднання з базою даних: Визначте власне з'єднання з базою даних, використовуючи змінну WORLD_DB_CONNECTION у файлі .env. Це дозволяє вам отримувати дані, підключаючись до бази даних, відмінної від вашого стандартного з'єднання.

Встановити пакет у ваш проект Laravel можна за допомогою Composer:

composer require nnjeim/world

Після цього виконайте наступну команду Artisan для автоматизації процесу встановлення:

php artisan world:install

Ця команда виконає міграції і заповнить базу даних.

# Приклади

Використовуючи фасад World, ви можете легко отримати список країн та вказати, які поля ви хочете повернути і які фільтри застосувати:

$countries = World::countries(); // повертає список усіх країн

// або наступний код поверне всі міста та штати/парафії Ямайки
$countryWithStatesAndCities = World::countries([
    'fields' => 'states,cities',
    'filters' => [
            'iso2' => 'JM'
    ]
]);

А якщо вам потрібен список валют, ви можете використати наступний код:

$currencies = World::currencies([
        'fields' => 'code,symbol,country',
        'filters' => [
                'code' => 'USD'
        ]
]);

Пакет також надає API-інтерфейси з можливістю вказувати поля, фільтри і навіть пошукові запити. Наприклад:

• http://world.test/api/countries?fields=states,cities
• http://world.test/api/countries?fields=states&search=Jamaica
• http://world.test/api/currencies
• http://world.test/api/currencies?fields=code&filters[code]=JMD

Дізнайтеся більше про цей пакет і перегляньте джерельний код на GitHub.