PHPackages                             og-soft/laravel-openapi-value-object - 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. [HTTP & Networking](/categories/http)
4. /
5. og-soft/laravel-openapi-value-object

ActiveLibrary[HTTP & Networking](/categories/http)

og-soft/laravel-openapi-value-object
====================================

Generate OpenAPI Specification for Laravel Applications from value objects

1.0.4(5y ago)01.1kMITPHPPHP ^8.0

Since Mar 2Pushed 5y ago1 watchersCompare

[ Source](https://github.com/FandaOG/laravel-openapi-value-object)[ Packagist](https://packagist.org/packages/og-soft/laravel-openapi-value-object)[ RSS](/packages/og-soft-laravel-openapi-value-object/feed)WikiDiscussions main Synced 6d ago

READMEChangelog (5)Dependencies (5)Versions (6)Used By (0)

laravel-openapi-value-object
============================

[](#laravel-openapi-value-object)

This library extends [vyuldashev/laravel-openapi](https://github.com/vyuldashev/laravel-openapi). Main idea is do not create a scheme manually:

```
class UserCreateRequestBody extends RequestBodyFactory
{
    public function build(): RequestBody
    {
        return RequestBody::create('UserCreate')
            ->description('User data')
            ->content(
                MediaType::json()->schema(UserSchema::ref())
            );
    }
}
```

The library get any PHP class and schema is autogenerated from class attributes. You should use PHP doc:

```
class CarRequest
{
	/**
	 * Car name name = $name;
		return $this;
	}

	/**
	 * @return int
	 */
	public function getEnginePower(): int
	{
		return $this->enginePower;
	}

	/**
	 * @param int $enginePower
	 * @return CarValueObject
	 */
	public function setEnginePower(int $enginePower): CarValueObject
	{
		$this->enginePower = $enginePower;
		return $this;
	}

	/**
	 * @return WheelValueObject[]
	 */
	public function getWheels(): array
	{
		return $this->wheels;
	}

	/**
	 * @param WheelValueObject[] $wheels
	 * @return CarValueObject
	 */
	public function setWheels(WheelValueObject ...$wheels): CarValueObject
	{
		$this->wheels = $wheels;
		return $this;
	}
}
```

Output is:

```
(...)
'properties' =>
[
    'name' =>
        [
            'title' => 'Car name',
            'description' => 'This is a car name description...',
            'type' => 'string',
            'nullable' => false,
        ],
    'enginePower' =>
        [
            'title' => 'Engine power in kW',
            'description' => 'More is better',
            'type' => 'integer',
            'nullable' => false,
        ],
    'wheels' =>
        [
            'title' => 'Wheels of car',
            'description' => 'It is necessary to move',
            'type' => 'array',
            'items' =>
                [
                    'type' => 'object',
                    'properties' =>
                        [
                            'size' =>
                                [
                                    'type' => 'integer',
                                    'nullable' => true,
                                ],
                            'tire' =>
                                [
                                    'type' => 'object',
                                    'properties' =>
                                        [
                                            'winter' =>
                                                [
                                                    'type' => 'boolean',
                                                    'nullable' => false,
                                                ],
                                        ],
                                ],
                        ],
                ],
            'nullable' => false,
        ],
]
(...)
```

Usage
=====

[](#usage)

Check `examples/cartore/CarController.php` controller and `exmples/carstore/OpenApi` directory.

TODO
====

[](#todo)

Update `composer.json` after [pull request](https://github.com/vyuldashev/laravel-openapi/pull/37) is accepted.

Changes
=======

[](#changes)

- 2021-03-05 - support `@example`

###  Health Score

29

—

LowBetter than 59% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity17

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity61

Established project with proven stability

 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 ~0 days

Total

5

Last Release

1900d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/44e506c08062b165a9e96f2657a13a9f0921d53b015dd74ad9532c797c90e8a0?d=identicon)[Fanda](/maintainers/Fanda)

---

Top Contributors

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

---

Tags

apilaravelrestdocumentationswaggeropenapidocs

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/og-soft-laravel-openapi-value-object/health.svg)

```
[![Health](https://phpackages.com/badges/og-soft-laravel-openapi-value-object/health.svg)](https://phpackages.com/packages/og-soft-laravel-openapi-value-object)
```

###  Alternatives

[vyuldashev/laravel-openapi

Generate OpenAPI Specification for Laravel Applications

4571.2M](/packages/vyuldashev-laravel-openapi)[api-platform/core

Build a fully-featured hypermedia or GraphQL API in minutes!

2.6k48.1M236](/packages/api-platform-core)[tartanlegrand/laravel-openapi

Generate OpenAPI Specification for Laravel Applications

38178.7k2](/packages/tartanlegrand-laravel-openapi)[api-platform/laravel

API Platform support for Laravel

59126.4k6](/packages/api-platform-laravel)[noitran/opendox

OpenApi(Swagger) 3.0 package for Lumen 5.5+ and Laravel 5.5+ with REDOC UI and SwaggerUI 3

2313.9k](/packages/noitran-opendox)[vanderlee/swaggergen

Generate Swagger/OpenAPI documentation from simple PHPdoc-like comments in PHP source code.

42127.9k3](/packages/vanderlee-swaggergen)

PHPackages © 2026

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