2011-03-04 13:17:12 +00:00
|
|
|
<?php
|
|
|
|
|
|
|
|
/*
|
|
|
|
* This file is part of the Symfony package.
|
|
|
|
*
|
2011-03-08 14:43:54 +00:00
|
|
|
* (c) Fabien Potencier <fabien@symfony.com>
|
2011-03-04 13:17:12 +00:00
|
|
|
*
|
|
|
|
* 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.
|
|
|
|
*
|
2011-03-08 14:43:54 +00:00
|
|
|
* @author Fabien Potencier <fabien@symfony.com>
|
2011-03-04 13:17:12 +00:00
|
|
|
*/
|
2011-12-05 12:58:28 +00:00
|
|
|
class DirectoryResource implements ResourceInterface
|
2011-03-04 13:17:12 +00:00
|
|
|
{
|
2011-03-23 18:34:00 +00:00
|
|
|
private $resource;
|
2011-04-01 12:56:50 +01:00
|
|
|
private $pattern;
|
2011-03-04 13:17:12 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Constructor.
|
|
|
|
*
|
|
|
|
* @param string $resource The file path to the resource
|
2011-04-01 12:56:50 +01:00
|
|
|
* @param string $pattern A pattern to restrict monitored files
|
2011-03-04 13:17:12 +00:00
|
|
|
*/
|
2011-04-01 12:56:50 +01:00
|
|
|
public function __construct($resource, $pattern = null)
|
2011-03-04 13:17:12 +00:00
|
|
|
{
|
2011-03-08 14:33:46 +00:00
|
|
|
$this->resource = $resource;
|
2011-04-01 12:56:50 +01:00
|
|
|
$this->pattern = $pattern;
|
2011-03-22 08:03:45 +00:00
|
|
|
}
|
|
|
|
|
2011-11-19 09:50:13 +00:00
|
|
|
/**
|
|
|
|
* Returns the list of filtered file and directory childs of directory resource.
|
|
|
|
*
|
|
|
|
* @return array An array of files
|
|
|
|
*/
|
2011-11-19 22:31:59 +00:00
|
|
|
public function getFilteredChilds()
|
2011-11-19 09:50:13 +00:00
|
|
|
{
|
2012-04-20 12:17:55 +01:00
|
|
|
if (!$this->exists()) {
|
|
|
|
return array();
|
|
|
|
}
|
|
|
|
|
|
|
|
$iterator = new \RecursiveIteratorIterator(
|
|
|
|
new \RecursiveDirectoryIterator($this->resource, \FilesystemIterator::SKIP_DOTS),
|
|
|
|
\RecursiveIteratorIterator::SELF_FIRST
|
|
|
|
);
|
|
|
|
|
2011-11-19 09:50:13 +00:00
|
|
|
$childs = array();
|
2012-04-20 12:17:55 +01:00
|
|
|
foreach ($iterator as $file) {
|
2011-11-19 09:50:13 +00:00
|
|
|
// if regex filtering is enabled only return matching files
|
2011-11-29 21:51:48 +00:00
|
|
|
if ($file->isFile() && !$this->hasFile($file)) {
|
2011-11-19 22:31:59 +00:00
|
|
|
continue;
|
2011-11-19 09:50:13 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
// 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;
|
|
|
|
}
|
|
|
|
|
2011-11-19 22:31:59 +00:00
|
|
|
/**
|
|
|
|
* Returns child resources that matches directory filters.
|
|
|
|
*
|
|
|
|
* @return array
|
|
|
|
*/
|
2011-11-29 21:51:48 +00:00
|
|
|
public function getFilteredResources()
|
2011-11-19 22:31:59 +00:00
|
|
|
{
|
2012-06-20 09:19:09 +01:00
|
|
|
if (!$this->exists()) {
|
|
|
|
return array();
|
|
|
|
}
|
|
|
|
|
2011-11-19 22:31:59 +00:00
|
|
|
$iterator = new \DirectoryIterator($this->resource);
|
|
|
|
|
|
|
|
$resources = array();
|
|
|
|
foreach ($iterator as $file) {
|
|
|
|
// if regex filtering is enabled only return matching files
|
2011-11-29 21:51:48 +00:00
|
|
|
if ($file->isFile() && !$this->hasFile($file)) {
|
2011-11-19 22:31:59 +00:00
|
|
|
continue;
|
|
|
|
}
|
|
|
|
|
|
|
|
// always monitor directories for changes, except the .. entries
|
|
|
|
// (otherwise deleted files wouldn't get detected)
|
|
|
|
if ($file->isDir() && '/..' === substr($file, -3)) {
|
|
|
|
continue;
|
|
|
|
}
|
|
|
|
|
2011-11-29 21:51:48 +00:00
|
|
|
// 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());
|
|
|
|
}
|
2011-11-19 22:31:59 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
return $resources;
|
|
|
|
}
|
|
|
|
|
2011-03-04 13:17:12 +00:00
|
|
|
/**
|
|
|
|
* 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;
|
|
|
|
}
|
|
|
|
|
2011-11-25 11:11:24 +00:00
|
|
|
/**
|
|
|
|
* Returns check pattern.
|
|
|
|
*
|
|
|
|
* @return mixed
|
|
|
|
*/
|
2011-09-16 12:43:09 +01:00
|
|
|
public function getPattern()
|
|
|
|
{
|
|
|
|
return $this->pattern;
|
|
|
|
}
|
|
|
|
|
2011-11-29 21:51:48 +00:00
|
|
|
/**
|
|
|
|
* 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;
|
|
|
|
}
|
|
|
|
|
2011-03-04 13:17:12 +00:00
|
|
|
/**
|
2011-11-19 07:58:54 +00:00
|
|
|
* Returns resource mtime.
|
2011-03-04 13:17:12 +00:00
|
|
|
*
|
2011-11-19 07:58:54 +00:00
|
|
|
* @return integer
|
2011-03-04 13:17:12 +00:00
|
|
|
*/
|
2011-11-19 07:58:54 +00:00
|
|
|
public function getModificationTime()
|
2011-03-04 13:17:12 +00:00
|
|
|
{
|
2012-06-20 09:19:09 +01:00
|
|
|
if (!$this->exists()) {
|
|
|
|
return -1;
|
|
|
|
}
|
|
|
|
|
2011-11-19 07:58:54 +00:00
|
|
|
clearstatcache(true, $this->resource);
|
2011-03-22 08:03:45 +00:00
|
|
|
$newestMTime = filemtime($this->resource);
|
2011-04-01 12:56:50 +01:00
|
|
|
|
2011-11-19 09:50:13 +00:00
|
|
|
foreach ($this->getFilteredChilds() as $file) {
|
2011-11-19 07:58:54 +00:00
|
|
|
clearstatcache(true, (string) $file);
|
2011-03-22 08:03:45 +00:00
|
|
|
$newestMTime = max($file->getMTime(), $newestMTime);
|
2011-03-04 13:17:12 +00:00
|
|
|
}
|
2011-03-08 14:33:46 +00:00
|
|
|
|
2011-11-19 07:58:54 +00:00
|
|
|
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;
|
|
|
|
}
|
|
|
|
|
2011-11-25 11:11:24 +00:00
|
|
|
return $this->getModificationTime() < $timestamp;
|
2011-11-19 07:58:54 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Returns true if the resource exists in the filesystem.
|
|
|
|
*
|
|
|
|
* @return Boolean
|
|
|
|
*/
|
|
|
|
public function exists()
|
|
|
|
{
|
2011-11-25 11:11:24 +00:00
|
|
|
return is_dir($this->resource);
|
2011-03-04 13:17:12 +00:00
|
|
|
}
|
2011-11-01 01:15:01 +00:00
|
|
|
|
2011-11-29 21:51:48 +00:00
|
|
|
/**
|
|
|
|
* Returns unique resource ID.
|
|
|
|
*
|
|
|
|
* @return string
|
|
|
|
*/
|
|
|
|
public function getId()
|
|
|
|
{
|
2012-06-09 12:25:01 +01:00
|
|
|
return md5('d'.$this->resource.$this->pattern);
|
2011-11-29 21:51:48 +00:00
|
|
|
}
|
|
|
|
|
2011-11-01 01:15:01 +00:00
|
|
|
public function serialize()
|
|
|
|
{
|
|
|
|
return serialize(array($this->resource, $this->pattern));
|
|
|
|
}
|
|
|
|
|
|
|
|
public function unserialize($serialized)
|
|
|
|
{
|
|
|
|
list($this->resource, $this->pattern) = unserialize($serialized);
|
|
|
|
}
|
2011-03-04 13:17:12 +00:00
|
|
|
}
|