6 * Find markdown reference files in several REFPATH paths.
8 * The base URL is used to extract the relative identifier out of the request
9 * url in Finder::find().
11 * Use the created Path of Finder::find() for Finder::glob() to find subrefs.
17 * @var \http\Controller\Url
25 protected $refs = array();
28 * @param \http\Controller\Url $baseUrl
29 * @param mixed $paths array or string of paths with markdown references
31 function __construct(\http\Controller\Url
$baseUrl, $paths = ".") {
32 if (!is_array($paths)) {
33 $paths = explode(PATH_SEPARATOR
, $paths);
36 $this->baseUrl
= $baseUrl;
40 * Find a markdown reference file in one REFPATH. If nothing could be found
41 * an empty Path will be returned.
43 * @param \http\Url $requestUrl
46 function find(\http\Url
$requestUrl, $ext = ".md") {
47 $file = implode(DIRECTORY_SEPARATOR
, $this->baseUrl
->params($requestUrl));
49 foreach ($this->refs
as $base) {
50 $path = new Path($base, $file);
51 if ($path->isFile($ext)) {
60 * Glob either in a Path's base dir, or, if the path does not have a base
61 * dir set, in each REFPATH paths.
63 * @param \mdref\Path $path
64 * @param string $pattern glob pattern
65 * @param int $flags glob flags
66 * @return array glob result
68 function glob(Path
$path, $pattern, $flags = GLOB_BRACE
) {
69 if (strlen($path->getBaseDir())) {
70 return glob($path->getFullPath($pattern), $flags);
73 foreach ($this->refs
as $ref) {
74 $glob = array_merge($glob, array_map(function ($fn) use ($ref) {
75 return substr($fn, strlen($ref));
76 }, glob($ref . $pattern, $flags)));