Differences

This shows you the differences between two versions of the page.

--- v5:reference:connection:adonewconnection [2016/01/17 03:29] – mnewnham
+++ v5:reference:connection:adonewconnection [2020/12/08 10:39] (current) – better use PHP string concatenation for example instead of javascript's ;-) peterdd
@@ Line 2: / Line 2: @@
 ~~NOTOC~~
 <WRAP right box>
-== Syntax before version 6.0.0 ==
+== Syntax ==
   mixed adoNewConnection(
       optional string $driverType=''
   )
-== Syntax version 6.0.0 ==
-  mixed adoNewConnection(
-      string $driverType
-  )
 </WRAP>
 ===== Description =====
@@ Line 31: / Line 27: @@
 include 'adodb.inc.php';
 /*
- * Simple connection
+* Simple connection
- */
+*/
 $driver = 'mysqli';
 $db     = adoNewConnection($driver);
 /*
- * Now connect to the database
+* Now connect to the database
- */
+*/
 $db->connect('localhost','user','password','employees');
 </code>
@@ Line 44: / Line 40: @@
 include 'adodb.inc.php';
 /*
- * Set DSN
+* Set DSN
- */
+*/
 $driver = 'mysqli';
 $DSN    = "user:password@localhost/employees";
-$db     = adoNewConnection($driver + '://' + $DSN);
+$db     = adoNewConnection($driver . '://' . $DSN);
 /*
- * Now connected
+* Now connected
- */
+*/
 </code>
 ===== Additional Parameters To DSN connection ====
 The following additional parameter can be added to the DSN connection string. Some of the parameters only work with specific drivers.
-^Code^Value^Parameter^Description^
+^ Code              ^ Driver             ^ Value                                      ^ Parameter                                        ^ Description                                                          ^
-|new|true|[[v5:reference:connection:nconnect|nConnect()]]|Forces a new connection|
+| new               |                    | true                                       | [[v5:reference:connection:nconnect|nConnect()]]  | Forces a new connection                                              |
-|persist|true|[[v5:reference:connection:pconnect|pConnect()]]|Creates a persistent connection|
+| persist           |                    | true                                       | [[v5:reference:connection:pconnect|pConnect()]]  | Creates a persistent connection                                      |
-|persistent|true|[[v5:reference:connection:pconnect|pConnect()]]|Creates a persistent connection|
+| persistent        |                    | true                                       | [[v5:reference:connection:pconnect|pConnect()]]  | Creates a persistent connection                                      |
-|debug|true|[[v5:reference:debug|debug]]|Enables debug mode|
+| debug             |                    | true| [[v5:userguide:debug|debug]]                                                            | Enables debug mode                                                   |
-|role|string||When using the ibase driver, allows setting a role|
+| port              | mysqli, postgres9  | int   |                                                                                       | Sets the connection port                                             |
-|dialect|integer||Undocumented option|
+| socket            | mysqli             | string |                    | Sets the connection socket |
-|charset|string|[[v5:reference:connection:setcharset|setCharSet()]]|Sets a character set|
+| nls_date_format   | oci8               | string |                    | Set date format            |
-|buffers|string||Undocumented option|
+| cachesecs         |                    | int    |                                                                                      | Sets the number of cache seconds                                     |
-|fetchmode|int|[[v5:reference:connection:setfetchmode|setFetchMode()]]|Sets the fetch mode|
+| memCache          |                    | false |[[v5:userguide:memcached|memcache]]                                                    | Enables memcache library for caching                                 |
-|charpage|string||Undocumented option|
+| memCacheHost      |                    | array |[[v5:userguide:memcached|memcache]]                                                    | Array of one or more memcached servers                               |
-|clientflags|string||Undocumented option|
+| memCachePort      |                    | int   |[[v5:userguide:memcached|memcache]]                                                      | Optional alternative port to connect to memcache server(s)           |
-|port|int||Sets the connection port|
+| memCacheCompress  |                    | false |[[v5:userguide:memcached|memcache]]                                                    | Enables memcache compression (not supported with memcached library)  |
-|socket|int||Sets the connection socket|
-|nls_date_format|string|Set date format|
-|cachesecs|int|Sets the number of cache seconds|
-|memcache|string||Undocumented series of options|
 ===== Error Codes =====
-As of version 6.0.0 , the following error codes will be returned if a connection fails.
+Note that, because no connection object is available, the codes cannot be retrieved via [[v5:reference:connection:errormsg|errorMsg()]]
-^Code^Description^
-|-1|An invalid driver name was given|
-|-2|Unable to parse DSN string|
-|-3|Connection to database via DSN string failed|
-|-4|DSN option not supported by driver|
-Note that, because no connection object is available, the codes cannot be retrieved via [[v5:reference:connection:errormsg|errorMsg()]]