Spec-Zone.ru › CakePHP 2.10

Класс файла

Удобный класс для чтения, записи и добавления в файлы.

Пакет: Cake\Utility
Авторские права: Copyright (c) Cake Software Foundation, Inc. (https://cakefoundation.org)
Лицензия: MIT License
Расположение: Cake/Utility/File.php

Резюме свойств

  • $Folder public
    Folder
    Объект папки файла
  • $handle public
    resource
    Содержит ресурс обработчика файла, если файл открыт
  • $info public
    array
    Информация о файле
  • $lock public
    boolean
    Включить блокировку для чтения и записи файла
  • $name public
    string
    Имя файла
  • $path public
    mixed
    Свойство пути

Резюме методов

  • __construct() public
    Конструктор
  • __destruct() public
    Закрывает текущий файл, если он открыт
  • append() public
    Добавить заданную строку данных в этот файл.
  • clearStatCache() public
    Очистить внутренний кэш stat 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" файла.
  • prepare() public static

    Подготавливает строку 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 $create необязательно false
Создать файл, если он не существует (если true)
integer $mode необязательно 0755
Режим, применяемый к папке, содержащей файл

Ссылка

https://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File

__destruct()source public

__destruct( )

Закрывает текущий файл, если он открыт

append()source public

append( string $data , string $force false )

Добавить заданную строку данных в этот файл.

Параметры

string $data
Данные для записи
string $force необязательно false
Принудительно открыть файл

Возвращает

boolean
Успех

Ссылка

https://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::append

clearStatCache()source public

clearStatCache( boolean $all false )

Очистить внутренний кэш stat PHP

Для версий 5.3 и выше можно очистить кэш только для одного файла. Передача true очистит весь кэш stat.

Параметры

boolean $all необязательно false
Очистить весь кэш или нет

close()source public

close( )

Закрывает текущий файл, если он открыт.

Возвращает

boolean
True, если закрытие прошло успешно или файл был уже закрыт, иначе false

Ссылка

https://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::close

copy()source public

copy( string $dest , boolean $overwrite true )

Скопировать файл в $dest

Параметры

string $dest
Место назначения для копирования
boolean $overwrite необязательно true
Перезаписать $dest, если он существует

Возвращает

boolean
Успех

Ссылка

https://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::copy

create()source public

create( )

Создает файл.

Возвращает

boolean
Успех

Ссылка

https://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::create

delete()source public

delete( )

Удаляет файл.

Возвращает

boolean
Успех

Ссылка

https://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::delete

executable()source public

executable( )

Возвращает true, если файл исполняемый.

Возвращает

boolean
True, если файл исполняемый, иначе false

Ссылка

https://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::executable

exists()source public

exists( )

Возвращает true, если файл существует.

Возвращает

boolean
True, если файл существует, иначе false

Ссылка

https://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::exists

ext()source public

ext( )

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

Возвращает

string
Расширение файла

Ссылка

https://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::ext

folder()source public

folder( )

Возвращает текущую папку.

Возвращает

Folder
Текущая папка

Ссылка

https://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::Folder

group()source public

group( )

Возвращает группу файла.

Возвращает

integer|false
Группа файла или false в случае ошибки

Ссылка

https://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::group

info()source public

info( )

Возвращает информацию о файле в виде массива с ключами:

  • dirname
  • basename
  • extension
  • filename
  • filesize
  • mime

Возвращает

array
Информация о файле.

Ссылка

https://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::info

lastAccess()source public

lastAccess( )

Возвращает время последнего доступа.

Возвращает

integer|false
Отметка времени последнего доступа или false в случае ошибки

Ссылка

https://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::lastAccess

lastChange()source public

lastChange( )

Возвращает время последнего изменения.

Возвращает

integer|false
Отметка времени последнего изменения или false в случае ошибки

Ссылка

https://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::lastChange

md5()source public

md5( integer|boolean $maxsize 5 )

Получение контрольной суммы md5 файла с предварительной проверкой размера файла

Параметры

integer|boolean $maxsize необязательно 5
в МБ или true для принудительного расчёта

Возвращает

string|false
Контрольная сумма md5 См. md5_file(), или false в случае ошибки

Ссылка

https://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::md5

mime()source public

mime( )

Получение MIME-типа файла. Используется расширение finfo, если оно доступно, в противном случае используется mime_content_type

Возвращает

false|string
MIME-тип файла или false, если чтение не удалось.

name()source public

name( )

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

Возвращает

string
Имя файла без расширения.

Ссылка

https://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::name

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, определяющая относительность смещения.

Возвращает

mixed
True при успехе, false при ошибке (режим установки), false при ошибке или целое смещение при успехе (режим получения)

Ссылка

https://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::offset

open()source public

open( string $mode 'r' , boolean $force false )

Открывает файл с заданным режимом.

Параметры

string $mode необязательно 'r'
Строка режима 'fopen' (r|w|a ...)
boolean $force необязательно false
Если true, файл будет переоткрыт, даже если он уже открыт; иначе нет

Возвращает

boolean
True при успехе, false при ошибке

Ссылка

https://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::open

owner()source public

owner( )

Возвращает владельца файла.

Возвращает

integer|false
Владелец файла или false в случае ошибки

Ссылка

https://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::owner

perms()source public

perms( )

Возвращает разрешения файла (chmod).

Возвращает

string|false
Разрешения файла или false в случае ошибки

Ссылка

https://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::perms

prepare()source public static

prepare( string $data , boolean $forceWindows false )

Подготавливает строку ASCII для записи. Преобразует окончания строк в соответствующий разделитель для текущей платформы. Если Windows, будет использоваться «\r\n», на всех остальных платформах будет использоваться «\n»

Параметры

строка $data
Данные для подготовки к записи.
логическое $forceWindows необязательно false
Если true, принудительно используется строка окончания строки Windows.

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

строка
Строка с преобразованными окончаниями строк.

Ссылка

https://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::prepare

pwd()source public

pwd( )

Возвращает полный путь к файлу.

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

строка
Полный путь к файлу

Ссылка

https://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::pwd

read()source public

read( string $bytes false , string $mode 'rb' , boolean $force false )

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

Параметры

строка $bytes необязательно false
с какой позиции начать чтение
строка $mode необязательно 'rb'
Режим, совместимый с fread.
логическое $force необязательно false
Если true, файл будет повторно открыт, даже если он уже открыт, в противном случае не будет.

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

mixed
строка при успехе, false при ошибке

Ссылка

https://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::read

readable()source public

readable( )

Возвращает true, если файл доступен для чтения.

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

boolean
True, если файл доступен для чтения, false в противном случае

Ссылка

https://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::readable

replaceText()source public

replaceText( string|array $search , string|array $replace )

Ищет заданный текст и заменяет его, если он найден.

Параметры

строка|массив $search
Текст(ы) для поиска.
строка|массив $replace
Текст(ы) для замены.

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

boolean
Успех

safe()source public

safe( string $name null , string $ext null )

Делает имя файла безопасным для сохранения.

Параметры

строка $name необязательно null
Имя файла для безопасного преобразования, если оно отличается от $this->name
строка $ext необязательно null
Имя расширения для безопасного преобразования, если оно отличается от $this->ext

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

строка
расширение файла

Ссылка

https://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::safe

size()source public

size( )

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

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

целое число|false
Размер файла в байтах или false в случае ошибки

Ссылка

https://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::size

writable()source public

writable( )

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

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

boolean
True, если доступен для записи, false в противном случае

Ссылка

https://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::writable

write()source public

write( string $data , string $mode 'w' , boolean $force false )

Записывает заданные данные в этот файл.

Параметры

строка $data
Данные для записи в этот файл.
строка $mode необязательно 'w'
Режим записи. См. fwrite().
логическое $force необязательно false
Принудительно открыть файл.

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

boolean
Успех

Ссылка

https://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::write

Подробное описание свойств

$Foldersource

public Folder

Объект папки файла

Ссылка

https://book.cakephp.org/2.0/ru/core-utility-libraries/file-folder.html#File::$Folder
null

$handlesource

public resource

Содержит ресурс дескриптора файла, если файл открыт

null

$infosource

public массив

Информация о файле

array()

$locksource

public boolean

Включить блокировку для чтения и записи файла

null

$namesource

public строка

Имя файла

null

$pathsource

public смешанный тип

Свойство пути

Абсолютный путь к текущему файлу

null

© 2005–2017 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.10/class-File.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API