Класс FormData
Предоставляет интерфейс для создания тел сообщений в формате multipart/form-encoded.
Используется в Http\Client для загрузки данных POST/PUT и файлов.
- Cake\Http\Client\FormData реализует Countable
Краткое описание свойств
-
$_boundaryprotectedМаркер границы.string -
$_hasComplexPartprotectedПризнак наличия сложной части в объекте formdata.boolean -
$_hasFileprotectedПризнак наличия прикрепленных файлов в объекте formdata.boolean -
$_partsprotectedЧасти в данных формы.Cake\Http\Client\FormDataPart[]
Краткое описание методов
- __toString() public
Преобразует FormData и её части в строку, подходящую для использования в HTTP-запросе.
- add() publicДобавляет новую часть данных.
- addFile() public
Добавляет ссылку на файл (строка, начинающаяся с @) или дескриптор файла.
- addMany() publicДобавляет сразу несколько частей.
- addRecursive() publicРекурсивно добавляет данные.
- boundary() publicПолучить маркер границы
- contentType() publicПолучить тип содержимого для этого полезного груза.
- count() publicВозвращает количество частей внутри этого объекта.
- hasFile() public
Проверка наличия файлов в текущем полезном грузе.
- isMultipart() public
Проверка того, является ли текущий полезный груз multipart.
- newPart() publicМетод для создания новых экземпляров Part
Подробное описание методов
__toString()source public
__toString( )
Преобразует FormData и её части в строку, подходящую для использования в HTTP-запросе.
Возвращает
строкаadd()source public
add( string|Cake\Http\Client\FormData $name , mixed $value = null )
Добавляет новую часть данных.
Значение части может быть строкой, массивом, целым числом, числом с плавающей точкой, дескриптором файла или объектом, реализующим метод __toString()
Если $value является массивом, будут добавлены несколько частей. Файлы будут считываться из текущей позиции и сохраняться в памяти.
Параметры
- строка|
Cake\Http\Client\FormData$name Имя добавляемой части или объект с данными части.
- смешанное
$valueнеобязательно null - Значение части.
Возвращает
$this
addFile()source public
addFile( string $name , mixed $value )
Добавляет ссылку на файл (строка, начинающаяся с @) или дескриптор файла.
Параметры
- строка
$name - Используемое имя.
- смешанное
$value - Имя файла в виде строки или дескриптор файла.
Возвращает
Cake\Http\Client\FormDataPartaddMany()source public
addMany( array $data )
Добавляет сразу несколько частей.
Проходит по параметрам и добавляет все пары ключ/значение.
Параметры
- массив
$data - Массив данных для добавления.
Возвращает
$this
addRecursive()source public
addRecursive( string $name , mixed $value )
Рекурсивно добавляет данные.
Параметры
- строка
$name - Используемое имя.
- смешанное
$value - Значение для добавления.
contentType()source public
contentType( )
Получить тип содержимого для этого полезного груза.
Если в этом объекте есть файлы, multipart/form-data будет использоваться, в противном случае application/x-www-form-urlencoded будет использоваться.
Возвращает
строкаcount()source public
count( )
Возвращает количество частей внутри этого объекта.
Возвращает
целое числоРеализация
Countable::count() hasFile()source public
hasFile( )
Проверка наличия файлов в текущем полезном грузе.
Возвращает
логическое значениеПризнак наличия файла в этом полезном грузе.
isMultipart()source public
isMultipart( )
Проверка того, является ли текущий полезный груз multipart.
Полезный груз становится multipart, когда вы добавляете файлы или используете add() с экземпляром Part.
Возвращает
логическое значениеПризнак того, что полезный груз является multipart.
newPart()source public
newPart( string $name , string $value )
Метод для создания новых экземпляров Part
Параметры
- строка
$name - Имя части.
- строка
$value - Значение для добавления.
Возвращает
Cake\Http\Client\FormDataPartПодробное описание свойств
$_hasComplexPartsource
protected логическое значение
Признак наличия сложной части в объекте formdata.
false
$_hasFilesource
protected логическое значение
Признак наличия прикрепленных файлов в объекте formdata.
false
© 2005–present 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/3.6/class-Cake.Http.Client.FormData.html