enl / moses-php-client
PHP Client for Moses xml-rpc server. Moses is a machine translation system
Installs: 1 398
Dependents: 0
Suggesters: 0
Security: 0
Stars: 1
Watchers: 2
Forks: 1
Open Issues: 0
Requires
- ext-curl: *
- comodojo/xmlrpc: 1.0.*
Requires (Dev)
- mockery/mockery: ~0.9
- phpunit/phpunit: ~4.8
This package is auto-updated.
Last update: 2024-10-29 03:46:09 UTC
README
This package is a simplest possible client for Moses xmlrpc server. Moses is a machine translation system. You can read more about it on its official website.
Installation
The best way to install the package is to install it via composer. If you're still not using this awesome manager it's right time to start!
composer require enl/moses-php-client
Or you can add the following string to your composer.json
by hand:
{
"require": {
"enl/moses-php-client": "~1.0"
}
}
And run composer update
.
Usage
First of all, you need to instantiate the Client:
use Enl\MosesClient\Client;
use Enl\MosesClient\Transport;
$transport = new Transport('http://your-moses-server.ltd:8080/RPC2');
$client = new Client($transport);
Or just use Client::factory
method:
use Enl\MosesClient\Client;
$client = Client::factory('http://your-moses-server.ltd:8080/RPC2');
How to translate a text
Text translation is simple as this line of code:
$translation = $client->translate('Text to translate goes here.');
Alignment option
Actually, Client::translate
function takes two parameters. The second one is optional align
boolean
parameter:
$translation = $client->translate('Text to translate goes here.', $align);
What this parameter mean? The official doc for Moses says the following:
To access the Moses server, an XMLRPC request should be sent to http://host:port/RPC2 where the parameter is a map containing the keys
text
and (optionally)align
. The value of the first of these parameters is the text to be translated and the second, if present, causes alignment information to be returned to the client. The client will receive a map containing the same two keys, where the value associated with thetext
key is the translated text, and thealign
key (if present) maps to a list of maps. The alignment gives the segmentation in target order, with each list element specifying the target start position (tgt-start
), source start position (src-start
) and source end position (src-end
).
So, if you set align
parameter as a true
, you will get the array with text
and align
keys as a response and just text otherwise.