> ## 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

> Aperçu, prérequis, installation, configuration initiale et premier post avec revolution/laravel-bluesky.

## Vue d'ensemble

[revolution/laravel-bluesky](https://github.com/invokable/laravel-bluesky) est un package qui permet de piloter AT Protocol (Bluesky) depuis Laravel.

La facade est `Revolution\Bluesky\Facades\Bluesky`. Vous pouvez créer des posts, récupérer le flux, effectuer des recherches ou envoyer des médias avec une syntaxe proche du client HTTP de Laravel.

## Prérequis

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

## Installation

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

## Variables d'environnement

Pour utiliser l'authentification par App Password, configurez `.env`.

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

## Démarrage rapide

### Premier post

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

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

### Gérer liens et tags avec TextBuilder

```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>
  `searchPosts()` ne fonctionne actuellement pas sans authentification en raison d'une restriction temporaire de l'API. Utilisez également une session authentifiée pour effectuer des recherches.
</Warning>

## Documentation

<Columns cols={2}>
  <Card title="Client de base" href="/fr/packages/laravel-bluesky/basic-client" icon="terminal-square">
    App Password / OAuth, publication, médias, réponses, citations, flux et recherche.
  </Card>

  <Card title="Socialite" href="/fr/packages/laravel-bluesky/socialite" icon="shield-check">
    Configuration et utilisation spécifiques à Bluesky de Socialite via AT Protocol OAuth (DPoP).
  </Card>

  <Card title="Canal de notification" href="/fr/packages/laravel-bluesky/notification" icon="bell">
    Envoyer des posts et des DM à Bluesky en tant que canal Laravel Notification.
  </Card>

  <Card title="Feed Generator" href="/fr/packages/laravel-bluesky/feed-generator" icon="rss">
    Créer et publier vos propres flux algorithmiques.
  </Card>
</Columns>

## Liens utiles

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


## Related topics

- [Laravel Bluesky](/en/packages/laravel-bluesky/index.md)