> ## Documentation Index
> Fetch the complete documentation index at: https://kawax.biz/llms.txt
> Use this file to discover all available pages before exploring further.

# Laravel Bluesky

> 汇总介绍 revolution/laravel-bluesky 的概览、环境要求、安装、初始配置以及发出第一条帖子的步骤。

## 概览

[revolution/laravel-bluesky](https://github.com/invokable/laravel-bluesky) 是一个从 Laravel 使用 AT Protocol（Bluesky）的扩展包。

Facade 是 `Revolution\Bluesky\Facades\Bluesky`。你可以以接近 Laravel HTTP 客户端的方式使用它来完成发帖、获取 feed、搜索、发送媒体等操作。

## 环境要求

* PHP `>= 8.3`
* Laravel `>= 12.x`

## 安装

```bash theme={null}
composer require revolution/laravel-bluesky
```

## 环境变量

如果要使用 App Password 认证，请配置 `.env`。

```dotenv theme={null}
BLUESKY_IDENTIFIER=your-handle.bsky.social
BLUESKY_APP_PASSWORD=xxxx-xxxx-xxxx-xxxx
```

## 快速上手

### 第一条帖子

```php theme={null}
use Revolution\Bluesky\Facades\Bluesky;

$response = Bluesky::login(
    identifier: config('bluesky.identifier'),
    password: config('bluesky.password'),
)->post('Hello Bluesky');
```

### 用 TextBuilder 处理链接和 tag

```php theme={null}
use Revolution\Bluesky\Facades\Bluesky;
use Revolution\Bluesky\Record\Post;
use Revolution\Bluesky\RichText\TextBuilder;

$post = Post::build(function (TextBuilder $builder) {
    $builder->text('Hello Bluesky')
        ->newLine(count: 2)
        ->link('https://bsky.app/')
        ->newLine()
        ->tag('#Bluesky');
});

$response = Bluesky::login(
    identifier: config('bluesky.identifier'),
    password: config('bluesky.password'),
)->post($post);
```

<Warning>
  由于 API 侧的临时限制，`searchPosts()` 目前在未认证状态下无法使用。使用搜索时也请使用已认证的 session。
</Warning>

## 文档

<Columns cols={2}>
  <Card title="Basic client" href="/zh/packages/laravel-bluesky/basic-client" icon="terminal-square">
    介绍 App Password / OAuth、发帖、媒体、回复、引用、feed、搜索。
  </Card>

  <Card title="Socialite" href="/zh/packages/laravel-bluesky/socialite" icon="shield-check">
    介绍使用 AT Protocol OAuth（DPoP）的 Bluesky 专属 Socialite 配置与用法。
  </Card>

  <Card title="通知通道" href="/zh/packages/laravel-bluesky/notification" icon="bell">
    以 Laravel Notification 通道的形式向 Bluesky 发送帖子和 DM。
  </Card>

  <Card title="Feed Generator" href="/zh/packages/laravel-bluesky/feed-generator" icon="rss">
    创建并发布自定义算法 feed。
  </Card>
</Columns>

## 参考链接

* GitHub: [invokable/laravel-bluesky](https://github.com/invokable/laravel-bluesky)
* DeepWiki: [invokable/laravel-bluesky](https://deepwiki.com/invokable/laravel-bluesky)


## Related topics

- [Socialite - Laravel Bluesky](/zh/packages/laravel-bluesky/socialite.md)
- [Bot 教程 - Laravel Bluesky](/zh/packages/laravel-bluesky/bot-tutorial.md)
- [Basic client - Laravel Bluesky](/zh/packages/laravel-bluesky/basic-client.md)
- [通知通道 - Laravel Bluesky](/zh/packages/laravel-bluesky/notification.md)
- [认证方式对比 - Laravel Bluesky](/zh/packages/laravel-bluesky/authentication.md)