PHPackages                             ovesio/ovesio-php - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. ovesio/ovesio-php

ActiveLibrary[API Development](/categories/api)

ovesio/ovesio-php
=================

PHP client library for Ovesio.com API

1.1.3(9mo ago)30113MITPHPPHP >=7.1

Since Jul 21Pushed 9mo ago1 watchersCompare

[ Source](https://github.com/ovesio/ovesio-php)[ Packagist](https://packagist.org/packages/ovesio/ovesio-php)[ RSS](/packages/ovesio-ovesio-php/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (5)DependenciesVersions (6)Used By (0)

Ovesio PHP SDK
==============

[](#ovesio-php-sdk)

A lightweight, fluent PHP client for interacting with the [Ovesio API](https://api.ovesio.com/docs/) and [Ovesio AI platform](https://ovesio.com).

🔐 Getting Started
-----------------

[](#-getting-started)

To use this SDK, you must have an account on . After registration, you'll be able to:

- Create and manage **projects**
- Retrieve a unique **API Key** per project
- Monitor API usage and translation stats

👉 Each project has its own API key, which must be used in API requests. You can find it in your Ovesio dashboard under **Settings → API Token**.

---

📦 Installation
--------------

[](#-installation)

```
composer require ovesio/ovesio-php
```

---

⚙️ Requirements
---------------

[](#️-requirements)

- PHP >= 7.1
- cURL enabled

---

🚀 What This SDK Can Do
----------------------

[](#-what-this-sdk-can-do)

This library allows you to:

- Send translation requests to Ovesio
- Generate product descriptions using AI
- Generate SEO meta tags
- Retrieve translation/generation status
- List workflows
- List supported languages
- Handle asynchronous callbacks from Ovesio

---

🔧 Basic Usage Example
---------------------

[](#-basic-usage-example)

```
use Ovesio\OvesioAI;

$client = new OvesioAI('YOUR_API_KEY');

$response = $client->translate()
    ->from('en')
    ->to(['fr', 'de'])
    ->workflow(1)
    ->data([
        [
            'key' => 'title',
            'value' => 'Awesome Product',
            'context' => 'E-commerce / Electronics'
        ],
        [
            'key' => 'desc',
            'value' => '' // this will be filtered out if filterByValue() is called
        ]
    ], 'ref-123')
    ->filterByValue() // optional: remove empty values
    ->request();

print_r($response);
```

### 🔄 Check Status

[](#-check-status)

```
$status = $client->translate()->status($response['data'][0]['id']);
print_r($status);
```

---

🧠 Features by Endpoint
----------------------

[](#-features-by-endpoint)

### ➤ Translation

[](#-translation)

```
$client->translate()
    ->from('en')
    ->to('fr')
    ->callbackUrl('https://yourdomain.com/callback')
    ->data([
        [
            'key' => 'name',
            'value' => 'Modern Chair',
            'context' => 'Furniture Product Title'
        ],
        [
            'key' => 'description',
            'value' => '',
            'context' => 'Product Description'
        ]
    ], 'product-102')
    ->filterByValue() // optional
    ->request();
```

### ➤ Generate Description

[](#-generate-description)

```
$client->generateDescription()
    ->workflow(2)
    ->to('en')
    ->data([
        'name' => 'HP MT43 Laptop',
        'categories' => ['Laptop', 'Second Hand'],
        'description' => 'Compact, powerful and affordable.',
        'additional' => [
            'RAM: 8GB',
            'Storage: 256GB SSD'
        ]
    ], 'ref-laptop')
    ->request();
```

### ➤ Generate SEO Meta

[](#-generate-seo-meta)

```
$client->generateSeo()
    ->workflow(3)
    ->to('en')
    ->data([
        'name' => 'iPhone 14 Pro Max',
        'categories' => ['Phones', 'Apple'],
        'description' => 'Latest flagship Apple phone.',
        'additional' => [
            'Camera: 48MP',
            'Chipset: A16 Bionic'
        ]
    ], 'ref-iphone')
    ->request();
```

### ➤ List Workflows

[](#-list-workflows)

```
$workflows = $client->workflow()->list();
```

### ➤ List Languages

[](#-list-languages)

```
$languages = $client->languages()->list();
```

### ➤ Handle Callbacks

[](#-handle-callbacks)

```
use Ovesio\Callback\CallbackHandler;

$callback = new CallbackHandler();
$data = $callback->handle();

if (!$data) {
    $callback->fail('Invalid callback payload');
    exit;
}

// process $data ...
$callback->success();
```

---

📂 Example Files
---------------

[](#-example-files)

All example files can be found in the `/examples` directory:

FileDescription`translate.php`Send a translation request and fetch status`generate_description.php`Generate product description and fetch status`generate_seo.php`Generate SEO meta tags and fetch status`workflows.php`List available workflows`languages.php`List available languages`callback.php`Handle and log Ovesio callback requests---

📚 Documentation
---------------

[](#-documentation)

- [Ovesio Official Docs](https://ovesio.com/docs/)
- [API Reference](https://api.ovesio.com/docs/)

---

🛠 Maintainer
------------

[](#-maintainer)

**Ovesio**

---

📄 License
---------

[](#-license)

This SDK is open-sourced under the MIT license.

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance57

Moderate activity, may be stable

Popularity16

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity35

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~3 days

Total

5

Last Release

287d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/0b07319ff9efa151b73ec9735d570ed3d32fdd2e6eca45db2f69a2330a2af08e?d=identicon)[aweb](/maintainers/aweb)

---

Top Contributors

[![marius-darock](https://avatars.githubusercontent.com/u/98028837?v=4)](https://github.com/marius-darock "marius-darock (16 commits)")

### Embed Badge

![Health badge](/badges/ovesio-ovesio-php/health.svg)

```
[![Health](https://phpackages.com/badges/ovesio-ovesio-php/health.svg)](https://phpackages.com/packages/ovesio-ovesio-php)
```

###  Alternatives

[stripe/stripe-php

Stripe PHP Library

4.0k143.3M480](/packages/stripe-stripe-php)[twilio/sdk

A PHP wrapper for Twilio's API

1.6k92.9M272](/packages/twilio-sdk)[facebook/php-business-sdk

PHP SDK for Facebook Business

90821.9M34](/packages/facebook-php-business-sdk)[meilisearch/meilisearch-php

PHP wrapper for the Meilisearch API

74513.7M114](/packages/meilisearch-meilisearch-php)[google/gax

Google API Core for PHP

265103.1M454](/packages/google-gax)[google/common-protos

Google API Common Protos for PHP

173103.7M50](/packages/google-common-protos)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)