PHPackages                             aazsamir/libphpsky - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. aazsamir/libphpsky

ActiveLibrary[API Development](/categories/api)

aazsamir/libphpsky
==================

PHP library for interacting with ATProto protocol

v0.8.0(7mo ago)7102[1 issues](https://github.com/aazsamir/libphpsky/issues)2MITPHPPHP >=8.3CI passing

Since Jan 19Pushed 2mo ago1 watchersCompare

[ Source](https://github.com/aazsamir/libphpsky)[ Packagist](https://packagist.org/packages/aazsamir/libphpsky)[ RSS](/packages/aazsamir-libphpsky/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (9)Dependencies (13)Versions (10)Used By (2)

Libphpsky
=========

[](#libphpsky)

Libphpsky is a PHP library designed to interact with the Bluesky decentralized social media protocol. All types are generated from the Bluesky protocol schema, along with queries and procedures, ensuring everything is statically typed.

> **Note:** This is not an official library and is not affiliated with Bluesky.

Table of Contents
-----------------

[](#table-of-contents)

- [Installation](#installation)
- [Documentation](#documentation)
- [Features](#features)
- [Contributing](#contributing)
- [License](#license)

Installation
------------

[](#installation)

To install Libphpsky, use Composer:

```
composer require aazsamir/libphpsky
```

For integration with Laravel, use [`aazsamir/libphpsky-laravel`](https://github.com/aazsamir/libphpsky-laravel) package:

```
composer require aazsamir/libphpsky-laravel
```

For integration with Symfony, use [`aazsamir/libphpsky-symfony`](https://github.com/aazsamir/libphpsky-symfony) package:

```
composer require aazsamir/libphpsky-symfony
```

Documentation
-------------

[](#documentation)

Check docs at .

### Usage

[](#usage)

The default implementation handles authorization out of the box by providing `ATPROTO_LOGIN` and `ATPROTO_PASSWORD` environment variables. If the session is stale, it will automatically refresh it.

```
$resolveHandle = ResolveHandle::default();
$did = $resolveHandle->query('bsky.app')->did;

$getProfile = GetProfile::default();
$response = $getProfile->query($did);
```

On top of that, there is a meta client, which can be used to handle all possible endpoints.

```
$client = new ATProtoMetaClient();
$resolved = $client->comAtprotoIdentityResolveHandle()->query('bsky.app');
```

Libphpsky also supports `\Amp\Http\Client\HttpClient` from [`amphp/http-client`](https://github.com/amphp/http-client) package out of the box.

```
$client = ATProtoClientBuilder::default()->useAsync(true)->build();
$getProfile = new GetProfile($client);
$actors = ['bsky.app', 'steampowered.com'];
$futures = [];

foreach ($actors as $actor) {
    $futures[] = \Amp\async(fn() => $getProfile->query($actor));
}

[$errors, $profiles] = \Amp\Future\awaitAll($futures);
```

### Examples

[](#examples)

[libphpsky-feed](https://github.com/aazsamir/libphpsky-feed) is an example project that uses libphpsky to serve a bluesky feed.

For more examples, check `examples` directory.

Features
--------

[](#features)

- Comprehensive interaction with the ATProtocol
- Statically typed queries, procedures and objects
- Authorization and automatic session management
- Query caching
- Amphp client support
- Subscriptions over WebSockets
- Custom lexicons support

Contributing
------------

[](#contributing)

Contributions are welcome! Just make sure that phpstan, php-cs-fixer and phpunit pass.

License
-------

[](#license)

Libphpsky is licensed under the MIT License. See the [LICENSE](LICENSE) file for more details.

###  Health Score

40

—

FairBetter than 88% of packages

Maintenance72

Regular maintenance activity

Popularity18

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity49

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~33 days

Recently: every ~66 days

Total

9

Last Release

215d ago

PHP version history (2 changes)v0.5.0PHP ^8.3

v0.8.0PHP >=8.3

### Community

Maintainers

![](https://www.gravatar.com/avatar/3d2e4c5c1b86c2d7e53966153a2d3c28fa01529bcde8f8deba61d430e6709b7b?d=identicon)[aazsamir](/maintainers/aazsamir)

---

Top Contributors

[![aazsamir](https://avatars.githubusercontent.com/u/17406826?v=4)](https://github.com/aazsamir "aazsamir (156 commits)")

---

Tags

atprotoblueskybskyphp

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan, Rector

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/aazsamir-libphpsky/health.svg)

```
[![Health](https://phpackages.com/badges/aazsamir-libphpsky/health.svg)](https://phpackages.com/packages/aazsamir-libphpsky)
```

###  Alternatives

[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M651](/packages/sylius-sylius)[tempest/framework

The PHP framework that gets out of your way.

2.1k23.1k9](/packages/tempest-framework)[theodo-group/llphant

LLPhant is a library to help you build Generative AI applications.

1.5k311.5k5](/packages/theodo-group-llphant)[commercetools/commercetools-sdk

The official PHP SDK for the commercetools Composable Commerce APIs

19281.5k](/packages/commercetools-commercetools-sdk)[vin-sw/shopware-sdk

A PHP SDK for Shopware 6 Platform

122469.3k6](/packages/vin-sw-shopware-sdk)[alexacrm/dynamics-webapi-toolkit

Web API toolkit for Microsoft Dynamics 365 and Dynamics CRM

81324.1k1](/packages/alexacrm-dynamics-webapi-toolkit)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)