ThinkPHP官方文档的附录(http://thinkphp.cn/Manual/218)对常量、配置、函数库和类库都有非常完备的说明,本附录仅说明ThinkSNS2.0特有的全局变量、常量、函数库和类库。
4.1全局变量
$ts:存储全局信息的数组,包括站点信息、用户信息、当前节点信息、用户的应用信息、当前广告信息、页脚文章信息等。
代码中通过global $ts;声明即可使用,模板中可以直接通过{$ts['param']}调用。
4.2常量
SITE_PATH: 系统根目录
SITE_URL: 站点根URL
APPS_PATH: /apps/目录
ADDON_PATH: /addons/目录
UPLOAD_PATH: /data/upload/目录,所有的上传文件都存放于此
30 / 32
4.3函数库
系统函数库位于/core/sociax/functions.php和/core/sociax/extend.php两个文件,这里仅列举常用函数,全部函数和及参数说明请参阅文件注释。
function.php
model: 实例化公共model
service: 实例化服务
widget: 实例化Widget
extends.php
canAccess: 根据access.inc.php检查是否有权访问当前节点
convert_ip: 获取给定IP的物理地址
desdecrypt: DES解密函数
desencrypt: DES加密函数
format: 格式化微博,替换表情/@用户/话题
formatComment: 格式化评论, 替换表情和@用户
friendlyDate: 友好的时间显示
get_client_ip: 获取客户端IP地址
getAppAlias: 根据应用名获取应用别名
getFollowState: 获取关注状态
getFrom: 获取微博来源
getLocation: 根据给定的省市的代码获取实际地址
getOnlineUserCount: 获取当前在线用户数(有效期15分钟)
getSex: 根据sexid获取性别
getShortUrl: 获取给定URL的短地址
getUids: 获取给定字符串中被@用户的uid数组
getUserEmail: 获取给定用户的Email
getUserFace: 获取用户头像
isBlackList: 是否为黑名单成员
isEmailAvailable: 检查Email是否可用
isSubmitLocked: 检查表单是否提交
isfavorited: 检查给定用户是否收藏给定微博
isValidEmail: 检查Email地址是否合法
lockSubmit: 锁定表单提交(防止重复提交表单)
object_to_array: 通过循环遍历将对象转换为数组
setOnline: 将给定用户设为在线
unlockSubmit: 表单解锁
31 / 32
4.4类库
系统类库包括公共Model、服务和Widget,分别位于/addons/models/, /addons/services/, /addons/widgets/目录,这里仅列举类库的概览,详细实现和使用方法请参阅具体代码的注释
服务
CreditService: 积分服务
FeedService: 动态服务
MailService: 邮件服务
NotifyService: 通知服务
PassportService: 通行证服务
ShortUrlService: 短地址服务
SystemPopedomService: 系统权限服务
ValidationService: 验证服务
XattachService: 附件服务。
公共Model
AppModel: 应用模型
AreaModel: 地区模型
AttachModel: 附件模型
ExpressionModel: 表情模型
FriendModel: 好友模型
GlobalCommentModel: 全局评论模型
InviteModel: 邀请模型
MedalModel: 勋章模型
MessageModel: 短消息模型
MyopModel: 漫游应用模型
TemplateModel: 模板模型
UserCountModel: 用户统计模型
UserGroupModel: 用户组模型
UserModel: 用户模型
XdataModel: Key-Value引擎模型
Widget
CommentWidget: 评论Widget
MedalWidget: 勋章Widget
RelatedUserWidget: 可能感兴趣的人Widget
4.1全局变量
$ts:存储全局信息的数组,包括站点信息、用户信息、当前节点信息、用户的应用信息、当前广告信息、页脚文章信息等。
代码中通过global $ts;声明即可使用,模板中可以直接通过{$ts['param']}调用。
4.2常量
SITE_PATH: 系统根目录
SITE_URL: 站点根URL
APPS_PATH: /apps/目录
ADDON_PATH: /addons/目录
UPLOAD_PATH: /data/upload/目录,所有的上传文件都存放于此
30 / 32
4.3函数库
系统函数库位于/core/sociax/functions.php和/core/sociax/extend.php两个文件,这里仅列举常用函数,全部函数和及参数说明请参阅文件注释。
function.php
model: 实例化公共model
service: 实例化服务
widget: 实例化Widget
extends.php
canAccess: 根据access.inc.php检查是否有权访问当前节点
convert_ip: 获取给定IP的物理地址
desdecrypt: DES解密函数
desencrypt: DES加密函数
format: 格式化微博,替换表情/@用户/话题
formatComment: 格式化评论, 替换表情和@用户
friendlyDate: 友好的时间显示
get_client_ip: 获取客户端IP地址
getAppAlias: 根据应用名获取应用别名
getFollowState: 获取关注状态
getFrom: 获取微博来源
getLocation: 根据给定的省市的代码获取实际地址
getOnlineUserCount: 获取当前在线用户数(有效期15分钟)
getSex: 根据sexid获取性别
getShortUrl: 获取给定URL的短地址
getUids: 获取给定字符串中被@用户的uid数组
getUserEmail: 获取给定用户的Email
getUserFace: 获取用户头像
isBlackList: 是否为黑名单成员
isEmailAvailable: 检查Email是否可用
isSubmitLocked: 检查表单是否提交
isfavorited: 检查给定用户是否收藏给定微博
isValidEmail: 检查Email地址是否合法
lockSubmit: 锁定表单提交(防止重复提交表单)
object_to_array: 通过循环遍历将对象转换为数组
setOnline: 将给定用户设为在线
unlockSubmit: 表单解锁
31 / 32
4.4类库
系统类库包括公共Model、服务和Widget,分别位于/addons/models/, /addons/services/, /addons/widgets/目录,这里仅列举类库的概览,详细实现和使用方法请参阅具体代码的注释
服务
CreditService: 积分服务
FeedService: 动态服务
MailService: 邮件服务
NotifyService: 通知服务
PassportService: 通行证服务
ShortUrlService: 短地址服务
SystemPopedomService: 系统权限服务
ValidationService: 验证服务
XattachService: 附件服务。
公共Model
AppModel: 应用模型
AreaModel: 地区模型
AttachModel: 附件模型
ExpressionModel: 表情模型
FriendModel: 好友模型
GlobalCommentModel: 全局评论模型
InviteModel: 邀请模型
MedalModel: 勋章模型
MessageModel: 短消息模型
MyopModel: 漫游应用模型
TemplateModel: 模板模型
UserCountModel: 用户统计模型
UserGroupModel: 用户组模型
UserModel: 用户模型
XdataModel: Key-Value引擎模型
Widget
CommentWidget: 评论Widget
MedalWidget: 勋章Widget
RelatedUserWidget: 可能感兴趣的人Widget