Correct errors in tests and add a README.md file for the tests

Author: sharadraju

tests/README.md

@@ -0,0 +1,22 @@
+# Test Configuration Requirements
+
+Check the [details.inc](details.inc) file for the configuration details.
+
+Set the following environment variables to provide credentials for the PHP tests:
+
+`PHP_OCI8_TEST_USER` - the username of the database schema user to be used for testing.
+
+`PHP_OCI8_TEST_PASS` - the password of the database schema user to be used for testing.
+
+`PHP_OCI8_TEST_DB` - the connection string that points to your database's location.
+
+`PHP_OCI8_TEST_DRCP` - for running DRCP tests. It should be set to ``true``
+to run DRCP tests. Otherwise, DRCP-specific tests are skipped.
+
+# Running the tests
+
+To run the tests, execute:
+```
+php <testname>
+
+```

tests/lob_prefetch.phpt

@@ -58,7 +58,7 @@ function get_clob_loc($c, $sql, $pfl) {
     while (($row = oci_fetch_array($stid, OCI_ASSOC)) != false) {
         $l[] = $row['CLOB']->load();
         $row['CLOB']->free();
-        if (strlen($l[0]) != LOBSIZE) { print("strlen(l) failure" .  strlen($l)); exit; }
+        if (strlen($l[0]) != LOBSIZE) { print("strlen(l) failure. clob length = " .  strlen($l[0])); exit; }
     }
     return($l);
 }
@@ -71,7 +71,7 @@ function get_clob_inline($c, $sql, $pfl) {
     $l = [];
     while (($row = oci_fetch_array($stid, OCI_ASSOC+OCI_RETURN_LOBS)) != false) {
         $l[] = $row['CLOB'];
-        if (strlen($l[0]) != LOBSIZE) { print("strlen(l) failure" . strlen($l)); exit; }
+        if (strlen($l[0]) != LOBSIZE) { print("strlen(l) failure. clob length = " . strlen($l[0])); exit; }
     }
     return($l);
 }
@@ -99,7 +99,7 @@ function get_blob_loc($c, $sql, $pfl) {
     while (($row = oci_fetch_array($stid, OCI_ASSOC)) != false) {
         $l[] = $row['BLOB']->load();
         $row['BLOB']->free();
-        if (strlen($l[0]) != LOBSIZE) { print("strlen(l) failure" .  strlen($l)); exit; }
+        if (strlen($l[0]) != LOBSIZE) { print("strlen(l) failure. blob length = " .  strlen($l[0])); exit; }
     }
     return($l);
 }

tests/lob_prefetch_ini.phpt

@@ -59,7 +59,7 @@ function get_clob_loc($c, $sql, $pfl) {
     while (($row = oci_fetch_array($stid, OCI_ASSOC)) != false) {
         $l[] = $row['CLOB']->load();
         $row['CLOB']->free();
-        if (strlen($l[0]) != LOBSIZE) { print("strlen(l) failure" .  strlen($l)); exit; }
+        if (strlen($l[0]) != LOBSIZE) { print("strlen(l) failure. clob length = " .  strlen($l[0])); exit; }
     }
     return($l);
 }
@@ -72,7 +72,7 @@ function get_clob_inline($c, $sql, $pfl) {
     $l = [];
     while (($row = oci_fetch_array($stid, OCI_ASSOC+OCI_RETURN_LOBS)) != false) {
         $l[] = $row['CLOB'];
-        if (strlen($l[0]) != LOBSIZE) { print("strlen(l) failure" . strlen($l)); exit; }
+        if (strlen($l[0]) != LOBSIZE) { print("strlen(l) failure. clob length = " . strlen($l[0])); exit; }
     }
     return($l);
 }
@@ -100,7 +100,7 @@ function get_blob_loc($c, $sql, $pfl) {
     while (($row = oci_fetch_array($stid, OCI_ASSOC)) != false) {
         $l[] = $row['BLOB']->load();
         $row['BLOB']->free();
-        if (strlen($l[0]) != LOBSIZE) { print("strlen(l) failure" .  strlen($l)); exit; }
+        if (strlen($l[0]) != LOBSIZE) { print("strlen(l) failure. blob length = " .  strlen($l[0])); exit; }
     }
     return($l);
 }