waFiles

Работа с файлами

Содержание...

Методы

public static function convert ($file, $from, $to = 'UTF-8', $target = null)

Изменяет кодировку текстового файла.

Параметры

Возвращаемое значение

Значение параметра $target, указанное при вызове метода, либо сформированный автоматически путь к конвертированному файлу.

Пример

$target_path = waFiles::convert($file_path, 'CP1251');

public static function copy ($source_path, $target_path, $skip_pattern = null)

Копирует файл или содержимое директории.

Параметры

Пример

//будет скопировано содержимое директории 'wa-log' в директорию 'wa-log-temp', кроме файлов и поддиректорий, имена которых содержат фрагмент 'installer'
waFiles::copy('wa-log', 'wa-log-temp', '/installer/')

public static function create ($path, $is_dir = false)

Создает указанную директорию либо директорию для указанного файла.

Параметры

Пример

//несмотря на точку в имени директории,
//которая по умолчанию указывала бы на то, что передан путь к файлу,
//т. к. точка обычно отделяет основное имя файла от расширения,
//параметр $id_dir = true явно "говорит", что речь идет именно о директории
waFiles::create(wa()->getConfig()->getPath('cache').'/some.folder', true);

public static function delete ($path, $ignore_dir_errors = false)

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

Параметры

Пример

waFiles::delete('wa-test')

public static function extension($file)

Возвращает расширение имени файла.

Параметры

Пример

waFiles::extension('robots.txt')

Результат

txt

public static function formatSize ($file_size, $format = '%0.2f', $dimensions = 'Bytes,KBytes,MBytes,GBytes')

Возвращает отформатированное значение размера файла.

Параметры

Пример

waFiles::formatSize(1000000, '%0.2f', 'Б,кБ,МБ,ГБ')

Результат

0,95 МБ

public static function getMimeType ($filename)

Определяет MIME-тип файла по его имени.

Параметры

Пример

waFiles::getMimeType('index.php')

Результат

text/html

public static function listdir ($dir, $recursive = false)

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

Параметры

Пример

waFiles::listdir('wa-config/apps')

Результат

Array
(
    [0] => contacts
    [1] => shop
    [2] => site
    [3] => mailer
    [4] => helpdesk
    [5] => photos
    [6] => webasyst
    [7] => stickies
    [8] => checklists
    [9] => blog
)

Пример

waFiles::listdir('wa-config/apps', true)

Результат

Array
(
    [0] => contacts/person_fields_order.php
    [1] => contacts/config.php
    [2] => contacts/custom_fields.php
    [3] => site/domains/yourdomain.php
    [4] => mailer/plugins.php
    [5] => helpdesk/workflows.php
    [6] => helpdesk/graph.php
    [7] => photos/plugins.php
    [8] => photos/config.php
    [9] => blog/plugins.php
)

public static function move ($source_path, $target_path)

Перемещает файл или директорию в указанную директорию.

Параметры

Пример

$source = wa('myapp')->getAppPath('lib/config/data/.htaccess');
$target = wa('myapp')->getDataPath(null, true, 'images/.htaccess');
waFiles::move($source, $target);

public static function readFile ($file, $attach = null, $exit = true, $md5 = false)

Считывает содержимое файла и направляет вывод в браузер пользователя.

Параметры

Пример

$path = wa('myapp')->getAppPath('lib/config/data/sample.zip');
waFiles::readFile($path);

public static function upload ($url, $path)

Загружает файл с указанного URL в директорию.

Параметры

Пример

$url = 'http://somedomain.ru/archive.zip';
$path = wa()->getDataPath('files/pricelist.zip', true, 'myapp');
waFiles::upload($url, $path);

public static function write ($path, $content)

Записывает содержимое в файл.

Параметры

Пример

$path = wa()->getDataPath('user/01.txt', false, 'myapp');
$content = 'some text';
waFiles::write($path, $content);