onstage2426/fuzor

Dependency-free full-text search for PHP. BM25 ranking, fuzzy and boolean modes, search-as-you-type prefix matching, stopword filtering and Snowball stemming for 62 languages, snippet extraction and result highlighting — one SQLite file, zero infrastructure.

Maintainers

Package info

github.com/onstage2426/fuzor

pkg:composer/onstage2426/fuzor

Statistics

Installs: 14

Dependents: 0

Suggesters: 0

Stars: 1

Open Issues: 0

Security

Advisories: 0

Aikido package health analysis

3.5.0 2026-05-15 11:40 UTC

Requires

  • php: >=8.5

Requires (Dev)

MIT 44dcce6649e001c950e7b78c9d7d9b36821a3d1e

  • Onstage2426 <70956213+Onstage2426.woop@users.noreply.github.com>

searchsqlitetokenizerhighlightingmultilingualsnippetstemmingstopwordsfull-text-searchbm25fuzzy-searchinverted-indexboolean-searchsearch-as-you-type

This package is auto-updated.

Last update: 2026-05-21 19:14:14 UTC

README

Fuzor Logo

PHP 8.5+ License Packagist Version CI

About

Fuzor is a dependency-free full-text search library for PHP. It tokenises your documents, stores an inverted index in a single SQLite file, and scores results with Okapi BM25 — no external services required.

  • BM25 ranked search with fuzzy and boolean modes
  • Faceted search — filter by attribute values and compute per-value counts
  • Search-as-you-type prefix matching
  • Stopword filtering and Snowball stemming for 62 languages
  • Snippet extraction and result highlighting
  • One SQLite file per index — zero infrastructure

Installation

composer require onstage2426/fuzor

Requirements: PHP 8.5+, SQLite 3.46.0+

Usage

use Fuzor\Index;
use Fuzor\FacetRange;

// Create an index and add documents
$index = new Index('/path/to/products.db', language: 'en', facets: true);
$index->insertMany([
    ['id' => 1, 'title' => 'Fast sedan',     'body' => 'City car with great fuel economy.', '_facets' => ['type' => 'sedan',  'price' => 24900]],
    ['id' => 2, 'title' => 'Off-road SUV',   'body' => 'Built for adventure and any terrain.', '_facets' => ['type' => 'suv',    'price' => 41500]],
    ['id' => 3, 'title' => 'Electric coupe', 'body' => 'Zero emissions and instant torque.', '_facets' => ['type' => 'coupe',  'price' => 58000]],
]);

// BM25 search (with optional fuzzy matching)
$results = $index->search('economi', fuzzy: true);

// Boolean search
$results = $index->searchBoolean('sedan or coupe -electric');

// Faceted search — filter by attribute, get counts per value
$results = $index->search('car', filter: ['type' => ['sedan', 'suv'], 'price' => FacetRange::max(45000)], facets: ['type']);

Documentation

License

MIT — see LICENSE.