vendor/commerceguys/intl/src/Country/CountryRepositoryInterface.php


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41

<?php

namespace CommerceGuys\Intl\Country;

/**
 * Country repository interface.
 */
interface CountryRepositoryInterface
{
    /**
     * Returns a country instance matching the provided country code.
     *
     * @param string $countryCode    The country code.
     * @param string $locale         The locale (i.e. fr-FR).
     * @param string $fallbackLocale A fallback locale (i.e "en").
     *
     * @return CountryInterface
     */
    public function get($countryCode, $locale = null, $fallbackLocale = null);

    /**
     * Returns all country instances.
     *
     * @param string $locale         The locale (i.e. fr-FR).
     * @param string $fallbackLocale A fallback locale (i.e "en").
     *
     * @return array An array of countries implementing the CountryInterface,
     *               keyed by country code.
     */
    public function getAll($locale = null, $fallbackLocale = null);

    /**
     * Returns a list of countries.
     *
     * @param string $locale         The locale (i.e. fr-FR).
     * @param string $fallbackLocale A fallback locale (i.e "en").
     *
     * @return array An array of country names, keyed by country code.
     */
    public function getList($locale = null, $fallbackLocale = null);
}