sepia / po-parser
Gettext *.PO file parser for PHP.
Installs: 423 017
Dependents: 20
Suggesters: 0
Security: 0
Stars: 118
Watchers: 18
Forks: 58
Open Issues: 4
Requires
- php: >=5.3
- symfony/polyfill-mbstring: ^1
Requires (Dev)
- fzaninotto/faker: ^1.7
- phpunit/phpunit: ^4.8.36
- squizlabs/php_codesniffer: ^2.0
- dev-master
- 6.0.1
- 6.0.0
- 5.1.8
- 5.1.7
- 5.1.6
- 5.1.5
- 5.1.4
- 5.1.3
- 5.1.2
- 5.1.1
- 5.1.0
- 5.0.0
- 4.2.2
- 4.2.1
- 4.2.0
- 4.1.1
- 4.1.0
- 4.0.1
- 4.0.0
- 3.0.5
- 3.0.4
- 3.0.3
- 3.0.2
- 3.0.1
- 3.0.0
- dev-feature/fix_escaped_quotes
- dev-compiling_headers
- dev-feature/6
- dev-develop
- dev-feature/modifyHeaders
- dev-feature/catalog_interface
- dev-feature/5.0.1
- dev-scrutinizer-patch-1
This package is auto-updated.
Last update: 2020-12-31 00:23:35 UTC
README
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
Features
It supports following parsing features:
- header section.
- msgid, both single and multiline.
- msgstr, both single and multiline.
- msgctxt (Message context).
- msgid_plural (plurals forms).
- #, keys (flags).
- # keys (translator comments).
- #. keys (Comments extracted from source code).
- #: keys (references).
- #| keys (previous strings), both single and multiline.
- #~ keys (old entries), both single and multiline.
Installation
composer require sepia/po-parser
Usage
<?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'));
Save Changes back to a file
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));
Documentation
Testing
Tests are done using PHPUnit. To execute tests, from command line type:
php vendor/bin/phpunit
TODO
- Add compatibility with older disambiguating contexts formats.