CodeIgniter4 辅助函数
辅助函数正如其名,是用于辅助你处理任务的。每个辅助文件都只是一个特殊分类下一系列函数的集合。 例如 URL辅助函数 用于创建链接,表单辅助函数 用于创建表单元素,文本辅助函数 用于不同的文本编排方式,Cookie辅助函数用于设置和获取cookies,文件辅助函数用于处理文件等。
与CodeIgniter中其他大多数的系统部件有所不同,辅助函数不是以面向对象的方式实现的,而仅仅是简单的,程序化的函数方法。 每个辅助函数都只执行一个特定的功能,并与其他的函数不产生依赖。
CodeIgniter在默认情况下不加载辅助函数文件,因此使用它的第一步就是加载它。 而当辅助函数被加载后,该函数就在你的 控制器 and 视图 中全局可用。
辅助函数通常储存在 system/Helpers 或 app/Helpers directory 下。CodeIgniter首先会在 app/Helpers 目录下进行查找,但是如果该目录不存在,或者指定的辅助函数文件不在当前位置。 CI就会在你的全局 system/Helpers/ 目录下进行搜索。
加载一个辅助文件
可以使用如下方法来轻易地加载辅助文件:
helper('name');
其中 name 是辅助文件的文件名,并不需要带有.php的文件扩展名或者是”helper”这部分。
举例来说,为了加载名为cookie_helper.php的Cookie辅助文件,你需要这样做:
helper('cookie');
如果你需要加载多个辅助文件,可以通过传值一个文件名构成的数组,这样一来这些文件就都会被加载了:
helper(['cookie', 'date']);
一个辅助函数文件可以在你的控制器方法里的任意位置被加载(甚至在你的视图文件里,虽然这样做并不符合最佳实践), 只要你在使用前加载了该文件就行。你也可以在控制器的构造函数里加载辅助函数,从而在当前控制器的任何方法里都可以使用, 或者在需要调用的方法里加载这个辅助函数。
注解
辅助函数的加载方法并不会返回值,所以请不要尝试将它赋值给一个变量。请如上所示调用即可。
URL辅助函数文件总是会自动加载,因此你不需要手动加载它。
从非标准位置加载
辅助函数文件可以从app/Helpers目录和system/Helpers目录外被加载, 只要它们所处的路径可以通过 自动加载器配置文件 中的PSR-4这节所配置的命名空间定位。 你可以为辅助函数文件用命名空间作为前缀来起名,从而使其可被定位。在命名空间所处的目录下,加载器期望该文件存在于命名空间中一个名为 Helpers
的子目录下。 以下是一个帮助理解的例子。
举例来说,假设我们把所有博客相关的代码都放在了我们的命名空间 Example\Blog
中。而文件存在于我们服务器的/Modules/Blog/命名空间下。 那么我们就应该把博客模块对应的辅助文件放在/Modules/Blog/Helpers/命名空间里。blog_helper 文件就应该位于/Modules/Blog/Helpers/blog_helper.php的位置。 在控制器中我们可以使用如下指令来加载该辅助文件:
helper('Modules\Blog\blog');
注解
通过该方式加载的文件中包含的函数并不是真正带有命名空间的。这里的命名空间只是用于简单快捷地定位文件而已。
使用一个辅助函数
当你加载完包含有你想要使用的辅助函数的文件后,就可以像调用一个标准的PHP函数一样调用它。
举例来说,在你的视图文件中使用 anchor
函数来创建一个链接,可以这样做:
<?php echo anchor('blog/comments', 'Click Here');?>
其中”Click Here”是链接名,而”blogs/comments”是你希望链接到的控制器/方法名所对应的的URI
“继承”辅助函数
为了实现对辅助函数文件的”继承”,在你的app/Helpers/ 目录下创建一个和现存的辅助函数文件同名的文件。
如果你你想做的只是对已有的辅助函数文件加一些新功能——那么在里面加一两个函数或者改某个特殊的辅助函数的代码—— 比起用你的版本来完全替换整个辅助函数文件来说要实用的多。在这种情况下,最好只是”继承”这个辅助函数文件。
注解
“继承”这个词语在这里用起来太过于泛化了,因为辅助函数是面向过程且离散的,并不能像传统的场景一样被继承。在这种情况下,这里的 继承 的意思是,让你可以添加或替换原本的辅助文件所提供的函数。
举个例子,为了继承原生的 数组辅助函数,你可以创建一个名为 app/Helpers/array_helper.php 的文件并增加或重载以下函数:
// any_in_array() 并不是数组辅助函数,因为被定义为一个新的函数
function any_in_array($needle, $haystack)
{
$needle = is_array($needle) ? $needle : [$needle];
foreach ($needle as $item)
{
if (in_array($item, $haystack))
{
return TRUE;
}
}
return FALSE;
}
// random_element() 在数组辅助函数中被定义了,所以在这里重载了原生的函数
function random_element($array)
{
shuffle($array);
return array_pop($array);
}
helper() 方法会扫描所有 app/Config/Autoload.php 里定义的PSR-4命名空间并同时加载所有匹配的辅助文件 这一行为将使得所有模块的辅助文件都会被加载,包括所有你所创建用于该程序的对应辅助文件。加载顺序如下:
- app/Helpers - 这里的文件总是首先被加载
- {namespace}/Helpers - 所有的命名空间都会通过所定义的顺序遍历
- system/Helpers - 系统辅助文件在最后加载
然后呢?
在内容表里你可以找到所有可用的辅助函数文件。请逐一浏览它们的用途吧。