Merge pull request msyk#101 from msyk/mod20240911-2

Added some exclamations about password parameter

Author: msyk

samples/FMDataAPI_Sample.php

@@ -16,7 +16,7 @@
 
 // FMDataAPI class handles an error as an exception by default.
 try {
-    // Instantiate the class FMDataAPI with database name, user name, password and host.
+    // Instantiate the class FMDataAPI with database name, username, password and host.
     // Although the port number and protocol can be set in parameters of constructor,
     // these parameters can be omitted with default values.
     $fmdb = new FMDataAPI("TestDB", "web", null, "localhost");

src/FMDataAPI.php

@@ -46,6 +46,9 @@ class FMDataAPI
      * @param string $user The fmrest privilege accessible user to the database.
      * If you’re going to call useOAuth method, you have to specify the data for X-FM-Data-OAuth-Request-Id.
      * @param string|null $password The password of the above user.
+     * This can be null for testing purpose only. Null data is going to replace the string "password".
+     * This prevents to be detected as a security issue.
+     * On the real solutions, you have to set a valid password string.
      * If you’re going to call useOAuth method, you have to specify the data for X-FM-Data-OAuth-Identifier.
      * @param string|null $host FileMaker Server's host name or IP address. If omitted, 'localhost' is chosen.
      * The value "localserver" tries to connect directory 127.0.0.1, and you don't have to set $port and $protocol.