maxakawizard/po-parser

Gettext *.po parser for PHP

1.4.0 2022-07-12 16:41 UTC

This package is auto-updated.

Last update: 2024-03-01 00:05:48 UTC


README

Build Scrutinizer Code Quality Code Climate Coverage Status

GitHub tag Packagist Packagist

Minimum PHP Version License

Gettext *.po files parser for PHP.

This package is compliant with PSR-4 autoloading standard and PSR-12 coding standard. If you notice compliance oversights, please send a patch via pull request.

Usage

Read file content

$parser = new PoParser\Parser();
$parser->read('my-pofile.po');
$entries = $parser->getEntriesAsArrays();
// Now $entries contains every string information in your pofile

echo '<ul>';
foreach ($entries as $entry) {
   echo '<li>'.
   '<b>msgid:</b> '.$entry['msgid'].'<br>'.         // Message ID
   '<b>msgstr:</b> '.$entry['msgstr'].'<br>'.       // Translation
   '<b>reference:</b> '.$entry['reference'].'<br>'. // Reference
   '<b>msgctxt:</b> ' . $entry['msgctxt'].'<br>'.   // Message Context
   '<b>tcomment:</b> ' . $entry['tcomment'].'<br>'. // Translator comment
   '<b>ccomment:</b> ' . $entry['ccomment'].'<br>'. // Code Comment
   '<b>obsolete?:</b> '.(string)$entry['obsolete'].'<br>'. // Is obsolete?
    '<b>fuzzy?:</b> ' .(string)$entry['fuzzy'].     // Is fuzzy?
    '</li>';
}
echo '</ul>';

Modify content

$parser = new PoParser\Parser();
$parser->read('my-pofile.po');
// Entries are stored in array, so you can modify them.

// Use updateEntry method to change messages you want.
$parser->updateEntry('Write your email', 'Escribe tu email');
$parser->write('my-pofile.po');

Todo

  • Improve entries edit interface
  • Ability to change any entry fields
  • Discover what's the meaning of "#@ " line
  • Fix multiline msgstr processing (for singular and plural entries)
  • Implement previous untranslated strings support

License

This library is released under MIT license.