Location.php

Go to the documentation of this file.

<?php

namespace Rsi\Fred;

class Location extends Component{

  public $rules = []; //!< Location rules (key = mask, value = array with path, version, and format - all optional).
  public $version = null; //!< Default version (empty = FRED™ version).
  public $format = '[full]?v=[version]'; //!< Default version format ([full] or [base] and [ext], and [version] are replaced).

  protected function init(){
    parent::init();
    if(!$this->version) $this->version = $this->_fred->version;
  }
  /**
   * Add a rule.
   * @param string $mask  Location mask (case insensitive prefix or regex) for locations that should follow this rule.
   * @param string $path  Path for this type (replaces the last capturing group of the mask, or complete match if no group).
   * @param string $version  Default version for this type.
   * @param string $format  Filename format ([full] or [base] and [ext], and [version] are replaced).
   */
  public function rule($mask,$path,$version = null,$format = null){
    $this->rules[$mask] = array_filter(compact('path','version','format'));
  }
  /**
   * Rewrite a location according to the rules.
   * @param string $url  Base/default location.
   * @return string  Rewritten location.
   */
  public function rewrite($url){
    $rule = null;
    $remote = strpos($url,'//') !== false;
    foreach($this->rules as $mask => $params)
      if(
        preg_match(substr($mask,0,1) == '/' ? $mask : '/^\\/' . preg_quote($mask,'/') . '\\//i',$url,$match) &&
        (!$remote || ($params['remote'] ?? null))
      ){
        if($path = \Rsi\Record::get($rule = $params,'path')) $url = str_replace(array_pop($match),$path,$url);
        break;
      }
    if(is_array($rule) && ($i = strrpos($url,'.'))){
      $rule += ['version' => $this->version,'format' => $this->format];
      $time = $this->filemtime(\Rsi\Http::docRoot() . $url);
      $url = strtr($rule['format'],['[full]' => $url,'[base]' => substr($url,0,$i),'[ext]' => substr($url,$i + 1),'[version]' => $time
        ? ($this->_fred->debug ? date('Ymd-His',$time) : base_convert($time - 1433116800,10,36))
        : preg_replace('/\\W/','-',$rule['version'])
      ]);
    }
    return $url;
  }

}