PHPackages                             asmi046/laravel-jsonld - 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. asmi046/laravel-jsonld

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

asmi046/laravel-jsonld
======================

Laravel package for rendering JSON-LD schema entities (Person, Organization, Article, Product, WebSite) with a fluent facade API

0.1.2(2mo ago)06MITPHPPHP ^8.1CI failing

Since Apr 9Pushed 2mo agoCompare

[ Source](https://github.com/asmi046/json_ld)[ Packagist](https://packagist.org/packages/asmi046/laravel-jsonld)[ Docs](https://github.com/asmi046/json_ld)[ RSS](/packages/asmi046-laravel-jsonld/feed)WikiDiscussions main Synced 2w ago

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

Laravel JSON-LD
===============

[](#laravel-json-ld)

Пакет для Laravel, который рендерит schema-сущности JSON-LD через fluent API фасада. Поддерживает типы Person, Organization, Article, Product, WebSite, LocalBusiness, TravelAgency и TouristTrip, а также строгую валидацию и интеграцию с Blade.

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

[](#installation)

```
composer require asmi046/laravel-jsonld
```

Configuration
-------------

[](#configuration)

Опубликуйте конфигурационный файл:

```
php artisan vendor:publish --tag=jsonld-config
```

### Configuration Options

[](#configuration-options)

```
// config/jsonld.php
return [
    // Включить строгую валидацию (обязательные поля должны быть заполнены)
    'strict' => true,

    // Красивое форматирование JSON
    'pretty_print' => false,

    // Режим экранирования HTML: 'none', 'json_encode', 'htmlspecialchars'
    'escape_mode' => 'json_encode',

    // Флаги json_encode
    'json_flags' => JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE,
];
```

Usage
-----

[](#usage)

### Fluent Builder API

[](#fluent-builder-api)

```
use Asmi\JsonLd\Facades\JsonLd;

// Person
$person = JsonLd::person()
    ->name('John Doe')
    ->jobTitle('Software Developer')
    ->email('john@example.com')
    ->url('https://johndoe.com')
    ->render();

// Organization
$org = JsonLd::organization()
    ->name('Acme Corporation')
    ->url('https://acme.com')
    ->logo('https://acme.com/logo.png')
    ->email('contact@acme.com')
    ->telephone('+1-555-0100')
    ->render();

// Article
$article = JsonLd::article()
    ->headline('Understanding JSON-LD')
    ->description('Learn how to use JSON-LD for structured data...')
    ->datePublished('2026-04-09')
    ->dateModified('2026-04-10')
    ->image('https://example.com/image.jpg')
    ->author(JsonLd::person()->name('Jane Smith'))
    ->render();

// Product
$product = JsonLd::product()
    ->name('Awesome Product')
    ->description('The best product ever')
    ->price(99.99)
    ->priceCurrency('USD')
    ->image('https://example.com/product.jpg')
    ->brand(JsonLd::organization()->name('Brand Inc'))
    ->url('https://example.com/product')
    ->render();

// WebSite
$website = JsonLd::website()
    ->name('My Website')
    ->url('https://example.com')
    ->description('Welcome to my website')
    ->logo('https://example.com/logo.png')
    ->render();

// LocalBusiness
$localBusiness = JsonLd::localBusiness()
    ->name('Кофейня на Арбате')
    ->url('https://coffeeshop.ru')
    ->telephone('+7-495-000-0000')
    ->address('Арбат, 10, Москва')
    ->openingHours('Mo-Fr 08:00-22:00')
    ->priceRange('$$')
    ->geo(['@type' => 'GeoCoordinates', 'latitude' => 55.7522, 'longitude' => 37.5722])
    ->paymentAccepted(['Cash', 'Credit Card'])
    ->render();

// TravelAgency
$travelAgency = JsonLd::travelAgency()
    ->name('Путешествия мечты')
    ->url('https://dream-travel.ru')
    ->telephone('+7-800-000-0000')
    ->email('info@dream-travel.ru')
    ->openingHours('Mo-Su 09:00-21:00')
    ->areaServed(['Россия', 'Европа', 'Азия'])
    ->serviceType('Туристические туры')
    ->render();

// TouristTrip
$trip = JsonLd::touristTrip()
    ->name('Золотое кольцо на выходные')
    ->description('Культурный тур по древним городам России')
    ->startDate('2026-06-01')
    ->endDate('2026-06-03')
    ->touristType(['Семьи', 'Пары'])
    ->itinerary(['Москва', 'Сергиев Посад', 'Суздаль'])
    ->provider(JsonLd::travelAgency()->name('Путешествия мечты'))
    ->render();
```

### Factory API

[](#factory-api)

```
// Создание сущности через метод make
$person = JsonLd::make('Person', [
    'name' => 'John Doe',
    'jobTitle' => 'Developer',
    'email' => 'john@example.com',
])->render();

$org = JsonLd::make('Organization', [
    'name' => 'Acme Corp',
    'url' => 'https://acme.com',
])->render();

$localBusiness = JsonLd::make('LocalBusiness', [
    'name' => 'Кофейня на Арбате',
    'telephone' => '+7-495-000-0000',
    'openingHours' => 'Mo-Fr 08:00-22:00',
])->render();

$travelAgency = JsonLd::make('TravelAgency', [
    'name' => 'Путешествия мечты',
    'areaServed' => ['Россия', 'Европа'],
    'serviceType' => 'Туристические туры',
])->render();

$trip = JsonLd::make('TouristTrip', [
    'name' => 'Золотое кольцо на выходные',
    'startDate' => '2026-06-01',
    'endDate' => '2026-06-03',
    'touristType' => ['Семьи', 'Пары'],
])->render();
```

### Using Helper Functions

[](#using-helper-functions)

```
// Fluent helper-функции
$person = jsonld_person()
    ->name('John Doe')
    ->jobTitle('Developer')
    ->render();

$org = jsonld_organization()->name('Acme Corp')->render();
$article = jsonld_article()->headline('My Post')->datePublished('2026-04-09')->render();
$product = jsonld_product()->name('Product')->price(99.99)->render();
$website = jsonld_website()->name('Site')->url('https://example.com')->render();
$localBusiness = jsonld_local_business()->name('Кофейня')->openingHours('Mo-Fr 08:00-22:00')->render();
$travelAgency = jsonld_travel_agency()->name('Агентство')->areaServed('Россия')->render();
$trip = jsonld_tourist_trip()->name('Тур')->startDate('2026-06-01')->render();

// Factory helper
$person = jsonld_make('Person', ['name' => 'John']);
$localBusiness = jsonld_make('LocalBusiness', ['name' => 'Кофейня']);
$travelAgency = jsonld_make('TravelAgency', ['name' => 'Агентство']);
$trip = jsonld_make('TouristTrip', ['name' => 'Тур']);
```

### In Blade Templates

[](#in-blade-templates)

```

@jsonld($person)

{{ $article->render() }}

{{ JsonLd::person()->name('John')->render() }}
```

### Getting Different Output Formats

[](#getting-different-output-formats)

```
$person = JsonLd::person()->name('John Doe');

// Рендер как HTML script tag (по умолчанию)
echo $person->render();

// Получить как JSON-строку
$json = $person->toJson();

// Получить как PHP-массив
$array = $person->toArray();
```

Entity Types
------------

[](#entity-types)

### Person

[](#person)

**Обязательные поля**: `name`

**Основные поля**:

- `name` - Полное имя
- `email` - Email-адрес
- `jobTitle` - Должность
- `url` - URL сайта
- `image` - URL изображения профиля
- `telephone` - Телефон
- `description` - Биография или описание
- `affiliation` - Связанная организация
- `address` - Физический адрес

### Organization

[](#organization)

**Обязательные поля**: `name`

**Основные поля**:

- `name` - Название организации
- `url` - URL сайта
- `logo` - URL логотипа
- `description` - Описание организации
- `email` - Контактный email
- `telephone` - Контактный телефон
- `address` - Физический адрес
- `location` - Информация о местоположении
- `sameAs` - Массив ссылок на соцсети
- `contactPoint` - Данные контактной точки

### Article

[](#article)

**Обязательные поля**: `headline`, `datePublished`

**Основные поля**:

- `headline` - Заголовок статьи
- `description` - Описание/анонс статьи
- `image` - URL главного изображения
- `author` - Person или Organization (см. Person/Organization)
- `datePublished` - Дата публикации (ISO 8601)
- `dateModified` - Дата последнего изменения
- `url` - URL статьи
- `articleBody` - Полный текст статьи
- `keywords` - Ключевые слова
- `publisher` - Организация-издатель
- `articleSection` - Раздел/категория статьи

### Product

[](#product)

**Обязательные поля**: `name`

**Основные поля**:

- `name` - Название товара
- `description` - Описание товара
- `image` - URL изображения товара
- `brand` - Бренд (Organization)
- `price` - Цена
- `priceCurrency` - Код валюты (USD, EUR и т.д.)
- `url` - URL товара
- `availability` - Статус наличия
- `rating` - Объект рейтинга
- `review` - Объект отзыва
- `manufacturer` - Производитель (Organization)
- `sku` - Артикул товара

### WebSite

[](#website)

**Обязательные поля**: `name`, `url`

**Основные поля**:

- `name` - Название сайта
- `url` - URL сайта
- `description` - Описание сайта
- `image` - Изображение сайта
- `logo` - URL логотипа
- `language` - Код языка
- `potentialAction` - Действия (например SearchAction)
- `copyrightHolder` - Правообладатель
- `author` - Автор сайта

### LocalBusiness

[](#localbusiness)

Наследует все поля `Organization`. Представляет физическое местное заведение.

**Обязательные поля**: `name`

**Основные поля (унаследованы от Organization)**:

- `name` - Название заведения
- `url` - URL сайта
- `telephone` - Телефон
- `email` - Email
- `address` - Физический адрес
- `logo` - URL логотипа
- `description` - Описание
- `sameAs` - Ссылки на соцсети

**Специфичные поля**:

- `openingHours` - Часы работы (например `Mo-Fr 08:00-22:00`)
- `priceRange` - Ценовой диапазон (`$`, `$$`, `$$$` и т.д.)
- `geo` - Географические координаты (`@type: GeoCoordinates`, `latitude`, `longitude`)
- `paymentAccepted` - Принимаемые способы оплаты (строка или массив)

### TravelAgency

[](#travelagency)

Наследует все поля `LocalBusiness`. Представляет туристическое агентство.

**Обязательные поля**: `name`

**Специфичные поля**:

- `areaServed` - Обслуживаемые регионы (строка или массив)
- `serviceType` - Тип туристических услуг

### TouristTrip

[](#touristtrip)

Представляет туристическую поездку/тур.

**Обязательные поля**: `name`

**Основные поля**:

- `name` - Название тура
- `description` - Описание тура
- `startDate` - Дата начала (ISO 8601)
- `endDate` - Дата окончания (ISO 8601)
- `itinerary` - Маршрут или программа тура (строка или массив)
- `offers` - Коммерческое предложение (например `Offer`)
- `touristType` - Целевая аудитория туристов (строка или массив)
- `provider` - Организатор тура (`Organization`, `TravelAgency` или массив)

Validation
----------

[](#validation)

Пакет проверяет обязательные поля в строгом режиме (включен по умолчанию). При ошибках валидации выбрасывается `ValidationException` с детализацией по полям:

```
use Asmi\JsonLd\Exceptions\ValidationException;

try {
    $person = JsonLd::person()->render(); // Отсутствует обязательное поле 'name'
} catch (ValidationException $e) {
    $errors = $e->getErrors();
    // ['name' => "Required field 'name' is missing."]
}
```

Отключить строгую валидацию:

```
// In config/jsonld.php
'strict' => false,

// Или временно
config(['jsonld.strict' => false]);
$person = JsonLd::person()->render(); // Исключение выброшено не будет
```

Пример вывода
-------------

[](#пример-вывода)

```

  {
    "@context": "https://schema.org",
    "@type": "Person",
    "name": "John Doe",
    "jobTitle": "Developer",
    "email": "john@example.com"
  }

```

С включенным `pretty_print`:

```

  {
    "@context": "https://schema.org",
    "@type": "Person",
    "name": "John Doe",
    "jobTitle": "Developer",
    "email": "john@example.com"
  }

```

Testing
-------

[](#testing)

```
php vendor/bin/phpunit

# С coverage
php vendor/bin/phpunit --coverage-html coverage
```

Contributing
------------

[](#contributing)

Подробности смотрите в [CONTRIBUTING.md](CONTRIBUTING.md).

License
-------

[](#license)

Лицензия MIT. Подробности в [LICENSE](LICENSE).

###  Health Score

34

—

LowBetter than 75% of packages

Maintenance85

Actively maintained with recent releases

Popularity5

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity34

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

Total

2

Last Release

78d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/82546eccf00e12fd428905da0d56b9b6768dda504bb944dfb3573c5fa8ce90e2?d=identicon)[asmi046](/maintainers/asmi046)

---

Top Contributors

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

---

Tags

laravelJSON-LDseostructured-dataschema-org

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/asmi046-laravel-jsonld/health.svg)

```
[![Health](https://phpackages.com/badges/asmi046-laravel-jsonld/health.svg)](https://phpackages.com/packages/asmi046-laravel-jsonld)
```

###  Alternatives

[psalm/plugin-laravel

Psalm plugin for Laravel

3345.1M337](/packages/psalm-plugin-laravel)[artesaos/seotools

SEO Tools for Laravel and Lumen

3.4k5.3M63](/packages/artesaos-seotools)[livewire/flux

The official UI component library for Livewire.

9476.8M122](/packages/livewire-flux)[moonshine/moonshine

Laravel administration panel

1.3k239.9k76](/packages/moonshine-moonshine)[webwizo/laravel-shortcodes

Wordpress like shortcodes for Laravel 11, 12 and 13

217685.2k8](/packages/webwizo-laravel-shortcodes)[larament/seokit

A complete SEO package for Laravel, covering everything from meta tags to social sharing and structured data.

452.5k](/packages/larament-seokit)

PHPackages © 2026

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