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 * @return \http\Controller\Url
42 function getBaseUrl() {
43 return $this->baseUrl
;
47 * Find a markdown reference file in one REFPATH. If nothing could be found
48 * an empty Path will be returned.
50 * @param \http\Url $requestUrl
53 function find(\http\Url
$requestUrl, $ext = ".md") {
54 $file = implode(DIRECTORY_SEPARATOR
, $this->baseUrl
->params($requestUrl));
56 foreach ($this->refs
as $base) {
57 $path = new Path($base, $file);
58 if ($path->isFile($ext)) {
67 * Glob either in a Path's base dir, or, if the path does not have a base
68 * dir set, in each REFPATH paths.
70 * @param \mdref\Path $path
71 * @param string $pattern glob pattern
72 * @param int $flags glob flags
73 * @return array glob result
75 function glob(Path
$path, $pattern, $flags = GLOB_BRACE
) {
76 if (strlen($path->getBaseDir())) {
77 return glob($path->getFullPath($pattern), $flags);
80 foreach ($this->refs
as $ref) {
81 $glob = array_merge($glob, array_map(function ($fn) use ($ref) {
82 return substr($fn, strlen($ref));
83 }, glob($ref . $pattern, $flags)));