PHPackages                             arnaudleroy-studio/coffeetrove - 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. arnaudleroy-studio/coffeetrove

ActiveLibrary

arnaudleroy-studio/coffeetrove
==============================

Access 440K+ cafes, brewing guides, and coffee data from CoffeeTrove.

00PHP

Since Mar 28Pushed 1mo agoCompare

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

READMEChangelogDependenciesVersions (1)Used By (0)

CoffeeTrove PHP Client
======================

[](#coffeetrove-php-client)

[![Packagist Version](https://camo.githubusercontent.com/3da18dc2008b042dbeeb504548f493030ad733786b18c9954b069112b5f41778/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f61726e6175646c65726f792d73747564696f2f636f6666656574726f7665)](https://packagist.org/packages/arnaudleroy-studio/coffeetrove)[![PHP Version](https://camo.githubusercontent.com/401f25e02e758222b43528cde5ed7fa682ef1769991550b6cc4d71af58419145/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f61726e6175646c65726f792d73747564696f2f636f6666656574726f7665)](https://packagist.org/packages/arnaudleroy-studio/coffeetrove)[![License](https://camo.githubusercontent.com/db512d26a38423cf86aada46c360b3eec910141059aa4e913a45937603c2bd89/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f61726e6175646c65726f792d73747564696f2f636f6666656574726f7665)](LICENSE)

PHP toolkit for accessing cafe, roaster, and coffee knowledge data from CoffeeTrove. The platform indexes over 440,000 cafes worldwide alongside brewing guides, bean origin profiles, and a scoring system called the Golden Drop that rates establishments on data completeness and quality signals.

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

[](#installation)

```
composer require arnaudleroy-studio/coffeetrove
```

Quick Start
-----------

[](#quick-start)

### Look up cafes by location

[](#look-up-cafes-by-location)

```
use CoffeeTrove\Client;

$client = new Client();

// Find cafes near a coordinate pair
$cafes = $client->searchCafes(
    latitude: 48.8566,
    longitude: 2.3522,
    radiusKm: 2,
    limit: 10,
);

foreach ($cafes as $cafe) {
    echo "{$cafe['name']} — score: {$cafe['score']}/100\n";
}
```

### Inspect scoring tiers

[](#inspect-scoring-tiers)

```
// Golden Drop tier thresholds
$tiers = Client::SCORE_TIERS;
// ['exceptional' => 90, 'excellent' => 80, 'notable' => 70, 'common' => 0]

$cafe = $client->getCafe(slug: 'blue-bottle-shinjuku');
$tier = $client->getTier(score: $cafe?->score ?? 0);

echo "{$cafe?->name}: {$tier} tier";
```

### Work with brewing methods

[](#work-with-brewing-methods)

```
// Retrieve all brewing method profiles
$methods = $client->getBrewingMethods();

// Array destructuring for clean iteration
foreach ($methods as ['slug' => $slug, 'name' => $name, 'grind' => $grind]) {
    echo "{$name} requires {$grind} grind\n";
}

// Arrow function to extract just the names
$names = array_map(fn(array $m) => $m['name'], $methods);
```

### Filter by bean origin

[](#filter-by-bean-origin)

```
$origins = $client->getOrigins(region: 'africa');

// Null-safe chaining on optional tasting notes
foreach ($origins as $origin) {
    $notes = $origin?->getData('tasting_notes') ?? 'no tasting notes available';
    echo "{$origin['name']}: {$notes}\n";
}
```

Available Data
--------------

[](#available-data)

CoffeeTrove covers the full specialty coffee landscape. The cafe dataset spans 50+ countries with addresses, hours, chain classification (independent, local chain, or global chain), and Golden Drop scores computed from data completeness and review signals. Brewing guides cover 15+ methods from pour-over to espresso with grind size, water temperature, and ratio recommendations. Origin profiles document growing regions, altitude ranges, processing methods, and characteristic flavor notes. The bean encyclopedia catalogs 160+ entries across varietals, blends, and single-origin roasts.

Links
-----

[](#links)

- [CoffeeTrove Platform](https://coffeetrove.com)
- [GitHub Repository](https://github.com/arnaudleroy-studio/coffeetrove-php)

License
-------

[](#license)

MIT License. See [LICENSE](LICENSE) for details.

###  Health Score

19

—

LowBetter than 10% of packages

Maintenance60

Regular maintenance activity

Popularity0

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity11

Early-stage or recently created project

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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/1825e83fcd5fd59c7ee41b967310ab63726ddb49a0549ca3b7260bde705369e7?d=identicon)[arnaudleroy-studio](/maintainers/arnaudleroy-studio)

### Embed Badge

![Health badge](/badges/arnaudleroy-studio-coffeetrove/health.svg)

```
[![Health](https://phpackages.com/badges/arnaudleroy-studio-coffeetrove/health.svg)](https://phpackages.com/packages/arnaudleroy-studio-coffeetrove)
```

PHPackages © 2026

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