PHPackages                             pigeon-cloud/pigeon-cloud-sdk - 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. [Utility & Helpers](/categories/utility)
4. /
5. pigeon-cloud/pigeon-cloud-sdk

ActiveLibrary[Utility & Helpers](/categories/utility)

pigeon-cloud/pigeon-cloud-sdk
=============================

v1.0.9(7mo ago)072MITPHP

Since Sep 17Pushed 7mo ago2 watchersCompare

[ Source](https://github.com/Loftal/pigeon-cloud-sdk)[ Packagist](https://packagist.org/packages/pigeon-cloud/pigeon-cloud-sdk)[ RSS](/packages/pigeon-cloud-pigeon-cloud-sdk/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)DependenciesVersions (11)Used By (0)

Pigeon Cloud SDK
================

[](#pigeon-cloud-sdk)

Overview
--------

[](#overview)

The Pigeon Cloud SDK makes it easier for developers to use Pigeon Cloud API in their PHP code. [Pigeon Cloud API](https://documenter.getpostman.com/view/8580068/VUjLLnHM)

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

[](#installation)

```
composer require pigeon-cloud/pigeon-cloud-sdk
```

Requirement
-----------

[](#requirement)

- PHP 8.0+

Usage
-----

[](#usage)

### .env

[](#env)

```
PIGEON_API_URL=https://xxx.pigeon-cloud.com/api/v1
PIGEON_MASTER_ID=admin
PIGEON_MASTER_PASSWORD=password

```

### example.php

[](#examplephp)

```
require 'vendor/autoload.php';

use PigeonCloudSdk\PigeonCondition;
use PigeonCloudSdk\PigeonProvider;

// Environment variables need to be loaded.
// Example: When using phpdotenv, `composer require vlucas/phpdotenv`
$dotenv = \Dotenv\Dotenv::createImmutable(__DIR__);
$dotenv->load();

$pigeonProvider = new PigeonProvider('{table_id}');
$pigeonCondition = new PigeonCondition();
$pigeonCondition->add('{and_or}', '{field}', '{condition}', '{value}');
list($data, $count) = $pigeonProvider->fetch($pigeonCondition);
```

Features
--------

[](#features)

### fetch

[](#fetch)

```
$pigeonProvider = new PigeonProvider('1');
$pigeonCondition = new PigeonCondition();
$pigeonCondition->add('and', 'field__1', 'eq', '1');
$page = 1;
$per_page = 10;
$order = 'id desc';
$fields = ['field__1'];

// fetch list
list($data, $count) = $pigeonProvider->fetch($pigeonCondition, $page, $per_page, $order, $fields);

// fetch one
$data = $pigeonProvider->fetchOne($pigeonCondition, $order, $fields);

// fetch all
$data_all = $pigeonProvider->fetchAll($pigeonCondition, $order, $fields);
```

### insert

[](#insert)

```
$pigeonProvider = new PigeonProvider('1');

// insert
$insert_data = [
    ['field__1' => 'Test 1'],
    ['field__1' => 'Test 2'],
];
$response_data = $pigeonProvider->insert($insert_data);

// insert one
$inserted_id = $pigeonProvider->insertOne(['field__1' => 'Test 1']);
```

### update

[](#update)

```
$pigeonProvider = new PigeonProvider('1');

// update
$update_data = [
    ['id' => 1, 'field__1' => 'Update 1'],
    ['id' => 2, 'field__1' => 'Update 2'],
];
$response_data = $pigeonProvider->update($update_data);

// update one
$isSucceeded = $pigeonProvider->updateOne(1, ['field__1' => 'Update 1']);
```

### delete

[](#delete)

```
$pigeonProvider = new PigeonProvider('1');

// delete
$response_data = $pigeonProvider->delete([1, 2]);

// delete one
$isSucceeded = $pigeonProvider->delete(1);
```

### file

[](#file)

```
$pigeonProvider = new PigeonProvider('1');

// delete
$response = $pigeonProvider->file('1');
header('Content-Disposition: attachment; filename="filename.ext"');
echo $response;
exit(0);
```

### debug mode

[](#debug-mode)

```
$pigeonProvider = new PigeonProvider('1');
$pigeonProvider->setDebug(); // Enable Debug mode
$pigeonProvider->fetch();

// The API URL, POST data, and response data will be displayed.
```

License
-------

[](#license)

[MIT License](LICENSE)

###  Health Score

34

—

LowBetter than 77% of packages

Maintenance67

Regular maintenance activity

Popularity8

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity45

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

Recently: every ~51 days

Total

10

Last Release

222d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/a0599d6faf4bb68ef1ad903ec53a87587ca1bd0c85c81b75da82deb964db5245?d=identicon)[moraine8](/maintainers/moraine8)

---

Top Contributors

[![moraine8](https://avatars.githubusercontent.com/u/7805843?v=4)](https://github.com/moraine8 "moraine8 (11 commits)")

### Embed Badge

![Health badge](/badges/pigeon-cloud-pigeon-cloud-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/pigeon-cloud-pigeon-cloud-sdk/health.svg)](https://phpackages.com/packages/pigeon-cloud-pigeon-cloud-sdk)
```

###  Alternatives

[mwhite/random-uagent

A library for generating random User Agents

2453.4k2](/packages/mwhite-random-uagent)

PHPackages © 2026

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