Stars: 123
Forks: 57
Pull Requests: 52
Issues: 50
Watchers: 17
Last Updated: 2023-08-02 15:47:59
Parse Gettext *.PO files with PHP
License: BSD 3-Clause "New" or "Revised" License
Languages: PHP
PoParser is a personal project to fulfill a need I got: parse Gettext Portable files (*.po files) and edit its content using PHP.
PoParser requires PHP >= 5.4, but may work in 5.3 too.
Changelog
It supports following parsing features:
composer require sepia/po-parser
<?php
// Parse a po file
$fileHandler = new Sepia\PoParser\SourceHandler\FileSystem('es.po');
$poParser = new Sepia\PoParser\Parser($fileHandler);
$catalog = $poParser->parse();
// Get an entry
$entry = $catalog->getEntry('welcome.user');
// Update entry
$entry = new Entry('welcome.user', 'Welcome User!');
$catalog->setEntry($entry);
// You can also modify other entry attributes as translator comments, code comments, flags...
$entry->setTranslatorComments(array('This is shown whenever a new user registers in the website'));
$entry->setFlags(array('fuzzy', 'php-code'));
Use PoCompiler
together with FileSystem
to save a catalog back to a file:
$fileHandler = new Sepia\PoParser\SourceHandler\FileSystem('en.po');
$compiler = new Sepia\PoParser\PoCompiler();
$fileHandler->save($compiler->compile($catalog));
Tests are done using PHPUnit. To execute tests, from command line type:
php vendor/bin/phpunit