Chris@18: <?php
Chris@18: 
Chris@18: namespace Drupal\jsonapi\Query;
Chris@18: 
Chris@18: /**
Chris@18:  * A condition group for the EntityQuery.
Chris@18:  *
Chris@18:  * @internal JSON:API maintains no PHP API since its API is the HTTP API. This
Chris@18:  *   class may change at any time and this will break any dependencies on it.
Chris@18:  *
Chris@18:  * @see https://www.drupal.org/project/jsonapi/issues/3032787
Chris@18:  * @see jsonapi.api.php
Chris@18:  */
Chris@18: class EntityConditionGroup {
Chris@18: 
Chris@18:   /**
Chris@18:    * The AND conjunction value.
Chris@18:    *
Chris@18:    * @var array
Chris@18:    */
Chris@18:   protected static $allowedConjunctions = ['AND', 'OR'];
Chris@18: 
Chris@18:   /**
Chris@18:    * The conjunction.
Chris@18:    *
Chris@18:    * @var string
Chris@18:    */
Chris@18:   protected $conjunction;
Chris@18: 
Chris@18:   /**
Chris@18:    * The members of the condition group.
Chris@18:    *
Chris@18:    * @var \Drupal\jsonapi\Query\EntityCondition[]
Chris@18:    */
Chris@18:   protected $members;
Chris@18: 
Chris@18:   /**
Chris@18:    * Constructs a new condition group object.
Chris@18:    *
Chris@18:    * @param string $conjunction
Chris@18:    *   The group conjunction to use.
Chris@18:    * @param array $members
Chris@18:    *   (optional) The group conjunction to use.
Chris@18:    */
Chris@18:   public function __construct($conjunction, array $members = []) {
Chris@18:     if (!in_array($conjunction, self::$allowedConjunctions)) {
Chris@18:       throw new \InvalidArgumentException('Allowed conjunctions: AND, OR.');
Chris@18:     }
Chris@18:     $this->conjunction = $conjunction;
Chris@18:     $this->members = $members;
Chris@18:   }
Chris@18: 
Chris@18:   /**
Chris@18:    * The condition group conjunction.
Chris@18:    *
Chris@18:    * @return string
Chris@18:    *   The condition group conjunction.
Chris@18:    */
Chris@18:   public function conjunction() {
Chris@18:     return $this->conjunction;
Chris@18:   }
Chris@18: 
Chris@18:   /**
Chris@18:    * The members which belong to the the condition group.
Chris@18:    *
Chris@18:    * @return \Drupal\jsonapi\Query\EntityCondition[]
Chris@18:    *   The member conditions of this condition group.
Chris@18:    */
Chris@18:   public function members() {
Chris@18:     return $this->members;
Chris@18:   }
Chris@18: 
Chris@18: }