PHP Classes
elePHPant
Icontem

File: README-ES.md

Recommend this page to a friend!
  Classes of Josantonius  >  PHP Language Code  >  README-ES.md  >  Download  
File: README-ES.md
Role: Documentation
Content type: text/markdown
Description: Documentation
Class: PHP Language Code
Get the name of language from code and vice-versa
Author: By
Last change: Updated to 1.1.5 version
Updated to 1.1.4 version
Date: 12 days ago
Size: 6,976 bytes
 

Contents

Class file image Download

PHP LanguageCode library

Latest Stable Version Latest Unstable Version License Codacy Badge Total Downloads Travis PSR2 PSR4 CodeCov

English version

Lista de 217 códigos de idioma: ISO 639-1.

Requisitos

Esta clase es soportada por versiones de PHP 5.6 o superiores y es compatible con versiones de HHVM 3.0 o superiores.

Instalación

La mejor forma de instalar esta extensión es a través de Composer.

Para instalar PHP LanguageCode library, simplemente escribe:

$ composer require Josantonius/LanguageCode

El comando anterior sólo instalará los archivos necesarios, si prefieres descargar todo el código fuente puedes utilizar:

$ composer require Josantonius/LanguageCode --prefer-source

También puedes clonar el repositorio completo con Git:

$ git clone https://github.com/Josantonius/PHP-LanguageCode.git

O instalarlo manualmente:

Descargar LanguageCode.php y anguageCodeCollection.php:

$ wget https://raw.githubusercontent.com/Josantonius/PHP-LanguageCode/master/src/LanguageCode.php
$ wget https://raw.githubusercontent.com/Josantonius/PHP-LanguageCode/master/src/LanguageCodeCollection.php

Métodos disponibles

Métodos disponibles en esta biblioteca:

- Obtener array con todos los códigos de idioma:

LanguageCode::get();

# Return (array) ? códigos y nombres de idiomas

- Obtener el nombre del idioma desde código de idioma:

LanguageCode::getLanguageFromCode($languageCode);

| Atributo | Descripción | Tipo | Requerido | Predeterminado | --- | --- | --- | --- | --- | | $languageCode | Código de idioma, e.g. 'es'. | string | Sí | |

# Return (tring|false) ? nombre del país

- Obtener código de idioma desde el nombre del idioma:

LanguageCode::getCodeFromLanguage($languageName);

| Atributo | Descripción | Tipo | Requerido | Predeterminado | --- | --- | --- | --- | --- | | $languageName | Nombre de idioma, e.g. 'Spanish'. | string | Sí | |

# Return (tring|false) ? código de idioma

Cómo empezar

Para utilizar esta biblioteca con Composer:

require __DIR__ . '/vendor/autoload.php';

use Josantonius\LanguageCode\LanguageCode;

Si la instalaste manualmente, utiliza:

require_once __DIR__ . '/LanguageCode.php';
require_once __DIR__ . '/LanguageCodeCollection.php';

use Josantonius\LanguageCode\LanguageCode;

Uso

Ejemplo de uso para esta biblioteca:

- Obtener array con todos los códigos de idioma:

LanguageCode::get();

/*
array(217) {
  ["aa"]=>
  string(4) "Afar"
  ["ab"]=>
  string(9) "Abkhazian"
  ["af"]=>
  string(9) "Afrikaans"
  ["am"]=>
  string(7) "Amharic"
  ["ar"]=>
  string(6) "Arabic"
  (...)
*/

- Obtener el nombre del idioma desde código de idioma:

LanguageCode::getLanguageFromCode('es'); // string(7) "Spanish"

- Obtener código de idioma desde el nombre del idioma:

LanguageCode::getCodeFromLanguage('spanish'); // string(2) "es"

List in Json format

Go to the resource.

Tests

Para ejecutar las pruebas necesitarás Composer y seguir los siguientes pasos:

$ git clone https://github.com/Josantonius/PHP-LanguageCode.git

$ cd PHP-LanguageCode

$ composer install

Ejecutar pruebas unitarias con PHPUnit:

$ composer phpunit

Ejecutar pruebas de estándares de código PSR2 con PHPCS:

$ composer phpcs

Ejecutar pruebas con PHP Mess Detector para detectar inconsistencias en el estilo de codificación:

$ composer phpmd

Ejecutar todas las pruebas anteriores:

$ composer tests

? Tareas pendientes

  • [ ] Añadir nueva funcionalidad
  • [ ] Mejorar pruebas
  • [ ] Mejorar documentación
  • [ ] Refactorizar código

Contribuir

Si deseas colaborar, puedes echar un vistazo a la lista de issues o tareas pendientes.

Pull requests

Repositorio

La estructura de archivos de este repositorio se creó con PHP-Skeleton.

Licencia

Este proyecto está licenciado bajo licencia MIT. Consulta el archivo LICENSE para más información.

Copyright

2016 - 2017 Josantonius, josantonius.com

Si te ha resultado útil, házmelo saber :wink:

Puedes contactarme en Twitter o a través de mi correo electrónico.