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