git.m6w6.name Git - mdref/mdref/blob - mdref/Finder.php

   1 <?php
   2
   3 namespace mdref;
   4
   5 /**
   6  * Find markdown reference files in several REFPATH paths.
   7  *
   8  * The base URL is used to extract the relative identifier out of the request
   9  * url in Finder::find().
  10  *
  11  * Use the created Path of Finder::find() for Finder::glob() to find subrefs.
  12  */
  13 class Finder
  14 {
  15         /**
  16          * Base URL
  17          * @var \http\Controller\Url
  18          */
  19         protected $baseUrl;
  20
  21         /**
  22          * Reference paths
  23          * @var array
  24          */
  25         protected $refs = array();
  26
  27         /**
  28          * @param \http\Controller\Url $baseUrl
  29          * @param mixed $paths array or string of paths with markdown references
  30          */
  31         function __construct(\http\Controller\Url $baseUrl, $paths = ".") {
  32                 if (!is_array($paths)) {
  33                         $paths = explode(PATH_SEPARATOR, $paths);
  34                 }
  35                 $this->refs = $paths;
  36                 $this->baseUrl = $baseUrl;
  37         }
  38
  39         function getBaseUrl() {
  40                 return $this->baseUrl;
  41         }
  42
  43         /**
  44          * Find a markdown reference file in one REFPATH. If nothing could be found
  45          * an empty Path will be returned.
  46          *
  47          * @param \http\Url $requestUrl
  48          * @return Path
  49          */
  50         function find(\http\Url $requestUrl, $ext = ".md") {
  51                 $file = implode(DIRECTORY_SEPARATOR, $this->baseUrl->params($requestUrl));
  52
  53                 foreach ($this->refs as $base) {
  54                         $path = new Path($base, $file);
  55                         if ($path->isFile($ext)) {
  56                                 return $path;
  57                         }
  58                 }
  59
  60                 return new Path;
  61         }
  62
  63         /**
  64          * Glob either in a Path's base dir, or, if the path does not have a base
  65          * dir set, in each REFPATH paths.
  66          *
  67          * @param \mdref\Path $path
  68          * @param string $pattern glob pattern
  69          * @param int $flags glob flags
  70          * @return array glob result
  71          */
  72         function glob(Path $path, $pattern, $flags = GLOB_BRACE) {
  73                 if (strlen($path->getBaseDir())) {
  74                         return glob($path->getFullPath($pattern), $flags);
  75                 }
  76                 $glob = array();
  77                 foreach ($this->refs as $ref) {
  78                         $glob = array_merge($glob, array_map(function ($fn) use ($ref) {
  79                                 return substr($fn, strlen($ref));
  80                         }, glob($ref . $pattern, $flags)));
  81                 }
  82                 return $glob;
  83         }
  84 }