PHPackages                             xbyter/php-object-mapping - 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. xbyter/php-object-mapping

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

xbyter/php-object-mapping
=========================

PHP对象映射，可以将array/object映射为类对象。可做参数的传递、Request参数映射、Entity、Bean等

v1.0.1(2y ago)284MITPHPPHP ^7.4 || ^8.0

Since Jul 6Pushed 2y ago1 watchersCompare

[ Source](https://github.com/xbyter/php-object-mapping)[ Packagist](https://packagist.org/packages/xbyter/php-object-mapping)[ Docs](https://github.com/xbyter/php-object-mapping)[ RSS](/packages/xbyter-php-object-mapping/feed)WikiDiscussions master Synced today

READMEChangelogDependencies (1)Versions (3)Used By (0)

php-object-mapping
==================

[](#php-object-mapping)

说明
==

[](#说明)

PHP对象映射，可以将array/object映射为类对象。可做参数的传递、Request参数映射、Entity、Bean等。并可根据定义的映射对象生成API文档。

示例
==

[](#示例)

```
class TestMapping extends BaseMapping
{
    /** @var int 总数 */
    public int $total;

    public ?TestItem $item = null;

    /** @var \Xbyter\PhpObjectMappingTests\Data\TestItem[] 列表对象 */
    public array $list = [];

    /** @var string 受保护的值，不会被设置 */
    protected string $protected_key = 'protected value';
}

class TestItem extends BaseMapping
{
    /** @var string|null 标题 */
    public ?string $title = null;

    /**
     * @var string|null 会返回装饰过的值
     * @return TitleDecorator
     */
    public ?string $decorate_title = null;
}

//装饰类
class TitleDecorator implements DecoratorInterface
{

    public function decorate($value)
    {
        return sprintf("this is a decorated value: %s", $value);
    }
}

//映射对象，多维数组可用 TestMapping::fromList([[...], [...]]);
$testMapping = TestMapping::fromItem([
    'total' => 10,
    'item'  => [
        'title' => 'a'
    ],
    'list'  => [
        [
            'title' => 'b',
            'decorate_title' => 'c',
        ]
    ],
    'protected_key' => '受保护的字段不会被赋值',
]);

//转为数组
$array = $testMapping->toArray();

var_dump($testMapping->total); //10
var_dump($testMapping->item->title); //a
var_dump($testMapping->list[0]->title); //b
var_dump($testMapping->list[0]->decorate_title); //this is a decorated value: c
var_dump($testMapping->protected_key); //Error : Cannot access protected property $protected_key
```

###  Health Score

25

—

LowBetter than 35% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity12

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity50

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

Every ~1 days

Total

2

Last Release

1092d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/f99d7f145bf92288181ca5159ca57e88f65eb1bb1a8fcadf85315dfbe662153e?d=identicon)[X-Byter](/maintainers/X-Byter)

---

Top Contributors

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

---

Tags

beanentityjson-mapperjson-mappingmappingobject-fillobject-mapperobject-mappingrequest-mappingrequestentitymappingbeanobject-mappingobject-fill

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/xbyter-php-object-mapping/health.svg)

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

###  Alternatives

[cuyz/valinor

Dependency free PHP library that helps to map any input into a strongly-typed structure.

1.5k13.2M174](/packages/cuyz-valinor)[cornford/googlmapper

An easy way to integrate Google Maps with Laravel.

465452.7k4](/packages/cornford-googlmapper)[shapecode/hidden-entity-type-bundle

Hidden field for Symfony entities

28448.1k1](/packages/shapecode-hidden-entity-type-bundle)[ballen/distical

A distance (Lat/Long) calculation library for PHP

40199.2k2](/packages/ballen-distical)[smile/module-custom-entity

Smile - Custom Entity Module

37110.6k6](/packages/smile-module-custom-entity)[smile/module-custom-entity-product-link

Smile - Custom Entity Product link Module

3269.9k1](/packages/smile-module-custom-entity-product-link)

PHPackages © 2026

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