README

这是一个 Laravel 模型列翻译管理器

当前工作模型

安装

您可以通过 composer 安装此包

composer require laravelarab/tarjama

如果您使用的是 Laravel 5.5 及以上版本，包将自动注册。

否则，您需要将服务提供者添加到 app/config/app.php 文件中

LaravelArab\Tarjama\TarjamaServiceProvider::class,

如果您想更改默认语言，必须发布配置文件

php artisan vendor:publish --provider="LaravelArab\Tarjama\TarjamaServiceProvider"

这是发布文件的 内容

return [

   /**
    * Default Locale || Root columns locale
    * We will use this locale if config('app.locale') translation not exist
    */
   'locale' => 'en',

   /**
    * Supported Locales e.g: ['en', 'fr', 'ar']
    */
   'locales' => ['ar', 'en', 'fr']

];

然后迁移翻译表

php artisan migrate

使模型可翻译

使模型可翻译的必要步骤是

• 只需使用 LaravelArab\Tarjama\Translatable 特性。

以下是一个准备好的模型示例

use Illuminate\Database\Eloquent\Model;
use LaravelArab\Tarjama\Translatable;

class Item extends Model
{
    use Translatable;

    /**
      * The attributes that are Translatable.
      *
      * @var array
      */
    protected $translatable = [
        'name', 'color'
    ];
}

可用方法

保存翻译

$item = new Item;
$data = array('en' => 'car', 'ar' => 'سيارة');

$item->setTranslations('name', $data); // setTranslations($attribute, array $translations, $save = false)

// or save one translation
$item->setTranslation('name', 'en', 'car', true); // setTranslation($attribute, $locale, $value, $save = false)

// or just do
$item->name = 'car'; // note: this will save automaticaly unless it's the default locale

// This will save if (current locale == default locale OR $save = false)
$item->save();

获取翻译

$item = new Item::first();
// get current locale translation
$item->city
OR
$item->getTranslation('city');

// pass translation locales
$item->getTranslation('city', 'ar'); // getTranslation($attribute, $language = null, $fallback = true)
$item->getTranslationsOf('name', ['ar', 'en']); // getTranslationsOf($attribute, array $languages = null, $fallback = true)

删除翻译

$item = new Item::first();
$item->deleteTranslations(['name', 'color'], ['ar', 'en']); // deleteTranslations(array $attributes, $locales = null)

维护者

Abdellah Chadidi