phpcms V9 整合 Discuz! X2 标准教程

关注

转载最新推荐文章于 2025-11-21 00:13:52 发布 1.4k 阅读 AI 写同款· GEO 优化 ›

整合原理：
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、修改 template\default\member\login.htm 第 36 行，删除
onsubmit="{if $this->setting['pwdsafety']}pwmd5('password3_$loginhash');{/if}pwdclear = 1;ajaxpost('loginform_$loginhash', 'returnmessage_$loginhash', 'returnmessage_$loginhash', 'onerror');return false;"

2、修改 template\default\member\login_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! 登录激活的。
如果您嫌在 Discuz! 激活麻烦，可以与我联系，我们将提供商业服务，帮您解决这个问题。
5、会员在 phpcms 登录后，没有同步登录到 Discuz! 怎么办？
答：这很可能是由于 phpsso 的“UCenter配置”有误引起的，请仔细检查各项参数设置。
6、会员在 Discuz! 登录后，没有同步登录到 phpcms 怎么办？
答：这很可能是由于 UCenter 的 phpsso 应用配置有误引起的，请仔细检查各项参数设置。