PHPackages                             ydn/tracking - 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. [PSR & Standards](/categories/psr-standards)
4. /
5. ydn/tracking

ActiveLibrary[PSR & Standards](/categories/psr-standards)

ydn/tracking
============

Laravel package for ocean tracking API integration.

V1.0.0(1y ago)08MITPHPPHP ^8.0

Since Apr 24Pushed 1y ago1 watchersCompare

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

READMEChangelog (1)DependenciesVersions (2)Used By (0)

Ocean Tracking Laravel Package
==============================

[](#ocean-tracking-laravel-package)

Ocean Tracking 是一个轻量级的 Laravel 扩展包，用于集成外部 API 并跟踪国际海运物流状态。适用于需要追踪提单号、箱号、多段运输信息的跨境业务系统。

📦 安装 Installation
-----------------

[](#-安装-installation)

> 适配 Laravel 8.x 及以上版本

推荐使用本地路径方式安装：

```
composer require ydn/tracking
```

⚙️ 配置 Configuration
-------------------

[](#️-配置-configuration)

发布配置文件到主项目：

```
php artisan vendor:publish --tag=ocean-tracking-config
```

在 `config/ocean-tracking.php` 中配置：

```
return [
    // 使用 .env 中的配置自动初始化
    'baseUrl' => env('OCEAN_TRACKING_BASE_URL', 'https://api.example.com'),
    'companyid' => env('OCEAN_TRACKING_COMPANYID','0000'),
    'secret' => env('OCEAN_TRACKING_SECRET','YOUR-SECRET'),
];
```

🧬 数据库迁移 Migration
-----------------

[](#-数据库迁移-migration)

执行包内迁移文件：

```
php artisan migrate
```

或如需发布：

```
php artisan vendor:publish --tag=ocean-tracking-migrations
```

🚀 使用方式 Usage
------------

[](#-使用方式-usage)

### 📝 示例一：注册追踪信息

[](#-示例一注册追踪信息)

```
use Ocean\Tracking\Request\RegisterTrackingRequest;

try {
    $request = new RegisterTrackingRequest();
    $request -> setTracking('MSC','177PHYHYQXX007V'); //单个注册

    /* 批量注册
    $trackings = [
        [
            'carriercd' => 'CMA',
            'referenceno' => 'QGDXXXX832'
        ],[
            'carriercd' => 'MSC',
            'referenceno' => '177PHYHYQXX007V'
        ]
    ];
    $request -> setTrackings($trackings);
     */

    $res = $request -> post();
    var_dump($res -> getResults());
} catch (\Throwable $th) {
    var_dump($th -> getMessage());
}
```

### 📦 示例二：获取追踪信息

[](#-示例二获取追踪信息)

```
use Ocean\Tracking\Request\GetTrackingRequest;
try {
    $request = new GetTrackingRequest;
    //单个获取
    $request -> getTracking('MSC','177PHYHYQXX007V');

    /* 批量获取
    $trackings = [
        [
            'carriercd' => 'CMA',
            'referenceno' => 'QGDXXXX832'
        ],[
            'carriercd' => 'MSC',
            'referenceno' => '177PHYHYQXX007V'
        ]
    ];
    $request -> setTrackings($trackings);
     */

    $res = $request -> post();
    var_dump($res -> getData());
    if($res -> hasErrors()){
        var_dump($res -> getErrorMessages());
    }
} catch (\Throwable $th) {
    var_dump($th -> getMessage());
}
```

### 🔁 示例三：自动同步追踪数据

[](#-示例三自动同步追踪数据)

你可以使用以下方式同步并持久化追踪数据：

```
use Ocean\Tracking\Traits\HasTrackingFiller;

$this->updateOrCreate($apiResponse);
```

海运箱动态全量推送：

```
POST https://your-domin.com/api/ocean-tracking
```

传入参数（keyid 和 referenceno），会自动更新主表、航程、箱信息及状态节点。

📡 API 对接 API Integration
------------------------

[](#-api-对接-api-integration)

本包默认支持：

- 提单号和箱号追踪
- 多段航程 lstcarriage
- 每个箱子的完整追踪状态 lstLinertrackingStatus

你也可以通过 HTTP 客户端扩展 `OceanTracking::generateToken()` 等方法。

📚 License
---------

[](#-license)

MIT

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance47

Moderate activity, may be stable

Popularity4

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity42

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

389d ago

### Community

Maintainers

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

---

Top Contributors

[![AndyMoxq](https://avatars.githubusercontent.com/u/165084870?v=4)](https://github.com/AndyMoxq "AndyMoxq (7 commits)")

---

Tags

containerlaraveltrackinglogisticsocean

### Embed Badge

![Health badge](/badges/ydn-tracking/health.svg)

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

###  Alternatives

[nunomaduro/laravel-pot

Set of commands to inspect Laravel's container

991.6k](/packages/nunomaduro-laravel-pot)[daylerees/container-debug

Inspect the Laravel IoC Container from Artisan.

572.8k](/packages/daylerees-container-debug)[godruoyi/easy-container

A small PHP 5.3 dependency injection container extended from Laravel container.

334.9k2](/packages/godruoyi-easy-container)[phpwatch/simple-container

A fast and minimal PSR-11 compatible Dependency Injection Container with array-syntax and without auto-wiring

1810.1k2](/packages/phpwatch-simple-container)

PHPackages © 2026

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