Skip to content
Permalink
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
146 lines (131 sloc) 2.56 KB
<?php namespace ProcessWire;
/**
* ProcessWire FilenameArray
*
* Manages array of filenames or file URLs, like for $config->scripts and $config->styles.
*
* ProcessWire 3.x, Copyright 2016 by Ryan Cramer
* https://processwire.com
*
*/
class FilenameArray implements \IteratorAggregate, \Countable {
/**
* Array of filenames indexed by MD5 hash of filename
*
* @var array
*
*/
protected $data = array();
/**
* Add a file
*
* @param string $filename
* @return $this
*
*/
public function add($filename) {
$key = $this->getKey($filename);
$this->data[$key] = $filename;
return $this;
}
/**
* Get key for $filename that excludes query strings
*
* @param string $filename
* @return string
*
*/
protected function getKey($filename) {
$pos = strpos($filename, '?');
$key = $pos ? substr($filename, 0, $pos) : $filename;
return md5($key);
}
/**
* Prepend $filename to the beginning
*
* @param string $filename
* @return $this
*
*/
public function prepend($filename) {
$key = $this->getKey($filename);
$data = array($key => $filename);
foreach($this->data as $k => $v) {
if($k == $key) continue;
$data[$k] = $v;
}
$this->data = $data;
return $this;
}
/**
* Append $filename to the end
*
* @param string $filename
* @return FilenameArray
*
*/
public function append($filename) {
return $this->add($filename);
}
/**
* Make iterable
*
* @return \ArrayObject
*
*/
public function getIterator() {
return new \ArrayObject($this->data);
}
/**
* Make FilenameArray unique (deprecated)
*
* @deprecated no longer necessary since the add() function ensures uniqueness
* @return FilenameArray
*
*/
public function unique() {
// no longer necessary since the add() function ensures uniqueness
// $this->data = array_unique($this->data);
return $this;
}
/**
* Remove filename
*
* @param string $filename
* @return $this
*
*/
public function remove($filename) {
$key = array_search($filename, $this->data);
if($key !== false) unset($this->data[$key]);
return $this;
}
/**
* Remove all filenames
*
* @return $this
*
*/
public function removeAll() {
$this->data = array();
return $this;
}
/**
* String value containing print_r() dump of all filenames
*
* @return string
*
*/
public function __toString() {
return print_r($this->data, true);
}
/**
* Return count of items in this FilenameArray
*
* @return int
*
*/
public function count() {
return count($this->data);
}
}
You can’t perform that action at this time.