Filters
7 months ago
Scanning
5 years ago
AbstractFileObject.php
1 year ago
AbstractFilesystemScanner.php
2 months ago
DebugLogReader.php
2 years ago
DirectoryListing.php
5 months ago
DiskWriteCheck.php
5 months ago
FileObject.php
1 year ago
Filesystem.php
7 months ago
FilesystemExceptions.php
5 years ago
FilesystemScanner.php
2 weeks ago
FilesystemScannerDto.php
2 weeks ago
FilterableDirectoryIterator.php
1 year ago
LegacyFileRulesTrait.php
2 weeks ago
LogCleanup.php
5 months ago
LogFiles.php
1 year ago
MissingFileException.php
3 years ago
OPcache.php
5 months ago
PartIdentifier.php
9 months ago
PathChecker.php
2 years ago
PathIdentifier.php
1 day ago
Permissions.php
1 week ago
WpUploadsFolderSymlinker.php
2 weeks ago
Permissions.php
70 lines
| 1 | <?php |
| 2 | |
| 3 | namespace WPStaging\Framework\Filesystem; |
| 4 | |
| 5 | use WPStaging\Framework\Traits\ApplyFiltersTrait; |
| 6 | |
| 7 | class Permissions |
| 8 | { |
| 9 | use ApplyFiltersTrait; |
| 10 | |
| 11 | /** @var string */ |
| 12 | const FILTER_FOLDER_PERMISSION = 'wpstg_folder_permission'; |
| 13 | |
| 14 | /** @var string */ |
| 15 | const FILTER_FILE_PERMISSION = 'wpstg_file_permission'; |
| 16 | |
| 17 | /** @var int */ |
| 18 | const DEFAULT_FILE_PERMISSION = 0644; |
| 19 | |
| 20 | /** @var int */ |
| 21 | const DEFAULT_DIR_PERMISSION = 0755; |
| 22 | |
| 23 | /** |
| 24 | * @return int |
| 25 | */ |
| 26 | public function getDirectoryOctal(): int |
| 27 | { |
| 28 | if (!defined('FS_CHMOD_DIR')) { |
| 29 | return $this->applyFilters(self::FILTER_FOLDER_PERMISSION, self::DEFAULT_DIR_PERMISSION); |
| 30 | } |
| 31 | |
| 32 | if ($this->isValidPermission(FS_CHMOD_DIR)) { |
| 33 | return $this->applyFilters(self::FILTER_FOLDER_PERMISSION, FS_CHMOD_DIR); |
| 34 | } |
| 35 | |
| 36 | return $this->applyFilters(self::FILTER_FOLDER_PERMISSION, self::DEFAULT_DIR_PERMISSION); |
| 37 | } |
| 38 | |
| 39 | /** |
| 40 | * @param string $filePath Absolute path to the file, or empty string when no path is known. |
| 41 | * Passed as a second arg to wpstg_file_permission; callbacks that |
| 42 | * want per-file control must register with accepted_args = 2. |
| 43 | * @return int |
| 44 | */ |
| 45 | public function getFilePermission(string $filePath): int |
| 46 | { |
| 47 | $permission = self::DEFAULT_FILE_PERMISSION; |
| 48 | if (defined('FS_CHMOD_FILE') && $this->isValidPermission(FS_CHMOD_FILE)) { |
| 49 | $permission = FS_CHMOD_FILE; |
| 50 | } |
| 51 | |
| 52 | $filtered = $this->applyFilters(self::FILTER_FILE_PERMISSION, $permission, $filePath); |
| 53 | |
| 54 | if (!is_int($filtered) || !$this->isValidPermission($filtered)) { |
| 55 | return $permission; |
| 56 | } |
| 57 | |
| 58 | return $filtered; |
| 59 | } |
| 60 | |
| 61 | /** |
| 62 | * @param int $permission |
| 63 | * @return bool |
| 64 | */ |
| 65 | private function isValidPermission(int $permission): bool |
| 66 | { |
| 67 | return $permission >= 0 && $permission <= 0777; |
| 68 | } |
| 69 | } |
| 70 |