* * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Symfony\Component\Config\Resource; /** * DirectoryResource represents a resources stored in a subdirectory tree. * * @author Fabien Potencier */ class DirectoryResource implements ResourceInterface { private $resource; private $pattern; /** * Constructor. * * @param string $resource The file path to the resource * @param string $pattern A pattern to restrict monitored files */ public function __construct($resource, $pattern = null) { $this->resource = $resource; $this->pattern = $pattern; } /** * Returns the list of filtered file and directory childs of directory resource. * * @return array An array of files */ public function getFilteredChilds() { if (!$this->exists()) { return array(); } $iterator = new \RecursiveIteratorIterator( new \RecursiveDirectoryIterator($this->resource, \FilesystemIterator::SKIP_DOTS), \RecursiveIteratorIterator::SELF_FIRST ); $childs = array(); foreach ($iterator as $file) { // if regex filtering is enabled only return matching files if ($file->isFile() && !$this->hasFile($file)) { continue; } // always monitor directories for changes, except the .. entries // (otherwise deleted files wouldn't get detected) if ($file->isDir() && '/..' === substr($file, -3)) { continue; } $childs[] = $file; } return $childs; } /** * Returns child resources that matches directory filters. * * @return array */ public function getFilteredResources() { $iterator = new \DirectoryIterator($this->resource); $resources = array(); foreach ($iterator as $file) { // if regex filtering is enabled only return matching files if ($file->isFile() && !$this->hasFile($file)) { continue; } // always monitor directories for changes, except the .. entries // (otherwise deleted files wouldn't get detected) if ($file->isDir() && '/..' === substr($file, -3)) { continue; } // if file is dot - continue if ($file->isDot()) { continue; } if ($file->isFile()) { $resources[] = new FileResource($file->getRealPath()); } elseif ($file->isDir()) { $resources[] = new DirectoryResource($file->getRealPath()); } } return $resources; } /** * Returns a string representation of the Resource. * * @return string A string representation of the Resource */ public function __toString() { return (string) $this->resource; } /** * Returns the resource tied to this Resource. * * @return mixed The resource */ public function getResource() { return $this->resource; } /** * Returns check pattern. * * @return mixed */ public function getPattern() { return $this->pattern; } /** * Checks that passed file exists in resource and matches resource filters. * * @param SplFileInfo|string $file * * @return Boolean */ public function hasFile($file) { if (!$file instanceof \SplFileInfo) { $file = new \SplFileInfo($file); } if (0 !== strpos($file->getRealPath(), realpath($this->resource))) { return false; } if ($this->pattern) { return (bool) preg_match($this->pattern, $file->getBasename()); } return true; } /** * Returns resource mtime. * * @return integer */ public function getModificationTime() { clearstatcache(true, $this->resource); $newestMTime = filemtime($this->resource); foreach ($this->getFilteredChilds() as $file) { clearstatcache(true, (string) $file); $newestMTime = max($file->getMTime(), $newestMTime); } return $newestMTime; } /** * Returns true if the resource has not been updated since the given timestamp. * * @param integer $timestamp The last time the resource was loaded * * @return Boolean true if the resource has not been updated, false otherwise */ public function isFresh($timestamp) { if (!$this->exists()) { return false; } return $this->getModificationTime() < $timestamp; } /** * Returns true if the resource exists in the filesystem. * * @return Boolean */ public function exists() { return is_dir($this->resource); } /** * Returns unique resource ID. * * @return string */ public function getId() { return md5($this->resource.$this->pattern); } public function serialize() { return serialize(array($this->resource, $this->pattern)); } public function unserialize($serialized) { list($this->resource, $this->pattern) = unserialize($serialized); } }