Merge branch 'main' of github.com:lesstif/php-JiraCloud-RESTAPI

* 'main' of github.com:lesstif/php-JiraCloud-RESTAPI:
  fix phpcs
  add possibility to pass request params to getCustomFieldOptions
  fix phpcs
  added ability to get, create and update custom select fields
  Update README.md
  Fixed issue where versions will not get unset because of some typo

Author: lesstif

README.md

@@ -2692,6 +2692,4 @@ try {
 Apache V2 License
 
 # JIRA Rest API Documents
-* 6.4 - https://docs.atlassian.com/jira/REST/6.4/
-* Jira Server latest - https://docs.atlassian.com/jira/REST/server/
-* Jira Cloud latest - https://docs.atlassian.com/jira/REST/latest/
+* https://developer.atlassian.com/cloud/jira/platform/rest/v3/

src/Field/FieldService.php

@@ -93,4 +93,90 @@ public function create(Field $field)
 
         return $cf;
     }
+
+    /**
+     * @param int $fieldId The custom field Id
+     *
+     * @throws \JiraCloud\JiraException
+     *
+     * @return string|bool
+     */
+    public function getCustomFieldContexts(int $fieldId)
+    {
+        $url = sprintf('%s/customfield_%s/contexts', $this->uri, $fieldId);
+        $ret = $this->exec($url);
+
+        $this->log->debug("get custom Field Contexts=\n".$ret);
+
+        return $ret;
+    }
+
+    /**
+     * Get a custom fields options.
+     *
+     * @param int   $fieldId    The custom field Id
+     * @param int   $contextId  Context ID related to the custom field
+     * @param array $paramArray Query parameters like 'startAt' and 'maxResults'
+     *
+     * @see https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-custom-field-options/#api-rest-api-3-field-fieldid-context-contextid-option-get
+     *
+     * @throws \JiraCloud\JiraException
+     *
+     * @return string
+     */
+    public function getCustomFieldOptions(int $fieldId, int $contextId, array $paramArray = [])
+    {
+        $url = sprintf('%s/customfield_%s/context/%s/option%s', $this->uri, $fieldId, $contextId, $this->toHttpQueryParameter($paramArray));
+        $ret = $this->exec($url);
+
+        $this->log->debug("get custom Field Options=\n".$ret);
+
+        return $ret;
+    }
+
+    /**
+     * Create custom field options.
+     *
+     * @param int   $fieldId   The custom field Id to add options to
+     * @param int   $contextId Context ID related to the custom field
+     * @param array $options   The options array
+     *
+     * @see https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-custom-field-options/#api-rest-api-3-field-fieldid-context-contextid-option-post
+     *
+     * @throws \JiraCloud\JiraException
+     *
+     * @return string
+     */
+    public function createCustomFieldOptions(int $fieldId, int $contextId, array $options = [])
+    {
+        $url = sprintf('%s/customfield_%s/context/%s/option', $this->uri, $fieldId, $contextId);
+        $ret = $this->exec($url, json_encode($options), 'POST');
+
+        $this->log->debug("create custom Field Options=\n".$ret);
+
+        return $ret;
+    }
+
+    /**
+     * Update a custom field options.
+     *
+     * @param int   $fieldId   The custom field Id
+     * @param int   $contextId Context ID related to the custom field
+     * @param array $options   The new options array
+     *
+     * @see https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-custom-field-options/#api-rest-api-3-field-fieldid-context-contextid-option-put
+     *
+     * @throws \JiraCloud\JiraException
+     *
+     * @return string
+     */
+    public function updateCustomFieldOptions(int $fieldId, int $contextId, array $options = [])
+    {
+        $url = sprintf('%s/customfield_%s/context/%s/option', $this->uri, $fieldId, $contextId);
+        $ret = $this->exec($url, json_encode($options), 'PUT');
+
+        $this->log->debug("update custom Field Options=\n".$ret);
+
+        return $ret;
+    }
 }

src/Project/Project.php

@@ -106,7 +106,7 @@ public function jsonSerialize()
             unset($params['leadName']);
         }
         if ($this->versions === null or count($this->versions) === 0) {
-            unset($params['version']);
+            unset($params['versions']);
         }
 
         return $params;