2010-04-15 13:41:42 +01:00
|
|
|
<?php
|
|
|
|
|
|
|
|
/*
|
2010-04-24 00:22:16 +01:00
|
|
|
* This file is part of the Symfony package.
|
2010-04-15 13:41:42 +01:00
|
|
|
*
|
2011-03-06 11:40:06 +00:00
|
|
|
* (c) Fabien Potencier <fabien@symfony.com>
|
2010-04-15 13:41:42 +01:00
|
|
|
*
|
|
|
|
* For the full copyright and license information, please view the LICENSE
|
|
|
|
* file that was distributed with this source code.
|
|
|
|
*/
|
|
|
|
|
2011-01-15 13:29:43 +00:00
|
|
|
namespace Symfony\Component\DomCrawler;
|
|
|
|
|
2011-02-04 18:10:13 +00:00
|
|
|
use Symfony\Component\DomCrawler\Field\FormField;
|
2011-01-15 13:29:43 +00:00
|
|
|
|
2010-04-15 13:41:42 +01:00
|
|
|
/**
|
|
|
|
* Form represents an HTML form.
|
|
|
|
*
|
2011-03-06 11:40:06 +00:00
|
|
|
* @author Fabien Potencier <fabien@symfony.com>
|
2011-03-24 09:00:10 +00:00
|
|
|
*
|
|
|
|
* @api
|
2010-04-15 13:41:42 +01:00
|
|
|
*/
|
2011-04-23 15:25:21 +01:00
|
|
|
class Form extends Link implements \ArrayAccess
|
2010-04-15 13:41:42 +01:00
|
|
|
{
|
2012-04-08 08:55:44 +01:00
|
|
|
/**
|
|
|
|
* @var \DOMNode
|
|
|
|
*/
|
2011-03-11 14:13:33 +00:00
|
|
|
private $button;
|
2012-04-08 08:55:44 +01:00
|
|
|
/**
|
|
|
|
* @var Field\FormField[]
|
|
|
|
*/
|
2011-03-11 14:13:33 +00:00
|
|
|
private $fields;
|
2010-05-06 12:25:53 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Constructor.
|
|
|
|
*
|
2011-04-23 15:25:21 +01:00
|
|
|
* @param \DOMNode $node A \DOMNode instance
|
|
|
|
* @param string $currentUri The URI of the page where the form is embedded
|
|
|
|
* @param string $method The method to use for the link (if null, it defaults to the method defined by the form)
|
2010-05-06 12:25:53 +01:00
|
|
|
*
|
|
|
|
* @throws \LogicException if the node is not a button inside a form tag
|
2011-03-24 09:00:10 +00:00
|
|
|
*
|
|
|
|
* @api
|
2010-05-06 12:25:53 +01:00
|
|
|
*/
|
2011-04-23 15:25:21 +01:00
|
|
|
public function __construct(\DOMNode $node, $currentUri, $method = null)
|
|
|
|
{
|
|
|
|
parent::__construct($node, $currentUri, $method);
|
|
|
|
|
|
|
|
$this->initialize();
|
|
|
|
}
|
|
|
|
|
2010-05-06 12:25:53 +01:00
|
|
|
/**
|
|
|
|
* Gets the form node associated with this form.
|
|
|
|
*
|
|
|
|
* @return \DOMNode A \DOMNode instance
|
|
|
|
*/
|
|
|
|
public function getFormNode()
|
2010-04-15 13:41:42 +01:00
|
|
|
{
|
2010-05-06 12:25:53 +01:00
|
|
|
return $this->node;
|
2010-04-15 13:41:42 +01:00
|
|
|
}
|
2010-05-06 12:25:53 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Sets the value of the fields.
|
|
|
|
*
|
|
|
|
* @param array $values An array of field values
|
2011-03-24 09:00:10 +00:00
|
|
|
*
|
2012-04-08 08:55:44 +01:00
|
|
|
* @return Form
|
|
|
|
*
|
2011-03-24 09:00:10 +00:00
|
|
|
* @api
|
2010-05-06 12:25:53 +01:00
|
|
|
*/
|
|
|
|
public function setValues(array $values)
|
2010-04-15 13:41:42 +01:00
|
|
|
{
|
2010-05-07 15:09:11 +01:00
|
|
|
foreach ($values as $name => $value) {
|
2012-01-04 15:20:28 +00:00
|
|
|
$this->fields->set($name, $value);
|
2010-05-06 12:25:53 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
return $this;
|
2010-04-15 13:41:42 +01:00
|
|
|
}
|
|
|
|
|
2010-05-06 12:25:53 +01:00
|
|
|
/**
|
|
|
|
* Gets the field values.
|
|
|
|
*
|
|
|
|
* The returned array does not include file fields (@see getFiles).
|
|
|
|
*
|
|
|
|
* @return array An array of field values.
|
2011-03-24 09:00:10 +00:00
|
|
|
*
|
|
|
|
* @api
|
2010-05-06 12:25:53 +01:00
|
|
|
*/
|
|
|
|
public function getValues()
|
|
|
|
{
|
|
|
|
$values = array();
|
2012-01-04 15:20:28 +00:00
|
|
|
foreach ($this->fields->all() as $name => $field) {
|
2011-08-23 10:21:48 +01:00
|
|
|
if ($field->isDisabled()) {
|
|
|
|
continue;
|
|
|
|
}
|
|
|
|
|
2010-05-08 14:32:30 +01:00
|
|
|
if (!$field instanceof Field\FileFormField && $field->hasValue()) {
|
2010-05-06 12:25:53 +01:00
|
|
|
$values[$name] = $field->getValue();
|
|
|
|
}
|
|
|
|
}
|
2010-04-15 13:41:42 +01:00
|
|
|
|
2010-05-06 12:25:53 +01:00
|
|
|
return $values;
|
|
|
|
}
|
2010-04-15 13:41:42 +01:00
|
|
|
|
2010-05-06 12:25:53 +01:00
|
|
|
/**
|
|
|
|
* Gets the file field values.
|
|
|
|
*
|
|
|
|
* @return array An array of file field values.
|
2011-03-24 09:00:10 +00:00
|
|
|
*
|
|
|
|
* @api
|
2010-05-06 12:25:53 +01:00
|
|
|
*/
|
|
|
|
public function getFiles()
|
2010-04-15 13:41:42 +01:00
|
|
|
{
|
2012-01-25 13:54:48 +00:00
|
|
|
if (!in_array($this->getMethod(), array('POST', 'PUT', 'DELETE', 'PATCH'))) {
|
2010-05-06 12:25:53 +01:00
|
|
|
return array();
|
|
|
|
}
|
|
|
|
|
|
|
|
$files = array();
|
2012-01-04 15:20:28 +00:00
|
|
|
|
|
|
|
foreach ($this->fields->all() as $name => $field) {
|
2011-08-23 10:21:48 +01:00
|
|
|
if ($field->isDisabled()) {
|
|
|
|
continue;
|
|
|
|
}
|
|
|
|
|
2010-05-08 14:32:30 +01:00
|
|
|
if ($field instanceof Field\FileFormField) {
|
2010-05-06 12:25:53 +01:00
|
|
|
$files[$name] = $field->getValue();
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
return $files;
|
2010-04-15 13:41:42 +01:00
|
|
|
}
|
|
|
|
|
2010-05-06 12:25:53 +01:00
|
|
|
/**
|
|
|
|
* Gets the field values as PHP.
|
|
|
|
*
|
2012-01-04 15:20:28 +00:00
|
|
|
* This method converts fields with the array notation
|
2010-05-06 12:25:53 +01:00
|
|
|
* (like foo[bar] to arrays) like PHP does.
|
|
|
|
*
|
|
|
|
* @return array An array of field values.
|
2011-03-24 09:00:10 +00:00
|
|
|
*
|
|
|
|
* @api
|
2010-05-06 12:25:53 +01:00
|
|
|
*/
|
|
|
|
public function getPhpValues()
|
2010-04-15 13:41:42 +01:00
|
|
|
{
|
2012-04-23 08:54:46 +01:00
|
|
|
$qs = http_build_query($this->getValues(), '', '&');
|
2010-05-06 12:25:53 +01:00
|
|
|
parse_str($qs, $values);
|
|
|
|
|
|
|
|
return $values;
|
2010-04-15 13:41:42 +01:00
|
|
|
}
|
|
|
|
|
2010-05-06 12:25:53 +01:00
|
|
|
/**
|
|
|
|
* Gets the file field values as PHP.
|
|
|
|
*
|
2012-01-04 15:20:28 +00:00
|
|
|
* This method converts fields with the array notation
|
2010-05-06 12:25:53 +01:00
|
|
|
* (like foo[bar] to arrays) like PHP does.
|
|
|
|
*
|
|
|
|
* @return array An array of field values.
|
2011-03-24 09:00:10 +00:00
|
|
|
*
|
|
|
|
* @api
|
2010-05-06 12:25:53 +01:00
|
|
|
*/
|
|
|
|
public function getPhpFiles()
|
2010-04-15 13:41:42 +01:00
|
|
|
{
|
2012-04-23 08:54:46 +01:00
|
|
|
$qs = http_build_query($this->getFiles(), '', '&');
|
2010-05-06 12:25:53 +01:00
|
|
|
parse_str($qs, $values);
|
|
|
|
|
|
|
|
return $values;
|
2010-04-15 13:41:42 +01:00
|
|
|
}
|
|
|
|
|
2010-05-06 12:25:53 +01:00
|
|
|
/**
|
|
|
|
* Gets the URI of the form.
|
|
|
|
*
|
|
|
|
* The returned URI is not the same as the form "action" attribute.
|
|
|
|
* This method merges the value if the method is GET to mimics
|
|
|
|
* browser behavior.
|
|
|
|
*
|
|
|
|
* @return string The URI
|
2011-03-24 09:00:10 +00:00
|
|
|
*
|
|
|
|
* @api
|
2010-05-06 12:25:53 +01:00
|
|
|
*/
|
2011-04-23 15:25:21 +01:00
|
|
|
public function getUri()
|
2010-04-15 13:41:42 +01:00
|
|
|
{
|
2011-04-23 15:25:21 +01:00
|
|
|
$uri = parent::getUri();
|
2011-04-08 16:52:43 +01:00
|
|
|
|
2012-01-25 13:54:48 +00:00
|
|
|
if (!in_array($this->getMethod(), array('POST', 'PUT', 'DELETE', 'PATCH')) && $queryString = http_build_query($this->getValues(), null, '&')) {
|
2010-05-06 12:25:53 +01:00
|
|
|
$sep = false === strpos($uri, '?') ? '?' : '&';
|
|
|
|
$uri .= $sep.$queryString;
|
|
|
|
}
|
|
|
|
|
|
|
|
return $uri;
|
2010-04-15 13:41:42 +01:00
|
|
|
}
|
|
|
|
|
2011-04-23 15:25:21 +01:00
|
|
|
protected function getRawUri()
|
|
|
|
{
|
|
|
|
return $this->node->getAttribute('action');
|
|
|
|
}
|
|
|
|
|
2010-05-06 12:25:53 +01:00
|
|
|
/**
|
|
|
|
* Gets the form method.
|
|
|
|
*
|
|
|
|
* If no method is defined in the form, GET is returned.
|
|
|
|
*
|
|
|
|
* @return string The method
|
2011-03-24 09:00:10 +00:00
|
|
|
*
|
|
|
|
* @api
|
2010-05-06 12:25:53 +01:00
|
|
|
*/
|
|
|
|
public function getMethod()
|
2010-04-15 13:41:42 +01:00
|
|
|
{
|
2010-05-07 15:09:11 +01:00
|
|
|
if (null !== $this->method) {
|
2010-05-06 12:25:53 +01:00
|
|
|
return $this->method;
|
|
|
|
}
|
|
|
|
|
2011-05-25 14:38:02 +01:00
|
|
|
return $this->node->getAttribute('method') ? strtoupper($this->node->getAttribute('method')) : 'GET';
|
2010-04-15 13:41:42 +01:00
|
|
|
}
|
|
|
|
|
2010-05-06 12:25:53 +01:00
|
|
|
/**
|
|
|
|
* Returns true if the named field exists.
|
|
|
|
*
|
|
|
|
* @param string $name The field name
|
|
|
|
*
|
2010-07-01 19:17:03 +01:00
|
|
|
* @return Boolean true if the field exists, false otherwise
|
2011-03-24 09:00:10 +00:00
|
|
|
*
|
|
|
|
* @api
|
2010-05-06 12:25:53 +01:00
|
|
|
*/
|
2010-11-23 08:42:19 +00:00
|
|
|
public function has($name)
|
2010-04-15 13:41:42 +01:00
|
|
|
{
|
2012-01-04 15:20:28 +00:00
|
|
|
return $this->fields->has($name);
|
2010-04-15 13:41:42 +01:00
|
|
|
}
|
|
|
|
|
2011-03-18 16:39:08 +00:00
|
|
|
/**
|
|
|
|
* Removes a field from the form.
|
|
|
|
*
|
|
|
|
* @param string $name The field name
|
2011-03-24 09:00:10 +00:00
|
|
|
*
|
2012-01-04 15:20:28 +00:00
|
|
|
* @throws \InvalidArgumentException when the name is malformed
|
|
|
|
*
|
2011-03-24 09:00:10 +00:00
|
|
|
* @api
|
2011-03-18 16:39:08 +00:00
|
|
|
*/
|
|
|
|
public function remove($name)
|
|
|
|
{
|
2012-01-04 15:20:28 +00:00
|
|
|
$this->fields->remove($name);
|
2011-03-18 16:39:08 +00:00
|
|
|
}
|
|
|
|
|
2010-05-06 12:25:53 +01:00
|
|
|
/**
|
|
|
|
* Gets a named field.
|
|
|
|
*
|
|
|
|
* @param string $name The field name
|
|
|
|
*
|
2010-07-27 14:33:28 +01:00
|
|
|
* @return FormField The field instance
|
2010-05-06 12:25:53 +01:00
|
|
|
*
|
|
|
|
* @throws \InvalidArgumentException When field is not present in this form
|
2011-03-24 09:00:10 +00:00
|
|
|
*
|
|
|
|
* @api
|
2010-05-06 12:25:53 +01:00
|
|
|
*/
|
2010-11-23 08:42:19 +00:00
|
|
|
public function get($name)
|
2010-04-15 13:41:42 +01:00
|
|
|
{
|
2012-01-04 15:20:28 +00:00
|
|
|
return $this->fields->get($name);
|
2010-04-15 13:41:42 +01:00
|
|
|
}
|
|
|
|
|
2010-05-06 12:25:53 +01:00
|
|
|
/**
|
|
|
|
* Sets a named field.
|
|
|
|
*
|
2012-01-04 15:20:28 +00:00
|
|
|
* @param FormField $field The field
|
2010-05-06 12:25:53 +01:00
|
|
|
*
|
2011-03-24 09:00:10 +00:00
|
|
|
* @api
|
2010-05-06 12:25:53 +01:00
|
|
|
*/
|
2012-01-04 15:20:28 +00:00
|
|
|
public function set(FormField $field)
|
2010-04-15 13:41:42 +01:00
|
|
|
{
|
2012-01-04 15:20:28 +00:00
|
|
|
$this->fields->add($field);
|
2010-04-15 13:41:42 +01:00
|
|
|
}
|
|
|
|
|
2010-05-06 12:25:53 +01:00
|
|
|
/**
|
|
|
|
* Gets all fields.
|
|
|
|
*
|
|
|
|
* @return array An array of fields
|
2011-03-24 09:00:10 +00:00
|
|
|
*
|
|
|
|
* @api
|
2010-05-06 12:25:53 +01:00
|
|
|
*/
|
2010-11-23 08:42:19 +00:00
|
|
|
public function all()
|
2010-04-15 13:41:42 +01:00
|
|
|
{
|
2012-01-04 15:20:28 +00:00
|
|
|
return $this->fields->all();
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Returns true if the named field exists.
|
|
|
|
*
|
|
|
|
* @param string $name The field name
|
|
|
|
*
|
|
|
|
* @return Boolean true if the field exists, false otherwise
|
|
|
|
*/
|
|
|
|
public function offsetExists($name)
|
|
|
|
{
|
|
|
|
return $this->has($name);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Gets the value of a field.
|
|
|
|
*
|
|
|
|
* @param string $name The field name
|
|
|
|
*
|
|
|
|
* @return FormField The associated Field instance
|
|
|
|
*
|
|
|
|
* @throws \InvalidArgumentException if the field does not exist
|
|
|
|
*/
|
|
|
|
public function offsetGet($name)
|
|
|
|
{
|
|
|
|
return $this->fields->get($name);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Sets the value of a field.
|
|
|
|
*
|
|
|
|
* @param string $name The field name
|
|
|
|
* @param string|array $value The value of the field
|
|
|
|
*
|
|
|
|
* @throws \InvalidArgumentException if the field does not exist
|
|
|
|
*/
|
|
|
|
public function offsetSet($name, $value)
|
|
|
|
{
|
|
|
|
$this->fields->set($name, $value);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Removes a field from the form.
|
|
|
|
*
|
|
|
|
* @param string $name The field name
|
|
|
|
*/
|
|
|
|
public function offsetUnset($name)
|
|
|
|
{
|
|
|
|
$this->fields->remove($name);
|
|
|
|
}
|
|
|
|
|
|
|
|
protected function setNode(\DOMNode $node)
|
|
|
|
{
|
|
|
|
$this->button = $node;
|
|
|
|
if ('button' == $node->nodeName || ('input' == $node->nodeName && in_array($node->getAttribute('type'), array('submit', 'button', 'image')))) {
|
|
|
|
do {
|
|
|
|
// use the ancestor form element
|
|
|
|
if (null === $node = $node->parentNode) {
|
|
|
|
throw new \LogicException('The selected node does not have a form ancestor.');
|
|
|
|
}
|
|
|
|
} while ('form' != $node->nodeName);
|
|
|
|
} elseif('form' != $node->nodeName) {
|
|
|
|
throw new \LogicException(sprintf('Unable to submit on a "%s" tag.', $node->nodeName));
|
|
|
|
}
|
|
|
|
|
|
|
|
$this->node = $node;
|
2010-04-15 13:41:42 +01:00
|
|
|
}
|
|
|
|
|
2011-03-11 14:13:33 +00:00
|
|
|
private function initialize()
|
2010-04-15 13:41:42 +01:00
|
|
|
{
|
2012-01-04 15:20:28 +00:00
|
|
|
$this->fields = new FormFieldRegistry();
|
2010-05-06 12:25:53 +01:00
|
|
|
|
|
|
|
$document = new \DOMDocument('1.0', 'UTF-8');
|
|
|
|
$node = $document->importNode($this->node, true);
|
|
|
|
$button = $document->importNode($this->button, true);
|
|
|
|
$root = $document->appendChild($document->createElement('_root'));
|
|
|
|
$root->appendChild($node);
|
|
|
|
$root->appendChild($button);
|
|
|
|
$xpath = new \DOMXPath($document);
|
|
|
|
|
2010-05-07 15:09:11 +01:00
|
|
|
foreach ($xpath->query('descendant::input | descendant::textarea | descendant::select', $root) as $node) {
|
2011-08-02 21:13:21 +01:00
|
|
|
if (!$node->hasAttribute('name')) {
|
2010-05-06 12:25:53 +01:00
|
|
|
continue;
|
|
|
|
}
|
|
|
|
|
|
|
|
$nodeName = $node->nodeName;
|
|
|
|
|
2010-05-07 15:09:11 +01:00
|
|
|
if ($node === $button) {
|
2010-11-23 08:42:19 +00:00
|
|
|
$this->set(new Field\InputFormField($node));
|
2010-05-07 15:09:11 +01:00
|
|
|
} elseif ('select' == $nodeName || 'input' == $nodeName && 'checkbox' == $node->getAttribute('type')) {
|
2010-11-23 08:42:19 +00:00
|
|
|
$this->set(new Field\ChoiceFormField($node));
|
2010-05-07 15:09:11 +01:00
|
|
|
} elseif ('input' == $nodeName && 'radio' == $node->getAttribute('type')) {
|
2010-11-23 08:42:19 +00:00
|
|
|
if ($this->has($node->getAttribute('name'))) {
|
|
|
|
$this->get($node->getAttribute('name'))->addChoice($node);
|
2010-05-07 15:09:11 +01:00
|
|
|
} else {
|
2010-11-23 08:42:19 +00:00
|
|
|
$this->set(new Field\ChoiceFormField($node));
|
2010-05-06 12:25:53 +01:00
|
|
|
}
|
2010-05-07 15:09:11 +01:00
|
|
|
} elseif ('input' == $nodeName && 'file' == $node->getAttribute('type')) {
|
2010-11-23 08:42:19 +00:00
|
|
|
$this->set(new Field\FileFormField($node));
|
2010-05-07 15:09:11 +01:00
|
|
|
} elseif ('input' == $nodeName && !in_array($node->getAttribute('type'), array('submit', 'button', 'image'))) {
|
2010-11-23 08:42:19 +00:00
|
|
|
$this->set(new Field\InputFormField($node));
|
2010-05-07 15:09:11 +01:00
|
|
|
} elseif ('textarea' == $nodeName) {
|
2010-11-23 08:42:19 +00:00
|
|
|
$this->set(new Field\TextareaFormField($node));
|
2010-05-06 12:25:53 +01:00
|
|
|
}
|
2010-04-15 13:41:42 +01:00
|
|
|
}
|
|
|
|
}
|
2012-01-04 15:20:28 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
class FormFieldRegistry
|
|
|
|
{
|
|
|
|
private $fields = array();
|
|
|
|
|
|
|
|
private $base;
|
2010-06-14 08:04:45 +01:00
|
|
|
|
|
|
|
/**
|
2012-01-04 15:20:28 +00:00
|
|
|
* Adds a field to the registry.
|
2010-06-14 08:04:45 +01:00
|
|
|
*
|
2012-01-04 15:20:28 +00:00
|
|
|
* @param FormField $field The field
|
2010-06-14 08:04:45 +01:00
|
|
|
*
|
2012-01-04 15:20:28 +00:00
|
|
|
* @throws \InvalidArgumentException when the name is malformed
|
2010-06-14 08:04:45 +01:00
|
|
|
*/
|
2012-01-04 15:20:28 +00:00
|
|
|
public function add(FormField $field)
|
2010-06-14 08:04:45 +01:00
|
|
|
{
|
2012-01-04 15:20:28 +00:00
|
|
|
$segments = $this->getSegments($field->getName());
|
|
|
|
|
|
|
|
$target =& $this->fields;
|
|
|
|
while ($segments) {
|
|
|
|
if (!is_array($target)) {
|
|
|
|
$target = array();
|
|
|
|
}
|
|
|
|
$path = array_shift($segments);
|
|
|
|
if ('' === $path) {
|
|
|
|
$target =& $target[];
|
|
|
|
} else {
|
|
|
|
$target =& $target[$path];
|
|
|
|
}
|
|
|
|
}
|
|
|
|
$target = $field;
|
2010-06-14 08:04:45 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2012-01-04 15:20:28 +00:00
|
|
|
* Removes a field and its children from the registry.
|
2010-06-14 08:04:45 +01:00
|
|
|
*
|
2012-01-04 15:20:28 +00:00
|
|
|
* @param string $name The fully qualified name of the base field
|
2010-06-14 08:04:45 +01:00
|
|
|
*
|
2012-01-04 15:20:28 +00:00
|
|
|
* @throws \InvalidArgumentException when the name is malformed
|
|
|
|
*/
|
|
|
|
public function remove($name)
|
|
|
|
{
|
|
|
|
$segments = $this->getSegments($name);
|
|
|
|
$target =& $this->fields;
|
|
|
|
while (count($segments) > 1) {
|
|
|
|
$path = array_shift($segments);
|
|
|
|
if (!array_key_exists($path, $target)) {
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
$target =& $target[$path];
|
|
|
|
}
|
|
|
|
unset($target[array_shift($segments)]);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Returns the value of the field and its children.
|
2010-06-25 18:13:01 +01:00
|
|
|
*
|
2012-01-04 15:20:28 +00:00
|
|
|
* @param string $name The fully qualified name of the field
|
|
|
|
*
|
|
|
|
* @return mixed The value of the field
|
|
|
|
*
|
|
|
|
* @throws \InvalidArgumentException when the name is malformed
|
2010-06-14 08:04:45 +01:00
|
|
|
* @throws \InvalidArgumentException if the field does not exist
|
|
|
|
*/
|
2012-01-04 15:20:28 +00:00
|
|
|
public function &get($name)
|
2010-06-14 08:04:45 +01:00
|
|
|
{
|
2012-01-04 15:20:28 +00:00
|
|
|
$segments = $this->getSegments($name);
|
|
|
|
$target =& $this->fields;
|
|
|
|
while ($segments) {
|
|
|
|
$path = array_shift($segments);
|
|
|
|
if (!array_key_exists($path, $target)) {
|
|
|
|
throw new \InvalidArgumentException(sprintf('Unreachable field "%s"', $path));
|
|
|
|
}
|
|
|
|
$target =& $target[$path];
|
2010-06-25 17:39:38 +01:00
|
|
|
}
|
|
|
|
|
2012-01-04 15:20:28 +00:00
|
|
|
return $target;
|
2010-06-14 08:04:45 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2012-01-04 15:20:28 +00:00
|
|
|
* Tests whether the form has the given field.
|
2010-06-14 08:04:45 +01:00
|
|
|
*
|
2012-01-04 15:20:28 +00:00
|
|
|
* @param string $name The fully qualified name of the field
|
2010-06-14 08:04:45 +01:00
|
|
|
*
|
2012-01-04 15:20:28 +00:00
|
|
|
* @return Boolean Whether the form has the given field
|
|
|
|
*/
|
|
|
|
public function has($name)
|
|
|
|
{
|
|
|
|
try {
|
|
|
|
$this->get($name);
|
2012-01-28 17:02:36 +00:00
|
|
|
|
2012-01-04 15:20:28 +00:00
|
|
|
return true;
|
|
|
|
} catch (\InvalidArgumentException $e) {
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Set the value of a field and its children.
|
|
|
|
*
|
|
|
|
* @param string $name The fully qualified name of the field
|
|
|
|
* @param mixed $value The value
|
|
|
|
*
|
|
|
|
* @throws \InvalidArgumentException when the name is malformed
|
2010-06-14 08:04:45 +01:00
|
|
|
* @throws \InvalidArgumentException if the field does not exist
|
|
|
|
*/
|
2012-01-04 15:20:28 +00:00
|
|
|
public function set($name, $value)
|
2010-06-14 08:04:45 +01:00
|
|
|
{
|
2012-01-04 15:20:28 +00:00
|
|
|
$target =& $this->get($name);
|
|
|
|
if (is_array($value)) {
|
|
|
|
$fields = self::create($name, $value);
|
|
|
|
foreach ($fields->all() as $k => $v) {
|
|
|
|
$this->set($k, $v);
|
|
|
|
}
|
|
|
|
} else {
|
|
|
|
$target->setValue($value);
|
2010-06-25 17:39:38 +01:00
|
|
|
}
|
2012-01-04 15:20:28 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Returns the list of field with their value.
|
|
|
|
*
|
|
|
|
* @return array The list of fields as array((string) Fully qualified name => (mixed) value)
|
|
|
|
*/
|
|
|
|
public function all()
|
|
|
|
{
|
|
|
|
return $this->walk($this->fields, $this->base);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Creates an instance of the class.
|
|
|
|
*
|
|
|
|
* This function is made private because it allows overriding the $base and
|
|
|
|
* the $values properties without any type checking.
|
|
|
|
*
|
|
|
|
* @param string $base The fully qualified name of the base field
|
|
|
|
* @param array $values The values of the fields
|
|
|
|
*
|
|
|
|
* @return FormFieldRegistry
|
|
|
|
*/
|
|
|
|
static private function create($base, array $values)
|
|
|
|
{
|
|
|
|
$registry = new static();
|
|
|
|
$registry->base = $base;
|
|
|
|
$registry->fields = $values;
|
2010-06-25 17:39:38 +01:00
|
|
|
|
2012-01-04 15:20:28 +00:00
|
|
|
return $registry;
|
2010-06-14 08:04:45 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2012-01-04 15:20:28 +00:00
|
|
|
* Transforms a PHP array in a list of fully qualified name / value.
|
2010-06-14 08:04:45 +01:00
|
|
|
*
|
2012-01-04 15:20:28 +00:00
|
|
|
* @param array $array The PHP array
|
|
|
|
* @param string $base The name of the base field
|
|
|
|
* @param array $output The initial values
|
|
|
|
*
|
|
|
|
* @return array The list of fields as array((string) Fully qualified name => (mixed) value)
|
2010-06-14 08:04:45 +01:00
|
|
|
*/
|
2012-01-04 15:20:28 +00:00
|
|
|
private function walk(array $array, $base = '', array &$output = array())
|
2010-06-14 08:04:45 +01:00
|
|
|
{
|
2012-01-04 15:20:28 +00:00
|
|
|
foreach ($array as $k => $v) {
|
|
|
|
$path = empty($base) ? $k : sprintf("%s[%s]", $base, $k);
|
|
|
|
if (is_array($v)) {
|
|
|
|
$this->walk($v, $path, $output);
|
|
|
|
} else {
|
|
|
|
$output[$path] = $v;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
return $output;
|
2010-06-14 08:04:45 +01:00
|
|
|
}
|
2011-06-14 14:16:43 +01:00
|
|
|
|
2012-01-04 15:20:28 +00:00
|
|
|
/**
|
|
|
|
* Splits a field name into segments as a web browser would do.
|
|
|
|
*
|
|
|
|
* <code>
|
|
|
|
* getSegments('base[foo][3][]') = array('base', 'foo, '3', '');
|
|
|
|
* </code>
|
|
|
|
*
|
|
|
|
* @param string $name The name of the field
|
|
|
|
*
|
|
|
|
* @return array The list of segments
|
|
|
|
*
|
|
|
|
* @throws \InvalidArgumentException when the name is malformed
|
|
|
|
*/
|
|
|
|
private function getSegments($name)
|
2011-06-14 14:16:43 +01:00
|
|
|
{
|
2012-01-04 15:20:28 +00:00
|
|
|
if (preg_match('/^(?P<base>[^[]+)(?P<extra>(\[.*)|$)/', $name, $m)) {
|
|
|
|
$segments = array($m['base']);
|
|
|
|
while (preg_match('/^\[(?P<segment>.*?)\](?P<extra>.*)$/', $m['extra'], $m)) {
|
|
|
|
$segments[] = $m['segment'];
|
|
|
|
}
|
|
|
|
|
|
|
|
return $segments;
|
2011-06-14 14:16:43 +01:00
|
|
|
}
|
|
|
|
|
2012-01-04 15:20:28 +00:00
|
|
|
throw new \InvalidArgumentException(sprintf('Malformed field path "%s"', $name));
|
2011-06-14 14:16:43 +01:00
|
|
|
}
|
2012-01-25 13:54:48 +00:00
|
|
|
}
|