1 教程-内容提要
1.1 CodeIgniter3.1教程——开始
1.2 加载静态内容
1.3 读取新闻条目
1.4 创建新闻条目
2 常规主题
2.1 CodeIgniter URL
2.2 控制器
2.3 保留名称
2.4 视图
2.5 模型
2.6 辅助函数
2.7 使用 CodeIgniter 类库
2.8 创建类库
2.9 使用 CodeIgniter 驱动器
2.10 创建驱动器
2.11 创建核心系统类
2.12 创建附属类
2.13 钩子 - 扩展框架核心
2.14 自动加载资源
2.15 公共函数
2.16 兼容性函数
2.17 URI 路由
2.18 错误处理
2.19 网页缓存
2.20 程序分析
2.21 以 CLI 方式运行
2.22 管理你的应用程序
2.23 处理多环境
2.24 在视图文件中使用 PHP 替代语法
2.25 安全
2.26 PHP 开发规范
3 类库参考
3.1 基准测试类
3.2 缓存驱动器
3.3 日历类
3.4 购物车类
3.5 配置类
3.6 Email 类
3.7 加密类(废弃)
3.8 加密类(新版)
3.9 文件上传类
3.10 表单验证类
3.11 FTP 类
3.12 图像处理类
3.13 输入类
3.14 Javascript 类
3.15 语言类
3.16 加载器类
3.17 迁移类
3.18 输出类
3.19 分页类
3.20 模板解析类
3.21 安全类
3.22 Session 类
3.23 HTML 表格类
3.24 引用通告类
3.25 排版类
3.26 单元测试类
3.27 URI 类
3.28 用户代理类
3.29 XML-RPC 与 XML-RPC 服务器类
3.30 Zip 编码类
4 数据库参考
4.1 数据库快速入门: 示例代码
4.2 数据库配置
4.3 连接你的数据库
4.4 查询
4.5 生成查询结果
4.6 查询辅助函数
4.7 查询构造器类
4.8 事务
4.9 数据库元数据
4.10 自定义函数调用
4.11 查询缓存
4.12 数据库工厂类
4.13 数据库工具类
4.14 数据库驱动器参考
5 辅助函数参考
5.1 数组辅助函数
5.2 验证码辅助函数
5.3 Cookie 辅助函数
5.4 日期辅助函数
5.5 目录辅助函数
5.6 下载辅助函数
5.7 邮件辅助函数
5.8 文件辅助函数
5.9 表单辅助函数
5.10 HTML 辅助函数
5.11 Inflector 辅助函数
5.12 语言辅助函数
5.13 数字辅助函数
5.14 路径辅助函数
5.15 安全辅助函数
5.16 表情辅助函数(废弃)
5.17 字符串辅助函数
5.18 文本辅助函数
5.19 排版辅助函数
5.20 URL 辅助函数
5.21 XML 辅助函数

文本辅助函数

2017-12-03 20:03:46
linefo
585
最后编辑:linefo 于 2017-12-03 21:19:28

文本辅助函数

文本辅助函数文件包含了一些帮助你处理文本的函数。

加载辅助函数

该辅助函数通过下面的代码加载:

$this->load->helper('text');

可用函数

该辅助函数有下列可用函数:

word_limiter($str[, $limit = 100[, $end_char = '…']])
参数:
  • $str (string) -- Input string
  • $limit (int) -- Limit
  • $end_char (string) -- End character (usually an ellipsis)
返回:

Word-limited string

返回类型:

string

根据指定的 单词 个数裁剪字符串。例如:

$string = "Here is a nice text string consisting of eleven words.";
$string = word_limiter($string, 4);
// Returns:  Here is a nice

第三个参数用于给裁剪的字符串设置一个可选的后缀,默认使用省略号。

character_limiter($str[, $n = 500[, $end_char = '…']])
参数:
  • $str (string) -- Input string
  • $n (int) -- Number of characters
  • $end_char (string) -- End character (usually an ellipsis)
返回:

Character-limited string

返回类型:

string

根据指定的 字符 个数裁剪字符串。它会保证单词的完整性,所以最终生成的 字符串长度和你指定的长度有可能会有出入。

例如:

$string = "Here is a nice text string consisting of eleven words.";
$string = character_limiter($string, 20);
// Returns:  Here is a nice text string

第三个参数用于给裁剪的字符串设置一个可选的后缀,如果没该参数,默认使用省略号。

注解

如果你需要将字符串精确的裁剪到指定长度,请参见下面的 ellipsize() 函数。

ascii_to_entities($str)
参数:
  • $str (string) -- Input string
返回:

A string with ASCII values converted to entities

返回类型:

string

将 ASCII 字符转换为字符实体,包括高位 ASCII 和 Microsoft Word 中的特殊字符, 在 Web 页面中使用这些字符可能会导致问题。转换为字符实体后,它们就可以 不受浏览器设置的影响正确的显示出来,也能可靠的存储到到数据库中。本函数依赖于 你的服务器支持的字符集,所以它可能并不能保证 100% 可靠,但在大多数情况下, 它都能正确的识别这些特殊字符(例如重音字符)。

例如:

$string = ascii_to_entities($string);
convert_accented_characters($str)
参数:
  • $str (string) -- Input string
返回:

A string with accented characters converted

返回类型:

string

将高位 ASCII 字符转换为与之相等的普通 ASCII 字符,当你的 URL 中需要使用 非英语字符,而你的 URL 又设置了只允许出现普通 ASCII 字符时很有用。

例如:

$string = convert_accented_characters($string);

注解

该函数使用了 application/config/foreign_chars.php 配置文件来决定 将什么字符转换为什么字符。

word_censor($str, $censored[, $replacement = ''])
参数:
  • $str (string) -- Input string
  • $censored (array) -- List of bad words to censor
  • $replacement (string) -- What to replace bad words with
返回:

Censored string

返回类型:

string

对字符串中出现的敏感词进行审查。第一个参数为原始字符串,第二个参数 为一个数组,包含你要禁用的单词,第三个参数(可选)可以设置将出现 的敏感词替换成什么,如果未设置,默认替换为磅字符:#### 。

例如:

$disallowed = array('darn', 'shucks', 'golly', 'phooey');
$string = word_censor($string, $disallowed, 'Beep!');
highlight_code($str)
参数:
  • $str (string) -- Input string
返回:

String with code highlighted via HTML

返回类型:

string

对一段代码(PHP、HTML 等)进行着色。例如:

$string = highlight_code($string);

该函数使用了 PHP 的 highlight_string() 函数,所以着色的颜色是在 php.ini 文件中设置的。

highlight_phrase($str, $phrase[, $tag_open = '<mark>'[, $tag_close = '</mark>']])
参数:
  • $str (string) -- Input string
  • $phrase (string) -- Phrase to highlight
  • $tag_open (string) -- Opening tag used for the highlight
  • $tag_close (string) -- Closing tag for the highlight
返回:

String with a phrase highlighted via HTML

返回类型:

string

对字符串内的一个短语进行突出显示。第一个参数是原始字符串, 第二个参数是你想要突出显示的短语。如果要用 HTML 标签对短语进行标记, 那么第三个和第四个参数分别是你想要对短语使用的 HTML 开始和结束标签。

例如:

$string = "Here is a nice text string about nothing in particular.";
echo highlight_phrase($string, "nice text", '<span style="color:#990000;">', '</span>');

上面的代码将输出:

Here is a <span style="color:#990000;">nice text</span> string about nothing in particular.

注解

该函数默认是使用 <strong> 标签,老版本的浏览器可能不支持 <mark> 这个 HTML5 新标签,所以如果你想支持这些老的浏览器,推荐你在你的样式文件 中添加如下 CSS 代码:

mark {
    background: #ff0;
    color: #000;
};
word_wrap($str[, $charlim = 76])
参数:
  • $str (string) -- Input string
  • $charlim (int) -- Character limit
返回:

Word-wrapped string

返回类型:

string

根据指定的 字符 数目对文本进行换行操作,并且保持单词的完整性。

例如:

$string = "Here is a simple string of text that will help us demonstrate this function.";
echo word_wrap($string, 25);

// Would produce:
// Here is a simple string
// of text that will help us
// demonstrate this
// function.
ellipsize($str, $max_length[, $position = 1[, $ellipsis = '&hellip;']])
参数:
  • $str (string) -- Input string
  • $max_length (int) -- String length limit
  • $position (mixed) -- Position to split at (int or float)
  • $ellipsis (string) -- What to use as the ellipsis character
返回:

Ellipsized string

返回类型:

string

该函数移除字符串中出现的标签,并根据指定的长度裁剪字符串,并插入省略号。

第一个参数是要处理的字符串,第二个参数为最终处理完后的字符串长度, 第三个参数为插入省略号的位置,值为 0-1 表示从左到右。例如设置为 1 省略号将插入到字符串的右侧,0.5 将插入到中间,0 将插入到左侧。

第四个参数是可选的,表示省略号的类型,默认是 &hellip; 。

例如:

$str = 'this_string_is_entirely_too_long_and_might_break_my_design.jpg';
echo ellipsize($str, 32, .5);

输出结果:

this_string_is_e&hellip;ak_my_design.jpg