library laravel-translator

parfumix/laravel-translator

Translator for Laravel

Introduction

Laravel translator allow you to easy translate your website using different drivers like File, Database and others., _(*1)

Instalation

You can use the composer package manager to install. From console run:, _(*2)

  $ php composer.phar require parfumix/laravel-translator "v1.0"

or add to your composer.json file, _(*3)

"parfumix/laravel-translator": "v1.0"

You have to publish package files using, _(*4)

  $ php artisan vendor:publish

Configuration

To register package you have to follow standart procedure registering serviceProvider class .Open your configuration file located in config/app.php and search for array of providers:, _(*5)

  'providers' => [
        // Add that line at the end of array ..
        'Translator\TranslatorServiceProvider'
      ]  

Basic usage

Before using translator you have to publish your configuration file and select driver which you want to use, _(*6)

  $ php artisan vendor:publish

# here will be set up default driver .
default_driver: file

After all that you just have to use :, _(*7)

 __($key, $replacement, $locale = null) // will translate your key based on default selected driver. Locale will grab automaticly from localization component.

Extending

You can register own translator drivers which have will have custom business logic . But for the first register it in your configuration file, _(*8)

drivers:
  my_driver:
    class: Namespace\To\My\Driver
    option1: value1
    option2: value2
  database:
    class: Translator\Drivers\Database
    cache_time: 60
  file:
    class: Translator\Drivers\File

and create you class which implelement Translatable interface:, _(*9)

<?php

namespace My\Namespace;

use Translator\Driver;
use Translator\Translatable;

class MyDriver extends Driver implements Translatable {

    // Get translation by key .
    public function get($key, $replacement = array(), $locale = null);

    // Check if has translation by key .
    public function has($key, $locale = null);

    // Delete translation by key .
    public function delete($key, $group, $locale = null);

    // Save your translation to source .
    public function translate($key, $translation, $locale = null);

}