ADOdb

Database Abstraction Layer for PHP

User Tools

Site Tools


v5:reference:connection:adonewconnection

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
v5:reference:connection:adonewconnection [2016/01/17 15:28] mnewnhamv5:reference:connection:adonewconnection [2020/12/08 10:39] (current) – better use PHP string concatenation for example instead of javascript's ;-) peterdd
Line 3: Line 3:
 <WRAP right box> <WRAP right box>
 == Syntax == == Syntax ==
-  +
   mixed adoNewConnection(   mixed adoNewConnection(
       optional string $driverType=''       optional string $driverType=''
   )   )
- +
 </WRAP> </WRAP>
 ===== Description ===== ===== Description =====
Line 27: Line 27:
 include 'adodb.inc.php'; include 'adodb.inc.php';
 /* /*
- * Simple connection +* Simple connection 
- */+*/
 $driver = 'mysqli'; $driver = 'mysqli';
 $db     = adoNewConnection($driver); $db     = adoNewConnection($driver);
 /* /*
- * Now connect to the database +* Now connect to the database 
- */+*/
 $db->connect('localhost','user','password','employees'); $db->connect('localhost','user','password','employees');
 </code> </code>
Line 40: Line 40:
 include 'adodb.inc.php'; include 'adodb.inc.php';
 /* /*
- * Set DSN +* Set DSN 
- */+*/
 $driver = 'mysqli'; $driver = 'mysqli';
 $DSN    = "user:password@localhost/employees"; $DSN    = "user:password@localhost/employees";
-$db     = adoNewConnection($driver '://' $DSN);+$db     = adoNewConnection($driver '://' $DSN);
 /* /*
- * Now connected +* Now connected 
- */+*/
 </code> </code>
 ===== Additional Parameters To DSN connection ==== ===== 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. 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:userguide: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 ===== ===== 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()]] 
  
v5/reference/connection/adonewconnection.1453040919.txt.gz · Last modified: 2017/04/21 11:37 (external edit)