saeven/circlical-po-editor

Gettext *.PO file editor and parser for PHP.

0.9.1 2017-09-19 02:52 UTC

Requires

• php: >=5.5.0

Requires (Dev)

• phpspec/phpspec: @stable

MIT

• Alexandre Lemaire

• i18n
• gettext
• po
• i10n

README

PHP Parser/Editor for Gettext PO files

PoEditor is a class that allows you to load / parse / manipulate / compile .po files using PHP. I built this to support a web-based PO file editor.

This repository is thoroughly tested, mosts tests were taken from raulferras/PHP-po-parser, thank you!

It supports all of the same features, with a simpler and stable interface:

• headers (HeaderBlock)
• msgid (message id)
• msgstr (translation strings)
• msgctxt (context)
• msgid_plural (plural translations)

• (flags, comments, source, references, annotations, etc.)

When you parse a po file, it transforms it into blocks that you can cleanly manipulate to thereafter compile.

Usage

Parsing Files

$po = new Circlical\PoEditor( 'file.po' );
$po->parse();

Editing Blocks

$po = new Circlical\PoEditor( 'file.po' );
$po->parse();
$po->getBlock( 'welcome' )->setMsgstr( "hola" );
$po->compile();

That transforms file.po from:

#: wp-admin/install.php:177
msgid "welcome"
msgstr "welcome"

to:

#: wp-admin/install.php:177
msgid "welcome"
msgstr "hola"