Work in progress
- PHP >= 8.2
- Laravel >= 11.0
composer require revolution/laravel-blueskycomposer remove revolution/laravel-blueskyThere are many public APIs that do not require authentication if you just want to retrieve data.
// routes/web.php
use Illuminate\Support\Facades\Route;
use Revolution\Bluesky\Facades\Bluesky;
Route::get('search', function () {
/** @var \Illuminate\Http\Client\Response $response */
$response = Bluesky::searchPosts(q: '#bluesky', limit: 10);
$response->collect('posts')
->each(function (array $post) {
dump(data_get($post, 'author.displayName'));
dump(data_get($post, 'author.handle'));
dump(data_get($post, 'author.did'));
dump(data_get($post, 'record.text'));
});
});// routes/web.php
use Illuminate\Support\Facades\Route;
use Revolution\Bluesky\Facades\Bluesky;
Route::get('feed', function () {
// "actor" is did(did:plc:***) or handle(***.bsky.social, alice.test)
$response = Bluesky::getAuthorFeed(actor: '***.bsky.social');
$response->collect('feed')
->each(function (array $feed) {
dump(data_get($feed, 'post.author.displayName'));
dump(data_get($feed, 'post.record.text'));
});
});You can get your own posts by specifying your did or handle as the actor. No authentication is required to get and save your own posts.
There are two authentication methods for Bluesky: "App password" and "OAuth". Here we will use "App password". Obtain the App password from Bluesky and set it in .env.
// .env
BLUESKY_IDENTIFIER=***.bsky.social
BLUESKY_APP_PASSWORD=****-****-****-****
// routes/web.php
use Illuminate\Support\Facades\Route;
use Revolution\Bluesky\Facades\Bluesky;
Route::get('post', function () {
$response = Bluesky::login(identifier: config('bluesky.identifier'), password: config('bluesky.password'))
->post('Hello Bluesky');
});This is easy if you're just sending simple text, but in the real world you'll need to use TextBuilder to make links and tags work.
// routes/web.php
use Illuminate\Support\Facades\Route;
use Revolution\Bluesky\Facades\Bluesky;
use Revolution\Bluesky\Record\Post;
use Revolution\Bluesky\RichText\TextBuilder;
Route::get('text-builder', function () {
$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);
});Following message will be posted:
Hello Bluesky
https://bsky.app/
#Bluesky
To authenticate with OAuth, read the Socialite documentation.
https://github.com/kawax/atproto-lexicon-contracts
MIT