ADOdb

Database Abstraction Layer for PHP

User Tools

Site Tools

Trace:
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
Next revisionBoth sides next revision
v5:reference:connection:adonewconnection [2016/01/17 03:29] – ↷ Page moved from v5:reference:adonewconnection to v5:reference:connection:adonewconnection mnewnhamv5:reference:connection:adonewconnection [2017/04/14 10:22] – [Table] fix table layout dregad
Line 1: Line 1:
 ====== adoNewConnection ====== ====== adoNewConnection ======
 ~~NOTOC~~ ~~NOTOC~~
-<WRAP alert> 
-Not passing a driver name as the parameter to this function does nothing but return an html string indication that the no driver name was passed. This behavior will be removed in version 6.0.0. 
-</WRAP> 
-<WRAP alert> 
-Passing an invalid or missing driver name as the parameter to this function returns an html formatted string. This behavior will be change in version 6.0.0. If an error occurs, the function will return a numeric error. See the guide below. 
-</WRAP> 
 <WRAP right box> <WRAP right box>
-== Syntax before version 6.0.0 ==+== Syntax ==
      
   mixed adoNewConnection(   mixed adoNewConnection(
Line 14: Line 8:
   )   )
    
-== Syntax version 6.0.0 == 
-  mixed adoNewConnection( 
-      string $driverType 
-  )  
 </WRAP> </WRAP>
 ===== Description ===== ===== Description =====
Line 62: Line 52:
 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             ^ 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| +| role             | string                                                             || When using the ibase driver, allows setting a role  | 
-|dialect|integer||Undocumented option| +| dialect          | integer                                                            || Undocumented option                                 | 
-|charset|string|[[v5:reference:connection:setcharset|setCharSet()]]|Sets a character set| +| charset          | string   | [[v5:reference:connection:setcharset|setCharSet()]]      | Sets a character set                                | 
-|buffers|string||Undocumented option| +| buffers          | string                                                             || Undocumented option                                 | 
-|fetchmode|int|[[v5:reference:connection:setfetchmode|setFetchMode()]]|Sets the fetch mode| +| fetchmode        | int      | [[v5:reference:connection:setfetchmode|setFetchMode()]]  | Sets the fetch mode                                 | 
-|charpage|string||Undocumented option| +| charpage         | string                                                             || Undocumented option                                 | 
-|clientflags|string||Undocumented option| +| clientflags      | string                                                             || Undocumented option                                 | 
-|port|int||Sets the connection port| +| port             | int                                                                || Sets the connection port                            | 
-|socket|int||Sets the connection socket| +| socket           | int                                                                || Sets the connection socket                          | 
-|nls_date_format|string|Set date format| +| nls_date_format  | string                                                             || Set date format                                     | 
-|cachesecs|int|Sets the number of cache seconds| +| cachesecs        | int                                                                || Sets the number of cache seconds                    | 
-|memcache|string||Undocumented series of options|+| 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. 
- 
-^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()]] Note that, because no connection object is available, the codes cannot be retrieved via [[v5:reference:connection:errormsg|errorMsg()]]
  
v5/reference/connection/adonewconnection.txt · Last modified: 2020/12/08 10:39 by peterdd