crazy-goat/ladybug-ext

Native PHP extension for LadybugDB (embedded graph database) — the ext-ladybug backend of crazy-goat/ladybug-php

v0.5.0 2026-08-17 20:38 UTC

Requires

• php: >=8.2

Suggests

• crazy-goat/ladybug-php: The PHP API this extension backs; the extension alone exposes only ladybug_* functions

MIT

• ladybug
• extension
• graph
• cypher
• graph-database
• ladybugdb
• kuzu

Published on Packagist.org on 2026-08-17 20:39 UTC

Extension name: ext-ladybug

Supports Zend Thread Safety (ZTS): ✅

Supports non-Thread Safe mode (NTS): ✅

Supported operating systems: bsd, darwin, solaris, linux, unknown

Configure flags:

• --with-liblbug=<value> Directory holding lbug.h and the liblbug library. Required unless liblbug is installed somewhere standard: the build searches /usr/local, /usr and /opt/homebrew.
• --enable-ladybug-static Link liblbug.a into the extension instead of depending on the shared library. Needs a liblbug-static release. Strongly recommended on Linux: a dynamically linked liblbug 0.19.x crashes the process on INSTALL when any extension carrying libstdc++ is loaded.

README

The native PHP extension for LadybugDB, installable with PIE. Verified against liblbug 0.19.1.

This repository is generated. The sources live in crazy-goat/ladybug-php under ext/, and every release overwrites this mirror with a single commit — issues and pull requests belong there.

Installing

The extension links against liblbug, so the library has to be on the machine before the build. For the static link, which is the one to use on Linux:

curl -sL https://raw.githubusercontent.com/crazy-goat/ladybug-php/main/tools/fetch-liblbug.sh \
  | bash -s 0.19.1 --static          # unpacks into ./lib
pie install crazy-goat/ladybug-ext --enable-ladybug-static --with-liblbug="$PWD/lib"

Or dynamically, if liblbug is already installed somewhere standard:

pie install crazy-goat/ladybug-ext

On Linux prefer the static link: a dynamically linked liblbug 0.19.x crashes the process on INSTALL whenever another extension carrying libstdc++ (intl is enough) shares it. The main README has the mechanism.

Prebuilt binaries for PHP 8.2–8.5 are attached to every ladybug-php release if you would rather not compile at all.

What it gives you

ladybug_* functions, which are an internal ABI rather than an API to write against. Install crazy-goat/ladybug-php for the API; it detects this extension and uses it automatically.

MIT, same as LadybugDB.