Scout 风格 API
search、where、orderBy、paginate，迁移主要换一个 trait。
一套 API，换引擎不改业务代码
Searchable trait 把模型、观察者与查询构建器串起来，搜索请求最终交给统一的 Engine 契约。
配置根能从 Webman 插件路径、SCOUT_CONFIG_KEY、Yii params 或 Scout::configure() 解析，同一份代码跑在六种框架与原生 PHP 上。
- Scout 兼容的查询构建器
- 九个引擎同一契约
- 索引同步可队列可降级
9搜索引擎
6框架适配
v2.2.0当前版本
探探
探探，一只拿着放大镜的侦察犬，嗅出文档、建立索引，再按需把它们找回来。
嗅一嗅，文档就排好队了。搜索、索引与引擎各就各位
模型、构建器与引擎之间只有一层契约。
九个搜索引擎
OpenSearch、Elasticsearch、Meilisearch 等九种引擎。
高级查询
时间范围、地理距离、全文检索、KNN 向量排序与分面聚合。
索引自动同步
saved、deleted、restored 事件触发写入，支持软删除文档。
队列化索引
Webman Redis Queue 可用时异步，缺失时记录日志并降级同步。
六框架接入
Webman、Laravel、Hyperf、ThinkPHP、Yii2、Yii3 与原生 PHP。
同一能力，Rust 与 Go 版本
PHP 版本之外，同一套搜索能力也有 Rust 与 Go 实现。
Rust
v0.9.0
Go
v1.4.0
从引擎到多框架落地
版本记录来自真实提交与发布。
v2.2.0
Laravel 13 适配
支持 Laravel 13 与 symfony/console 8，依赖解析跟上新框架栈。
v2.1.6
console 8 兼容修复
修复 symfony/console 8.x 下的安装失败与致命错误。
v2.1.0
原生 PHP 与审查修复
新增原生 PHP 配置入口与项目宠物，集中修复一轮审查问题。
v2.0.0
多框架支持
新增多框架接入支持，并补齐对应文档。
架构与设计
点击图片放大查看。
安装与使用
先安装，再跑一个最小示例。
安装
composer require erikwang2013/webman-scout最小示例
use Erikwang2013\WebmanScout\Searchable;
use support\Model;
class Product extends Model
{
use Searchable;
public function searchableAs(): string
{
return 'products';
}
}
$products = Product::search('phone')
->where('status', 1)
->paginate(15);安装
cargo add rust-scout
cargo add tokio --features macros,rt
cargo add serde_json最小示例
use rust_scout::{Engine, EngineManager, ScoutConfig, SearchBuilder, SearchDocument};
#[tokio::main]
async fn main() -> rust_scout::Result<()> {
let engine = EngineManager::new(ScoutConfig::collection()).engine()?;
let doc = SearchDocument::new("book-1", serde_json::json!({
"title": "Programming Rust"
}))?;
engine.update(&[doc]).await?;
let result = engine
.search(SearchBuilder::new("rust").within("default").take(10))
.await?;
println!("total = {}", result.total);
Ok(())
}安装
go get github.com/erikwang2013/go-scout最小示例
type Post struct { ID int; Title string }
func (p Post) ScoutKey() any { return p.ID }
func (p Post) TableName() string { return "posts" }
func (p Post) ShouldBeSearchable() bool { return p.Title != "" }
func (p Post) ToSearchableArray() map[string]any { return map[string]any{"title": p.Title} }
func main() {
ctx := context.Background()
s := scout.NewWithConfig(scout.DefaultConfig())
engines.Register(s.Manager)
sr := s.Searchable(&Post{}, scout.NewMemorySource(Post{ID: 1}))
_, _ = sr.MakeAllSearchable(ctx, 0)
_, _ = sr.Search(ctx, "Go", nil).Take(10).Get(ctx)
}探探的十二种表情
鼠标停一停，它会换一种心情。