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.10.0(yesterday)13197[1 issues](https://github.com/aazsamir/libphpsky/issues)2MITPHPPHP >=8.3CI passing

Since Jan 19Pushed 3w ago1 watchersCompare

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

READMEChangelog (10)Dependencies (40)Versions (13)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

46

—

FairBetter than 92% of packages

Maintenance92

Actively maintained with recent releases

Popularity20

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity50

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 ~48 days

Recently: every ~66 days

Total

12

Last Release

1d ago

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

v0.8.0PHP >=8.3

### Community

Maintainers

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

---

Top Contributors

[![aazsamir](https://avatars.githubusercontent.com/u/17406826?v=4)](https://github.com/aazsamir "aazsamir (163 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

[tempest/framework

The PHP framework that gets out of your way.

2.2k34.4k15](/packages/tempest-framework)[sylius/sylius

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

8.5k5.9M738](/packages/sylius-sylius)[civicrm/civicrm-core

Open source constituent relationship management for non-profits, NGOs and advocacy organizations.

751291.4k43](/packages/civicrm-civicrm-core)[shopware/platform

The Shopware e-commerce core

3.4k1.5M3](/packages/shopware-platform)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

585.6M572](/packages/shopware-core)[typo3/cms

TYPO3 CMS is a free open source Content Management Framework initially created by Kasper Skaarhoj and licensed under GNU/GPL.

1.2k1.9M122](/packages/typo3-cms)

PHPackages © 2026

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