/includes/bootstrap.inc

Description
Constants
DIDA_VERSION = '1.0 alpha 3' (line 4)
Functions
arg (line 3388)

将路径解析为数组,以 / 分割,从 0 开始

void arg ([(int) $index = NULL], [(string) $path = NULL])
  • (int) $index: 索引,从 0 开
  • (string) $path: 路径,默认为 $_GET['q']
bootstrap (line 13)

系统初始化

void bootstrap ((string) $op, [(array) $inc = NULL])
  • (string) $op: 加载类型
  • (array) $inc: 加载文件
cache_del_file (line 3576)

删除缓存目录的文件

(bool) cache_del_file ((string) $filename)
  • (string) $filename: 文件名称
cache_system_get_file (line 3563)

从缓存目录获取 php 文件

void cache_system_get_file ((string) $filename, (string) $var_name)
  • (string) $filename: 文件名
  • (string) $var_name: 变量名
cache_system_set_file (line 3528)

写入 php 文件

  • return: 失败返回 false,成功返回文件路径
bool|string cache_system_set_file ((string) $filename, (string) $var_name, (*) $value, [(string) $path = 1])
  • (string) $filename: 文件名
  • (string) $var_name: 变量名
  • (*) $value: 待保存的数据
  • (string) $path: 保存路径,默认保存在缓存目录
check_plain (line 3159)

字符串检查,去除 html 标签

(string) check_plain ((string) $text)
  • (string) $text: 待检查的字符串
check_url (line 3207)

检查 uri 是否合法

(bool) check_url ((string) $uri)
  • (string) $uri: 待检查的 uri
conf_init (line 1189)

获取域名、路径、cookie 作用域、session id

void conf_init ()
custom_del (line 666)

删除自定义数据

void custom_del ((string) $name)
  • (string) $name: 名称
custom_get (line 618)

读取自定义数据

(*); custom_get ((string) $name, [(*) $default = NULL])
  • (string) $name: 名称
  • (*) $default: 默认值,若没有请求的配置,则返回此值
custom_set (line 593)

写入自定义数据

(bool) custom_set ((string) $name, (*) $value)
  • (string) $name: 名称
  • (*) $value: 数据
dd_add_css (line 2589)

向页面添加 css 或文件

(array) dd_add_css ([ $data = NULL], [(string) $type = 'module'], [(string) $media = 'all'], [(bool) $cached = true], (string) $path)
  • (string) $path: css 或 css 文件路径
  • (string) $type: 添加类型,该类型决定加载顺序:core -> module -> theme 特殊类型 inline,直接输出一段 css
  • (string) $media: media 类型
  • (bool) $cached: 是否缓存
  • $data
dd_add_js (line 2858)

向当前页面添加 js

void dd_add_js ([(string) $data = NULL], [(string) $type = 'module'], [ $cached = true], [(string) $scope = 'header'], [(bool) $defer = false], (bool) $cache)
  • (string) $data: js 文件路径
  • (string) $type: 类型,决定加载顺序:core -> module -> theme
  • (bool) $cache: 是否合并缓存
  • (string) $scope: 加载位置:header、footer
  • (bool) $defer: defer 模式
  • $cached
dd_array2_to (line 3414)

将多维数组转为一维

(array) dd_array2_to ([(string) $op = 'value'],  $array, [ &$arr = array()], (array) $multi, (array) &$array)
  • (string) $op: 是保留索引,还是值,默认保留值
  • (array) $multi: 待转换多维数组
  • (array) &$array: 转换后的一维数组
  • $array
  • &$arr
dd_array_to_string (line 2299)

将数组格式化输出,用于调试

(string) dd_array_to_string ((array) $array)
  • (array) $array
dd_attributes (line 506)

将数组解析为字符串,以半角空格分隔,多用于 html 元素属性解析

  • return: 如:alt="test" title="title"
(string) dd_attributes ((array) $attributes)
  • (array) $attributes: 待解析数组,如:array('alt' => 'test', 'title' => 'title'
dd_decode_ascii (line 3500)

ascii 编码的字符串转 utf-8 字符串

(string) dd_decode_ascii ((string) $str, [(string) $imp = '.'])
  • (string) $str: 待转换字符串
  • (string) $imp: 分隔符
dd_decrypt (line 1073)

字符串解密

  • return: 解密后的字符串
(string) dd_decrypt ((string) $text, [(string) $key = NULL])
  • (string) $text: 待解密的字符串
  • (string) $key: 密钥,与加密时的一致
dd_dialog_att (line 2223)

jquery dialog 弹出层设置

  • return: 可用于 url() 的数
(array) dd_dialog_att ([(int) $height = 400], [(int) $width = 600], [(bool) $iframe = true], [(string) $inlineId = NULL], [(bool) $reload = NULL])
  • (int) $height: 高度
  • (int) $width: 宽度
  • (bool) $iframe: 以 iframe 模式加载
  • (string) $inlineId: 显示页面指定 id 的内
  • (bool) $reload: 关闭后是否刷新当前页
dd_encode_ascii (line 3471)

utf-8 字符转 ascii 编码

(string) dd_encode_ascii ((string) $str, [(string) $imp = '.'])
  • (string) $str: 待转换字符串
  • (string) $imp: 分隔符
dd_encrypt (line 1052)

将字符串简单加密,并不能保证安全性,仅比明文好一点

  • return: 加密后的字符串
(string) dd_encrypt ((string) $text, [(string) $key = NULL])
  • (string) $text: 待加密的字符串
  • (string) $key: 密钥,解密时,必须指定密钥,才可正确获取数据
dd_encrypt_key (line 1102)

获取密钥的 ASCII 值

  • return: 密钥的 ASCII值和md5值,如:array('md5' => '', 'ascii' => '');
(array) dd_encrypt_key ([(string) $key = NULL])
  • (string) $key: 若不指定,则使用默认密钥
dd_error_msg (line 1795)
void dd_error_msg ( $msg)
  • $msg
dd_feed_wrapper (line 3951)

默认 feed 输

void dd_feed_wrapper ((string) $items, (string) $title, [(string) $link = NULL], [(string) $des = NULL])
  • (string) $items: 通常为使用 dd_rss_item() 获取的 xml 元素
  • (string) $title: 标题
  • (string) $link: 链接
  • (string) $des: 描述
dd_filter_unchunkHttp11 (line 1780)

HTTP 1.1 Transfer-Encoding: chunked 过滤

  • return: 去除 Transfer-Encoding 标识
(string) dd_filter_unchunkHttp11 ((string) $data)
  • (string) $data: http 返回主体
dd_get_absolute_url (line 237)

获取完整 URL

void dd_get_absolute_url ()
dd_get_access (line 261)

没有访问权限,如未登录,则显示登录表单

void dd_get_access ()
dd_get_breadcrumb (line 2460)

获取导航

(string) dd_get_breadcrumb ()
dd_get_cookie (line 1274)

获取通过 dd_set_cookie 加密写入的 cookie

(string) dd_get_cookie ((string) $name)
  • (string) $name: cookie 名称
dd_get_css (line 2620)

获取所有通过 dd_add_css 添加的 css

  • return: css html 标记
(string) dd_get_css ([(string) $css = NULL])
  • (string) $css: css 文件路径
dd_get_footer (line 2347)

获取页脚信息

(string) dd_get_footer ()
dd_get_help (line 2324)

获取帮助信息,在当前页显示

(string) dd_get_help ()
dd_get_history (line 286)

上一页地址,若上一页非当前网站,则返回首页

void dd_get_history ()
dd_get_hook (line 891)

hook 缓存,将 hook 函数缓

void dd_get_hook ( $hook, [ $clear = 0])
  • $hook
  • $clear
dd_get_html_head (line 2572)

获取 head

(string) dd_get_html_head ()
dd_get_ip (line 1960)

获取 IP 地理位置

  • return: 地理信息,如:9.9.9.9.9(中国),或:中国
(string) dd_get_ip ((string) $ip, [(bool) $true = NULL], [(string) $function = 'qqwry_data'])
  • (string) $ip: ip 地址
  • (bool) $true: 在括号内显示地理信息,如:9.9.9.9.9(中国)。默认为:中国
  • (string) $function: 调用函数,默认使用 纯真 ip 库函
dd_get_js (line 2902)

获取当前页面加载的 js

(string) dd_get_js ([(string) $scope = 'header'], [(array) $js = NULL])
  • (string) $scope: 位置,header 或 footer
  • (array) $js: js 文件
dd_get_menu (line 2474)

获取下拉导航,触发 hook_site_menu()

(string) dd_get_menu ([array $menus = NULL], [bool $fisrt = true])
  • array $menus: 导航菜单,若无,则执行 hook_site_menu
  • bool $fisrt: 第一次调用,添加 js 代码,以实现下拉效果
dd_get_message (line 2274)

获取提示信息

(string) dd_get_message ()
dd_get_microtime (line 1292)

获得当前毫秒数

void dd_get_microtime ()
dd_get_not (line 244)

页面不存在

void dd_get_not ()
dd_get_online (line 224)

站点关闭

void dd_get_online ()
dd_get_path (line 178)

获取模块、主题文件物理路径

void dd_get_path (string $type, (string) $name)
  • string $type: 类型,分为:theme、module、all
  • (string) $name: 模块或主题的系统名称
dd_get_rand_string (line 927)

获取指定长度的随机字符串

(string) dd_get_rand_string ((int) $len, [(string) $query = NULL])
  • (int) $len: 字符串长度
  • (string) $query: 查询数据库语句,若有此值得,则获取不重复的值 验证是否已使用,如:SELECT COUNT(name) FROM {users} WHERE name = ?
dd_get_redirect (line 3451)

获取跳转地址,用于 url()

(string) dd_get_redirect ([(string) $url = NULL])
  • (string) $url: 指定地址,默认为 $_GET['q']
dd_get_referer (line 1148)

获取站内来路

void dd_get_referer ((string) $url)
  • (string) $url
dd_get_required (line 3589)

必需项转为文字

  • return: or null)
(string dd_get_required ((bool) $required)
  • (bool) $required
dd_get_share_fav (line 3354)

获取分享网站代码,触发 hook_share_fav

  • return: 所有分享网站链接列表
(string) dd_get_share_fav ((string) $url, (string) $title, [(string) $desc = ''], [(string) $tags = ''], [(string) $pic = ''])
  • (string) $url: 待分享的链接
  • (string) $title: 待分享的标题
  • (string) $desc: 描述
  • (string) $tags: 标签
  • (string) $pic: 图片地址,图片分享
dd_get_sort_link (line 2781)

获取排序链接,可用于通过 GET 参数排序

函数将使用 ext_sort 和 ext_order 两个参数,以与 theme_table 的排序区别

  • return: 返回 html 链接
(string) dd_get_sort_link ((array) $sort, [(string) $path = NULL], [(array) $exclude = NULL])
  • (array) $sort: 排序参数,例如: array( 'timestamp' => array('data' => '时间'), 'visit' => array('data' => '访问', 'sort' => 'desc'), // 若有 sort 参数,则表示此字段为默认值 );
  • (string) $path: 链接路径,如:user/login,默认为 $_GET['q']
  • (array) $exclude: 默认将把当前 $_GET 值保留,若不需要保留某些值,在此处指明,如:arraqy('page', 'order')
dd_get_strong (line 1827)

以 <strong> 包裹字符串

(string) dd_get_strong ((string) $text, [(string) $sufpix = ':'])
  • (string) $text
  • (string) $sufpix
dd_get_sub_tabs (line 2376)

获取 tabs 导

(string) dd_get_sub_tabs ()
dd_get_summary (line 3661)

生成摘要

void dd_get_summary ((string) $body, (int) $size, [(int) $format = NULL])
  • (string) $body: 正文
  • (int) $size: 摘要长度
  • (int) $format: 输入格式 id
dd_get_tabs (line 2405)

获取 sub tabs 导

(string) dd_get_tabs ()
dd_get_title (line 2428)

获取页面标题

(string) dd_get_title ()
dd_get_token (line 871)

调用 hook_token_replace 进行遍历替换

void dd_get_token ((string) $text, [(*) $value = NULL], [ $modules = NULL], (array) $module)
  • (string) $text: 要替换字符串
  • (*) $value: 包含一组替换值
  • (array) $module: 指定模块,若不指定,则调用所有模块的 hook_token_replac
  • $modules
dd_goto (line 321)

重定向

void dd_goto ([(string) $path = ''], [(array $query = NULL], [(bool) $file = NULL], [(string) $fragment = NULL], [(int) $http_response_code = 301])
  • (string) $path: 系统路径或完整 url
  • (bool) $file: 是否物理文件
  • (string) $fragment: 锚点
  • (int) $http_response_code: 重定向模式,301 或 302
  • (array $query: or string) $query query 参数,字符串或数组形式
dd_goto_redirect (line 3459)

跳转至 redirect 或 指定路径

void dd_goto_redirect ([(string) $url = NULL])
  • (string) $url
dd_http_request (line 1507)

执行一个 HTTP 请求

  • return: $result->code:HTTP 响应代码,小于 0 则为请求失 $result->data:返回内容
返回一个包含执行结果的对象 dd_http_request ((string) $url, [(*) $data = NULL], [(string) $method = 'POST'], [(array) $headers = array()], [(int) $retry = 3], [(float) $timeout = 15.0])
  • (string) $url: 合法完整的 URL
  • (array) $headers: HTTP header 数组
  • (string) $method: 请求方式:POST、GET、PUT
  • (*) $data: 写入的数据,字符串或数组、对象
  • (int) $retry: 重定向次数
  • (float) $timeout: 超时时间,默认 15 秒
dd_http_request_cookie (line 1758)

将通过 dd_http_request 获取的 cookie 转换为与浏览器提交格式 获取到的 cookie 格式一般为: name=value; path=/; expires=Tue, 29-Mar-22 18:52:18 GMT; domain=test.com,name2=......

转换为浏览器提交格式: name=value;name2=value;name3=value

  • access: public
string dd_http_request_cookie (string $cookie)
  • string $cookie: 获取到的 cookie,包含了 path、domain 等
dd_imp (line 2762)

以指定字符分割数组,并以 span 包裹

void dd_imp ([(array) $v = array()], [(string) $str = ' | '])
  • (array) $v: 待操作数组
  • (string) $str: 分隔符
dd_is_front (line 3429)

判断当前页是否为首页

(bool) dd_is_front ()
dd_is_root_admin (line 1122)

验证超级管理员

void dd_is_root_admin ()
dd_is_spider (line 2138)

判断是否为蜘蛛

void dd_is_spider ()
dd_jqedit (line 2160)

载入 jqedit 插

void dd_jqedit ([(array) $v = array()])
  • (array) $v: 自定义参数
dd_jqui (line 2149)

载入 vjquery ui,

void dd_jqui ([(string) $theme = 'base'])
  • (string) $theme: 载入的主题
dd_js_goto (line 2743)

js 页面跳转

void dd_js_goto ((int) $limit)
  • (int) $limit: 页码,或其它标识
dd_js_print (line 2723)

将 js 输出在页面,并中止代码

void dd_js_print ((string) $js)
  • (string) $js: js 代码
dd_line_to_array (line 3046)

将字符串转换为数组,以换行符分割

void dd_line_to_array ((string) $string, [(bool) $repeat = NULL])
  • (string) $string: 待处理的字符串
  • (bool) $repeat: 若为 true,则去除数组中空白和重复值
dd_log (line 529)

日志记录

void dd_log ((string) $type, (string) $value, [ $ext_id = NULL], [(string) $link = NULL], [(int) $status = 0], [(int) $uid = NULL])
  • (string) $type: 类型,自定义
  • (string) $value: 内容
  • (string) $link: 发生地址,默认为当前地址
  • (int) $status: 状态,0、普通,1、警告,2、严重
  • (int) $uid: 用户 id,默认为当前用户
  • $ext_id
dd_logs_get_status (line 548)

系统日志状态

(string) dd_logs_get_status ([(int) $id = NULL])
  • (int) $id
dd_page_cache_header (line 3286)

缓存页面 header

  • return: true
(bool) dd_page_cache_header ((int) $timestamp)
  • (int) $timestamp: 上次缓存时间
dd_page_header (line 3273)

默认 header

void dd_page_header ()
dd_php_error (line 1431)

处理 PHP 错误信息

void dd_php_error ( $errno,  $message,  $filename, [ $line = NULL], [ $context = NULL])
  • $errno
  • $message
  • $filename
  • $line
  • $context
dd_query_string_encode (line 3076)

将数组转换为 GET 字符串

  • return: 如:op=update&id=100
(string) dd_query_string_encode ([(array) $query = array()], [(array) $exclude = array()], [(string) $parent = ''])
  • (array) $query: 待转换的数组,如:array('op' => 'update', 'id' => 100)
  • (array) $exclude: 不转换的单元
  • (string) $parent: 父级名称,如:list,则上面的数组转换为:list[op]=update&list[id]=100
dd_rand_str (line 914)

获取随机字符串

void dd_rand_str ()
dd_range_str (line 3264)

字母数字混合模式的随机数

(string) dd_range_str ()
dd_redirect (line 3441)

获取跳转地址

  • return: 注:将废除,请使用 dd_get_redirect()
(string) dd_redirect ([(string) $url = NULL])
  • (string) $url
dd_rss_feed (line 3835)

获取 rss 格式的数据

(string) dd_rss_feed ($args $items, [(array) $channel = array()], [ $args = array()])
  • $args $items: 之前自定义参数
  • (array) $channel: rss 属性
  • $args
dd_rss_item (line 3880)

数据转换为 xml 元素

(string) dd_rss_item ((array $fields, [(string) $item = 'item'], [(array) $args = array()])
  • (string) $item: xml 标签
  • (array) $args: 自定义属性
  • (array $fields: or string) $fields 待转换数据
dd_save_cron (line 213)

写入一个任务到cron表,在调度 cron 时,优先执行

  • return: cid
写入成功则返回 dd_save_cron ((string) $module, (string) $type, [(array) $data = array()], [(int) $weight = 0])
  • (string) $module: 模块系统名称,错误的名称将无法写入
  • (string) $type: 任务类型,由模块自定义,便于自行查找
  • (array) $data: 任务数据。必须包含回调函数。参数(*表示必须,以下同): *(string) func:执行该条任务时,将回调此函数。返回 true 为成功 (array) args:传递给回调函数的参数 (array) includes:需要加载的文件,完整的系统路径 (string) success:成功执行回调的函数,并以 args 作为参数传递。
  • (int) $weight: 任务权重,可提高任务优先级。排序方式:weight ASC, cid ASC
dd_set_breadcrumb (line 2446)

写入导航

void dd_set_breadcrumb ([(string $breadcrumb = NULL], [(bool) $front = true])
  • (bool) $front: 是否在前面显示 首页
  • (string $breadcrumb: or array) $breadcrumb 导航链接
dd_set_cookie (line 1256)

写入 cookie,同时加密待写入的数据

void dd_set_cookie ((string) $name, (string) $value, [(int) $expires = NULL], [(string) $path = '/'], [(string) $domain = NULL])
  • (string) $name: cookie 名称
  • (string) $value: 待写入的值
  • (int) $expires: 过期时间
  • (string) $path: 作用路径
  • (string) $domain: 作用域
dd_set_footer (line 2334)

写入页脚信息

void dd_set_footer ([(string) $item = NULL])
  • (string) $item
dd_set_header (line 2546)

写入 header

void dd_set_header ([(string) $header = NULL])
  • (string) $header
dd_set_help (line 2312)

写入帮助信息

(string) dd_set_help ([(string) $help = NULL])
  • (string) $help
dd_set_html_head (line 2560)

写入 head

(string) dd_set_html_head ([(string) $data = NULL])
  • (string) $data
dd_set_lang (line 782)

合并模块语言文件

void dd_set_lang ([(array) $lists = NULL], [(array) $language = array()])
  • (array) $lists: 模块列表,默认为所有模块文件夹下的语言文件,modules/test/lang/*
  • (array) $language: 需导入的语言,默认为所有设定的语言 语言文件缓存在 ./sties/cache/lang_{$language}.lang,合并规则: 若有相同键名,取第一个保存为默认字符串,其它保存为特殊翻译串。 特殊翻译保存在以模块系统名称加双下划线为键名的数组下 如 __block,以此避免与模块名称翻译产生冲突。 以此增加语言字符串重用率,减少语言文件体积。同时可为相同字符串提供多种翻译。 示例: system.module 定义了 $lang['cache'] = '缓存' block.module 定义了 $lang['cache'] = '区块缓存'; // 假设 在导入合并时,'缓存' 将作为 'cache' 的默认翻译,而 '区块缓存' 作为特殊翻译 最终的语言文件如: $lang = array(
dd_set_mail (line 1854)

邮件发送,默认使用 mail() 发

  • return: true,失败返回 false,并发出一条警告
成功返回 dd_set_mail ((array) $mails, (string) $subject, (string) $message, [(array) $headers = NULL], [(bool) $html = 1], [(array) $att = NULL])
  • (array) $mails: 数组,包含发件人等(键名区分大小写): To:(array) 一组收件人的姓名和邮址 例1:$mails = 'user@example.com'; // 仅一个邮址,若需提供姓名或一组: 例2:$mails = array(array('user@c.com', 'name'), 'user1@example.com', )
  • (string) $subject: 邮件主题,纯文本将在每70个字符后插入换行符,html 无此限制
  • (string) $message: 邮件正文,每行不超过70
  • (bool) $html: 发送为 html 内容
  • (array) $headers: 可提供更多邮件头信息,如抄送等
  • (array) $att: 更多配置,如可发送附件等。mail() 发送不支持
dd_set_message (line 2247)

写入提示信息

void dd_set_message ([(string) $message = NULL], [(string) $type = 'notice'], [(bool) $repeat = true])
  • (string) $message: 信息内容
  • (string) $type: 信息类型,可自定义,常用:notice、error
  • (bool) $repeat: 是否替换旧的相同类型的提示信息
dd_set_meta (line 3326)

设置 meta 参数

void dd_set_meta ([ $v = array()])
  • (array) $v: meta 值对
dd_set_ping (line 1455)

以 xmprpc 方式通知服务器内容更新

  • return: 接口响应
(array) dd_set_ping ((array) $data, [(array) $service = array()], [(string) $method = 'weblogUpdates.extendedPing'])
  • (array) $data: 数据
  • (array) $service: 自定义通知服务器列表
  • (string) $method: 应答方式
dd_set_sub_tabs (line 2386)

写入 sub tabs 导

void dd_set_sub_tabs ([(string $tab = NULL])
  • (string $tab: or array) $item
dd_set_tabs (line 2357)

写入 tabs 导

void dd_set_tabs ([(string $tab = NULL])
  • (string $tab: or array) $item
dd_set_title (line 2415)

写入页面标题

void dd_set_title ([(string) $title = NULL])
  • (string) $title
dd_sort_cmp (line 3248)

多维数组,按 weight 排序

void dd_sort_cmp ( $a,  $b)
  • $a
  • $b
dd_to_install (line 1283)

转至安装文件

void dd_to_install ()
dd_to_js (line 2999)

任意类型转换为 js

(string) dd_to_js ((*) $var)
  • (*) $var
dd_unset_globals (line 297)

注销所有全局变量

void dd_unset_globals ()
dd_urlencode (line 3192)

字符串 url 编码

  • return: 编码后的字符串
(string) dd_urlencode ((string) $text)
  • (string) $text: 待编码的字符串
dd_user_validate (line 978)

用户验证

void dd_user_validate ()
dd_validate_utf8 (line 3179)

检查字符串是否为 utf8 编码

(bool) dd_validate_utf8 ((string) $text)
  • (string) $text: 待检查的字符串
dd_xml_elements (line 3917)

解析 xml 自定义属性

(string) dd_xml_elements ((array) $array, [(string) $root = ''])
  • (array) $array: 待解析数组
  • (string) $root: 项目名称
decode_entities (line 3103)

字符串编码

void decode_entities ((string) $text, [(array) $exclude = array()])
  • (string) $text
  • (array) $exclude
f (line 416)

输出物理文件可访问 url

(string) f ((string) $filepath, [ $absolute = false])
  • (string) $filepath: 文件路径
  • $absolute
filter_xss_bad_protocol (line 3219)

检查 uri 协议是否合法

(bool) filter_xss_bad_protocol ((string) $string, [(bool) $decode = true])
  • (string) $string: 待检查的 uri
  • (bool) $decode: 是否需要解码
format_date (line 1326)

格式时间戳

  • return: 格式化之后的时间
(string) format_date ((int) $timestamp, [(string) $type = 'default'], [(string) $format = ''])
  • (int) $timestamp: 时间戳
  • (string) $type: 处理方式
  • (string) $format: 自定义格式
format_date_mktime (line 1386)

将字符串形式的日期转时间戳,日期格式:2010-05-25 或 2010/05/25 或 2010-05-25 12:24:32

  • return: 时间戳期
(int) format_date_mktime ((string) $text)
  • (string) $text: 待转换日期
format_date_week_cn (line 1308)

获取指定时间的星期的中文表达

(string) format_date_week_cn ((int) $timestamp)
  • (int) $timestamp: 时间戳
format_get_current (line 1421)

获取当天零点的时间戳

(string) format_get_current ()
format_interval (line 1354)

时间格式化,距离当前多少时间

(string) format_interval ((int) $timestamp, [(int) $granularity = 5])
  • (int) $timestamp: 时间戳
  • (int) $granularity: 显示层级,默认为 年 周 天 小时 分钟 秒
img (line 387)

输出图片标签

  • return: html img,如:<img src="test.jpg" />
(string) img ((string) $path, [(string) $alt = ''], [(string) $title = ''], [(array) $attributes = NULL])
  • (string) $path: 图片 url,相对或绝对地址皆可
  • (string) $alt: alt 属性
  • (string) $title: title 属性
  • (array) $attributes: 其它属性
ip_address (line 962)

获取客户端 ip

void ip_address ()
l (line 348)

超链接格式化

  • return: html a,如:<a href="url">test</a>
(string) l ((string) $text, (string) $path, [$options $options = array()])
  • (string) $text: 链接名称
  • (string) $path: 系统路径或完整 url
  • $options $options: 详细参数: array( 'attributes' => (array), // a 链接属性,如 'alt' => 'test 'strlen' => (int), // 链接名称超过此长度,则截断 'external' => (bool), // 是否为外部链接。若不传值,也将判断 $path 是否为外部链接 'fragment' => (string), // 锚点 'query' => (array or string), // 数组:array('op' => 'insert', 'id' => 1), 或字符串:op=insert&id=1 'absolute' => (bool), // 若为 true,则输出完整路径(包含域名) 'file' => (bool), // 是否为物理文件 'access' => (bool), // 是否检查权限 )
qqwry_data (line 1997)

使用纯真 ip 库解析地理位置

(string) qqwry_data ((string) $ip, [(string) $file = './tools/QQWry.Dat'])
  • (string) $ip: ip 地址
  • (string) $file: 纯真 ip 库位置
t (line 695)

多语言

void t ((string) $module, (string) $index, [(array) $args = array()], [(string) $language = NULL])
  • (string) $index: 语言字符串键名,若无对应值,则返回键名
  • (string) $module: 默认系统名称,赋值则优先使用该模块定义的值
  • (array) $args: 要转换的字符串参数
  • (string) $language: 指定语言 所有模块的语言文件缓存在 {$conf_dir}/cache/{$language}.php 可在相同目录自定义语言翻译文件,命名为 custom_{$language}.php,自定义翻译,优先级最高
temp_del (line 3648)

删除一条或多条临时记录

  • return: 删除的列数
(int) temp_del ((string) $tid)
  • (string) $tid
temp_get (line 3599)

获取一条临时记录

(object) temp_get ((string) $tid)
  • (string) $tid: 记录 i
temp_set (line 3625)

写入一条临时记录

(bool) temp_set ((string) $tid, (*) $data, [(string) $type = ''], [(int) $uid = NULL])
  • (string) $tid: 记录 i
  • (*) $data: 待写入数据
  • (string) $type: 自定义类型
  • (int) $uid: 用户 id,默认为当前用户
text_log (line 1814)

写入错误日志,保存在配置目录

void text_log ((string) $filename, (string) $msg)
  • (string) $filename: 文件名。最终文件名将附加年月
  • (string) $msg: 错误信息
url (line 442)

用于生成 url,不必考虑简洁链接、相对或绝对、站内或站外等因素,均可以正确判断和处理

  • return: 返回处理后的 url
(string) url ([(string) $path = NULL], [(array) $options = array()])
  • (string) $path: 系统路径或外部链接
  • (array) $options: 其它参数: array( 'external' => (bool), // 是否为外部链接。若不传值,也将判断 $path 是否为外部链接 'fragment' => (string), // 锚点 'query' => (array or string), // 数组:array('op' => 'insert', 'id' => 1), 或字符串:op=insert&id=1 'absolute' => (bool), // 若为 true,则输出完整路径(包含域名) 'file' => (bool), // 是否为物理文件 'access' => (bool), // 是否检查权限 )
user_anonymous (line 1176)

游客信息

void user_anonymous ()
user_logout (line 1129)

注销,触发 hook_user_logout($ac)

void user_logout ()
var_del (line 652)

删除配置

void var_del ((string) $name, [(bool) $clear = true])
  • (string) $name: 配置名称
  • (bool) $clear: 是否立即刷新配置缓存
var_get (line 605)

读取配置

(*); var_get ((string) $name, [(*) $default = NULL])
  • (string) $name: 配置名称
  • (*) $default: 默认值,若没有请求的配置,则返回此值
var_get_key (line 640)

读取子配置,针对数组配置,参数同 var_get()

(*); var_get_key ((string) $name, (string) $key, [(*) $default = false])
  • (string) $name: 配置名称
  • (string) $key: 子配置名称,即数组键名
  • (*) $default: 默认值,若没有请求的配置,则返回此值
var_init (line 673)

更新配置缓存,无参数,无返回值

void var_init ()
var_set (line 565)

写入配置,若存在则更新。初始化时将加载所有配置。

void var_set ($name $name, $value $value, [$clear $clear = 1], [(bool) $replace = 1])
  • (bool) $replace: 是否使用 db_replace 写入数
  • $name $name: = String 配置名称,不应大于 255 个字符
  • $value $value: = * 配置内容,序列化存储 $return 无返回值,但将即时更新全局变量 $conf
  • $clear $clear: = 1; 清除配置文件缓存
_dd_build_css_path (line 2701)

css 文件合并缓存,背景图片路径替换

void _dd_build_css_path ((array) $matches, [(string) $base = NULL])
  • (array) $matches: 正则匹配数据
  • (string) $base: css 文件路径
_dd_js_print (line 2734)

为 js 代码添加 script 标签

(string) _dd_js_print ((string) $js)
  • (string) $js: js 代码
_decode_entities (line 3117)

处理字符串

void _decode_entities ( $prefix,  $codepoint,  $original,  &$table,  &$exclude)
  • $prefix
  • $codepoint
  • $original
  • &$table
  • &$exclude
_l_external (line 398)

检查是否为绝对路径

(bool) _l_external ((string) $path)
  • (string) $path: 待检查路径

Documentation generated on Wed, 04 Jul 2012 14:35:56 +0800 by phpDocumentor 1.4.3