Gettext::fileToDatabase

public static Gettext::fileToDatabase($file, $options)

Reads the given PO files into the database.

Parameters

object $file: File object with an 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.

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 += array(
    'overwrite_options' => array(),
    '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 = array(
    '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;
}

Links:

https://api.drupal.org/api/drupal/core%21modules%21locale%21src%21Gettext.php/function/Gettext%3A%3AfileToDatabase/8.2.x

doc_Drupal

2025-01-10 15:47:30

Comments