Форма
класс Form расширяет Ссылка и реализует ArrayAccess
Форма представляет HTML-форму.
Свойства
| защищенное DOMElement | $node | из AbstractUriElement | |
| защищенная строка | $method | из AbstractUriElement | |
| защищенная строка | $currentUri | из AbstractUriElement |
Методы
| __construct(DOMElement $node, строка $currentUri, строка|null $method = null, строка $baseHref = null) | ||
| DOMElement | getNode() Возвращает узел, связанный с этой ссылкой. | из AbstractUriElement |
| строка | getMethod() Возвращает метод формы. | |
| строка | getUri() Возвращает URI формы. | |
| строка | getRawUri() Возвращает необработанные данные URI. | |
| строка | canonicalizePath(строка $path) Возвращает канонизированный путь URI (см. RFC 3986, раздел 5.2.4). | из AbstractUriElement |
| setNode(DOMElement $node) Устанавливает узел для формы. | ||
| DOMElement | getFormNode() Возвращает узел формы, связанный с этой формой. | |
| $this | setValues(массив $values) Устанавливает значение полей. | |
| массив | getValues() Возвращает значения полей. | |
| массив | getFiles() Возвращает значения полей типа файл. | |
| массив | getPhpValues() Возвращает значения полей как PHP. | |
| массив | getPhpFiles() Возвращает значения полей типа файл как PHP. | |
| булево | has(строка $name) Возвращает true, если поле с указанным именем существует. | |
| remove(строка $name) Удаляет поле из формы. | ||
| FormField | get(строка $name) Возвращает поле с указанным именем. | |
| set(FormField $field) Устанавливает поле с указанным именем. | ||
| FormField[] | all() Возвращает все поля. | |
| булево | offsetExists(строка $name) Возвращает true, если поле с указанным именем существует. | |
| FormField | offsetGet(строка $name) Возвращает значение поля. | |
| offsetSet(строка $name, строка|массив $value) Устанавливает значение поля. | ||
| offsetUnset(строка $name) Удаляет поле из формы. | ||
| Форма | disableValidation() Отключает валидацию. |
Подробности
__construct(DOMElement $node, string $currentUri, string|null $method = null, string $baseHref = null)
Параметры
| DOMElement | $node | Экземпляр \DOMElement |
| string | $currentUri | URI страницы, где вставлена ссылка (или базовый URI) |
| string|null | $method | Метод для ссылки (по умолчанию GET) |
| string | $baseHref | URI тега |
Исключения
| LogicException | если узел не является кнопкой внутри тега формы |
DOMElement getNode()
Получает узел, связанный с этой ссылкой.
Значение результата
| DOMElement | Экземпляр \DOMElement |
string getMethod()
Получает метод формы.
Если метод не определен в форме, возвращается GET.
Значение результата
| string | Метод |
string getUri()
Получает URI формы.
Возвращаемый URI не совпадает с атрибутом "action" формы. Этот метод объединяет значение, если метод GET, чтобы имитировать поведение браузера.
Значение результата
| string | URI |
protected string getRawUri()
Возвращает необработанные данные URI.
Значение результата
| string |
protected string canonicalizePath(string $path)
Возвращает канонизированный путь URI (см. RFC 3986, раздел 5.2.4).
Параметры
| string | $path | Путь URI |
Значение результата
| string |
protected setNode(DOMElement $node)
Устанавливает узел для формы.
Ожидает узел 'submit' \DOMElement и находит соответствующий элемент формы или сам элемент формы.
Параметры
| DOMElement | $node | Экземпляр \DOMElement |
Исключения
| LogicException | Если заданный узел не является кнопкой или полем ввода, или не имеет родительского элемента формы |
DOMElement getFormNode()
Получает узел формы, связанный с этой формой.
Значение результата
| DOMElement | Экземпляр \DOMElement |
$this setValues(array $values)
Устанавливает значения полей.
Параметры
| array | $values | Массив значений полей |
Значение результата
| $this |
array getValues()
Получает значения полей.
Возвращаемый массив не включает поля типа файл (см. getFiles).
Значение результата
| array | Массив значений полей |
array getFiles()
Получает значения полей типа файл.
Значение результата
| array | Массив значений полей типа файл |
array getPhpValues()
Получает значения полей в формате PHP.
Этот метод преобразует поля с обозначением массива (например, foo[bar] в массивы) так же, как это делает PHP.
Значение результата
| array | Массив значений полей |
array getPhpFiles()
Получает значения полей типа файл в формате PHP.
Этот метод преобразует поля с обозначением массива (например, foo[bar] в массивы) так же, как это делает PHP. Возвращаемый массив согласуется с массивом значений полей (см. getPhpValues), а не с загруженными файлами, найденными в $_FILES. Для составного поля типа файл foo[bar] он создаст foo[bar][name], а не foo[name][bar], что можно найти в $_FILES.
Значение результата
| array | Массив значений полей типа файл |
bool has(string $name)
Возвращает true, если поле с указанным именем существует.
Параметры
| string | $name | Имя поля |
Значение результата
| bool | true, если поле существует, иначе false |
remove(string $name)
Удаляет поле из формы.
Параметры
| string | $name | Имя поля |
FormField get(string $name)
Получает поле с указанным именем.
Параметры
| string | $name | Имя поля |
Значение результата
| FormField | Экземпляр поля |
Исключения
| InvalidArgumentException | Если поле отсутствует в этой форме |
set(FormField $field)
Устанавливает поле с указанным именем.
Параметры
| FormField | $field |
FormField[] all()
Получает все поля.
Значение результата
| FormField[] |
bool offsetExists(string $name)
Возвращает true, если поле с указанным именем существует.
Параметры
| string | $name | Имя поля |
Значение результата
| bool | true, если поле существует, иначе false |
FormField offsetGet(string $name)
Получает значение поля.
Параметры
| string | $name | Имя поля |
Значение результата
| FormField | Соответствующий экземпляр поля |
Исключения
| InvalidArgumentException | если поле не существует |
offsetSet(string $name, string|array $value)
Устанавливает значение поля.
Параметры
| string | $name | Имя поля |
| string|array | $value | Значение поля |
Исключения
| InvalidArgumentException | если поле не существует |
offsetUnset(string $name)
Удаляет поле из формы.
Параметры
| string | $name | Имя поля |
Form disableValidation()
Отключает валидацию.
Значение результата
| Form |
© 2004–2017 Fabien Potencier
Licensed under the MIT License.
https://api.symfony.com/4.1/Symfony/Component/DomCrawler/Form.html