Finder - 类別

forge($paths = array())

forge 回传一个新的 Finder 物件。

array()

$array = array(APPPATH, COREPATH);
$finder = Finder::forge($array));

instance()

instance 方法回传 Finder 物件的独体。 这个实例也被 FuelPHP 核心类别用来寻找档案，并且在第一次呼叫时会初始化， 带着 APPPATH 和 COREPATH 做为预设搜寻路径。

$finder = Finder::instance();

search($dir, $file, $ext = '.php', $multiple = false, $cache = true)

search 方法是在预设 Finder 实例上 locate() 的静态别名。

'.php'

false

true

// 将回传 APPPATH/views/welcome/index.php
$viewfile = Finder::search('views', 'welcome/index');

add_path($paths, $pos = null)

add_path 方法添加一个新搜寻路径到 Finder 实例，在所给的位置。

null

// 确保 Finder 最先搜寻 'mypackage'
Finder::instance()->add_path(PKGPATH.'mypackage', -1);

remove_path($path)

remove_path 方法从 Finder 实例搜寻列表移除所给的路径。

// 从搜寻路径列表移除 'mypackage'
Finder::instance()->remove_path(PKGPATH.'mypackage');

paths()

paths 方法回传定义的搜寻路径列表。

// 取回给预设实例的定义路径。
$paths = Finder::instance()->paths();
print_r($paths);

list_files($directory = null, $filter = '*.php')

list_files 方法取得一个在所给目录中所有已载入的搜寻路径里的所有档案的列表 （例如级联式的档案系统）。 这在像从所有搜寻路径中寻找所有配置是非常有用的。

null

'*.php'

// 寻找所有资料库配置档案
$dbcfg = Finder::instance()->list_files('config', 'db.php');

这个方法会了解目前请求的情境。这意味着当活跃的请求是一个 HMVC 呼叫到一个模组控制器时， 模组路径会动态添加到要搜寻的路径列表。

locate($dir, $file, $ext = '.php', $multiple = false, $cache = true)

locate 方法在定义搜寻路径中定位档案。

'.php'

false

true

// 将回传 APPPATH/views/welcome/index.php
$viewfile = Finder::instance()->locate('views', 'welcome/index');