Xunsearch PHP-SDK v1.4.9 权威指南

开发规范

在开始任何开发之前,有必要先强调一下开发规范。开发规范并不是强制性的要求,而只是 为了使项目及代码更利于维护、阅读而制定的一些习惯行为公约。

1. 目录设置?

无论您是否将 PHP-SDK 的代码拷出单独使用,强烈建议保留现有的目录结构。

开发的项目配置 ini 文件统一放入 $prefix/sdk/php/app 目录。

自定义或扩展的类库请统一放入 $prefix/sdk/php/lib 以便 XS 进行 autoload

2. 保留字?

所有 Xunsearch PHP-SDK 的系统类库定义时均以 XS 开头,为避免冲突,请自行编写 代码和定义时不要也以 XS 开头。

3. 自定义分词?

Xunsearch 在项目配置时支持针对某些字段自定义分词。每个自定义分词功能单独使用一个 文件名,命名为 XSTokenizerXyz.class.php,其中 Xyz 是您自己的分词名称,文件统一 放入 $prefix/sdk/php/lib 目录,分词类名即为 XSTokenizerXyz,该类必须实现 XSTokenizer 接口。

4. 字段设计?

多数搜索项目可能都是和相关的数据库联动的,出于开发方便,强烈建议让搜索项目的字段命名 和实际数据库内的命名一致。在此基础下推荐以下命名规范:

5. 异常处理?

由于 Xunsearch PHP-SDK 全面采用面向对象技术,所有失败的操作均抛出类型为 XSException 的异常,请在执行主线中捕捉它。具体参见 XSException 异常 章节的有关介绍。

$Id$
Copyright © 2008-2011 by 杭州云圣网络科技有限公司
All Rights Reserved.