PHPackages sdfsky/tipask-xunsearch - 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 & Filtering](/categories/search) 4. / 5. sdfsky/tipask-xunsearch ActiveLibrary[Search & Filtering](/categories/search) sdfsky/tipask-xunsearch ======================= Laravel 5 package for full-text search over Eloquent models based on XunSearch. v1.0.1(7y ago)11.5k2MITHTMLPHP >=5.5.9 Since May 7Pushed 7y ago1 watchersCompare [ Source](https://github.com/sdfsky/tipask-xunsearch)[ Packagist](https://packagist.org/packages/sdfsky/tipask-xunsearch)[ RSS](/packages/sdfsky-tipask-xunsearch/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (2)Dependencies (1)Versions (3)Used By (0) Laravel 5.1 XunSearch ===================== [](#laravel-51-xunsearch) [![Latest Stable Version](https://camo.githubusercontent.com/fb7eb0176a28b141bd9e100664360b83d2bcee246b0932d8696668909ccd0730/68747470733a2f2f706f7365722e707567782e6f72672f646176696e2d62616f2f6c61726176656c2d78756e2d7365617263682f762f737461626c652e706e67)](https://packagist.org/packages/davin-bao/laravel-xun-search)[![Latest Unstable Version](https://camo.githubusercontent.com/6fe1b98781defd39bdb8ad18fbe383c950465bef6f5273025d77b6eae64eb6dd/68747470733a2f2f706f7365722e707567782e6f72672f646176696e2d62616f2f6c61726176656c2d78756e2d7365617263682f762f756e737461626c652e706e67)](https://packagist.org/packages/davin-bao/laravel-xun-search)[![License](https://camo.githubusercontent.com/4764297cb7088f8675edc980d7d2a751b9a6a5ff5cfb5d792eae62d2d8e02186/68747470733a2f2f706f7365722e707567782e6f72672f646176696e2d62616f2f6c61726176656c2d78756e2d7365617263682f6c6963656e73652e706e67)](https://packagist.org/packages/davin-bao/laravel-xun-search)[![Total Downloads](https://camo.githubusercontent.com/d3f83ce918c43774b6a41f4ca33f210873f4e1572c8e8c45def21444d63079ff/68747470733a2f2f706f7365722e707567782e6f72672f646176696e2d62616f2f6c61726176656c2d78756e2d7365617263682f646f776e6c6f616473)](https://packagist.org/packages/davin-bao/laravel-xun-search) Laravel 5.1 package for full-text search over Eloquent models based on XunSearch. Installation ------------ [](#installation) Require this package in your composer.json and run composer update: ``` { "require": { "sdfsky/tipask-xunsearch": "dev-master" } } ``` After updating composer, add the ServiceProvider to the providers array in `app/config/app.php` ``` 'providers' => [ Sdfsky\TipaskXunSearch\ServiceProvider::class, ], ``` If you want to use the facade to search, add this to your facades in `app/config/app.php`: ``` 'aliases' => [ 'Search' => Sdfsky\TipaskXunSearch\Facade::class, ], ``` Configuration ------------- [](#configuration) Publish the config file into your project by running: ``` php artisan vendor:publish --provider="Sdfsky\TipaskXunSearch\ServiceProvider" ``` \###Basic In published config file add descriptions for models which need to be indexed, for example: ``` //@see http://www.xunsearch.com/doc/php/guide/ini.guide "project" => [ "project.name" => "tipask", "project.default_charset" => "utf-8", "server.index" => "127.0.0.1:8383", "server.search" => "127.0.0.1:8384", //remember change FIELD_LABEL_DEFAULT_SEARCH_PK value in Config.php "primary_key" => [ "type" => "id" ], //remember change FIELD_LABEL_DEFAULT_CLASS_ID value in Config.php "class_uid" => [ "index" => "both" ], //remember change FIELD_LABEL_DEFAULT_DB_PK value in Config.php "id" => [ "type" => "numeric" ], "subject" => [ "type" => "title" ], "status" => [ 'type' => "numeric" ], "content" => [ "type" => "body" ] ], 'index' => [ // ... namespace\FirstModel::class => [ 'fields' => [ 'name', 'full_description', // fields for indexing ], 'primary_key' => 'id' //primary_key name in DB, default 'id' ], namespace\SecondModel::class => [ 'fields' => [ 'name', 'short_description', // fields for indexing ] ], // ... ], ``` Usage ----- [](#usage) ### Artisan commands [](#artisan-commands) #### Initialize or rebuild search index [](#initialize-or-rebuild-search-index) For building of search index run: ``` php artisan search:rebuild --verbose ``` #### Clear search index [](#clear-search-index) For clearing of search index run: ``` php artisan search:clear ``` #### Filtering of models in search results [](#filtering-of-models-in-search-results) For filtering of models in search results each model's class can implements `SearchableInterface`. For example: ``` use Illuminate\Database\Eloquent\Model; use DavinBao\LaravelXunSearch\Model\SearchableInterface; class Dummy extends Model implements SearchableInterface { // ... /** * Get id list for all searchable models. */ public static function searchableIds() { return self::wherePublish(true)->lists('id'); } // ... } ``` ### Partial updating of search index [](#partial-updating-of-search-index) For register of necessary events (save/update/delete) `use DavinBao\LaravelXunSearch\Model\SearchTrait` in target model: ``` use Illuminate\Database\Eloquent\Model; use DavinBao\LaravelXunSearch\Model\SearchableInterface; use DavinBao\LaravelXunSearch\Model\SearchTrait; class Dummy extends Model implements SearchableInterface { use SearchTrait; // ... } ``` ### Query building [](#query-building) Build query in several ways: #### Using constructor: [](#using-constructor) By default, queries which will execute search in the **phrase entirely** are created. ##### Simple queries [](#simple-queries) ``` $query = Model::getSearch()->addQuery("clock"); // search by all fields. // or $query = Model::getSearch()->addQuery('name:clock'); // search by 'name' field. // or $query = Model::getSearch()->addQuery('name:clock'); // filter by 'short_description' field. $Ids = Model::getSearch()->addQuery('name:clock')->getIDList(); // filter by 'short_description' field. ``` ### Getting of results [](#getting-of-results) For built query are available following actions: #### Get all found models [](#get-all-found-models) ``` $models = $query->search(); ``` #### Get all found models ID [](#get-all-found-models-id) ``` $models = $query->getIDList(); ``` #### Get count of results [](#get-count-of-results) ``` $count = $query->count(); ``` #### Get limit results with offset [](#get-limit-results-with-offset) ``` $models = $query->limit(5, 10)->get(); // Limit = 5 and offset = 10 ``` #### Sort [](#sort) ``` $query = $query->setSort('chrono', true); ``` ### Highlighting of matches [](#highlighting-of-matches) Highlighting of matches is available for any html fragment encoded in **utf-8** and is executed only for the last executed request. ``` $docs = $search->setQuery('测试')->setLimit(5)->search(); foreach ($docs as $doc) { $subject = $search->highlight($doc->subject); // 高亮处理 subject 字段 $message = $search->highlight($doc->message); // 高亮处理 message 字段 echo $doc->rank() . '. ' . $subject . " [" . $doc->percent() . "%] - "; echo date("Y-m-d", $doc->chrono) . "\n" . $message . "\n"; } ``` License ------- [](#license) Package licenced under the MIT license. ### Health Score 31 — LowBetter than 68% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity21 Limited adoption so far Community11 Small or concentrated contributor base Maturity59 Maturing project, gaining track record Bus Factor1 Top contributor holds 55.6% 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 ~25 days Total 2 Last Release 2899d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/bac51e91f69930a4387b8eb7d88efe63b926b20239395cc771e001f89dad65d7?d=identicon)[sdf\_sky](/maintainers/sdf_sky) --- Top Contributors [![davin-bao](https://avatars.githubusercontent.com/u/5162830?v=4)](https://github.com/davin-bao "davin-bao (5 commits)")[![sdfsky](https://avatars.githubusercontent.com/u/2081383?v=4)](https://github.com/sdfsky "sdfsky (4 commits)") --- Tags laravelxunsearchtipask ### Embed Badge ![Health badge](/badges/sdfsky-tipask-xunsearch/health.svg) ``` [![Health](https://phpackages.com/badges/sdfsky-tipask-xunsearch/health.svg)](https://phpackages.com/packages/sdfsky-tipask-xunsearch) ``` ### Alternatives [mailerlite/laravel-elasticsearch An easy way to use the official PHP ElasticSearch client in your Laravel applications. 934529.3k2](/packages/mailerlite-laravel-elasticsearch)[jeroen-g/explorer Next-gen Elasticsearch driver for Laravel Scout. 397612.3k](/packages/jeroen-g-explorer)[romanstruk/manticore-scout-engine Laravel Manticore Scout Engine 4818.1k](/packages/romanstruk-manticore-scout-engine)[internachi/blade-alpine-instantsearch Algolia instant search as Blade/Alpine.js components 1940.9k](/packages/internachi-blade-alpine-instantsearch)[remoblaser/search A simple to implement Search for your Application 101.5k](/packages/remoblaser-search) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)