function Gettext::fileToDatabase

Same name in other branches
  1. 8.9.x core/modules/locale/src/Gettext.php \Drupal\locale\Gettext::fileToDatabase()
  2. 10 core/modules/locale/src/Gettext.php \Drupal\locale\Gettext::fileToDatabase()
  3. 11.x core/modules/locale/src/Gettext.php \Drupal\locale\Gettext::fileToDatabase()

Reads the given PO files into the database.

Parameters

object $file: File object with a URI property pointing at the file's path.

  • "langcode": The language the strings will be added to.
  • "uri": File URI.

array $options: An array with options that can have the following elements:

  • 'overwrite_options': Overwrite options array as defined in Drupal\locale\PoDatabaseWriter. Optional, defaults to an empty array.
  • 'customized': Flag indicating whether the strings imported from $file are customized translations or come from a community source. Use LOCALE_CUSTOMIZED or LOCALE_NOT_CUSTOMIZED. Optional, defaults to LOCALE_NOT_CUSTOMIZED.
  • 'seek': Specifies from which position in the file should the reader start reading the next items. Optional, defaults to 0.
  • 'items': Specifies the number of items to read. Optional, defaults to -1, which means that all the items from the stream will be read.

Return value

array Report array as defined in Drupal\locale\PoDatabaseWriter.

See also

\Drupal\locale\PoDatabaseWriter

1 call to Gettext::fileToDatabase()
locale_translate_batch_import in core/modules/locale/locale.bulk.inc
Implements callback_batch_operation().

File

core/modules/locale/src/Gettext.php, line 42

Class

Gettext
Static class providing Drupal specific Gettext functionality.

Namespace

Drupal\locale

Code

public static function fileToDatabase($file, $options) {
    // Add the default values to the options array.
    $options += [
        'overwrite_options' => [],
        'customized' => LOCALE_NOT_CUSTOMIZED,
        'items' => -1,
        'seek' => 0,
    ];
    // Instantiate and initialize the stream reader for this file.
    $reader = new PoStreamReader();
    $reader->setLangcode($file->langcode);
    $reader->setURI($file->uri);
    try {
        $reader->open();
    } catch (\Exception $exception) {
        throw $exception;
    }
    $header = $reader->getHeader();
    if (!$header) {
        throw new \Exception('Missing or malformed header.');
    }
    // Initialize the database writer.
    $writer = new PoDatabaseWriter();
    $writer->setLangcode($file->langcode);
    $writer_options = [
        'overwrite_options' => $options['overwrite_options'],
        'customized' => $options['customized'],
    ];
    $writer->setOptions($writer_options);
    $writer->setHeader($header);
    // Attempt to pipe all items from the file to the database.
    try {
        if ($options['seek']) {
            $reader->setSeek($options['seek']);
        }
        $writer->writeItems($reader, $options['items']);
    } catch (\Exception $exception) {
        throw $exception;
    }
    // Report back with an array of status information.
    $report = $writer->getReport();
    // Add the seek position to the report. This is useful for the batch
    // operation.
    $report['seek'] = $reader->getSeek();
    return $report;
}

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.