README

为 PHP 开发者提供的完整 Notion SDK。

📦 安装

此项目需要 PHP 8.1 或更高版本。使用 Composer 安装，请运行

$ composer require mariosimao/notion-sdk-php

👩‍💻 基本用法

使用 SDK 在 Notion 上创建页面非常简单。

use Notion\Blocks\Heading1;
use Notion\Blocks\ToDo;
use Notion\Common\Emoji;
use Notion\Notion;
use Notion\Pages\Page;
use Notion\Pages\PageParent;

$notion = Notion::create("secret_token");

$parent = PageParent::page("c986d7b0-7051-4f18-b165-cc0b9503ffc2");
$page = Page::create($parent)
            ->changeTitle("Shopping list")
            ->changeIcon(Emoji::fromString("🛒"));

$content = [
    Heading1::fromString("Supermarket"),
    ToDo::fromString("Tomato"),
    ToDo::fromString("Sugar"),
    ToDo::fromString("Apple"),
    ToDo::fromString("Milk"),
    Heading1::fromString("Mall"),
    ToDo::fromString("Black T-shirt"),
];

$page = $notion->pages()->create($page, $content);

📄 文档

更多文档可以在 https://mariosimao.github.io/notion-sdk-php 找到。

Notion PHP SDK 支持使用静态分析器。我们强烈建议与该库结合使用 vimeo/psalm 或 phpstan/phpstan，以避免简单的错误。

🏷️ 版本控制

严格遵守 SemVer。次要版本和补丁版本不应引入对代码库的破坏性更改。

标记为 @internal 的任何类或方法都不建议在库外使用，并且可能会随时进行破坏性更改，请避免使用它们。

🛠️ 维护与支持

当发布新次要版本（例如，1.3 -> 1.4）时，上一个版本（1.3）将继续至少3个月内接收安全更新和关键错误修复。

当发布新主要版本时（例如，1.6 -> 2.0），上一个版本（1.6）将至少在发布后3个月内接收关键错误修复，并在之后6个月内接收安全更新。

此政策可能在未来发生变化，并且可能根据具体情况做出例外。

❤️ 赞助商

特别感谢所有积极支持 SDK 的赞助商！

mariosimao / notion-sdk-php

维护者

详细信息