shahmal1yev/blueskysdk

BlueSky SDK is a comprehensive PHP library designed to seamlessly integrate with the BlueSky social network.

v1.9.1-beta 2025-03-27 22:12 UTC

README

Logo

BlueSky SDK for PHP

PHP Workflow GitHub tag (latest by date) GitHub last commit License: MIT Packagist Downloads Discord

๐ŸŒŸ Overview

BlueSky SDK is a comprehensive PHP library designed to seamlessly integrate with the BlueSky social network.

๐Ÿ“ Documentation

Explore the Wiki for documentation.

๐Ÿš€ Quick Start

Installation

composer require shahmal1yev/blueskysdk

Basic Usage

<?php

use Atproto\Client;

// Create a client instance
$client = new Client();

// Authenticate with BlueSky
$client->authenticate('your-handle', 'your-password');

// Get your profile
$profile = bskyFacade($client)->getProfile()
    ->actor($client->authenticated()->handle())
    ->send();

// Get the date you joined
$createdAt = $profile->createdAt();

๐Ÿ“‹ Requirements

  • PHP 7.4 or higher
  • Extensions: json, curl, fileinfo
  • Composer

๐Ÿงช Testing

# Run all tests
composer test

# Run unit tests only
composer test-unit

# Run feature tests only  
composer test-feature

# Static analysis
composer analyse

๐Ÿค Contributing

We welcome contributions! Please see our Contributing Guide for details on:

  • Code standards (PSR, SOLID principles)
  • Development setup and workflow
  • Testing requirements
  • Pull request process

Before contributing, please:

  1. Read the Contributing Guide
  2. Check existing issues and pull requests
  3. Join our Discord community for discussions

๐Ÿ“ License

Released under the MIT License. See LICENSE for details.

๐Ÿ™‹โ€โ™‚๏ธ Support

Built with โค๏ธ by Eldar Shahmaliyev.