|
Quando usada, a macro cria uma nova conexão com as informações inseridas em seus parâmetros. Esta conexão fica disponível em toda a sessão atual do Scriptcase, deixando de existir somente quando a sessão for fechada.
A nova conexão só estará disponível na próxima aplicação.
1º Parâmetro: Nome da conexão à ser criada.
Obs: Se existir uma conexão criada dentro do Scriptcase com o mesmo nome, essa macro não terá nenhum efeito. Conexões criadas dentro do Scriptcase prevalecem. Caso deseje editar uma conexão já existente, veja a documentação da macro sc_connection_edit.
2º Parâmetro: Array de itens contendo as informações da conexão. Confira abaixo os indices do array:
Indice
|
Descrição |
Exemplo |
| ['drive'] |
Driver do banco de dados utilizado na conexão (ver tabela abaixo) |
$arr_conn['drive'] = "oci8" |
| ['server'] |
Servidor do banco de dados |
$arr_conn['server'] = "127.0.0.1" |
| ['user'] |
Usuário do banco de dados |
$arr_conn['user'] = "root" |
| ['password'] |
Senha do banco de dados |
$arr_conn['password'] = "secretpass123" |
| ['database'] |
Base de dados utilizada pela conexão |
$arr_conn['database'] = "sc_samples" |
| ['persistent'] |
Define se a conexão será persistente ou não |
$arr_conn['persistent'] = "Y" / "N" |
| ['encoding'] |
Configura o encoding da conexão |
$arr_conn['encoding'] = "utf8" |
Obs: É obrigatório que todos os itens estejam preenchidos, com exceção dos itens ['persistent'] e ['encoding'].
Veja abaixo a lista de drivers das conexões:
Driver
|
Descrição
|
| access |
MS Access |
| ado_access |
MS Access ADO |
| odbc |
ODBC Genérico |
| db2 |
DB2 |
| db2_odbc |
DB2 ODBC Nativo |
| odbc_db2 |
DB2 ODBC Genérico |
| odbc_db2v6 |
DB2 ODBC Genérico 6 ou Abaixo |
| pdo_db2_odbc |
DB2 PDO ODBC |
| pdo_ibm |
DB2 PDO |
| firebird |
Firebird |
| pdo_firebird |
Firebird PDO |
| borland_ibase |
Interbase 6.5 ou Acima |
| ibase |
Interbase |
| pdo_informix |
Informix PDO |
| informix |
Informix |
| informix72 |
Informix 7.2 ou Abaixo |
| ado_mssql |
MSSQL Server ADO |
| pdo_sqlsrv |
MSSQL Server NATIVE SRV PDO |
| mssqlnative |
MSSQL Server NATIVE SRV |
| odbc_mssql |
MSSQL Server ODBC |
| mssql |
MSSQL Server |
| pdo_dblib |
DBLIB |
| pdo_mysql |
MySQL PDO |
| mysqlt |
Mysql (Transactional) |
| mysql |
MySQL (Non-Transactional) |
| pdo_oracle |
Oracle PDO |
| oci805 |
Oracle 8.0.5 ou Acima |
| odbc_oracle |
Oracle ODBC |
| oci8 |
Oracle 8 |
| oci8po |
Oracle 8 Portable |
| oracle |
Oracle 7 ou menor |
| postgres7 |
PostgreSQL 7 ou Acima |
| pdo_pgsql |
PostgreSQL PDO |
| postgres64 |
PostgreSQL 6.4 ou acima |
| postgres |
PostgreSQL 6.3 ou abaixo |
| pdosqlite |
SQLite PDO |
| sqlite |
SQLite |
| sybase |
Sybase |
| pdo_sybase_dblib |
Sybase PDO DBLIB |
| pdo_sybase_odbc |
Sybase PDO ODBC |
Exemplo de uso da macro:
$arr_conn = array();
$arr_conn['drive'] = "mysqlt"; $arr_conn['server'] = "127.0.0.1"; $arr_conn['user'] = "root"; $arr_conn['password'] = "pass123"; $arr_conn['database'] = "sc_samples"; $arr_conn['persistent'] = "Y"; $arr_conn['encoding'] = "utf8";
sc_connection_new("new_conn_mysql", $arr_conn);
|