||================================================================================||
||   xweibo标准版升级到OAuth 2.0接口方法说明文档(patch_20120911_oauth2.0)         ||
||================================================================================||

发布时间：2012-09-11
补丁包下载地址：http://bbs.x.weibo.com/forum.php?mod=viewthread&tid=136155

以下文档将阐述如何将xweibo标准版升级到使用新浪微博V2接口（OAuth 2.0）。 
升级步骤包含两大部分：open.weibo.com设置、xweibo标准版文件升级
 
==========================
一、open.weibo.com设置
==========================
（1）到open.weibo.com，找到你的应用，然后点击“应用信息”->“高级信息”。
如果找不到，多半是因为应用被划归到“我的网站”下，此时请直接访问如下URL：
http://open.weibo.com/apps/【你的appkey】/info/advanced
 
（2）有关OAuth 2.0的安全设置，推荐采用“域名绑定”方式，这样你的appkey可以用在该网站下别的应用中。但修改此项，需要重新审核。
修改规则：
（A）如果该appkey只确定用于某个域名下（比如仅用于http://t.xweibo.com），则在绑定域名中填写具体的域名名称（如：t.xweibo.com）
（B）如果该appkey还用于多个分域名下（比如除了用于http://t.xweibo.com ，还用于http://bbs.xweibo.com ， http://www.xweibo.com ......），则只填写根域名即可（如xweibo.com）
（请注意：如果“域名绑定”内已经绑定了根域名，则无需修改）
 
（3）如果你不想采用“域名绑定”方式、并且确信该appkey只用于xweibo，则可以在“OAuth2.0 授权设置”，直接填写xweibo OAuth 2.0的回调地址。好处是不用重新审核：
授权回调页：http://【xweibo访问url路径】/oauth2_callback.php
取消授权回调页：http://【xweibo访问url路径】/oauth2_callback_cancel.php
（请注意：如果应用划归被划归到“我的网站”，则不能采用该方式，只能采用“域名绑定”方式）
 
 
==========================
二、xweibo标准版文件升级
==========================
（一）如果我使用的是xweibo 2.0、xweibo 2.1......
xweibo 2.0和2.1不提供OAuth 2.0的接口补丁，必须要升级到xweibo 2.2才能继续使用。 
（1）下载xweibo 2.2完整安装包（必须为2012-09-11及以后发布的完整安装包）
（2）按照Xweibo 升级文档（readme/upgrade.txt）进行升级到xweibo 2.2的升级操作。
（3）升级完毕后，运行网站看是否存在异常
（4）查看“三、其它注意事项”
 
 
（二）如果我使用的是xweibo 2.2，并且没有修改任何文件......
（1）备份程序的所有文件以及数据库表，并且保存到其他地方，以便升级失败的时候及时快速恢复 
（2）解压升级包
（3）如果你已经将xweibo 2.2升级到RELEASE 20120405版本，那就将升级包下的“from_20120405_to_20120911/upload”文件夹下的所有文件和文件夹上传，直接覆盖原文件；
否则，应将升级包下的“patch_all_to_20120911/upload”文件夹下的所有文件和文件夹上传，直接覆盖原文件。
（4）运行网站看是否存在异常
（5）到后台重新授权代理账号
（6）查看“三、其它注意事项”
 
 
（三）如果我使用的是xweibo 2.2，但修改过任何文件......
（1）备份程序的所有文件以及数据库表，并且保存到其他地方，以便升级失败的时候及时快速恢复 
（2）解压升级包到别的地方
（3）使用文件比对工具（比如beyond compare）进行升级包文件和网站文件逐一比对并修改。
其中，如果你曾经修改过weibo.class.php，则可不用比对，直接将旧的重命名为weibo_v1.class.php即可。
请注意，如果你已经将xweibo 2.2升级到RELEASE 20120405版本，比对的升级包文件夹应该为“from_20120405_to_20120911/upload”；
否则，比对的升级包文件夹应该为“patch_all_to_20120911/upload”。
（4）将最终修改的文件上传到网站，并覆盖源文件
（5）运行网站看是否存在异常
（6）到后台重新授权代理账号
（7）查看“三、其它注意事项”
 
 
==========================
三、其它注意事项
==========================
（1）升级后，所有用户均需要重新使用新浪微博登录，来重新授权该应用
（2）由于access token已经非永久授权，若开启xweibo和dz的通讯将会存在问题，故应在升级后，断开xweibo和dz的通讯，并且以后均不能启用它
（3）由于access token已经非永久授权，故后台的代理账号也会有过期时间，请定期登录到后台进行代理帐号的重新授权

