Download the PHP package rpwebdevelopment/laravel-translate without Composer

Laravel Translate

Laravel Translate is a tool intended to automatically generate translated language files. Currently, the package leverages either DeepL API, Amazon Translate or the amazing Google Translate package from Stichoza which allows for zero configuration usage.

The default configuration makes use of Google translations and can be used straight out of the box with no sign-up or configuration. If you would rather use the DeepL translations API you will need to sign up here; DeepL configuration details described below.

Installation

You can install the package via composer:

You can publish the config file with:

This is the contents of the published config file:

DeepL Configuration

In order to make use of the DeepL API you will need to publish the config file as detailed above and update the provider to deepl. You will then need to add your DeepL API auth token to your .env file under the env variable DEEPL_AUTH_TOKEN.

Amazon Configuration

In order to make use of the AWS Translate API you will need to publish the config file as detailed above and update the provider to aws. You will then need to ensure that you .env file contains the required AWS variables: AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY & AWS_DEFAULT_REGION.

Note:

You will need to ensure that the AWS IAM role has the permission policy TranslateFullAccess .

Usage

This package is designed to function with as much flexibility as possible, as such it is designed to work for multiple configurations with minimal setup, whether you have a single file or directory per language, or if you are using PHP lang files or JSON lang files.

Options:

Bulk Processing

Rather than processing each target language manually you can add all your target locales to the target_locales option in the translations configuration file, this will enable the usage of the bulk translate command:

Options:

Key Validation

If you simply wish to ascertain if translations are missing from your project you can implement the missing command:

Options:

This command can be used in conjunction with git-hooks in order to prevent changes being deployed to your repository with missing translations, this can be done by adding the following bash script to your .git/hooks/pre-commit:

Example Usages

Directory Structure:

Example directory structure:

Assuming the config default_source is set to en_GB; for the above structure the following command:

Would produce the following structure:

Alternately, you can explicitly declare the source locale:

If you are only wanting to replace a specific file you can also pass in the file option (note the file extension is optional):

Single File Structure

If you are using a single file per language rather than a directory structure as below:

You can use the exact same command syntax, so the following:

Would result in the following output:

Notes

• Any existing translations will be overridden, it is recommended that you back-up any previously created lang files to allow for easy restoration if required.

• Translations are a result of machine translation and therefore some translation errors may occur.

• While efforts have been made to persist lang string attributes, their persistence cannot be 100% guaranteed, as such it is recommended to verify your files after production.

Credits

• Richard Porter

Changelog

Please see CHANGELOG for more information on what has changed recently.

License

The MIT License (MIT). Please see License File for more information.