maxakawizard/po-parser

Gettext *.po parser for PHP

1.4.0 2022-07-12 16:41 UTC

Requires

• php: >=7.1

Requires (Dev)

• php-coveralls/php-coveralls: ~2.5
• phpunit/phpunit: >7 <10
• squizlabs/php_codesniffer: ~3.0

MIT

• Max Grigorian

• i18n
• gettext
• l10n
• po

README

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.