Skip to content

Latest commit

 

History

History
77 lines (57 loc) · 2.7 KB

UPGRADING.md

File metadata and controls

77 lines (57 loc) · 2.7 KB
Raw

Upgrading

Because there are many breaking changes an upgrade is not that easy. There are many edge cases this guide does not cover. We accept PRs to improve this guide.

From v4.2 to v4.3.0

  • The larex.php config was changed:
    • Optional. Please append new source_language key in this way: 
      'source_language' => 'en',

Or you can delete your current config and publish it again (copy your changes before).

From v4.0 to v4.2

  • The larex.php config was changed:
    • Optional. Please append new SameParametersLinter linter in this way: 
      'linters' => [
    // other linters here
    // Lukasss93\Larex\Linters\SameParametersLinter::class,
],
    • Optional. Please append ignore_empty_values key in this way: 
      'ignore_empty_values' => false,

Or you can delete your current config and publish it again (copy your changes before).

From v3.x to v4.0

  • The larex.php config was changed. Please change the path key in this way:
// <project-root>/config/larex.php

// before
'path' => 'resources/lang/localization.csv',

// after (Laravel 9)
'path' => lang_path('localization.csv'),

// after (Laravel 8)
'path' => resource_path('lang/localization.csv'),

Or you can delete your current config and publish it again (copy your changes before).

  • ⚠️ Dropped PHP 7.4 support, please upgrade at least to PHP 8.0.
  • ⚠️ Dropped Laravel 7 support, please upgrade at least to Laravel 8.

From v2.1 to v3.x

  • The larex.php config was changed. Please delete your current config and publish it again (copy your changes before).

  • If you created a custom Linter, please follow this steps:

    • Change public function description() to public static function description()
    • Change public function handle(Collection $row) to public function handle(CsvReader $reader)
      • The CsvReader class exposes the following methods:
        • getHeader to get the CSV header as Collection
        • getRows to get the CSV rows as LazyCollection

  • ⚠️ Dropped PHP 7.3 support, please upgrade at least to PHP 7.4.

  • ⚠️ Dropped Laravel 6 support, please upgrade at least to Laravel 7.

From v1.6 to v2.0

Because the CSV default format was changed, please follow this steps:

  1. ⚠️ Please run the php artisan larex:export before upgrading to v2.0!
  2. Delete the localization.csv file inside project-root/resources/lang folder
  3. Upgrade the library to v2.0
  4. Run the php artisan larex:import command

From v1.5 to v1.6

  • No breaking changes.
  • ⚠️ Dropped support for PHP 7.2, please upgrade at least to PHP 7.3.