Download the PHP package polyctopus/core without Composer
On this page you can find all versions of the php package polyctopus/core. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download polyctopus/core
More information about polyctopus/core
Files in polyctopus/core
Package core
Short Description A modern, modular PHP library for multidimensional, multilingual content management with versioning, variants, translations, and asset handling.
License LGPL-3.0-or-later
Homepage https://github.com/polyctopus/core
Informations about the package core
Polyctopus Core
Polyctopus Core is a lightweight PHP library for managing structured content and content types, inspired by headless CMS concepts. It provides a flexible, type-safe way to define content models, fields, and to manage content instances in your application.
Features
- Versioning and rollback for content entries
- Content Dimensions: Support for content variants based on arbitrary dimensions (e.g. brands, channels, campaigns)
- Multilingual content and variants: Optional translations for any content or variant using locales (e.g.
de_DE) - Event mechanism for custom application logic based on triggered events by accepting callbacks
- Structured validation errors for better error handling
- Test utilities for easy test data setup
Requirements
- PHP 8.3 or higher
Installation
Install via Composer (assuming you have a composer.json):
Service Structure
Polyctopus Core uses a modular service structure for clear separation of concerns:
ContentService: Core operations for content (create, update, delete, rollback, resolve, etc.)ContentTypeService: Manage content types (create, update, delete, list)ContentVariantService: Manage content variants for dimensionsContentTranslationService: Manage translations for content and variantsContentVersionService: Manage content versioning and rollback
You typically obtain all services pre-wired via the InMemoryContentServiceFactory or a similar factory.
The ContentService is the main entry point for all operations, and it uses the other services internally.
Example:
Creating Content
Validation
When creating or updating content, the service automatically validates the data against the field definitions of the content type.
If validation fails (e.g. a string is too long), a ValidationException is thrown, containing structured error objects.
Example:
Extending
- Add new field types by implementing
FieldTypeInterface. - Implement your own repositories for persistent storage by extending
ContentRepositoryInterfaceandContentVersionRepositoryInterface. - Create custom validation rules by implementing
FieldTypeInterfaceor custom logic in your service. - Use the provided
TestFactoryfor easy test data setup in your tests.
Usage Example
See the example-usage.php file in the repository for a complete example of how to use the library.
Content Types
- Content Types
Content Variants (Dimension Overrides)
- Content Variants
Multilingual Content & Translations
- Translations
Publish Scheduling
- Publish Start & End Dates
Event Mechanism
- Events
Versioning & Rollback
- Versioning & Rollback
Asset Handling
- Asset Handling
Contributing
Contributions are welcome! Please create a pull request or open an issue for discussion.
License
LGPL-3.0-or-later