2010-02-17 13:55:05 +00:00
|
|
|
<?php
|
|
|
|
|
|
|
|
namespace Symfony\Framework\WebBundle\Util;
|
|
|
|
|
2010-05-05 15:56:14 +01:00
|
|
|
use Symfony\Components\Finder\Finder;
|
|
|
|
|
2010-02-17 13:55:05 +00:00
|
|
|
/*
|
2010-04-07 01:51:29 +01:00
|
|
|
* This file is part of the Symfony framework.
|
2010-02-17 13:55:05 +00:00
|
|
|
*
|
|
|
|
* (c) Fabien Potencier <fabien.potencier@symfony-project.com>
|
|
|
|
*
|
|
|
|
* This source file is subject to the MIT license that is bundled
|
|
|
|
* with this source code in the file LICENSE.
|
|
|
|
*/
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Provides basic utility to manipulate the file system.
|
|
|
|
*
|
2010-04-07 01:51:29 +01:00
|
|
|
* @package Symfony
|
|
|
|
* @subpackage Framework_WebBundle
|
|
|
|
* @author Fabien Potencier <fabien.potencier@symfony-project.com>
|
2010-02-17 13:55:05 +00:00
|
|
|
*/
|
|
|
|
class Filesystem
|
|
|
|
{
|
2010-05-06 12:25:53 +01:00
|
|
|
/**
|
|
|
|
* Copies a file.
|
|
|
|
*
|
|
|
|
* This method only copies the file if the origin file is newer than the target file.
|
|
|
|
*
|
|
|
|
* By default, if the target already exists, it is not overridden.
|
|
|
|
*
|
|
|
|
* To override existing files, pass the "override" option.
|
|
|
|
*
|
|
|
|
* @param string $originFile The original filename
|
|
|
|
* @param string $targetFile The target filename
|
|
|
|
* @param array $options An array of options
|
|
|
|
*/
|
|
|
|
public function copy($originFile, $targetFile, $options = array())
|
2010-02-17 13:55:05 +00:00
|
|
|
{
|
2010-05-06 12:25:53 +01:00
|
|
|
if (!array_key_exists('override', $options))
|
|
|
|
{
|
|
|
|
$options['override'] = false;
|
|
|
|
}
|
2010-02-17 13:55:05 +00:00
|
|
|
|
2010-05-06 12:25:53 +01:00
|
|
|
// we create target_dir if needed
|
|
|
|
if (!is_dir(dirname($targetFile)))
|
|
|
|
{
|
|
|
|
$this->mkdirs(dirname($targetFile));
|
|
|
|
}
|
2010-02-17 13:55:05 +00:00
|
|
|
|
2010-05-06 12:25:53 +01:00
|
|
|
$mostRecent = false;
|
|
|
|
if (file_exists($targetFile))
|
|
|
|
{
|
|
|
|
$statTarget = stat($targetFile);
|
|
|
|
$stat_origin = stat($originFile);
|
|
|
|
$mostRecent = ($stat_origin['mtime'] > $statTarget['mtime']) ? true : false;
|
|
|
|
}
|
2010-02-17 13:55:05 +00:00
|
|
|
|
2010-05-06 12:25:53 +01:00
|
|
|
if ($options['override'] || !file_exists($targetFile) || $mostRecent)
|
|
|
|
{
|
|
|
|
copy($originFile, $targetFile);
|
|
|
|
}
|
2010-02-17 13:55:05 +00:00
|
|
|
}
|
|
|
|
|
2010-05-06 12:25:53 +01:00
|
|
|
/**
|
|
|
|
* Creates a directory recursively.
|
|
|
|
*
|
|
|
|
* @param string $path The directory path
|
|
|
|
* @param int $mode The directory mode
|
|
|
|
*
|
|
|
|
* @return bool true if the directory has been created, false otherwise
|
|
|
|
*/
|
|
|
|
public function mkdirs($path, $mode = 0777)
|
2010-02-17 13:55:05 +00:00
|
|
|
{
|
2010-05-06 12:25:53 +01:00
|
|
|
if (is_dir($path))
|
|
|
|
{
|
|
|
|
return true;
|
|
|
|
}
|
2010-02-17 13:55:05 +00:00
|
|
|
|
2010-05-06 12:25:53 +01:00
|
|
|
return @mkdir($path, $mode, true);
|
2010-02-17 13:55:05 +00:00
|
|
|
}
|
|
|
|
|
2010-05-06 12:25:53 +01:00
|
|
|
/**
|
|
|
|
* Creates empty files.
|
|
|
|
*
|
|
|
|
* @param mixed $files The filename, or an array of filenames
|
|
|
|
*/
|
|
|
|
public function touch($files)
|
2010-02-17 13:55:05 +00:00
|
|
|
{
|
2010-05-06 12:25:53 +01:00
|
|
|
if (!is_array($files))
|
|
|
|
{
|
|
|
|
$files = array($files);
|
|
|
|
}
|
2010-02-17 13:55:05 +00:00
|
|
|
|
2010-05-06 12:25:53 +01:00
|
|
|
foreach ($files as $file)
|
|
|
|
{
|
|
|
|
touch($file);
|
|
|
|
}
|
2010-02-17 13:55:05 +00:00
|
|
|
}
|
|
|
|
|
2010-05-06 12:25:53 +01:00
|
|
|
/**
|
|
|
|
* Removes files or directories.
|
|
|
|
*
|
|
|
|
* @param mixed $files A filename or an array of files to remove
|
|
|
|
*/
|
|
|
|
public function remove($files)
|
2010-02-17 13:55:05 +00:00
|
|
|
{
|
2010-05-06 12:25:53 +01:00
|
|
|
if (!is_array($files))
|
2010-02-17 13:55:05 +00:00
|
|
|
{
|
2010-05-06 12:25:53 +01:00
|
|
|
$files = array($files);
|
2010-02-17 13:55:05 +00:00
|
|
|
}
|
|
|
|
|
2010-05-06 12:25:53 +01:00
|
|
|
$files = array_reverse($files);
|
|
|
|
foreach ($files as $file)
|
|
|
|
{
|
|
|
|
if (!file_exists($file))
|
|
|
|
{
|
|
|
|
continue;
|
|
|
|
}
|
2010-02-17 13:55:05 +00:00
|
|
|
|
2010-05-06 12:25:53 +01:00
|
|
|
if (is_dir($file) && !is_link($file))
|
|
|
|
{
|
|
|
|
$fp = opendir($file);
|
|
|
|
while (false !== $item = readdir($fp))
|
|
|
|
{
|
|
|
|
if (!in_array($item, array('.', '..')))
|
|
|
|
{
|
|
|
|
$this->remove($file.'/'.$item);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
closedir($fp);
|
2010-02-17 13:55:05 +00:00
|
|
|
|
2010-05-06 12:25:53 +01:00
|
|
|
rmdir($file);
|
|
|
|
}
|
|
|
|
else
|
|
|
|
{
|
|
|
|
unlink($file);
|
|
|
|
}
|
|
|
|
}
|
2010-02-17 13:55:05 +00:00
|
|
|
}
|
|
|
|
|
2010-05-06 12:25:53 +01:00
|
|
|
/**
|
|
|
|
* Change mode for an array of files or directories.
|
|
|
|
*
|
|
|
|
* @param array $files An array of files or directories
|
|
|
|
* @param integer $mode The new mode
|
|
|
|
* @param integer $umask The mode mask (octal)
|
|
|
|
*/
|
|
|
|
public function chmod($files, $mode, $umask = 0000)
|
2010-02-17 13:55:05 +00:00
|
|
|
{
|
2010-05-06 12:25:53 +01:00
|
|
|
$currentUmask = umask();
|
|
|
|
umask($umask);
|
2010-02-17 13:55:05 +00:00
|
|
|
|
2010-05-06 12:25:53 +01:00
|
|
|
if (!is_array($files))
|
|
|
|
{
|
|
|
|
$files = array($files);
|
|
|
|
}
|
2010-02-17 13:55:05 +00:00
|
|
|
|
2010-05-06 12:25:53 +01:00
|
|
|
foreach ($files as $file)
|
|
|
|
{
|
|
|
|
chmod($file, $mode);
|
|
|
|
}
|
2010-02-17 13:55:05 +00:00
|
|
|
|
2010-05-06 12:25:53 +01:00
|
|
|
umask($currentUmask);
|
|
|
|
}
|
2010-02-17 13:55:05 +00:00
|
|
|
|
2010-05-06 12:25:53 +01:00
|
|
|
/**
|
|
|
|
* Renames a file.
|
|
|
|
*
|
|
|
|
* @param string $origin The origin filename
|
|
|
|
* @param string $target The new filename
|
|
|
|
*
|
|
|
|
* @throws \RuntimeException When target file already exists
|
|
|
|
*/
|
|
|
|
public function rename($origin, $target)
|
2010-02-17 13:55:05 +00:00
|
|
|
{
|
2010-05-06 12:25:53 +01:00
|
|
|
// we check that target does not exist
|
|
|
|
if (is_readable($target))
|
|
|
|
{
|
|
|
|
throw new \RuntimeException(sprintf('Cannot rename because the target "%" already exist.', $target));
|
|
|
|
}
|
2010-02-17 13:55:05 +00:00
|
|
|
|
2010-05-06 12:25:53 +01:00
|
|
|
rename($origin, $target);
|
2010-02-17 13:55:05 +00:00
|
|
|
}
|
|
|
|
|
2010-05-06 12:25:53 +01:00
|
|
|
/**
|
|
|
|
* Creates a symbolic link or copy a directory.
|
|
|
|
*
|
|
|
|
* @param string $originDir The origin directory path
|
|
|
|
* @param string $targetDir The symbolic link name
|
|
|
|
* @param bool $copyOnWindows Whether to copy files if on windows
|
|
|
|
*/
|
|
|
|
public function symlink($originDir, $targetDir, $copyOnWindows = false)
|
2010-02-17 13:55:05 +00:00
|
|
|
{
|
2010-05-06 12:25:53 +01:00
|
|
|
if (!function_exists('symlink') && $copyOnWindows)
|
|
|
|
{
|
|
|
|
$this->mirror($originDir, $targetDir);
|
2010-02-17 13:55:05 +00:00
|
|
|
|
2010-05-06 12:25:53 +01:00
|
|
|
return;
|
|
|
|
}
|
2010-02-17 13:55:05 +00:00
|
|
|
|
2010-05-06 12:25:53 +01:00
|
|
|
$ok = false;
|
|
|
|
if (is_link($targetDir))
|
|
|
|
{
|
|
|
|
if (readlink($targetDir) != $originDir)
|
|
|
|
{
|
|
|
|
unlink($targetDir);
|
|
|
|
}
|
|
|
|
else
|
|
|
|
{
|
|
|
|
$ok = true;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
if (!$ok)
|
|
|
|
{
|
|
|
|
symlink($originDir, $targetDir);
|
|
|
|
}
|
2010-02-17 13:55:05 +00:00
|
|
|
}
|
|
|
|
|
2010-05-06 12:25:53 +01:00
|
|
|
/**
|
|
|
|
* Mirrors a directory to another.
|
|
|
|
*
|
|
|
|
* @param string $originDir The origin directory
|
|
|
|
* @param string $targetDir The target directory
|
|
|
|
* @param Finder $finder An Finder instance
|
|
|
|
* @param array $options An array of options (see copy())
|
|
|
|
*
|
|
|
|
* @throws \RuntimeException When file type is unknown
|
|
|
|
*/
|
|
|
|
public function mirror($originDir, $targetDir, Finder $finder = null, $options = array())
|
2010-02-17 13:55:05 +00:00
|
|
|
{
|
2010-05-06 12:25:53 +01:00
|
|
|
if (null === $finder)
|
|
|
|
{
|
|
|
|
$finder = new Finder();
|
|
|
|
}
|
2010-04-21 10:18:41 +01:00
|
|
|
|
2010-05-06 12:25:53 +01:00
|
|
|
foreach ($finder->in($originDir) as $file)
|
|
|
|
{
|
|
|
|
$target = $targetDir.DIRECTORY_SEPARATOR.str_replace(realpath($originDir), '', $file->getRealPath());
|
|
|
|
|
|
|
|
if (is_dir($file))
|
|
|
|
{
|
|
|
|
$this->mkdirs($target);
|
|
|
|
}
|
|
|
|
else if (is_file($file))
|
|
|
|
{
|
|
|
|
$this->copy($file, $target, $options);
|
|
|
|
}
|
|
|
|
else if (is_link($file))
|
|
|
|
{
|
|
|
|
$this->symlink($file, $target);
|
|
|
|
}
|
|
|
|
else
|
|
|
|
{
|
|
|
|
throw new \RuntimeException(sprintf('Unable to guess "%s" file type.', $file));
|
|
|
|
}
|
|
|
|
}
|
2010-02-17 13:55:05 +00:00
|
|
|
}
|
|
|
|
}
|