https://github.com/prezly/draft-php
Simple Draft.js model implemented in PHP
https://github.com/prezly/draft-php
contentstate draft-js draft-php php
Last synced: about 1 year ago
JSON representation
Simple Draft.js model implemented in PHP
- Host: GitHub
- URL: https://github.com/prezly/draft-php
- Owner: prezly
- License: mit
- Created: 2016-09-26T07:56:47.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2022-09-14T12:08:28.000Z (over 3 years ago)
- Last Synced: 2025-04-11T22:52:03.846Z (about 1 year ago)
- Topics: contentstate, draft-js, draft-php, php
- Language: PHP
- Homepage:
- Size: 85.9 KB
- Stars: 12
- Watchers: 5
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Prezly's Draft-PHP
==================
PHP implementation of Draft.js ContentState model to allow server-side handling of Draft.js produced content.
### Table of contents
* [Usage](#usage)
- [Reading ContentState JSON](#reading-contentstate-json)
- [Serializing ContentState back to JSON](#serializing-contentstate-back-to-json)
* [Notes on implementation](#notes-on-implementation)
* [Other implementations](#other-implementations)
* [License](#license)
* [Credits](#credits)
Usage
-----
### Reading ContentState JSON
```php
// raw JSON content state coming from Draft.js frontend
$json = '{
"blocks":[
{
"key": "7si2a",
"text": "Say hello to world!",
"type": "unstyled",
"depth": 0,
"inlineStyleRanges": [
{
"style": "BOLD",
"offset": 0,
"length": 9
}
],
"entityRanges": [
{
"key": "0",
"offset": 0,
"length": 9
}
],
"data": {}
}
],
"entityMap":{
"0":{
"type":"link",
"mutability":"MUTABLE",
"data":{
"href":"https://www.prezly.com/"
}
}
}
}';
// convert raw JSON state to ContentState model object
$contentState = \Prezly\DraftPhp\Converter::convertFromJson($json);
// or
$rawState = json_decode($json); // Note: raw state should be an stdClass object, not an associative array
$contentState = \Prezly\DraftPhp\Converter::convertFromRaw($rawState);
var_dump($contentState);
/*
Prezly\DraftPhp\Model\ContentState {
-_blocks: array:1 [
0 => Prezly\DraftPhp\Model\ContentBlock {#1507
-_key: "7si2a"
-_type: "unstyled"
-_text: "Say hello to world!"
-_characterList: array:19 [
0 => Prezly\DraftPhp\Model\CharacterMetadata {#1506
-_style: ["BOLD"]
-_entity: "0"
}
1 => Prezly\DraftPhp\Model\CharacterMetadata {#1506}
2 => Prezly\DraftPhp\Model\CharacterMetadata {#1506}
3 => Prezly\DraftPhp\Model\CharacterMetadata {#1506}
4 => Prezly\DraftPhp\Model\CharacterMetadata {#1506}
5 => Prezly\DraftPhp\Model\CharacterMetadata {#1506}
6 => Prezly\DraftPhp\Model\CharacterMetadata {#1506}
7 => Prezly\DraftPhp\Model\CharacterMetadata {#1506}
8 => Prezly\DraftPhp\Model\CharacterMetadata {#1506}
9 => Prezly\DraftPhp\Model\CharacterMetadata {#1490
-_style: []
-_entity: null
}
10 => Prezly\DraftPhp\Model\CharacterMetadata {#1490}
11 => Prezly\DraftPhp\Model\CharacterMetadata {#1490}
12 => Prezly\DraftPhp\Model\CharacterMetadata {#1490}
13 => Prezly\DraftPhp\Model\CharacterMetadata {#1490}
14 => Prezly\DraftPhp\Model\CharacterMetadata {#1490}
15 => Prezly\DraftPhp\Model\CharacterMetadata {#1490}
16 => Prezly\DraftPhp\Model\CharacterMetadata {#1490}
17 => Prezly\DraftPhp\Model\CharacterMetadata {#1490}
18 => Prezly\DraftPhp\Model\CharacterMetadata {#1490}
]
-_depth: 0
-_data: []
}
]
-_entityMap: array:1 [
0 => Prezly\DraftPhp\Model\EntityInstance {#1505
-_type: "link"
-_mutability: "MUTABLE"
-_data: array:1 [
"href" => "https://www.prezly.com/"
]
}
]
}
*/
var_dump($contentState->blocks[0]->characterList[0]);
/*
Prezly\DraftPhp\Model\CharacterMetadata {#1506
-_style: ["BOLD"]
-_entity: "0"
}
*/
var_dump($contentState->getEntity($contentState->blocks[0]->characterList[0]->entity));
/*
Prezly\DraftPhp\Model\EntityInstance {#1505
-_type: "link"
-_mutability: "MUTABLE"
-_data: array:1 [
"href" => "https://www.prezly.com/"
]
}
*/
```
### Serializing ContentState back to JSON
```php
// convert raw JSON state to ContentState model object
$contentState = \Prezly\DraftPhp\Converter::convertFromJson($json);
$serializedJson = \Prezly\DraftPhp\Serializer::serialize($contentState);
// or
$serializedJson = json_serialize($contentState);
// now $json is equivalent to $serializedJson (formatting and order may differ though)
// see SerializerTest for examples
```
Notes on implementation
-----------------------
1. ContentState now holds an `$entityMap` property and has `->getEntity(string $entityKey)` method.
This approach allows to incapsulate all the data coming from JSON into a single object and then use it for rendering.
Having global static pool of entities (as in native Draft.js implementation, and another PHP port of Draft.js model)
is not that useful. Global state gets into your way when you need to render multiple content states in a single PHP process.
Also it complicates testing.
2. All the model classes are immutable. That's achived by storing all the data in private properies
providing getters only as public API (`getXxxx` methods + magic `__get()` method to emulate read-only public props).
Other implementations
---------------------
- [webstronauts/draft-php](https://github.com/webstronauts/draft-php) — a one-to-one port of Draft.js model specs, well tested
License
-------
[MIT](./LICENSE)
Credits
-------
Built with :metal: by [Prezly](https://www.prezly.com/) — CRM software crafted for PR communication