Класс Файл
Удобный класс для чтения, записи и добавления в файлы.
Авторское право: Copyright (c) Cake Software Foundation, Inc. (http://cakefoundation.org)
Лицензия: MIT Лицензия
Расположение: Cake/Utility/File.php
Краткое описание свойств
- Объект папки файла
$Folderpublic -
$handlepublicСодержит ресурс обработчика файла, если файл открытresource -
$infopublicИнформация о файлеarray -
$lockpublicВключить блокировку для чтения и записи файлаboolean -
$namepublicИмя файлаstring -
$pathpublicСвойство путиmixed
Краткое описание методов
- __construct() publicКонструктор
- __destruct() publicЗакрывает текущий файл, если он открыт
- append() publicДобавить заданную строку данных в этот файл.
- clearStatCache() publicОчистить внутренний кеш статистики PHP
- close() publicЗакрывает текущий файл, если он открыт.
- copy() publicСкопировать файл в $dest
- create() publicСоздаёт файл.
- delete() publicУдалить файл.
- executable() publicВозвращает true, если файл исполняемый.
- exists() publicВозвращает true, если файл существует.
- ext() publicВозвращает расширение файла.
- folder() publicВозвращает текущую папку.
- group() publicВозвращает группу файла.
- info() publicВозвращает информацию о файле в виде массива со следующими ключами:
- lastAccess() publicВозвращает время последнего доступа.
- lastChange() publicВозвращает время последнего изменения.
- md5() publicПолучить контрольную сумму md5 файла с предварительной проверкой размера файла
- mime() public
Получить тип MIME файла. Использует расширение finfo, если оно доступно, в противном случае использует mime_content_type
- name() publicВозвращает имя файла без расширения.
- offset() publicУстанавливает или получает смещение для текущего открытого файла.
- open() publicОткрывает текущий файл с заданным $mode
- owner() publicВозвращает владельца файла.
- perms() publicВозвращает права (chmod) файла.
-
Подготавливает строку ASCII для записи. Преобразует символы конца строки в правильный разделитель для текущей платформы. Если Windows, используется "\r\n", во всех остальных случаях используется "\n"
- pwd() publicВозвращает полный путь к файлу.
- read() publicВозвращает содержимое файла в виде строки.
- readable() publicВозвращает true, если файл читаем.
- replaceText() publicИщет заданный текст и заменяет его, если найден.
- safe() publicДелает имя файла безопасным для сохранения
- size() publicВозвращает размер файла
- writable() publicВозвращает true, если файл записывается.
- write() publicЗаписать заданные данные в этот файл.
Детали методов
__construct()source public
__construct( string $path , boolean $create false , integer $mode 0755 )
Конструктор
Параметры
- строка
$path - Путь к файлу
- логическое значение
$createнеобязательно false - Создать файл, если он не существует (если true)
- целое число
$modeнеобязательно 0755 - Режим, применяемый к папке, содержащей файл
Ссылка
http://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#Fileappend()source public
append( string $data , string $force false )
Добавить строку данных в конец этого файла.
Параметры
- строка
$data - Данные для записи
- строка
$forceнеобязательно false - Принудительно открыть файл
Возвращает
booleanУспех
Ссылка
http://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::appendclearStatCache()source public
clearStatCache( boolean $all false )
Очистить внутренний кэш статистики PHP
Для версии 5.3 и выше можно очистить кэш только для одного файла. Передача true очистит весь кэш статистики.
Параметры
- логическое значение
$allнеобязательно false - Очистить весь кэш или нет
close()source public
close( )
Закрывает текущий файл, если он открыт.
Возвращает
booleanTrue, если закрытие прошло успешно или файл уже был закрыт, иначе false
Ссылка
http://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::closecopy()source public
copy( string $dest , boolean $overwrite true )
Копирует файл в $dest
Параметры
- строка
$dest - Место назначения копии
- логическое значение
$overwriteнеобязательно true - Перезаписать $dest, если он существует
Возвращает
booleanУспех
Ссылка
http://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::copycreate()source public
create( )
Создаёт файл.
Возвращает
booleanУспех
Ссылка
http://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::createdelete()source public
delete( )
Удаляет файл.
Возвращает
booleanУспех
Ссылка
http://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::deleteexecutable()source public
executable( )
Возвращает true, если файл имеет разрешение на выполнение.
Возвращает
booleanTrue, если разрешение на выполнение есть, иначе false
Ссылка
http://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::executableexists()source public
exists( )
Возвращает true, если файл существует.
Возвращает
booleanTrue, если файл существует, иначе false
Ссылка
http://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::existsext()source public
ext( )
Возвращает расширение файла.
Возвращает
stringРасширение файла
Ссылка
http://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::extfolder()source public
folder( )
Возвращает текущую папку.
Возвращает
FolderТекущая папка
Ссылка
http://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::Foldergroup()source public
group( )
Возвращает группу файла.
Возвращает
integer|falseГруппа файла или false в случае ошибки
Ссылка
http://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::groupinfo()source public
info( )
Возвращает информацию о файле в виде массива с ключами:
- dirname
- basename
- extension
- filename
- filesize
- mime
Возвращает
arrayИнформация о файле.
Ссылка
http://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::infolastAccess()source public
lastAccess( )
Возвращает время последнего доступа.
Возвращает
integer|falseОтметка времени последнего доступа или false в случае ошибки
Ссылка
http://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::lastAccesslastChange()source public
lastChange( )
Возвращает время последнего изменения.
Возвращает
integer|falseОтметка времени последнего изменения или false в случае ошибки
Ссылка
http://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::lastChangemd5()source public
md5( integer|boolean $maxsize 5 )
Получение контрольной суммы md5 файла с предварительной проверкой размера файла
Параметры
- integer|boolean
$maxsizeoptional 5 - в МБ или true для принудительного вычисления
Возвращает
string|falseКонтрольная сумма md5 См. md5_file(), или false в случае ошибки
Ссылка
http://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::md5mime()source public
mime( )
Получение типа MIME файла. Использует расширение finfo, если оно доступно, в противном случае возвращает mime_content_type.
Возвращает
false|stringТип MIME файла или false, если чтение завершилось ошибкой.
name()source public
name( )
Возвращает имя файла без расширения.
Возвращает
stringИмя файла без расширения.
Ссылка
http://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::nameoffset()source public
offset( integer|boolean $offset false , integer $seek SEEK_SET )
Устанавливает или получает смещение для текущего открытого файла.
Параметры
- integer|boolean
$offsetнеобязательно false - Смещение в байтах, к которому нужно перейти. Если установлено в false, возвращается текущее смещение.
- integer
$seekнеобязательно SEEK_SET - Константа PHP SEEK_SET | SEEK_CUR | SEEK_END, определяющая, относительно чего задается смещение $offset.
Возвращает
mixedTrue при успехе, false при неудаче (в режиме установки), false при неудаче или целое смещение при успехе (в режиме получения).
Ссылка
http://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::offsetopen()source public
open( string $mode 'r' , boolean $force false )
Открывает текущий файл с заданным режимом $mode.
Параметры
- string
$modeнеобязательно 'r' - Строка режима 'fopen' (r|w|a и т.д.).
- boolean
$forceнеобязательно false - Если true, файл будет повторно открыт, даже если он уже открыт; в противном случае - нет.
Возвращает
booleanTrue при успехе, false при неудаче.
Ссылка
http://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::openowner()source public
owner( )
Возвращает владельца файла.
Возвращает
integer|falseВладелец файла или false в случае ошибки.
Ссылка
http://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::ownerperms()source public
perms( )
Возвращает разрешения ("chmod") файла.
Возвращает
string|falseРазрешения файла или false в случае ошибки.
Ссылка
http://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::permsprepare()source public static
prepare( string $data , boolean $forceWindows false )
Подготавливает строку ASCII для записи. Преобразует окончания строк в соответствующий терминатор для текущей платформы. Для Windows используется "\r\n", для всех остальных платформ - "\n".
Параметры
- string
$data - Данные для подготовки к записи.
- boolean
$forceWindowsнеобязательно false - Если true, принудительно использует строку окончания строки Windows.
Возвращает
stringСтрока с преобразованными окончаниями строк.
Ссылка
http://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::preparepwd()source public
pwd( )
Возвращает полный путь к файлу.
Возвращает
stringПолный путь к файлу
Ссылка
http://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::pwdread()source public
read( string $bytes false , string $mode 'rb' , boolean $force false )
Возвращает содержимое файла в виде строки.
Параметры
- string
$bytesнеобязательно false - с какой позиции начать чтение
- string
$modeнеобязательно 'rb' - Режим, совместимый с
fread. - boolean
$forceнеобязательно false - Если true, файл будет повторно открыт, даже если он уже открыт; в противном случае нет.
Возвращает
mixedстрока при успехе, false при ошибке
Ссылка
http://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::readreadable()source public
readable( )
Возвращает true, если файл доступен для чтения.
Возвращает
booleanTrue, если файл доступен для чтения, false в противном случае
Ссылка
http://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::readablereplaceText()source public
replaceText( string|array $search , string|array $replace )
Ищет заданный текст и заменяет его, если найдет.
Параметры
- string|array
$search - Текст(ы) для поиска.
- string|array
$replace - Текст(ы) для замены.
Возвращает
booleanУспех
safe()source public
safe( string $name null , string $ext null )
Делает имя файла безопасным для сохранения.
Параметры
- string
$nameнеобязательно null - Имя файла для безопасного изменения, если отличается от $this->name.
- string
$extнеобязательно null - Имя расширения для безопасного изменения, если отличается от $this->ext.
Возвращает
stringрасширение файла
Ссылка
http://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::safesize()source public
size( )
Возвращает размер файла.
Возвращает
integer|falseРазмер файла в байтах, или false в случае ошибки
Ссылка
http://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::sizewritable()source public
writable( )
Возвращает true, если файл доступен для записи.
Возвращает
booleanTrue, если доступен для записи, false в противном случае
Ссылка
http://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::writablewrite()source public
write( string $data , string $mode 'w' , boolean $force false )
Записать заданные данные в этот файл.
Параметры
- строка
$data - Данные для записи в этот файл.
- строка
$modeнеобязательно 'w' - Режим записи. См. fwrite().
- логическое значение
$forceнеобязательно false - Принудительно открыть файл
Возвращаемые значения
booleanУспех
Ссылка
http://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::writeПодробное описание свойств
$Foldersource
public Folder
Объект папки файла
Ссылка
http://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::$Foldernull
© 2005–2016 The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
https://api.cakephp.org/2.9/class-File.html