Download the PHP package datalinx/gettext-context without Composer
On this page you can find all versions of the php package datalinx/gettext-context. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download datalinx/gettext-context
More information about datalinx/gettext-context
Files in datalinx/gettext-context
Package gettext-context
Short Description Implementation of context functions for the PHP gettext extension
License MIT
Homepage https://github.com/DataLinx/gettext-context
Informations about the package gettext-context
gettext-context
Implementation of context functions for the PHP gettext extension
About
PHP still lacks full support for gettext, because it does not implement the context functions. Until this is sorted out, you can use this package to add context support to your localization efforts.
For example, in English, both persons and products have a "name" attribute. So using a simple gettext:
... would yield "Ime" in Slovenian, which is wrong.
To solve this, you can use a context function provided by this package:
Requirements
- PHP >= 7.4
- gettext PHP extension
It can be used on lower versions of PHP, but you won't be able to install it with composer (or run tests).
This package is tested for Linux, but it should work for other systems too. Any Windows and Mac feedback is highly welcome. It would be great if you could make a pull request for testing on those platforms (including the GitHub workflow).
Installing
- Download it with composer:
composer require datalinx/gettext-context
- Include the
vendor/datalinx/gettext-context/src/gettext-context.php
file when you need it*
* It's not added to the autoload
directive, since you might not need or want to always include it in runtime. If you want to always load it, just add the source file to your composer.json
autoload files list:
Usage
See the documented src/gettext-context.php file for the list of functions and their parameters.
Extracting messages with context support
With xgettext
You can add extra keyword parameters to your xgettext
call to include the context functions.
For example, this would be used in our package:
With Poedit
If you're using Poedit, add the following keywords in your Catalog > Properties > Sources Keywords:
pgettext:1c,2
npgettext:1c,2,3
dpgettext:2c,3
dnpgettext:2c,3,4
Then run the "Update from code" procedure :)
Contributing
If you have some suggestions how to make this package better, please open an issue or even better, submit a pull request.
Should you want to contribute, please see the development guidelines in the DataLinx PHP package template.
Changelog
All notable changes to this project are automatically documented in the release-please GitHub action.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
For all this to work, commit messages must follow the Conventional commits specification, which is also enforced by a Git hook.
Credits
- This answer on Stack Overflow for the implementation.
- This comment on the PHP documentation for the messages extraction fix.
All versions of gettext-context with dependencies
ext-gettext Version *