[Xunsearch PHP-SDK](http://www.xunsearch.com) v1.4.8 權威指南 # 添加文檔 搜索數據庫在創建之初或運行過程中，都免不了要往索引數據庫添加新文檔用于檢索。 首先您必須創建類型為 [XSDocument](#) 的文檔對象，關于文檔對象的創建請參閱[XSDocument 文檔](#) 中關于**索引文檔**的部分。特別要指出的是，文檔中的主鍵字段值必須明確指定（即類型為 `ID` 的字段），否則在添加、更新過程中會拋出異常，其余字段若未指定則相當于忽略這些字段。 索引文檔創建后，再調用 [XSIndex::add](#) 方法將文檔加入索引數據庫中即可。 > **Note:** 如果索引數據庫中已存在主鍵值相同的文檔，并不會有沖突提示，文檔仍會 添加成功并且不會有任何沖突提醒。所以除非您明確知道此為新文檔，否則建議使用 [更新文檔](#)。 > 此外，如果您自行擴展了 [XSDocument](#)，請使用您自定定義的文檔類創建對象。 參考代碼如下： ~~~ $data = array( 'pid' => 234, // 此字段為主鍵，必須指定 'subject' => '測試文檔的標題', 'message' => '測試文檔的內容部分', 'chrono' => time() ); // 創建文檔對象 $doc = new XSDocument; $doc->setFields($data); // 添加到索引數據庫中 $index->add($doc); ~~~ $Id$ [? 索引概述](#) [更新、修改文檔 ?](#) Copyright ? 2008-2011 by [杭州云圣網絡科技有限公司](http://www.xunsearch.com) All Rights Reserved.