mode = $mode; } if (!file_exists($path) && $create === true) { $this->create($path, $this->mode); } if (!Folder::isAbsolute($path)) { $path = realpath($path); } if (!empty($path)) { $this->cd($path); } } /** * Return current path. * * @return string Current path * @link http://book.cakephp.org/2.0/en/core-utility-libraries/file-folder.html#Folder::pwd */ public function pwd() { return $this->path; } /** * Change directory to $path. * * @param string $path Path to the directory to change to * @return string The new path. Returns false on failure * @link http://book.cakephp.org/2.0/en/core-utility-libraries/file-folder.html#Folder::cd */ public function cd($path) { $path = $this->realpath($path); if (is_dir($path)) { return $this->path = $path; } return false; } /** * Returns an array of the contents of the current directory. * The returned array holds two arrays: One of directories and one of files. * * @param boolean $sort Whether you want the results sorted, set this and the sort property * to false to get unsorted results. * @param array|boolean $exceptions Either an array or boolean true will not grab dot files * @param boolean $fullPath True returns the full path * @return mixed Contents of current directory as an array, an empty array on failure * @link http://book.cakephp.org/2.0/en/core-utility-libraries/file-folder.html#Folder::read */ public function read($sort = true, $exceptions = false, $fullPath = false) { $dirs = $files = array(); if (!$this->pwd()) { return array($dirs, $files); } if (is_array($exceptions)) { $exceptions = array_flip($exceptions); } $skipHidden = isset($exceptions['.']) || $exceptions === true; try { $iterator = new DirectoryIterator($this->path); } catch (Exception $e) { return array($dirs, $files); } foreach ($iterator as $item) { if ($item->isDot()) { continue; } $name = $item->getFileName(); if ($skipHidden && $name[0] === '.' || isset($exceptions[$name])) { continue; } if ($fullPath) { $name = $item->getPathName(); } if ($item->isDir()) { $dirs[] = $name; } else { $files[] = $name; } } if ($sort || $this->sort) { sort($dirs); sort($files); } return array($dirs, $files); } /** * Returns an array of all matching files in current directory. * * @param string $regexpPattern Preg_match pattern (Defaults to: .*) * @param boolean $sort Whether results should be sorted. * @return array Files that match given pattern * @link http://book.cakephp.org/2.0/en/core-utility-libraries/file-folder.html#Folder::find */ public function find($regexpPattern = '.*', $sort = false) { list($dirs, $files) = $this->read($sort); return array_values(preg_grep('/^' . $regexpPattern . '$/i', $files)); } /** * Returns an array of all matching files in and below current directory. * * @param string $pattern Preg_match pattern (Defaults to: .*) * @param boolean $sort Whether results should be sorted. * @return array Files matching $pattern * @link http://book.cakephp.org/2.0/en/core-utility-libraries/file-folder.html#Folder::findRecursive */ public function findRecursive($pattern = '.*', $sort = false) { if (!$this->pwd()) { return array(); } $startsOn = $this->path; $out = $this->_findRecursive($pattern, $sort); $this->cd($startsOn); return $out; } /** * Private helper function for findRecursive. * * @param string $pattern Pattern to match against * @param boolean $sort Whether results should be sorted. * @return array Files matching pattern */ protected function _findRecursive($pattern, $sort = false) { list($dirs, $files) = $this->read($sort); $found = array(); foreach ($files as $file) { if (preg_match('/^' . $pattern . '$/i', $file)) { $found[] = Folder::addPathElement($this->path, $file); } } $start = $this->path; foreach ($dirs as $dir) { $this->cd(Folder::addPathElement($start, $dir)); $found = array_merge($found, $this->findRecursive($pattern, $sort)); } return $found; } /** * Returns true if given $path is a Windows path. * * @param string $path Path to check * @return boolean true if windows path, false otherwise * @link http://book.cakephp.org/2.0/en/core-utility-libraries/file-folder.html#Folder::isWindowsPath */ public static function isWindowsPath($path) { return (preg_match('/^[A-Z]:\\\\/i', $path) || substr($path, 0, 2) == '\\\\'); } /** * Returns true if given $path is an absolute path. * * @param string $path Path to check * @return boolean true if path is absolute. * @link http://book.cakephp.org/2.0/en/core-utility-libraries/file-folder.html#Folder::isAbsolute */ public static function isAbsolute($path) { return !empty($path) && ($path[0] === '/' || preg_match('/^[A-Z]:\\\\/i', $path) || substr($path, 0, 2) == '\\\\'); } /** * Returns a correct set of slashes for given $path. (\\ for Windows paths and / for other paths.) * * @param string $path Path to check * @return string Set of slashes ("\\" or "/") * @link http://book.cakephp.org/2.0/en/core-utility-libraries/file-folder.html#Folder::normalizePath */ public static function normalizePath($path) { return Folder::correctSlashFor($path); } /** * Returns a correct set of slashes for given $path. (\\ for Windows paths and / for other paths.) * * @param string $path Path to check * @return string Set of slashes ("\\" or "/") * @link http://book.cakephp.org/2.0/en/core-utility-libraries/file-folder.html#Folder::correctSlashFor */ public static function correctSlashFor($path) { return (Folder::isWindowsPath($path)) ? '\\' : '/'; } /** * Returns $path with added terminating slash (corrected for Windows or other OS). * * @param string $path Path to check * @return string Path with ending slash * @link http://book.cakephp.org/2.0/en/core-utility-libraries/file-folder.html#Folder::slashTerm */ public static function slashTerm($path) { if (Folder::isSlashTerm($path)) { return $path; } return $path . Folder::correctSlashFor($path); } /** * Returns $path with $element added, with correct slash in-between. * * @param string $path Path * @param string $element Element to and at end of path * @return string Combined path * @link http://book.cakephp.org/2.0/en/core-utility-libraries/file-folder.html#Folder::addPathElement */ public static function addPathElement($path, $element) { return rtrim($path, DS) . DS . $element; } /** * Returns true if the File is in a given CakePath. * * @param string $path The path to check. * @return boolean * @link http://book.cakephp.org/2.0/en/core-utility-libraries/file-folder.html#Folder::inCakePath */ public function inCakePath($path = '') { $dir = substr(Folder::slashTerm(ROOT), 0, -1); $newdir = $dir . $path; return $this->inPath($newdir); } /** * Returns true if the File is in given path. * * @param string $path The path to check that the current pwd() resides with in. * @param boolean $reverse Reverse the search, check that pwd() resides within $path. * @return boolean * @link http://book.cakephp.org/2.0/en/core-utility-libraries/file-folder.html#Folder::inPath */ public function inPath($path = '', $reverse = false) { $dir = Folder::slashTerm($path); $current = Folder::slashTerm($this->pwd()); if (!$reverse) { $return = preg_match('/^(.*)' . preg_quote($dir, '/') . '(.*)/', $current); } else { $return = preg_match('/^(.*)' . preg_quote($current, '/') . '(.*)/', $dir); } return (bool)$return; } /** * Change the mode on a directory structure recursively. This includes changing the mode on files as well. * * @param string $path The path to chmod * @param integer $mode octal value 0755 * @param boolean $recursive chmod recursively, set to false to only change the current directory. * @param array $exceptions array of files, directories to skip * @return boolean Returns TRUE on success, FALSE on failure * @link http://book.cakephp.org/2.0/en/core-utility-libraries/file-folder.html#Folder::chmod */ public function chmod($path, $mode = false, $recursive = true, $exceptions = array()) { if (!$mode) { $mode = $this->mode; } if ($recursive === false && is_dir($path)) { if (@chmod($path, intval($mode, 8))) { $this->_messages[] = __d('cake_dev', '%s changed to %s', $path, $mode); return true; } $this->_errors[] = __d('cake_dev', '%s NOT changed to %s', $path, $mode); return false; } if (is_dir($path)) { $paths = $this->tree($path); foreach ($paths as $type) { foreach ($type as $key => $fullpath) { $check = explode(DS, $fullpath); $count = count($check); if (in_array($check[$count - 1], $exceptions)) { continue; } if (@chmod($fullpath, intval($mode, 8))) { $this->_messages[] = __d('cake_dev', '%s changed to %s', $fullpath, $mode); } else { $this->_errors[] = __d('cake_dev', '%s NOT changed to %s', $fullpath, $mode); } } } if (empty($this->_errors)) { return true; } } return false; } /** * Returns an array of nested directories and files in each directory * * @param string $path the directory path to build the tree from * @param array|boolean $exceptions Either an array of files/folder to exclude * or boolean true to not grab dot files/folders * @param string $type either 'file' or 'dir'. null returns both files and directories * @return mixed array of nested directories and files in each directory * @link http://book.cakephp.org/2.0/en/core-utility-libraries/file-folder.html#Folder::tree */ public function tree($path = null, $exceptions = false, $type = null) { if ($path == null) { $path = $this->path; } $files = array(); $directories = array($path); if (is_array($exceptions)) { $exceptions = array_flip($exceptions); } $skipHidden = false; if ($exceptions === true) { $skipHidden = true; } elseif (isset($exceptions['.'])) { $skipHidden = true; unset($exceptions['.']); } try { $directory = new RecursiveDirectoryIterator($path, RecursiveDirectoryIterator::KEY_AS_PATHNAME | RecursiveDirectoryIterator::CURRENT_AS_SELF); $iterator = new RecursiveIteratorIterator($directory, RecursiveIteratorIterator::SELF_FIRST); } catch (Exception $e) { if ($type === null) { return array(array(), array()); } return array(); } foreach ($iterator as $itemPath => $fsIterator) { if ($skipHidden) { $subPathName = $fsIterator->getSubPathname(); if ($subPathName{0} == '.' || strpos($subPathName, DS . '.') !== false) { continue; } } $item = $fsIterator->current(); if (!empty($exceptions) && isset($exceptions[$item->getFilename()])) { continue; } if ($item->isFile()) { $files[] = $itemPath; } elseif ($item->isDir() && !$item->isDot()) { $directories[] = $itemPath; } } if ($type === null) { return array($directories, $files); } if ($type === 'dir') { return $directories; } return $files; } /** * Create a directory structure recursively. Can be used to create * deep path structures like `/foo/bar/baz/shoe/horn` * * @param string $pathname The directory structure to create * @param integer $mode octal value 0755 * @return boolean Returns TRUE on success, FALSE on failure * @link http://book.cakephp.org/2.0/en/core-utility-libraries/file-folder.html#Folder::create */ public function create($pathname, $mode = false) { if (is_dir($pathname) || empty($pathname)) { return true; } if (!$mode) { $mode = $this->mode; } if (is_file($pathname)) { $this->_errors[] = __d('cake_dev', '%s is a file', $pathname); return false; } $pathname = rtrim($pathname, DS); $nextPathname = substr($pathname, 0, strrpos($pathname, DS)); if ($this->create($nextPathname, $mode)) { if (!file_exists($pathname)) { $old = umask(0); if (mkdir($pathname, $mode)) { umask($old); $this->_messages[] = __d('cake_dev', '%s created', $pathname); return true; } else { umask($old); $this->_errors[] = __d('cake_dev', '%s NOT created', $pathname); return false; } } } return false; } /** * Returns the size in bytes of this Folder and its contents. * * @return integer size in bytes of current folder * @link http://book.cakephp.org/2.0/en/core-utility-libraries/file-folder.html#Folder::dirsize */ public function dirsize() { $size = 0; $directory = Folder::slashTerm($this->path); $stack = array($directory); $count = count($stack); for ($i = 0, $j = $count; $i < $j; ++$i) { if (is_file($stack[$i])) { $size += filesize($stack[$i]); } elseif (is_dir($stack[$i])) { $dir = dir($stack[$i]); if ($dir) { while (false !== ($entry = $dir->read())) { if ($entry === '.' || $entry === '..') { continue; } $add = $stack[$i] . $entry; if (is_dir($stack[$i] . $entry)) { $add = Folder::slashTerm($add); } $stack[] = $add; } $dir->close(); } } $j = count($stack); } return $size; } /** * Recursively Remove directories if the system allows. * * @param string $path Path of directory to delete * @return boolean Success * @link http://book.cakephp.org/2.0/en/core-utility-libraries/file-folder.html#Folder::delete */ public function delete($path = null) { if (!$path) { $path = $this->pwd(); } if (!$path) { return null; } $path = Folder::slashTerm($path); if (is_dir($path)) { try { $directory = new RecursiveDirectoryIterator($path, RecursiveDirectoryIterator::CURRENT_AS_SELF); $iterator = new RecursiveIteratorIterator($directory, RecursiveIteratorIterator::CHILD_FIRST); } catch (Exception $e) { return false; } foreach ($iterator as $item) { $filePath = $item->getPathname(); if ($item->isFile() || $item->isLink()) { if (@unlink($filePath)) { $this->_messages[] = __d('cake_dev', '%s removed', $filePath); } else { $this->_errors[] = __d('cake_dev', '%s NOT removed', $filePath); } } elseif ($item->isDir() && !$item->isDot()) { if (@rmdir($filePath)) { $this->_messages[] = __d('cake_dev', '%s removed', $filePath); } else { $this->_errors[] = __d('cake_dev', '%s NOT removed', $filePath); return false; } } } $path = rtrim($path, DS); if (@rmdir($path)) { $this->_messages[] = __d('cake_dev', '%s removed', $path); } else { $this->_errors[] = __d('cake_dev', '%s NOT removed', $path); return false; } } return true; } /** * Recursive directory copy. * * ### Options * * - `to` The directory to copy to. * - `from` The directory to copy from, this will cause a cd() to occur, changing the results of pwd(). * - `mode` The mode to copy the files/directories with. * - `skip` Files/directories to skip. * * @param array|string $options Either an array of options (see above) or a string of the destination directory. * @return boolean Success * @link http://book.cakephp.org/2.0/en/core-utility-libraries/file-folder.html#Folder::copy */ public function copy($options = array()) { if (!$this->pwd()) { return false; } $to = null; if (is_string($options)) { $to = $options; $options = array(); } $options = array_merge(array('to' => $to, 'from' => $this->path, 'mode' => $this->mode, 'skip' => array()), $options); $fromDir = $options['from']; $toDir = $options['to']; $mode = $options['mode']; if (!$this->cd($fromDir)) { $this->_errors[] = __d('cake_dev', '%s not found', $fromDir); return false; } if (!is_dir($toDir)) { $this->create($toDir, $mode); } if (!is_writable($toDir)) { $this->_errors[] = __d('cake_dev', '%s not writable', $toDir); return false; } $exceptions = array_merge(array('.', '..', '.svn'), $options['skip']); if ($handle = @opendir($fromDir)) { while (false !== ($item = readdir($handle))) { if (!in_array($item, $exceptions)) { $from = Folder::addPathElement($fromDir, $item); $to = Folder::addPathElement($toDir, $item); if (is_file($from)) { if (copy($from, $to)) { chmod($to, intval($mode, 8)); touch($to, filemtime($from)); $this->_messages[] = __d('cake_dev', '%s copied to %s', $from, $to); } else { $this->_errors[] = __d('cake_dev', '%s NOT copied to %s', $from, $to); } } if (is_dir($from) && !file_exists($to)) { $old = umask(0); if (mkdir($to, $mode)) { umask($old); $old = umask(0); chmod($to, $mode); umask($old); $this->_messages[] = __d('cake_dev', '%s created', $to); $options = array_merge($options, array('to' => $to, 'from' => $from)); $this->copy($options); } else { $this->_errors[] = __d('cake_dev', '%s not created', $to); } } } } closedir($handle); } else { return false; } if (!empty($this->_errors)) { return false; } return true; } /** * Recursive directory move. * * ### Options * * - `to` The directory to copy to. * - `from` The directory to copy from, this will cause a cd() to occur, changing the results of pwd(). * - `chmod` The mode to copy the files/directories with. * - `skip` Files/directories to skip. * * @param array $options (to, from, chmod, skip) * @return boolean Success * @link http://book.cakephp.org/2.0/en/core-utility-libraries/file-folder.html#Folder::move */ public function move($options) { $to = null; if (is_string($options)) { $to = $options; $options = (array)$options; } $options = array_merge( array('to' => $to, 'from' => $this->path, 'mode' => $this->mode, 'skip' => array()), $options ); if ($this->copy($options)) { if ($this->delete($options['from'])) { return (bool)$this->cd($options['to']); } } return false; } /** * get messages from latest method * * @return array * @link http://book.cakephp.org/2.0/en/core-utility-libraries/file-folder.html#Folder::messages */ public function messages() { return $this->_messages; } /** * get error from latest method * * @return array * @link http://book.cakephp.org/2.0/en/core-utility-libraries/file-folder.html#Folder::errors */ public function errors() { return $this->_errors; } /** * Get the real path (taking ".." and such into account) * * @param string $path Path to resolve * @return string The resolved path * @link http://book.cakephp.org/2.0/en/core-utility-libraries/file-folder.html#Folder::realpath */ public function realpath($path) { $path = str_replace('/', DS, trim($path)); if (strpos($path, '..') === false) { if (!Folder::isAbsolute($path)) { $path = Folder::addPathElement($this->path, $path); } return $path; } $parts = explode(DS, $path); $newparts = array(); $newpath = ''; if ($path[0] === DS) { $newpath = DS; } while (($part = array_shift($parts)) !== null) { if ($part === '.' || $part === '') { continue; } if ($part === '..') { if (!empty($newparts)) { array_pop($newparts); continue; } else { return false; } } $newparts[] = $part; } $newpath .= implode(DS, $newparts); return Folder::slashTerm($newpath); } /** * Returns true if given $path ends in a slash (i.e. is slash-terminated). * * @param string $path Path to check * @return boolean true if path ends with slash, false otherwise * @link http://book.cakephp.org/2.0/en/core-utility-libraries/file-folder.html#Folder::isSlashTerm */ public static function isSlashTerm($path) { $lastChar = $path[strlen($path) - 1]; return $lastChar === '/' || $lastChar === '\\'; } }