Версия: 6.x
burger close
Класс Tools

Подробное описание

Здесь собраны различные дополнительные функции для работы с файлами

Открытые статические члены

static makePath ($dstFilename, $parseDir=false)
 
static deleteFolder ($dir, $delself=true)
 
static moveWithReplace ($sfolder, $dfolder, $moveself=false, $copy=false)
 
static parseFileName ($filename, $removeDot=false)
 
static checkUploadError ($err_status)
 
static sendToDownload ($source, $filename, $mime= 'application/octet-stream')
 
static fileSizeToStr ($inbytes)
 
static getMaxPostFileSize ()
 
static normalizeFilePost ($post_files_arr)
 
static makePrivateDir ($path)
 
static buildRelativePath ($absolute_path)
 

Методы

static buildRelativePath (   $absolute_path)
static

Возвращает относительный путь на основе абсолютного пути. Итоговый путь будет относительно $_SERVER['DOCUMENT_ROOT'], включая папку В случае, если не удается сделать относительный путь, то возвращается исходный $absolute_path

Аргументы
string$absolute_pathабсолютный путь к папке или файлу
Возвращает
string
static checkUploadError (   $err_status)
static

Возвращает false - если нет ошибок при загрузке файла, иначе текст ошибки

Аргументы
integer$err_status- результат $_FILES[имя_формы][error]
Возвращает
bool(false) | string
static deleteFolder (   $dir,
  $delself = true 
)
static

Удаляет рекурсивно папку и все ее содержимое.

Аргументы
string$dir- путь к папке
bool$delself- Если true, то папка $dir тоже будет удалена, иначе, только содержимое папки $dir
Возвращает
bool true - если все прошло успешно, false - если что-то не удалено.
static fileSizeToStr (   $inbytes)
static

Возвращает строковое представление размера файла

Аргументы
integer$inbytesразмер файла в байтах
Возвращает
string
static getMaxPostFileSize ( )
static

Возвращает максимально допустимый в настройках PHP размер загружаемого файла в байтах

Возвращает
integer максимально допустимый размер загружаемого файла в байтах
static makePath (   $dstFilename,
  $parseDir = false 
)
static

Создает недостающие папки для указанного пути

Аргументы
string$dstFilename- путь к файлу или папке
boolean$parseDir- Устанавливайте true, если в $dstFilename присутствует еще имя файла, в этом случае оно будет игнорироваться.
static makePrivateDir (   $path)
static

Закрывает директорию от публичного просмотра, добавляя в ней файл .htaccess со строкой deny from all

Аргументы
string$path- путь к директории
Возвращает
string возвращает путь к директории $path
static moveWithReplace (   $sfolder,
  $dfolder,
  $moveself = false,
  $copy = false 
)
static

Переносит рекурсивно или копирует папку из одного места в другое с заменой файлов

Аргументы
string$sfolderпапка источник
string$dfolderпапка назначения
bool$moveselfпереносить ли папку источник
bool$copyесли задано true, то копировать файлы, иначе переносить
Возвращает
bool возвращает true, если все файлы перенесены успешно, если хоть один файл не перенесен, то false
static normalizeFilePost (   $post_files_arr)
static

Группирует сведения по загруженным файлам вокруг файлов. Вместо массива [ 'name' => [0 => ..., 1 => ...], 'type' => [0 => ..., 1 => ...], 'tmp_name' => [0 => ..., 1 => ...], 'error' => [0 => ..., 1 => ...], 'size' => [0 => ..., 1 => ...] ] массив принимает вид: [ [ 'name' => ..., 'type' => ..., 'tmp_name' => ..., 'error' => ..., 'size' => ... ], [ 'name' => ..., 'type' => ..., 'tmp_name' => ..., 'error' => ..., 'size' => ... ] ]

Возвращает
array
static parseFileName (   $filename,
  $removeDot = false 
)
static

Возвращает массив с двумя элементами array(0 => 'Имя файла', 1 => 'Расширение') Удобно применять так list($filename, $fileext) = ::parseFileName('test.txt');

Аргументы
string$filename- имя файла
bool$removeDot- если true, то точка в расширении будет удалена
Возвращает
array
static sendToDownload (   $source,
  $filename,
  $mime = 'application/octet-stream' 
)
static

Отправляет файл на скачивание

Аргументы
string$source- абсолютный путь к файлу
string$filename- имя файла в диалоге сохранения файла
string$mime- Mime тип содержимого файла
Возвращает
bool возвращает true, если файл найден, иначе false