Release version of Ver.32.

Author: msyk

README.md

@@ -1,4 +1,4 @@
-# FMDataAPI Ver.31 [![Build Status](https://github.com/msyk/FMDataAPI/actions/workflows/php.yml/badge.svg)](https://github.com/msyk/FMDataAPI/actions/workflows/php.yml)
+# FMDataAPI Ver.32 [![Build Status](https://github.com/msyk/FMDataAPI/actions/workflows/php.yml/badge.svg)](https://github.com/msyk/FMDataAPI/actions/workflows/php.yml)
 
 by Masayuki Nii (nii@msyk.net)
 
@@ -51,13 +51,13 @@ Although the Custom Web Publishing is the way to access the database
 for a long while, FileMaker Inc. has introduced the modern feature to operate
 the database. The current version of FMDataAPI works on just FileMaker 18 and 19 platform.
 
-For now, I'm focusing to develop the web application framework "INTER-Mediator"
+For now, I'm focusing on developing the web application framework "INTER-Mediator"
 (https://inter-mediator.com/ or https://github.com/INTER-Mediator/INTER-Mediator.git)
 which can develop the core features of database-driven web application
 with declarative descriptions. INTER-Mediator has already supported the Custom
 Web Publishing with FX.php, and I develop codes here for support REST APIs.
 
-Bug reports and contribution are welcome.
+Bug reports and contributions are welcome.
 
 ## Installing to Your Project
 
@@ -101,7 +101,7 @@ MIT License
 ## Acknoledgement
 
 - Thanks to Atsushi Matsuo. Your script is quite helpful to implement the "localserver" feature.
-(https://gist.github.com/matsuo/ef5cb7c98bb494d507731886883bcbc1) Moreover thanks for updating and fixing bugs.
+(https://gist.github.com/matsuo/ef5cb7c98bb494d507731886883bcbc1) Moreover, thanks for updating and fixing bugs.
 - Thanks to Frank Gonzalez. Your bug report is brilliant, and I could fix it quickly.
 - Thanks to base64bits for coding about container field.
 - Thanks to phpsa for bug fix.
@@ -137,7 +137,7 @@ MIT License
 - 2023-11-24: [Ver.31]
   The curlErrorMessage() method returns the error message from curl (Thanks to @P1-Roger).
   Corrected phpdoc issue (Thanks to @patacra).
-- 2024-XX-XX: [Ver.32] (upcoming release)
+- 2024-10-10: [Ver.32]
   From this version, the minimum PHP version is 8.1.
   Fix SSL certificate check errors by using the system's certificate authorities (Thanks to @patacra).
   FileMakerLayout::getMetadataOld and getMetadata methods don't return the false value in the case of log-in error.

src/Supporting/CommunicationProvider.php

@@ -260,7 +260,7 @@ public function __construct(string      $solution,
      * @param array $params Array to build the API path. Ex: `["layouts" => null]` or `["sessions" => $this->accessToken]`.
      * @param string|array|null $request The query parameters as `"key" => "value"`.
      * @param string $methodLower The method in lowercase. Ex: `"get"`, `"delete"`, etc.
-     * @param bool $isSystem If the query is for the system (sessions, databases, etc) or for a database.
+     * @param bool $isSystem If the query is for the system (sessions, databases, etc.) or for a database.
      * @param string|null|false $directPath If we don't want to build the path with the other parameters, you can provide the direct path.
      * @return string
      * @ignore
@@ -554,9 +554,9 @@ private function getSupportingProviders(): null|array
             $this->callRestAPI([], true, 'GET', [], [],
                 false, "/fmws/oauthproviderinfo"); // Throw Exception
             $result = [];
-            foreach ($this->responseBody as $key => $item) {
-
-            }
+//            foreach ($this->responseBody as $key => $item) {
+//
+//            }
             return $result;
         } catch (Exception $ex) {
             return null;
@@ -587,9 +587,9 @@ private function getOAuthIdentifier($provider): string|array|null
                 false, "/oauth/getoauthurl"
             ); // Throw Exception
             $result = [];
-            foreach ($this->responseBody as $key => $item) {
-
-            }
+//            foreach ($this->responseBody as $key => $item) {
+//
+//            }
             return $result;
         } catch (Exception $ex) {
             return null;
@@ -600,7 +600,7 @@ private function getOAuthIdentifier($provider): string|array|null
      * @param array $params
      * @param bool $isAddToken
      * @param string $method
-     * @param array|null $request
+     * @param string|array|null $request
      * @param array|null $addHeader
      * @param bool $isSystem for Metadata
      * @param string|null|false $directPath
@@ -698,6 +698,7 @@ public function callRestAPI(array             $params,
      * Thanks to 'base64bits' as https://github.com/msyk/FMDataAPI/issues/18.
      * @param string $url
      * @return string The base64 encoded data in container field.
+     * @throws Exception
      * @ignore
      */
     public function accessToContainer(string $url): string
@@ -732,7 +733,7 @@ public function accessToContainer(string $url): string
     /**
      * @ignore
      */
-    public function storeToProperties()
+    public function storeToProperties(): void
     {
         $this->httpStatus = 0;
         $this->errorCode = -1;
@@ -790,7 +791,7 @@ public function storeToProperties()
      * @return string
      * @ignore
      */
-    public function adjustSortDirection($direction): string
+    public function adjustSortDirection(string $direction): string
     {
         if (strtoupper($direction) == 'ASC') {
             $direction = 'ascend';
@@ -806,7 +807,7 @@ public function adjustSortDirection($direction): string
      * @return mixed
      * @ignore
      */
-    public function getCurlInfo($key)
+    public function getCurlInfo($key): mixed
     {
         return $this->curlInfo[$key];
     }

src/Supporting/FileMakerLayout.php

@@ -147,7 +147,7 @@ private function buildScriptParameters(array|null $param): array
      * If you want to omit record match with condition set the "omit" element as like:
      * array("FamilyName"=>"Nii*", "omit"=>"true").
      * If you want to query all records in the layout, set the first parameter to null.
-     * @param array|null $sort The array of array which has 2 elements as a field name and order key:
+     * @param array|null $sort The array of array which has two elements as a field name and order key:
      * array(array("FamilyName", "ascend"), array("GivenName", "descend")).
      * The value of order key can be 'ascend', 'descend' or value list name. The default value is 'ascend'.
      * @param int $offset The start number of the record set, and the first record is 1, but the number 0
@@ -579,8 +579,8 @@ public function getScriptErrorPresort(): int|null
     }
 
     /**
-     * Get the return value from the presort script.
-     * @return string|null  The return value from the presort script.
+     * Get the return value from the presorted script.
+     * @return string|null  The return value from the presorted script.
      * If any script wasn't called, returns null.
      */
     public function getScriptResultPresort(): string|null