PHPackages                             ernadoo/mondial-relay - 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. ernadoo/mondial-relay

ActiveLibrary

ernadoo/mondial-relay
=====================

Mondial Relay API client — V2 REST (label creation) + SOAP (relay point search)

v3.0.0(3w ago)0131MITPHPPHP ^8.2CI passing

Since Apr 19Pushed 3w ago1 watchersCompare

[ Source](https://github.com/ErnadoO/mondial-relay)[ Packagist](https://packagist.org/packages/ernadoo/mondial-relay)[ RSS](/packages/ernadoo-mondial-relay/feed)WikiDiscussions master Synced today

READMEChangelog (1)Dependencies (2)Versions (2)Used By (1)

ernadoo/mondial-relay
=====================

[](#ernadoomondial-relay)

PHP client for the Mondial Relay shipping API. Framework-agnostic.

- **Label creation** — V2 REST API (production + sandbox)
- **Relay point search** — V1 SOAP API (MR has not yet published a V2 REST endpoint for this)

Requirements
------------

[](#requirements)

- PHP 8.2+
- `ext-curl`, `ext-soap`, `ext-simplexml`

Installation
------------

[](#installation)

```
composer require ernadoo/mondial-relay
```

Quick start
-----------

[](#quick-start)

```
use Ernadoo\MondialRelay\MondialRelayClient;
use Ernadoo\MondialRelay\Shipment\Address;
use Ernadoo\MondialRelay\Shipment\DeliveryMode;
use Ernadoo\MondialRelay\Shipment\Parcel;
use Ernadoo\MondialRelay\Shipment\ShipmentRequest;

$client = MondialRelayClient::create(
    login:      'YOUR_LOGIN',
    password:   'YOUR_PASSWORD',
    customerId: 'YOUR_CUSTOMER_ID',
    secretKey:  'YOUR_SECRET_KEY',
    sandbox:    true, // false in production
);

$request = new ShipmentRequest(
    sender:    new Address('FR', '59510', 'Hem', '4 Av. Antoine Pinay', 'Erwan', 'Nader', mobileNo: '+33600000000'),
    recipient: new Address('FR', '75001', 'Paris', '1 Rue de la Paix', 'Jane', 'Doe', mobileNo: '+33600000001'),
    parcels:   [new Parcel(weightGrams: 500, content: 'Vêtements')],
    // deliveryLocation left empty = "Notif Destinataire":
    // Mondial Relay notifies the recipient by SMS so they choose their relay point.
);

$response = $client->createShipment($request);

echo $response->shipmentNumber; // e.g. "12345678"
echo $response->labelOutput;    // PDF URL to download the label
echo $response->trackingUrl;    // Public tracking link
```

Documentation
-------------

[](#documentation)

- [Installation & credentials](docs/01-installation.md)
- [Creating shipment labels](docs/02-shipment.md)
- [Searching relay points](docs/03-parcel-shop-search.md)

Tests
-----

[](#tests)

```
composer install
vendor/bin/phpunit
```

###  Health Score

41

—

FairBetter than 89% of packages

Maintenance95

Actively maintained with recent releases

Popularity8

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity46

Maturing project, gaining track record

 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

Unknown

Total

1

Last Release

22d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/f795c1c99e312237edefde78586d80ee0e49bcbe316842c9796d185c74d52daa?d=identicon)[ErnadoO](/maintainers/ErnadoO)

---

Top Contributors

[![ErnadoO](https://avatars.githubusercontent.com/u/6375756?v=4)](https://github.com/ErnadoO "ErnadoO (10 commits)")

---

Tags

labelshippingcarriermondial-relayrelay-point

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/ernadoo-mondial-relay/health.svg)

```
[![Health](https://phpackages.com/badges/ernadoo-mondial-relay/health.svg)](https://phpackages.com/packages/ernadoo-mondial-relay)
```

###  Alternatives

[dvdoug/boxpacker

An implementation of the 3D (actually 4D) bin packing/knapsack problem (aka creating parcels by putting items into boxes)

6522.7M18](/packages/dvdoug-boxpacker)[gabrielbull/ups-api

PHP UPS API

4642.4M10](/packages/gabrielbull-ups-api)[easypost/easypost-php

EasyPost Shipping API Client Library for PHP

1753.1M5](/packages/easypost-easypost-php)[shippo/shippo-php

A PHP library for connecting with multiple carriers (FedEx, UPS, USPS) using Shippo.

1711.8M2](/packages/shippo-shippo-php)[firstred/postnl-api-php

PostNL REST API PHP Bindings

27610.2k1](/packages/firstred-postnl-api-php)[sylius/shipping

Flexible shipping component for PHP e-commerce projects.

13209.1k8](/packages/sylius-shipping)

PHPackages © 2026

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