PHPackages                             jankx/search-engine - 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. [Search &amp; Filtering](/categories/search)
4. /
5. jankx/search-engine

ActiveLibrary[Search &amp; Filtering](/categories/search)

jankx/search-engine
===================

1.1.2(3mo ago)024GPL-3.0-or-laterPHP

Since Jan 16Pushed 3mo agoCompare

[ Source](https://github.com/jankx/search-engine)[ Packagist](https://packagist.org/packages/jankx/search-engine)[ RSS](/packages/jankx-search-engine/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (6)Dependencies (4)Versions (8)Used By (0)

Jankx Search Engine
===================

[](#jankx-search-engine)

`jankx/search-engine` là một thành phần cốt lõi trong hệ sinh thái **Jankx Framework**, được thiết kế để giải quyết vấn đề hiệu năng tìm kiếm của WordPress trên mọi môi trường lưu trữ.

✨ Tính năng nổi bật
-------------------

[](#-tính-năng-nổi-bật)

- **Driver-based Architecture:** Dễ dàng chuyển đổi giữa các công cụ tìm kiếm mà không cần thay đổi logic ứng dụng.
- **Shared Hosting Friendly:** Sử dụng **TNTSearch** làm driver mặc định (pure PHP) để mang lại tốc độ tìm kiếm Full-text mà không cần cài đặt thêm phần mềm server.
- **Enterprise Ready:** Hỗ trợ các adapter mạnh mẽ như **Typesense** và **Meilisearch** khi chạy trên VPS/Cloud.
- **WordPress Optimized:** Tự động lắng nghe các sự kiện `save_post`, `delete_post` để cập nhật chỉ mục (indexing) theo thời gian thực.
- **Fuzzy Search:** Hỗ trợ tìm kiếm mờ, tìm kiếm theo cụm từ và đánh trọng số kết quả.
- **Smart Facets (Bộ lọc thông minh):** Tự động tính toán số lượng kết quả (Term Counts) theo thời gian thực (Live Update) dựa trên ngữ cảnh tìm kiếm hiện tại.

🧩 Logic Tìm kiếm &amp; Bộ lọc
-----------------------------

[](#-logic-tìm-kiếm--bộ-lọc)

Hệ thống áp dụng logic tìm kiếm nâng cao để đảm bảo trải nghiệm người dùng tự nhiên nhất:

1. **Logic trong cùng một nhóm (OR Condition):**

    - Khi chọn nhiều giá trị trong cùng một nhóm (ví dụ: *Category A* và *Category B*), kết quả trả về sẽ bao gồm bài viết thuộc *Category A* **HOẶC** *Category B*.
2. **Logic giữa các nhóm khác nhau (AND Condition):**

    - Khi chọn giá trị ở các nhóm khác nhau (ví dụ: *Category A* và *Tag X*), kết quả phải thỏa mãn cả hai điều kiện (thuộc *Category A* **VÀ** có *Tag X*).
3. **Shadow Search (Tính toán số lượng khả dụng):**

    - Hệ thống chạy ngầm các truy vấn để tính toán trước số lượng bài viết cho mỗi bộ lọc, giúp người dùng biết trước có bao nhiêu kết quả nếu chọn bộ lọc đó (hiển thị dạng `(n)`).
    - Bộ lọc nào có **0 kết quả** sẽ tự động bị vô hiệu hóa (disabled UI) để tránh người dùng thực hiện truy vấn rỗng.

🚀 Các Driver hỗ trợ
-------------------

[](#-các-driver-hỗ-trợ)

DriverMôi trườngLoại`tntsearch`Shared HostingPHP-native (SQLite)`typesense`VPS / DockerIn-memory Search`meilisearch`VPS / CloudRESTful Search API📦 Cài đặt
---------

[](#-cài-đặt)

```
composer require jankx/search-engine
```

🛠 Cách sử dụng cơ bản
---------------------

[](#-cách-sử-dụng-cơ-bản)

```
use Jankx\Search\EngineManager;

$search = new EngineManager([
    'driver' => 'tntsearch', // hoặc typesense/meilisearch
    'config' => [...]
]);

$results = $search->search('từ khóa tìm kiếm');
```

###  Health Score

35

—

LowBetter than 80% of packages

Maintenance81

Actively maintained with recent releases

Popularity6

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity39

Early-stage or recently created project

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

Total

6

Last Release

103d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/6a609a3b3a36dee9f36ef6f8d3b2b2dc91eebefc7644031e829e65bca4329799?d=identicon)[puleeno](/maintainers/puleeno)

---

Top Contributors

[![puleeno](https://avatars.githubusercontent.com/u/22538657?v=4)](https://github.com/puleeno "puleeno (52 commits)")

---

Tags

full-text-searchjankx-frameworkphpsearch-enginetntsearchwordpress

### Embed Badge

![Health badge](/badges/jankx-search-engine/health.svg)

```
[![Health](https://phpackages.com/badges/jankx-search-engine/health.svg)](https://phpackages.com/packages/jankx-search-engine)
```

###  Alternatives

[ruflin/elastica

Elasticsearch Client

2.3k50.4M203](/packages/ruflin-elastica)[teamtnt/laravel-scout-tntsearch-driver

Driver for Laravel Scout search package based on https://github.com/teamtnt/tntsearch

1.1k2.5M28](/packages/teamtnt-laravel-scout-tntsearch-driver)[vanry/laravel-scout-tntsearch

包含中文分词的 Laravel Scout TNTSearch 驱动，支持 scws, phpanalysis 和 jieba 分词。

17811.8k1](/packages/vanry-laravel-scout-tntsearch)[tomaj/nette-api

Nette api

36261.8k4](/packages/tomaj-nette-api)[vxm/yii2-searchable

Simple full-text search for Yii2 active record

181.4k](/packages/vxm-yii2-searchable)

PHPackages © 2026

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