[Xunsearch PHP-SDK](http://www.xunsearch.com) v1.4.8 权威指南
1. [按主键删除](#)
1. [按特定字段上的索引词删除](#)
# 删除文档
当某一条数据(文档)已经过期或失效,则必须将它从索引数据库中移除,才能从搜索结果中消失。在 `Xunsearch PHP-SDK` 中删除文档有下面两种方式。
### 1. 按主键删除[?]()
主键是指项目中类型为 `id` 的字段,删除是调用的是 [XSIndex::del](#) 方法,传入参数必须是要删除的文档的`主键值`,或一系列主键值组成的`数组`。
~~~
$index->del('123'); // 删除主键值为 123 的记录
$index->del(array('123', '789', '456')); // 同时删除主键值为 123, 789, 456 的记录
~~~
### 2. 按特定字段上的索引词删除[?]()
在项目中,除了主键之外我们通常也会对其它字段进行索引。如果该字段的索引方式(即配置文件中 `index` 选项的值)为 `self` 或 `both`,那么也可以根据该字段上的**索引词**进行删除。
特别注意是根据**索引词**删除而不是该字段的值,索引词是指该字段值经过分词器处理后得到的词汇。对于索引方式为 `mixed` 的,如需删除,请把字段名设为类型为 `body` 的字段的名称。
~~~
$index->del('abc', 'subject'); // 删除字段 subject 上带有索引词 abc 的所有记录
$index->del(array('abc', 'def'), 'subject'); // 删除字段 subject 上带有索引词 abc 或 def 的所有记录
~~~
> **Note:** 如果您删除时指定的主键或字段索引词包含中文字符,则它的编码必须与整个项目的 默认字符集 [XS::defaultCharset](#) 一致。
> 此外删除操作和[添加文档](#)一样,也是一个异步行为。
$Id$
[« 更新、修改文档](#)
[清空索引 »](#)
Copyright © 2008-2011 by [杭州云圣网络科技有限公司](http://www.xunsearch.com)
All Rights Reserved.
![](https://box.kancloud.cn/2015-09-10_55f11d036151e.gif)
![](https://box.kancloud.cn/2015-09-10_55f11d0373aaf.gif)
![](https://box.kancloud.cn/2015-09-10_55f11d037c3af.gif)
- 权威指南
- 新手上路
- 最新主要变动
- 概述
- 关于 Xunsearch PHP-SDK
- 安装、升级
- 体验 demo 项目
- 开发规范
- 开发流程
- 了解基础对象
- 基础对象概述
- XS 项目
- XSException 异常
- XSDocument 文档
- XSIndex 索引管理
- XSSearch 搜索
- XSTokenizer 分词接口
- 编写项目配置文件
- 项目配置详解
- 自定义分词器
- 编写第一个配置文件
- 管理索引
- 索引概述
- 添加文档
- 更新、修改文档
- 删除文档
- 清空索引
- 平滑重建索引
- 使用索引缓冲区
- 自定义SCWS词库
- 使用搜索
- 搜索概述
- 构建搜索语句
- 获取搜索匹配结果
- 获取搜索匹配数量
- 获取热门搜索词
- 获取相关搜索词
- 搜索建议和纠错
- 按字段值分面搜索
- 使用辅助工具
- RequiredCheck 运行检测
- Indexer 索引管理器
- Quest 搜索测试工具
- SearchSkel 生成搜索代码
- IniWizzard 配置文件向导
- Logger 搜索日志管理
- 专题
- 同义词搜索功能
- 在SDK中使用SCWS分词
- API 指南
- XS
- XS
- XSCommand
- XSComponent
- XSDocument
- XSErrorException
- XSException
- XSFieldMeta
- XSFieldScheme
- XSIndex
- XSSearch
- XSServer
- XS.tokenizer
- XSTokenizer
- XSTokenizerFull
- XSTokenizerNone
- XSTokenizerScws
- XSTokenizerSplit
- XSTokenizerXlen
- XSTokenizerXstep
- XS.util
- XSCsvDataSource
- XSDataFilter
- XSDatabaseDataSource
- XSDebugFilter
- XSJsonDataSource
- XSUtil
- XS.util.db
- XSDatabase
- XSDatabaseMySQL
- XSDatabaseMySQLI
- XSDatabasePDO
- XSDatabasePDO_MySQL
- XSDatabasePDO_PgSQL
- XSDatabasePDO_SQLite
- XSDatabasePgSQL
- XSDatabaseSQLite
- XSDatabaseSQLite3
- XS.utilf
- XSDataSource
- 其它文档
- 关于 xunsearch
- 特色和优势
- Xunsearch 架构简图
- 下载 Xunsearch
- 商业服务与支持
- XunSearch 授权许可证