phpcms V9 整合 Discuz! X2 教程

整合原理：
UCenter 作服务端；phpsso 与 Discuz! 分别作 UCenter 的客户端应用；phpsso 与 Discuz! 通过 UCenter 发生交互。
phpcms 通过 phpsso 与 Discuz! 发生交互。

第一步：安装 phpcms V9 。安装 Discuz! X2 （同时安装 UCenter）。

第二步：在 UCenter 中添加“phpsso 应用”。
1、管理员登录 Discuz! X2 管理中心，进入“UCenter”，点击“应用管理”。
2、点击“添加新应用”按钮，选择安装方式为”自定义安装“。在展开的”添加新应用“参数配置表中，各项参数配置如下：

    应用名称：phpsso
    应用的主 URL：http：//localhost/phpcms/phpsso_server   （必填，蓝色字体部分为 phpcms 安装路径，视实际情况而定，最后不要带斜线）
    应用 IP：（选填，正常情况下留空即可。如果由于域名解析问题导致 UCenter 与该应用通信失败，请尝试设置为该应用所在服务器的 IP 地址。）
    通信密钥：（必填，phpcms 的通信密钥必须与此设置保持一致，否则 phpsso 将无法与 UCenter 正常通信。）
    应用类型：其它（必选）
    应用的物理路径：（选填，默认留空）
    查看个人资料页面地址：（选填，URL中域名后面的部分，如：/space.php?uid=%s 这里的 %s 代表uid）
    应用接口文件名称：（选填，默认为uc.php）
    标签单条显示模板：（选填，默认留空）
    标签模板标记说明：（选填，默认留空）
    是否开启同步登录：是（可选，开启同步登录后，当用户在登录 Discuz! 时，同时也会登录 phpcms 。）
    是否接受通知：否（可选）

3、提交后，将生成新的应用ID。（记住这个应用ID，在”第三步“中将用到它。）
4、进入“站涨”，点击“UCenter 设置”。"是否允许直接激活"一项，选择“是”。

第三步：配置 phpsso 。
1、管理员登录 phpcms V9 后台管理中心，进入“phpsso”，点击“系统设置”。
2、在“系统设置”下的“UCenter配置”一栏中，各项参数配置如下：
   

是否启用：是
    Ucenter api 地址：http：//localhost/discuz/uc_server     （必填，蓝色字体部分为 Discuz! 安装路径，视实际情况而定，最后不要带斜线）
    Ucenter api IP：（选填，一般不用填写，遇到无法同步时，请填写 UCenter 主机的IP地址）
    Ucenter 数据库主机名：localhost     （必填，视实际情况而定）
    Ucenter 数据库用户名：root     （必填，视实际情况而定）
    Ucenter 数据库密码：root    （视实际情况而定）
    Ucenter 数据库名：discuz     （必填，视实际情况而定）
    Ucenter 数据库表前缀：dz_ucenter_     （必填，视实际情况而定。如果此项填写错误，将导致 phpcms 无法注册新会员！）
    Ucenter 数据库字符集：UTF-8      （必选，视实际情况而定）
    应用id(APP ID)：（必填，该值来在“第二步”中 UCenter 创建的 phpsso 应用时自动。）
    Ucenter 通信密钥：（必填，一定确保该值与在“第二步”中 UCenter 创建的 phpsso 应用密钥相同。）

3、提交。

第四步：查看通信状态。
查看在 UCenter 中创建的 phpsso 应用与 UCenter 通信是否成功。
如果通信成功，则进行下一步。
如果通信失败，请检查“第二步”与“第三步”中的各项参数配置是否正确。

第五步：备份 ./phpsso 。将 Discuz! X2 的 uc_client 复制到 phpsso_server/api/ 下，覆盖原来的 uc_client 。

第六步：修改 Discuz! 会员登录相关
1、修改 templatedefaultmemberlogin.htm 第 36 行，删除
onsubmit="{if $this->setting['pwdsafety']}pwmd5('password3_$loginhash');{/if}pwdclear = 1;
ajaxpost('loginform_$loginhash', 'returnmessage_$loginhash', 'returnmessage_$loginhash', 'onerror');
return false;"

2、修改 templatedefaultmemberlogin_s imple.htm 第 3 行，删除
onsubmit="return lsSubmit()"
3、修改 /source/function/function_message.php 第 78 行，查找
$param['header'] = true;
替换为：
$param['header'] = false;

常见问题解答：
1、整合完成后，在 phpcms 注册、登录均“失败”怎么办？
答：这可能是由于无法连接到 UCenter 的原因。可以尝试修改文件
        phpsso_server/api/uc_client/model/base.php
        将第 74 行的

$this->db->connect(UC_DBHOST, UC_DBUSER, UC_DBPW, '', UC_DBCHARSET, UC_DBCONNECT, UC_DBTABLEPRE);
替换为：

$this->db->connect(UC_DBHOST, UC_DBUSER, UC_DBPW, UC_DBNAME, UC_DBCHARSET, UC_DBCONNECT, UC_DBTABLEPRE);
2、为什么不使用官方自带的 UCenter 客户端？
答：官方自带的 UCenter 客户端版本为 1.5.1 Release 20100501 ，而 Discuz! X2 使用的版本为 1.6.0 。版本不一致，无法整合成功。
3、整合成功后，能达到怎样的效果？
答：实现 phpcms 与 Discuz! 会员的双向同步注册、登录、退出等。
4、第一次在 phpcms 注册的会员必须在 Discuz! 登录一次，下次才会同步登录。这正常吗？
答：正常。因为 phpsso 作为 UCenter 的第三方应用，是需要在 Discuz! 登录激活的。
5、会员在 phpcms 登录后，没有同步登录到 Discuz! 怎么办？
答：这很可能是由于 phpsso 的“UCenter配置”有误引起的，请仔细检查各项参数设置。
6、会员在 Discuz! 登录后，没有同步登录到 phpcms 怎么办？
答：这很可能是由于 UCenter 的 phpsso 应用配置有误引起的，请仔细检查各项参数设置。