Класс Файл
Удобный класс для чтения, записи и добавления в файлы.
Краткое описание свойств
- Объект папки файла
$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 )
Конструктор
Параметры
- string
$path - Путь к файлу
- boolean
$createoptional false - Создать файл, если он не существует (если true)
- integer
$modeoptional 0755 - Режим, применяемый к папке, содержащей файл
Ссылка
http://book.cakephp.org/3.0/en/core-libraries/file-folder.html#file-apiappend()source public
append( string $data , boolean $force false )
Добавляет строку данных к данному файлу.
Параметры
- string
$data - Данные для записи
- boolean
$forceoptional false - Принудительно открыть файл
Возвращает
booleanУспех
clearStatCache()source public
clearStatCache( boolean $all false )
Очистить внутренний кэш статист PHP
Параметры
- boolean
$alloptional false Очистить весь кэш или нет. Передача false очистит кэш статист только для текущего пути.
close()source public
close( )
Закрывает текущий файл, если он открыт.
Возвращает
booleanTrue, если закрытие прошло успешно или файл уже был закрыт, иначе false
copy()source public
copy( string $dest , boolean $overwrite true )
Копирует файл в $dest
Параметры
- string
$dest - Место назначения для копии
- boolean
$overwriteoptional true - Перезаписать $dest, если он существует
Возвращает
booleanУспех
executable()source public
executable( )
Возвращает true, если файл имеет разрешение на выполнение.
Возвращает
booleanTrue, если файл имеет разрешение на выполнение, иначе false
exists()source public
exists( )
Возвращает true, если файл существует.
Возвращает
booleanTrue, если файл существует, иначе false
ext()source public
ext( )
Возвращает расширение файла.
Возвращает
string|falseРасширение файла, false, если расширение извлечь не удалось.
folder()source public
folder( )
Возвращает текущую папку.
Возвращает
Cake\Filesystem\FolderТекущая папка
group()source public
group( )
Возвращает группу файла.
Возвращает
integer|falseГруппа файла или false в случае ошибки
info()source public
info( )
Возвращает информацию о файле в виде массива со следующими ключами:
- dirname
- basename
- extension
- filename
- filesize
- mime
Возвращает
arrayИнформация о файле.
lastAccess()source public
lastAccess( )
Возвращает время последнего доступа.
Возвращает
integer|falseОтметка времени последнего доступа или false в случае ошибки
lastChange()source public
lastChange( )
Возвращает время последнего изменения.
Возвращает
integer|falseОтметка времени последнего изменения или false в случае ошибки
md5()source public
md5( integer|boolean $maxsize 5 )
Получить контрольную сумму md5 файла с предварительной проверкой размера.
Параметры
- integer|boolean
$maxsizeопционально 5 - в МБ или true для принудительной проверки
Возвращает
string|falseконтрольная сумма md5 См. md5_file(), или false в случае ошибки
mime()source public
mime( )
Получить тип MIME файла. Использует расширение finfo, если оно доступно, в противном случае использует mime_content_type.
Возвращает
false|stringТип MIME файла или false в случае сбоя чтения.
name()source public
name( )
Возвращает имя файла без расширения.
Возвращает
string|falseИмя файла без расширения, false, если имя извлечь не удалось.
offset()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, определяющая, относительно чего задается смещение.
Возвращает
integer|booleanTrue в случае успеха, false в случае неудачи (режим установки), false в случае неудачи или целое смещение в случае успеха (режим получения)
open()source public
open( string $mode 'r' , boolean $force false )
Открывает текущий файл с заданным режимом.
Параметры
- string
$modeопционально 'r' - Действительная строка режима 'fopen' (r|w|a ...)
- boolean
$forceопционально false - Если true, файл будет повторно открыт даже если он уже открыт, иначе нет
Возвращает
booleanTrue в случае успеха, false в случае неудачи
owner()source public
owner( )
Возвращает владельца файла.
Возвращает
integer|falseВладелец файла или false в случае ошибки
perms()source public
perms( )
Возвращает разрешения ("chmod") файла.
Возвращает
string|falseРазрешения для файла, или false в случае ошибки
prepare()source public static
prepare( string $data , boolean $forceWindows false )
Подготавливает строку ASCII для записи. Преобразует символы конца строки в правильный терминатор для текущей платформы. Если Windows, используется "\r\n", в противном случае используется "\n".
Параметры
- string
$data - Данные для подготовки к записи.
- boolean
$forceWindowsопционально false - Если true, принудительно использует строку новой строки Windows.
Возвращает
stringСтрока с преобразованными символами конца строки.
read()source public
read( string|boolean $bytes false , string $mode 'rb' , boolean $force false )
Возвращает содержимое файла в виде строки.
Параметры
- string|boolean
$bytesопционально false - с какой позиции начать чтение
- string
$modeопционально 'rb' - Режим совместимый с
fread - boolean
$forceопционально false - Если true, файл будет повторно открыт, даже если он уже открыт, иначе нет
Возвращает
string|falseстрока в случае успеха, false в случае неудачи
readable()source public
readable( )
Возвращает true, если файл доступен для чтения.
Возвращает
booleanTrue, если файл доступен для чтения, иначе false
replaceText()source public
replaceText( string|array $search , string|array $replace )
Ищет заданный текст и заменяет его, если найден.
Параметры
- string|array
$search - Текст(ы) для поиска.
- string|array
$replace - Текст(ы) для замены.
Возвращает
booleanУспех
safe()source public
safe( string|null $name null , string|null $ext null )
Делает имя файла безопасным для сохранения
Параметры
- string|null
$nameнеобязательно null - Имя файла, которое нужно сделать безопасным, если оно отличается от $this->name
- string|null
$extнеобязательно null - Имя расширения, которое нужно сделать безопасным, если оно отличается от $this->ext
Возвращает
stringРасширение файла
size()source public
size( )
Возвращает размер файла
Возвращает
integer|falseРазмер файла в байтах или false в случае ошибки
writable()source public
writable( )
Возвращает true, если файл доступен для записи.
Возвращает
booleanTrue, если файл доступен для записи, иначе false
write()source public
write( string $data , string $mode 'w' , boolean $force false )
Записывает заданные данные в этот файл.
Параметры
- string
$data - Данные для записи в этот файл.
- string
$modeнеобязательно 'w' - Режим записи. См. fwrite().
- boolean
$forceнеобязательно false - Принудительно открыть файл
Возвращает
booleanУспех
Подробное описание свойств
$Foldersource
public Cake\Filesystem\Folder
Объект папки файла
Ссылка
http://book.cakephp.org/3.0/ru/core-libraries/file-folder.htmlnull
© 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.
http://api.cakephp.org/3.2/class-Cake.Filesystem.File.html