123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835 |
- <?php
- /**
- * CakePHP(tm) : Rapid Development Framework (http://cakephp.org)
- * Copyright 2005-2012, Cake Software Foundation, Inc. (http://cakefoundation.org)
- *
- * Licensed under The MIT License
- * Redistributions of files must retain the above copyright notice.
- *
- * @copyright Copyright 2005-2012, Cake Software Foundation, Inc. (http://cakefoundation.org)
- * @link http://cakephp.org CakePHP(tm) Project
- * @package Cake.Utility
- * @since CakePHP(tm) v 0.2.9
- * @license MIT License (http://www.opensource.org/licenses/mit-license.php)
- */
- /**
- * Folder structure browser, lists folders and files.
- * Provides an Object interface for Common directory related tasks.
- *
- * @package Cake.Utility
- */
- class Folder {
- /**
- * Default scheme for Folder::copy
- * Recursively merges subfolders with the same name
- *
- * @constant MERGE
- */
- const MERGE = 'merge';
- /**
- * Overwrite scheme for Folder::copy
- * subfolders with the same name will be replaced
- *
- * @constant OVERWRITE
- */
- const OVERWRITE = 'overwrite';
- /**
- * Skip scheme for Folder::copy
- * if a subfolder with the same name exists it will be skipped
- *
- * @constant SKIP
- */
- const SKIP = 'skip';
- /**
- * Path to Folder.
- *
- * @var string
- * @link http://book.cakephp.org/2.0/en/core-utility-libraries/file-folder.html#Folder::$path
- */
- public $path = null;
- /**
- * Sortedness. Whether or not list results
- * should be sorted by name.
- *
- * @var boolean
- * @link http://book.cakephp.org/2.0/en/core-utility-libraries/file-folder.html#Folder::$sort
- */
- public $sort = false;
- /**
- * Mode to be used on create. Does nothing on windows platforms.
- *
- * @var integer
- * http://book.cakephp.org/2.0/en/core-utility-libraries/file-folder.html#Folder::$mode
- */
- public $mode = 0755;
- /**
- * Holds messages from last method.
- *
- * @var array
- */
- protected $_messages = array();
- /**
- * Holds errors from last method.
- *
- * @var array
- */
- protected $_errors = array();
- /**
- * Holds array of complete directory paths.
- *
- * @var array
- */
- protected $_directories;
- /**
- * Holds array of complete file paths.
- *
- * @var array
- */
- protected $_files;
- /**
- * Constructor.
- *
- * @param string $path Path to folder
- * @param boolean $create Create folder if not found
- * @param string|boolean $mode Mode (CHMOD) to apply to created folder, false to ignore
- * @link http://book.cakephp.org/2.0/en/core-utility-libraries/file-folder.html#Folder
- */
- public function __construct($path = false, $create = false, $mode = false) {
- if (empty($path)) {
- $path = TMP;
- }
- if ($mode) {
- $this->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(, $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)) {
- //@codingStandardsIgnoreStart
- if (@chmod($path, intval($mode, 8))) {
- //@codingStandardsIgnoreEnd
- $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 $fullpath) {
- $check = explode(DS, $fullpath);
- $count = count($check);
- if (in_array($check[$count - 1], $exceptions)) {
- continue;
- }
- //@codingStandardsIgnoreStart
- if (@chmod($fullpath, intval($mode, 8))) {
- //@codingStandardsIgnoreEnd
- $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) {
- $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()) {
- //@codingStandardsIgnoreStart
- if (@unlink($filePath)) {
- //@codingStandardsIgnoreEnd
- $this->_messages[] = __d('cake_dev', '%s removed', $filePath);
- } else {
- $this->_errors[] = __d('cake_dev', '%s NOT removed', $filePath);
- }
- } elseif ($item->isDir() && !$item->isDot()) {
- //@codingStandardsIgnoreStart
- if (@rmdir($filePath)) {
- //@codingStandardsIgnoreEnd
- $this->_messages[] = __d('cake_dev', '%s removed', $filePath);
- } else {
- $this->_errors[] = __d('cake_dev', '%s NOT removed', $filePath);
- return false;
- }
- }
- }
- $path = rtrim($path, DS);
- //@codingStandardsIgnoreStart
- if (@rmdir($path)) {
- //@codingStandardsIgnoreEnd
- $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.
- * - `scheme` Folder::MERGE, Folder::OVERWRITE, Folder::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) {
- 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(), 'scheme' => Folder::MERGE), $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']);
- //@codingStandardsIgnoreStart
- if ($handle = @opendir($fromDir)) {
- //@codingStandardsIgnoreEnd
- while (($item = readdir($handle)) !== false) {
- $to = Folder::addPathElement($toDir, $item);
- if (($options['scheme'] != Folder::SKIP || !is_dir($to)) && !in_array($item, $exceptions)) {
- $from = Folder::addPathElement($fromDir, $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) && $options['scheme'] == Folder::OVERWRITE) {
- $this->delete($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);
- }
- } elseif (is_dir($from) && $options['scheme'] == Folder::MERGE) {
- $options = array_merge($options, array('to' => $to, 'from' => $from));
- $this->copy($options);
- }
- }
- }
- 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.
- * - `scheme` Folder::MERGE, Folder::OVERWRITE, Folder::SKIP
- *
- * @param array $options (to, from, chmod, skip, scheme)
- * @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
- *
- * @param boolean $reset Reset message stack after reading
- * @return array
- * @link http://book.cakephp.org/2.0/en/core-utility-libraries/file-folder.html#Folder::messages
- */
- public function messages($reset = true) {
- $messages = $this->_messages;
- if ($reset) {
- $this->_messages = array();
- }
- return $messages;
- }
- /**
- * get error from latest method
- *
- * @param boolean $reset Reset error stack after reading
- * @return array
- * @link http://book.cakephp.org/2.0/en/core-utility-libraries/file-folder.html#Folder::errors
- */
- public function errors($reset = true) {
- $errors = $this->_errors;
- if ($reset) {
- $this->_errors = array();
- }
- return $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 === '\\';
- }
- }
|