矩阵/旗帜

Laravel 包,用于将国家代码(ISO 3166-1 alpha-2)转换为相应的旗帜表情符号

0.4.0 2023-03-25 14:25 UTC

This package is auto-updated.

Last update: 2024-08-25 17:26:45 UTC


README

Run Tests Latest Stable Version Total Downloads

一个 Laravel 包,用于将国家代码(ISO 3166-1 alpha-2)转换为相应的旗帜表情符号。

该包封装了 Country Flags,该包的所有限制也适用于此。

旗帜 在印度尼西亚语中意为旗帜 🇮🇩。

安装

您可以通过 composer 安装此包

Laravel 10

composer require matriphe/bendera

Laravel 9 或更早版本

composer require matriphe/bendera:0.3.0

配置

这不是必需的,但如果您想添加映射,请发布配置文件。

php artisan vendor:publish --provider="Matriphe\Bendera\BenderaServiceProvider" --tag="bendera"

例如,您想将自定义国家 XY 映射为 ID

return [
    'aliases' => [
        'XY' => 'ID',
    ]
];

使用方法

您可以使用 Facade Bendera 获取表情符号。

Bendera::emoji('id'); // will return 🇮🇩
Bendera::emoji('en'); // will return 🇬🇧
Bendera::emoji('uk'); // will return 🇬🇧
Bendera::emoji('GB'); // will return 🇬🇧
Bendera::emoji('XYZ'); // will return null

对于无效的国家代码,它将返回 null

您还可以通过注入 BenderaContract 到您的类中,使用依赖注入风格。

class SomeAwesomeClass 
{
    public function awesome(\Matriphe\Bendera\BenderaContract $bendera)
    {
        return $bendera->emoji('id');
    }
}

贡献

欢迎通过 Github 的 Pull Requests 进行贡献。

鸣谢

  • Stidges 提供了他的初始 Country Flags 包。
  • Spatie 提供了他们的出色包。

许可

MIT 许可证 (MIT)。请参阅许可文件以获取更多信息。