PHPackages                             eram/ersal - 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. [Utility & Helpers](/categories/utility)
4. /
5. eram/ersal

ActiveLibrary[Utility & Helpers](/categories/utility)

eram/ersal
==========

A simple, type-safe PHP library for Iranian shipping and courier services.

v0.2.0-beta.1(3mo ago)10MITPHPPHP ^8.1CI passing

Since Apr 16Pushed 3mo agoCompare

[ Source](https://github.com/eramhq/ersal)[ Packagist](https://packagist.org/packages/eram/ersal)[ Docs](https://github.com/eramhq/ersal)[ RSS](/packages/eram-ersal/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (2)Dependencies (4)Versions (3)Used By (0)

Ersal
=====

[](#ersal)

A unified, type-safe PHP library for Iranian shipping and courier services.

[![Tests](https://github.com/eramhq/ersal/actions/workflows/tests.yml/badge.svg)](https://github.com/eramhq/ersal/actions)[![License: MIT](https://camo.githubusercontent.com/08cef40a9105b6526ca22088bc514fbfdbc9aac1ddbf8d4e6c750e3a88a44dca/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d626c75652e737667)](LICENSE)[![PHP](https://camo.githubusercontent.com/ef363a5a30025ffef1857918c40fa01e97f03929e5f87d12a14bf334a7de9220/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253545382e312d3838393242462e737667)](https://php.net/)

**Documentation:** [English](docs/en/README.md) | [فارسی](docs/fa/README.md)

What is Ersal?
--------------

[](#what-is-ersal)

Ersal (ارسال, "shipping" in Farsi) is an omni-carrier PHP library that gives you a single, consistent API across **major Iranian shipping providers** — from national postal services to private couriers and on-demand urban delivery. Write your shipping logic once, swap the carrier with one line of config.

**Why Ersal?**

- **Minimal dependencies** — one internal Composer package ([`eram/abzar`](https://github.com/eramhq/abzar-php), Persian/Iranian utilities) plus the standard PHP extensions `ext-curl`, `ext-json`, `ext-openssl`, `ext-soap`. No Guzzle, no framework coupling, no third-party supply-chain risk.
- **One interface, every carrier** — `quote()` → `createShipment()` → `track()` → `cancel()`. Same flow whether it's Iran Post or Alopeyk.
- **Type-safe value objects** — `Address`, `Parcel`, `ShipmentStatus`, `TrackingEvent` — no stringly-typed dictionaries.
- **Integer units everywhere** — grams for weight, millimeters for dimensions, Rials for money. Zero floating-point drift.
- **Framework-agnostic** — works with Laravel, Symfony, or plain PHP. Plug in your own HTTP client, logger, or event dispatcher.
- **Fully tested** — unit tests for every provider, PHPStan static analysis, PER-CS2 code style.

Install
-------

[](#install)

```
composer require eram/ersal
```

Supported Carriers
------------------

[](#supported-carriers)

AliasCarrierProtocolCapabilitiesDocs`post`Iran Post (شرکت پست)SOAP + RESTLabel, Branches[Guide](docs/en/providers/post.md)`tipax`Tipax (تیپاکس)RESTLabel, Pickup, Branches, COD[Guide](docs/en/providers/tipax.md)`chapar`Chapar ExpressRESTLabel, Pickup, COD[Guide](docs/en/providers/chapar.md)`mahex`Mahex (ماهکس)RESTPickup, COD[Guide](docs/en/providers/mahex.md)`amadast`Amadast (آمادست)REST—[Guide](docs/en/providers/amadast.md)`paygan`Paygan (پایگان)RESTCOD[Guide](docs/en/providers/paygan.md)`alopeyk`Alopeyk (الوپیک)RESTPickup[Guide](docs/en/providers/alopeyk.md)Quick Start
-----------

[](#quick-start)

The flow is always: **quote → book → track → (optionally) cancel**.

See the [Getting Started](docs/en/getting-started.md) guide for a complete walkthrough with code examples.

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

[](#documentation)

Full documentation with API reference, cookbook, per-carrier guides, and more:

- [English Documentation](docs/en/README.md)
- [مستندات فارسی](docs/fa/README.md)

About Eram
----------

[](#about-eram)

[Eram](https://github.com/eramhq) is a small engineering team building open-source developer tools for the Persian ecosystem. Our projects — [pardakht](https://github.com/eramhq/pardakht), [ersal](https://github.com/eramhq/ersal), [daynum](https://github.com/eramhq/daynum), [persian-kit](https://github.com/eramhq/persian-kit) — solve the everyday problems that Iranian developers run into: payment integration, shipping, calendar conversion, and string/number localization. Everything we ship is MIT-licensed, zero-dependency where possible, and built to be boring infrastructure you never have to think about.

License
-------

[](#license)

[MIT](LICENSE)

###  Health Score

31

—

LowBetter than 65% of packages

Maintenance82

Actively maintained with recent releases

Popularity2

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity30

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

2

Last Release

96d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/79f7082bc28725eab3841fb8e6d28a55302aa621b694cb8567e0a6c7b0013495?d=identicon)[mostafasoufi](/maintainers/mostafasoufi)

---

Top Contributors

[![mostafasoufi](https://avatars.githubusercontent.com/u/701520?v=4)](https://github.com/mostafasoufi "mostafasoufi (6 commits)")

---

Tags

alopeykamadastchaparersaliranmahexparcepaygantipaxtrackingtrackingshippingdeliverypostiranpersiancourierlogisticsparceliranianAloPeykcash-on-deliveryersaltipaxchaparmahexamadastpaygan

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/eram-ersal/health.svg)

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

###  Alternatives

[sylius/shipping

Flexible shipping component for PHP e-commerce projects.

13225.7k12](/packages/sylius-shipping)

PHPackages © 2026

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