add suggest helpers

README.md

@@ -433,6 +433,8 @@ $result = (new SphinxQL($this->conn))
 * `(new Helper($conn))->setVariable($name, $value, $global = false)`
 * `(new Helper($conn))->callSnippets($data, $index, $query, $options = array())`
 * `(new Helper($conn))->callKeywords($text, $index, $hits = null)`
+* `(new Helper($conn))->callSuggest($text, $index, $options = array())`
+* `(new Helper($conn))->callQsuggest($text, $index, $options = array())`
 * `(new Helper($conn))->describe($index)`
 * `(new Helper($conn))->createFunction($udf_name, $returns, $soname)`
 * `(new Helper($conn))->dropFunction($udf_name)`

docs/helper.rst

@@ -51,6 +51,16 @@ SphinxQL Query Builder Helper
     Helper::create($conn)
       ->callKeywords($text, $index, $hits = null);
 
+.. code-block:: php
+
+    Helper::create($conn)
+      ->callSuggest($text, $index, $options = array());
+
+.. code-block:: php
+
+    Helper::create($conn)
+      ->callQsuggest($text, $index, $options = array());
+
 .. code-block:: php
 
     Helper::create($conn)

src/Helper.php

@@ -209,6 +209,58 @@ public function callKeywords($text, $index, $hits = null)
         return $this->query('CALL KEYWORDS('.implode(', ', $this->connection->quoteArr($arr)).')');
     }
 
+    /**
+     * CALL SUGGEST syntax
+     *
+     * @param string      $text
+     * @param string      $index
+     * @param array       $options Associative array of additional options
+     *
+     * @return SphinxQL A SphinxQL object ready to be ->execute();
+     * @throws Exception\ConnectionException
+     * @throws Exception\DatabaseException
+     */
+    public function callSuggest($text, $index, $options = array())
+    {
+        $arr = array($text, $index);
+
+        foreach ($options as $key => &$val) {
+            if (is_string($key)) {
+                $val .= ' AS '.$key;
+            }
+        }
+
+        $arr = array_merge($this->connection->quoteArr($arr), $options);
+
+        return $this->query('CALL SUGGEST('.implode(', ', $arr).')');
+    }
+
+    /**
+     * CALL QSUGGEST syntax
+     *
+     * @param string      $text
+     * @param string      $index
+     * @param array       $options Associative array of additional options
+     *
+     * @return SphinxQL A SphinxQL object ready to be ->execute();
+     * @throws Exception\ConnectionException
+     * @throws Exception\DatabaseException
+     */
+    public function callQsuggest($text, $index, $options = array())
+    {
+        $arr = array($text, $index);
+
+        foreach ($options as $key => &$val) {
+            if (is_string($key)) {
+                $val .= ' AS '.$key;
+            }
+        }
+
+        $arr = array_merge($this->connection->quoteArr($arr), $options);
+
+        return $this->query('CALL QSUGGEST('.implode(', ', $arr).')');
+    }
+
     /**
      * DESCRIBE syntax
      *