https://github.com/yiisoft/i18n

Yii i18n
https://github.com/yiisoft/i18n

hacktoberfest i18n yii3

Last synced: about 1 month ago
JSON representation

Yii i18n

• Host: GitHub
• URL: https://github.com/yiisoft/i18n
• Owner: yiisoft
• License: bsd-3-clause
• Created: 2019-04-03T23:20:33.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2024-04-04T07:07:31.000Z (8 months ago)
• Last Synced: 2024-04-15T03:00:38.473Z (7 months ago)
• Topics: hacktoberfest, i18n, yii3
• Language: PHP
• Homepage: https://www.yiiframework.com/
• Size: 129 KB
• Stars: 25
• Watchers: 20
• Forks: 25
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: .github/CONTRIBUTING.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE.md
  • Code of conduct: .github/CODE_OF_CONDUCT.md
  • Security: .github/SECURITY.md

Awesome Lists containing this project

README

        


    

        

    

    
Yii Internationalization Library

    


[![Latest Stable Version](https://poser.pugx.org/yiisoft/i18n/v/stable.png)](https://packagist.org/packages/yiisoft/i18n)

[![Total Downloads](https://poser.pugx.org/yiisoft/i18n/downloads.png)](https://packagist.org/packages/yiisoft/i18n)

[![Build status](https://github.com/yiisoft/i18n/workflows/build/badge.svg)](https://github.com/yiisoft/i18n/actions?query=workflow%3Abuild)

[![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/yiisoft/i18n/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/yiisoft/i18n/?branch=master)

[![Code Coverage](https://scrutinizer-ci.com/g/yiisoft/i18n/badges/coverage.png?b=master)](https://scrutinizer-ci.com/g/yiisoft/i18n/?branch=master)

[![Mutation testing badge](https://img.shields.io/endpoint?style=flat&url=https%3A%2F%2Fbadge-api.stryker-mutator.io%2Fgithub.com%2Fyiisoft%2Fi18n%2Fmaster)](https://dashboard.stryker-mutator.io/reports/github.com/yiisoft/i18n/master)

[![static analysis](https://github.com/yiisoft/i18n/workflows/static%20analysis/badge.svg)](https://github.com/yiisoft/i18n/actions?query=workflow%3A%22static+analysis%22)

[![type-coverage](https://shepherd.dev/github/yiisoft/i18n/coverage.svg)](https://shepherd.dev/github/yiisoft/i18n)

The package provides common internationalization utilities:

- `Locale` stores locale information created from [BCP 47](https://www.rfc-editor.org/info/bcp47) formatted string. It

  can parse locale string, modify locale parts, form locale string from parts, and derive fallback locale.

- `LocaleProvider` is a stateful service that stores current locale.

## Requirements

- PHP 8.0 or higher.

## Installation

The package could be installed with [Composer](https://getcomposer.org):

```shell

composer install yiisoft/i18n

```

## General usage

Use `Locale` as follows:

```php

$locale = new \Yiisoft\I18n\Locale('es-CL');

echo $locale->language(); // es

echo $locale->region(); // CL

$locale = $locale->withLanguage('en');

echo $locale->asString(); // en-CL

echo $locale

    ->fallbackLocale()

    ->asString(); // en

```

Use `LocaleProvider` as follows:

```php

use \Yiisoft\I18n\LocaleProvider;

final class MyService

{

    public function __construct(

        private LocaleProvider $localeProvider

    ) {    

    }

    

    public function doIt(): void

    {

        $locale = $this->localeProvider->get();

        if ($this->localeProvider->isDefaultLocale()) {

            // ...

        }

        

        // ...        

    }

    

}

```

## Documentation

- [Internals](docs/internals.md)

If you need help or have a question, the [Yii Forum](https://forum.yiiframework.com/c/yii-3-0/63) is a good place for that.

You may also check out other [Yii Community Resources](https://www.yiiframework.com/community).

## License

The Yii Internationalization Library is free software. It is released under the terms of the BSD License.

Please see [`LICENSE`](./LICENSE.md) for more information.

Maintained by [Yii Software](https://www.yiiframework.com/).

## Support the project

[![Open Collective](https://img.shields.io/badge/Open%20Collective-sponsor-7eadf1?logo=open%20collective&logoColor=7eadf1&labelColor=555555)](https://opencollective.com/yiisoft)

## Follow updates

[![Official website](https://img.shields.io/badge/Powered_by-Yii_Framework-green.svg?style=flat)](https://www.yiiframework.com/)

[![Twitter](https://img.shields.io/badge/twitter-follow-1DA1F2?logo=twitter&logoColor=1DA1F2&labelColor=555555?style=flat)](https://twitter.com/yiiframework)

[![Telegram](https://img.shields.io/badge/telegram-join-1DA1F2?style=flat&logo=telegram)](https://t.me/yii3en)

[![Facebook](https://img.shields.io/badge/facebook-join-1DA1F2?style=flat&logo=facebook&logoColor=ffffff)](https://www.facebook.com/groups/yiitalk)

[![Slack](https://img.shields.io/badge/slack-join-1DA1F2?style=flat&logo=slack)](https://yiiframework.com/go/slack)