Rinvex Language

https://github.com/rinvex/languages
Admin
Rinvex Language is a lightweight PHP package for retrieving comprehensive language details,...
Tokens:2,268
Snippets:6
Trust Score:9.6
License:MIT
Update:1 year ago
Show doc for...
Tokens:
Raw
### Semantic Versioning Guidelines

Source: https://github.com/rinvex/languages/blob/master/CONTRIBUTING.md

The project follows Semantic Versioning (SemVer) for releases. Releases are numbered as <major>.<minor>.<patch> or <breaking>.<feature>.<fix>, with specific rules for incrementing each part.

```APIDOC
Release Format:
  <major>.<minor>.<patch>
  <breaking>.<feature>.<fix>

Guidelines:
- Breaking backward compatibility: Increment major, reset minor and patch.
- New additions (no breaking changes): Increment minor, reset patch.
- Bug fixes/misc changes: Increment patch.
```

--------------------------------

### Get Single Language Details

Source: https://github.com/rinvex/languages/blob/master/README.md

Demonstrates how to retrieve and access various details of a specific language using its ISO 639-1 code. This includes getting the language name, native name, ISO codes, script information, family details, scope, type, and cultures.

```php
// Get single language
$english = language('en');

// Get language name: English
echo $english->getName();

// Get language native name: English
echo $english->getNativeName();

// Get language ISO 639-1 code: en
echo $english->getIso6391();

// Get language ISO 639-2 code: eng
echo $english->getIso6392();

// Get language ISO 639-3 code: eng
echo $english->getIso6393();

// Get language script details: {"name": "Latin","iso_15924": "Latn","iso_numeric": "215","direction": "ltr"}
echo $english->getScript();

// Get language script name: Latin
echo $english->getScriptName();

// Get language script ISO 15924 code: Latn
echo $english->getScriptIso15924();

// Get language script ISO numeric code: 215
echo $english->getScriptIsoNumeric();

// Get language script direction: ltr
echo $english->getScriptDirection();

// Get language family details: {"name": "Indo-European","iso_639_5": "ine","hierarchy": "ine"}
echo $english->getFamily();

// Get language family name: Indo-European
echo $english->getFamilyName();

// Get language family ISO 6395 code: ine
echo $english->getFamilyIso6395();

// Get language family hierarchy: ine
echo $english->getFamilyHierarchy();

// Get language scope: individual
echo $english->getScope();

// Get language type: living
echo $english->getType();

// Get language cultures: {"en-US": {"name": "English (United States)","native": "English (United States)"}, {...}}
echo $english->getCultures();

// Get language specific culture: {"name": "English (United States)","native": "English (United States)"}
echo $english->getCulture('en-US');
```

--------------------------------

### Git Flow Branching Model

Source: https://github.com/rinvex/languages/blob/master/CONTRIBUTING.md

The project utilizes the Git-Flow branching model. Key branches include 'master' (stable releases), 'develop' (work-in-progress), and support branches (X.Y). All pull requests must be submitted to the 'develop' branch.

```APIDOC
Branching Model: Git-Flow

Key Branches:
- master: Latest stable releases.
- develop: Latest work-in-progress development.
- X.Y: Support branches for multiple major versions.

Pull Request Target:
- All pull requests MUST be sent to the `develop` branch.
```

--------------------------------

### PSR Standards Compliance

Source: https://github.com/rinvex/languages/blob/master/CONTRIBUTING.md

This project adheres to the PSR-1, PSR-2, and PSR-4 standards for PHP coding. These standards ensure a high level of interoperability and consistent code style.

```PHP
http://www.php-fig.org/psr/psr-1/
http://www.php-fig.org/psr/psr-2/
http://www.php-fig.org/psr/psr-4/
```

--------------------------------

### Retrieve All Languages, Scripts, and Families

Source: https://github.com/rinvex/languages/blob/master/README.md

Shows how to fetch collections of all available languages, language scripts, and language families supported by the package. This is useful for iterating through or listing all supported language data.

```php
// Get all languages
$languages = languages();

// Get all language scripts
$language_scripts = language_scripts();

// Get all language families
$language_families = language_families();
```

--------------------------------

### Filter Languages by Criteria

Source: https://github.com/rinvex/languages/blob/master/README.md

Demonstrates how to use the `LanguageLoader` class to filter languages based on specific criteria, such as the language script name. This allows for targeted retrieval of language data.

```php
// Get languages with where condition (language script: Latin)
$whereLanguages = \Rinvex\Language\LanguageLoader::where('script.name', 'Latin');
```
Tokens:
Raw