Chris@0: <?php
Chris@0: 
Chris@0: namespace Drupal\Core\Ajax;
Chris@0: 
Chris@0: /**
Chris@0:  * AJAX command for updating the value of a hidden form_build_id input element
Chris@0:  * on a form. It requires the form passed in to have keys for both the old build
Chris@0:  * ID in #build_id_old and the new build ID in #build_id.
Chris@0:  *
Chris@0:  * The primary use case for this Ajax command is to serve a new build ID to a
Chris@0:  * form served from the cache to an anonymous user, preventing one anonymous
Chris@0:  * user from accessing the form state of another anonymous user on Ajax enabled
Chris@0:  * forms.
Chris@0:  *
Chris@0:  * This command is implemented by
Chris@0:  * Drupal.AjaxCommands.prototype.update_build_id() defined in misc/ajax.js.
Chris@0:  *O
Chris@0:  * @ingroup ajax
Chris@0:  */
Chris@0: class UpdateBuildIdCommand implements CommandInterface {
Chris@0: 
Chris@0:   /**
Chris@0:    * Old build id.
Chris@0:    *
Chris@0:    * @var string
Chris@0:    */
Chris@0:   protected $old;
Chris@0: 
Chris@0:   /**
Chris@0:    * New build id.
Chris@0:    *
Chris@0:    * @var string
Chris@0:    */
Chris@0:   protected $new;
Chris@0: 
Chris@0:   /**
Chris@0:    * Constructs a UpdateBuildIdCommand object.
Chris@0:    *
Chris@0:    * @param string $old
Chris@0:    *   The old build_id.
Chris@0:    * @param string $new
Chris@0:    *   The new build_id.
Chris@0:    */
Chris@0:   public function __construct($old, $new) {
Chris@0:     $this->old = $old;
Chris@0:     $this->new = $new;
Chris@0:   }
Chris@0: 
Chris@0:   /**
Chris@0:    * {@inheritdoc}
Chris@0:    */
Chris@0:   public function render() {
Chris@0:     return [
Chris@0:       'command' => 'update_build_id',
Chris@0:       'old' => $this->old,
Chris@0:       'new' => $this->new,
Chris@0:     ];
Chris@0:   }
Chris@0: 
Chris@0: }