[TASK] CleanUp canonicalizing identifiers in FAL-drivers
[Packages/TYPO3.CMS.git] / typo3 / sysext / core / Classes / Resource / Driver / AbstractHierarchicalFilesystemDriver.php
1 <?php
2 namespace TYPO3\CMS\Core\Resource\Driver;
3
4 /***************************************************************
5 * Copyright notice
6 *
7 * (c) 2013 Steffen Ritter <steffen.ritter@typo3.org>
8 * All rights reserved
9 *
10 * This script is part of the TYPO3 project. The TYPO3 project is
11 * free software; you can redistribute it and/or modify
12 * it under the terms of the GNU General Public License as published by
13 * the Free Software Foundation; either version 2 of the License, or
14 * (at your option) any later version.
15 *
16 * The GNU General Public License can be found at
17 * http://www.gnu.org/copyleft/gpl.html.
18 * A copy is found in the textfile GPL.txt and important notices to the license
19 * from the author is found in LICENSE.txt distributed with these scripts.
20 *
21 *
22 * This script is distributed in the hope that it will be useful,
23 * but WITHOUT ANY WARRANTY; without even the implied warranty of
24 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
25 * GNU General Public License for more details.
26 *
27 * This copyright notice MUST APPEAR in all copies of the script!
28 ***************************************************************/
29
30 /**
31 * Class AbstractHierarchicalFilesystemDriver
32 *
33 * @package TYPO3\CMS\Core\Resource\Driver
34 */
35 abstract class AbstractHierarchicalFilesystemDriver extends AbstractDriver {
36
37 /**
38 * Wrapper for \TYPO3\CMS\Core\Utility\GeneralUtility::validPathStr()
39 *
40 * @param string $theFile Filepath to evaluate
41 * @return boolean TRUE if no '/', '..' or '\' is in the $theFile
42 * @see \TYPO3\CMS\Core\Utility\GeneralUtility::validPathStr()
43 */
44 protected function isPathValid($theFile) {
45 return \TYPO3\CMS\Core\Utility\GeneralUtility::validPathStr($theFile);
46 }
47
48 /**
49 * Makes sure the Path given as parameter is valid
50 *
51 * @param string $filePath The file path (including the file name!)
52 * @return string
53 * @throws \TYPO3\CMS\Core\Resource\Exception\InvalidPathException
54 */
55 protected function canonicalizeAndCheckFilePath($filePath) {
56 $filePath = \TYPO3\CMS\Core\Utility\PathUtility::getCanonicalPath($filePath);
57
58 // filePath must be valid
59 if (!$this->isPathValid($filePath)) {
60 throw new \TYPO3\CMS\Core\Resource\Exception\InvalidPathException('File ' . $filePath . ' is not valid (".." and "//" is not allowed in path).', 1320286857);
61 }
62 return $filePath;
63 }
64
65 /**
66 * Makes sure the Path given as parameter is valid
67 *
68 * @param string $fileIdentifier The file path (including the file name!)
69 * @return string
70 */
71 protected function canonicalizeAndCheckFileIdentifier($fileIdentifier) {
72 $fileIdentifier = $this->canonicalizeAndCheckFilePath($fileIdentifier);
73 $fileIdentifier = '/' . ltrim($fileIdentifier, '/');
74 if (!$this->isCaseSensitiveFileSystem()) {
75 $fileIdentifier = strtolower($fileIdentifier);
76 }
77 return $fileIdentifier;
78 }
79
80 /**
81 * Makes sure the Path given as parameter is valid
82 *
83 * @param string $folderPath The file path (including the file name!)
84 * @return string
85 */
86 protected function canonicalizeAndCheckFolderIdentifier($folderPath) {
87 return $this->canonicalizeAndCheckFileIdentifier($folderPath) . '/';
88 }
89
90 /**
91 * Returns the identifier of the folder the file resides in
92 *
93 * @param string $fileIdentifier
94 * @return mixed
95 */
96 public function getFolderIdentifierForFile($fileIdentifier) {
97 $fileIdentifier = $this->canonicalizeAndCheckFileIdentifier($fileIdentifier);
98 return \TYPO3\CMS\Core\Utility\PathUtility::dirname($fileIdentifier) . '/';
99 }
100
101
102 }