官方文档:http://www.xunsearch.com/doc/php/guide/start.installation
一、安装
3.待命令运行结束后,如果没有出错中断,则表示顺利安装完成,然后就可以启动/重新启动 xunsearch
的后台服务,下面命令中的 $prefix
请务必替换为您的安装目录,而不是照抄。
cd $prefix ; bin/xs-ctl.sh restart4. 可以开启开机自启 linux下
/etc/rc.local 中添加 /usr/local/xunsearch/bin/xs-ctl.sh restart
5.引用文件
如果您的搜索应用程序和 xunsearch
在同一台服务器,则无需复制任何代码,在开发的时候直接包含 入口文件 $prefix/sdk/php/lib/XS.php
即可。代码如下:
require_once '$prefix/sdk/php/lib/XS.php';
从现在开始的文档及示范代码中我们都假定您将 xunsearch
安装在 $prefix
目录中,而不再另行说明。
基础运行条件要求 PHP 最低版本为 5.2.0,随着功能需求的不同可能还会用到一些其它扩展,具体请在 命令行环境里运行我们提供的检测脚本。如果您的 php
可执行文件不在默认搜索路径中,假设是安装在 /path/to/bin/php
请使用第二种方式运行。运行方式如下:
1. $prefix/sdk/php/util/RequiredCheck.php 2. /path/to/bin/php $prefix/sdk/php/util/RequiredCheck.php 3. $prefix/sdk/php/util/RequiredCheck.php -c gbk
运行结果输出的中文编码默认为 UTF-8
,如果您使用 GBK
环境请在运行命令最后加上 -c GBK
。 运行结果会给出一个可视化的表格说明检测结果,并在最终给出检测结论,告诉您是否符合运行的基础要求。
至此,安装和准备工作已经完成了,您可以开始使用 Xunsearch PHP-SDK 开发自己的搜索应用了。
Note: 在开始安装前,无论如何请先安装一次最新发布的完整版本,以便将所有的运行依赖库安装到位。
我们的源代码托管在 github 上。您可以直接浏览代码仓库,也可以通过以下方式之一取得源代码:
git clone git://github.com/hightman/xunsearch.git git clone https://github.com/hightman/xunsearch.git
如果要编译安装这份源代码,您还必须在主机环境上安装相关的 autoconf, automake 工具,然后运行 下面指令完成准备工作。
cd xunsearch/ chmod +x acprep ./acprep
在完成上述的准备工作后,接下来编译安装 xunsearch 就和常见的开源软件类似,假设您的安装目录为 $prefix
,然后按以下步骤操作即可:
./configure --prefix=$prefix make make install
vi /etc/sysconfig/iptables -A INPUT -m state --state NEW -m tcp -p tcp --dport 8383 -j ACCEPT #允许8383端口通过防火墙 -A INPUT -m state --state NEW -m tcp -p tcp --dport 8484 -j ACCEPT #允许8384端口通过防火墙