[coreseek/sphinx学习笔记2]--安装

[参考Coreseek 全文检索服务器 2.0 (Sphinx 0.9.8)参考手册，详情见 http://www.coreseek.cn/docs/sphinx_doc_zhcn_0.9.pdf]

2.1 平台
目前的阶段，Sphinx 的 Windows 版可用于测试和调试，但不建议用于生产系统。突出的两个问题是：
（1）缺少并发查询的支持；
（2）缺少索引数据热切换的支持。虽然目前已经有成功的生产环境克服了这两个问题，仍然不推荐在 Windows 下运行 Sphinx 提供高强度的搜索服务。

2.2 安装步骤
（1）将你下载的 tar 包解压，并进入 sphinx 子目录:
    $ tar xzvf sphinx-0.9.7.tar.gz
    $ cd sphinx
（2）运行 configuration 程序：
    $ ./configure
    configure 程序有很多运行选项。完整的列表可以通过使用 --help 开关得到。最重要的如下：
        --prefix, 定义将 Sphinx 安装到何处;
        --with-mysql, 当自动检测失败时，指出在那里能找到 MySQL 头文件和库文件;
        --with-pgsql, 指出在那里能找到 PostgreSQL 头文件和库文件。
（3）制作二进制程序：
    $ make
（4）按照二进制程序到你选好的目录下：
    $ make install

2.3 常见问题及解决
（1）如果 configure 程序没有找到 MySQL 的头文件和库文件，请试图检查 mysql-devel 这个包是否安装了。在有些系统上，默认安装包括这个包。
（2）如果 make 程序给出如下错误提示，
    /bin/sh: g++: command not found
    make[1]: *** [libsphinx_a-sphinx.o] Error 127
    请检查 gcc-c++ 这个包是否安装了。
（3）如果你在编译时得到如下错误
    sphinx.cpp:67: error: invalid application of `sizeof' to incomplete type `Private::SizeError<false>'
    这意味着某些编译时的类型检查失败了，一个有可能的原因是在你的系统上类型 off_t 的长度小于 64bit。一个快速的修复手段是，你可以修改 sphinx.h ，将在定义类型SphOffset_t处，将 off_t 替换成 DWORD，需要注意，这种改动将使你的全文索引文件不能超过 2GB。
    即便这种修改有用，也请汇报这一问题，在汇报中请包括具体的错误信息以及操作系统编译器的配置情况。这样，我可能能够在下一个版本中解决这一问题。

2.4 使用入门
以下所有的例子都假设你将 sphinx 安装在目录 /usr/local/sphinx 中了。为了使用 Sphinx，你需要：
（1）创建配置文件
    缺省的配置文件名为 sphinx.conf。全部的 Sphinx 提供的程序默认都在当前工作的目录下寻找该文件。
    由 configure 程序生成的示例配置文件 sphinx.conf.dist 中包括全部选项的注释，复制并编辑这个文件使之适用于你的具体情况：
    $ cd /usr/local/sphinx/etc
    $ cp sphinx.conf.dist sphinx.conf
    $ vi sphinx.conf
    在示例配置文件中，将试图对 MySQL 数据库 test 中的 documents 表建立索引；
    因此在这里还提供了 example.sql 用于给测试表增加数据用于测试：
    $ mysql -u test < /usr/local/sphinx/etc/example.sql
（2）运行 indexer 创建你的全文索引：
    $ cd /usr/local/sphinx/etc
    $ /usr/local/sphinx/bin/indexer
（3）检索你新创建的索引！
    你可以使用 search 实用程序可以从命令行对索引进行检索：
    $ cd /usr/local/sphinx/etc
    $ /usr/local/sphinx/bin/search test
    
注意：如果要从 PHP 脚本检索索引，你需要：
1. 运行守护进程 searchd，PHP 脚本需要连接到 searchd 上进行检索 :
    $ cd /usr/local/sphinx/etc
    $ /usr/local/sphinx/bin/searchd
2. 运行 PHP API 附带的 test 脚本（运行之前请确认 searchd 守护进程已启动）：
    $ cd sphinx/api
    $ php test.php test
3. 将 API 文件(位于 api/sphinxapi.php) 包含进你自己的脚本，开始编程。