可以通过一下地址学习composer：学习地址

在开发一个内容管理系统时，我遇到了一个棘手的问题：如何在 php 环境中高效地处理 tiptap 编辑器生成的内容。tiptap 是一个基于 prosemirror 的富文本编辑器，它生成的 json 格式内容需要在后端进行转换和处理，但这对我来说是一个全新的挑战。我尝试了多种方法，但都未能找到一个既简单又高效的解决方案。最终，我发现了 ueberdosis/tiptap-php 这个库，它完美地解决了我的问题。

使用 ueberdosis/tiptap-php 库，你可以轻松地在 PHP 中处理 Tiptap 内容。它提供了多种功能，包括将 Tiptap JSON 转换为 HTML，反之亦然，内容清理和修改等。安装这个库非常简单，只需通过 Composer 即可：

composer require ueberdosis/tiptap-php

这个库的使用非常直观，如果你熟悉 Tiptap 的 JavaScript API，那么 PHP 版本的语法也会让你感到熟悉。以下是一些常见的使用场景：

将 Tiptap HTML 转换为 JSON

你可以将 HTML 片段转换为 Tiptap 兼容的 PHP 数组结构：

(new \Tiptap\Editor)
    ->setContent('
Example Text
立即学习“PHP免费学习笔记（深入）”；
')
    ->getDocument();

// 返回：
// ['type' => 'doc', 'content' => …]

你也可以获取 JSON 字符串：

(new \Tiptap\Editor)
    ->setContent('
Example Text
立即学习“PHP免费学习笔记（深入）”；
')
    ->getJSON();

// 返回：
// {"type": "doc", "content": …}

将 Tiptap JSON 转换为 HTML

反向操作也同样简单，只需传递 JSON 字符串或 PHP 数组即可生成 HTML：

(new \Tiptap\Editor)
    ->setContent([
        'type' => 'doc',
        'content' => [
            [
                'type' => 'paragraph',
                'content' => [
                    [
                        'type' => 'text',
                        'text' => 'Example Text',
                    ],
                ]
            ]
        ],
    ])
    ->getHTML();

// 返回：
// 
Example Text

代码块的语法高亮

默认的 CodeBlock 扩展不支持语法高亮，但你可以使用 CodeBlockHighlight 扩展来实现：

PHP经典实例(第二版)

PHP经典实例（第2版）能够为您节省宝贵的Web开发时间。有了这些针对真实问题的解决方案放在手边，大多数编程难题都会迎刃而解。《PHP经典实例(第2版)》将PHP的特性与经典实例丛书的独特形式组合到一起，足以帮您成功地构建跨浏览器的Web应用程序。在这个修订版中，您可以更加方便地找到各种编程问题的解决方案，《PHP经典实例(第2版)》中内容涵盖了：表单处理；Session管理；数据库交互；使用We

下载

(new \Tiptap\Editor([
    'extensions' => [
        new \Tiptap\Extensions\StarterKit([
            'codeBlock' => false,
        ]),
        new \Tiptap\Nodes\CodeBlockHighlight(),
    ],
]))
->setContent('')
->getHTML();

// 返回：
//  phpinfo()

如果你更喜欢 Shiki 语法高亮器，你需要先安装 shiki npm 包：

npm install shiki

然后使用 CodeBlockShiki 扩展：

(new \Tiptap\Editor([
    'extensions' => [
        new \Tiptap\Extensions\StarterKit([
            'codeBlock' => false,
        ]),
        new \Tiptap\Nodes\CodeBlockShiki(),
    ],
]))
->setContent('')
->getHTML();

转换内容为纯文本

(new \Tiptap\Editor)
    ->setContent('
Heading
Paragraph
')
    ->getText();

// 返回：
// "Heading

// Paragraph"

(new \Tiptap\Editor)
    ->sanitize('
Example Text
');

// 返回：
// '
Example Text
立即学习“PHP免费学习笔记（深入）”；
'

$editor->descendants(function (&$node) {
    if ($node->type !== 'heading') {
        return;
    }

    $node->attrs->level = 1;
});