spryker/api-platform

ApiPlatform module

0.1.0 2025-12-04 11:50 UTC

Requires

• php: >=8.3
• api-platform/api-pack: ^1.4.0
• api-platform/hal: ^4.2.0
• api-platform/json-api: ^4.2.0
• api-platform/metadata: ^4.2.0
• api-platform/state: ^4.2.0
• spryker/log: ^3.0.0
• symfony/config: ^6.0.0 || ^7.0.0
• symfony/console: ^6.0.0 || ^7.0.0
• symfony/finder: ^6.0.0 || ^7.0.0
• symfony/http-kernel: ^6.0.0 || ^7.0.0
• symfony/yaml: ^6.0.0 || ^7.0.0

Requires (Dev)

• spryker/code-sniffer: *
• spryker/console: *
• spryker/symfony: *
• spryker/testify: *

proprietary

• api
• schema
• api-platform
• code-generation
• spryker

README

Spryker API Platform Module

Use this module to integrate the API Platform into a Spryker project. A schema-based code generator for API Platform resources in Spryker applications. Define your API resources using YAML schemas and automatically generate PHP classes with full API Platform attribute support.

Overview

This module provides a developer-friendly way to define API Platform resources through declarative schema files, similar to Spryker's Transfer object pattern. Resources can be defined across core, feature, and project layers with automatic merging and validation.

Features

• 📝 Schema-based Definition: Define resources using YAML
• 🔄 Multi-layer Support: Core, Feature, and Project layer schemas
• 🎯 ApiType Isolation: Separate configurations for Storefront, Backend, etc.
• ✅ Comprehensive Validation: Post-merge validation with helpful errors
• 🚀 Efficient Generation: Generator-based file discovery for memory efficiency
• 💾 Smart Caching: Automatic cache invalidation based on file changes

Installation

composer require spryker/api-platform

Configuration

Default configuration (can be overridden in the bundle config: '%kernel.project_dir%/config/Symfony/{APPLICATION}/packages/spryker_api_platform.php'):

spryker_api_platform:
  source_directories:
    - src/Spryker
    - src/Pyz
  cache_dir: '%kernel.cache_dir%/api-generator'
  generated_dir: '%kernel.project_dir%/src/Generated/Api'
  debug: '%kernel.debug%'

Usage

# Generate all ApiTypes
docker/sdk glue api:generate

# Generate specific ApiType
docker/sdk glue api:generate Storefront

# Debug a resource
docker/sdk glue api:debug Customer --api-type=Storefront