Issue #3495264 by tcrawford: Support custom query options

src/OData/SelectQuery.php

@@ -44,6 +44,13 @@ class SelectQuery implements SelectQueryInterface {
    */
   protected array $conditions = [];
 
+  /**
+   * Custom query parameters.
+   *
+   * @var array
+   */
+  protected array $customQueryParameters = [];
+
   /**
    * Constructor for a SelectQuery object.
    *
@@ -81,6 +88,11 @@ class SelectQuery implements SelectQueryInterface {
   public function __toString(): string {
     $query = $this->objectType . '?';
 
+    if ($this->customQueryParameters) {
+      // There will always be a $select parameter, so we need to append to it.
+      $query .= http_build_query($this->customQueryParameters) . '&';
+    }
+
     if ($this->fields) {
       $query .= '$select=' . implode(',', array_unique($this->fields));
     }
@@ -168,4 +180,12 @@ class SelectQuery implements SelectQueryInterface {
     $this->conditions[] = $condition;
   }
 
+  /**
+   * {@inheritdoc}
+   */
+  public function addCustomQueryParameter(string $key, string $value): void {
+    // The query may be opened in a browser (e.g. for debugging purposes).
+    $this->customQueryParameters[$key] = htmlspecialchars($value, ENT_QUOTES, 'UTF-8');
+  }
+
 }

src/OData/SelectQueryInterface.php

@@ -91,4 +91,14 @@ interface SelectQueryInterface {
    */
   public function addBuiltCondition(string|array $condition): void;
 
+  /**
+   * Add a custom query parameter.
+   *
+   * @param string $key
+   *   The query parameter key.
+   * @param string $value
+   *   The query parameter value.
+   */
+  public function addCustomQueryParameter(string $key, string $value): void;
+
 }