Utilizando
a biblioteca php_tsql.so é possível executar
query's do PHP em uma base de dados OpenBase.
Veja
a baixo as funções:
tsql_connect - Abre uma conexão
Descrição:
resource tsql_connect (string conexão, string
usuário, string password)
retorna uma identificação de conexão
do tipo resource ou FALSE se erro.
conexão : string do tipo “HST=…;DSN=…;UID=…;PWD=….;etc…”
usuário : corresponde à palavra de nível.
password : corresponde ao código de segurança
Se no string de conexão, forem atribuidos valores
aos itens UID e PWD(palavra de nível e código
de segurança), esses valores terão prioridade
sobre os valores passados pelos parâmetros (usuário
e password.)
tsql_close - Termina uma conexão
Descrição:
bool tsql_close ( resource id_conexão)
retorna TRUE se sucesso, FALSE se erro.
id_conexão : identificação da
conexão do tipo resource
tsql_query - executa um commando SQL
Descrição:
resource tsql_exec( resource id_conexão, string
query)
retorna uma identificação de resultado
do tipo resource ou FALSE se erro
id_conexão : identificação de
uma conexão aberta
query : texto do commando SQL
tsql_fetch_row - lê a proxima
linha de um conjunto resultado em um vetor numéricamente
indexado.
Descrição:
array tsql_fetch_row( resource id_resultado )
retorna um array numérico se existe a linha,
senão retorna FALSE
id_resultado : identificador de resultado devolvido
por uma chamada tsql_query para um commando SQL do tipo
SELECT.
tsql_fetch_row retorna a próxima linha de um
conjunto resultado . Cada coluna é armazenada
numa célula de uma array. O primeiro índice
é igual a zero.
tsql_fetch_assoc – lê a proxima
linha de um conjunto resultado em um vetor associativo
Descrição:
array tsql_fetch_assoc(resouce id_resultado)
retorna um array associativo se existe a linha, senão
retorna FALSE.
id_resultado : identificador de resultado devolvido
por uma chamada
tsql_query para um commando SQL do tipo SELECT.
Assim como a função tsql_fetch_row, tsql_fetch_assoc
lê a próxima linha, com a diferença
que cada coluna é armazenada numa célula
de um array que é indexado pelo nome da coluna
ao invés da posição da coluna.
tsql_num_fields - devolve o número
de colunas de uma linha
Descrição:
int tsql_num_fields ( resource id_resultado);
retorna número de colunas ou FALSE se erro.
id_resultado : identificador de resultado devolvido
por uma chamada tsql_query .
Se o número de colunas retornados for igual a
zero, o commando SQL executado, não é
um commando SELECT.
tsql_affected_rows – número
de linhas alteradas
Descrição :
int tsql_affected_rows(resource id_resultado);
retorna número de linhas alteradas ou FALSE se
erro
id_resultado : identificador de resultado devolvido
por uma chamada tsql_query para um commando SQL .
A função se aplica para os commandos SQL
que alteram dados como INSERT, DELETE e UPDATE.
tsql_field_name – devolve o nome de
uma coluna
Descrição:
string tsql_field_name(resource id_resultado, int coluna);
retorna nome da coluna ou FALSE se erro
id_resultado : identificador de resultado devolvido
por uma chamada tsql_query para um commando SQL do tipo
SELECT.
coluna : número da coluna do conjunto resultado(a
partir de zero)
tsql_field_type – devolve o tipo de
uma coluna
Descrição:
string tsql_field_type(resource id_resultado, int coluna);
retorna nome da coluna ou FALSE se erro
id_resultado : identificador de resultado devolvido
por uma chamada tsql_query para um commando SQL do tipo
SELECT.
coluna : número da coluna do conjunto resultado(a
partir de zero)
tsql_field_length – devolve o tamanho
interno de uma coluna
Descrição:
int tsql_field_length(resource id_resultado, int coluna);
retorna tamanho da coluna ou FALSE se erro
id_resultado : identificador de resultado devolvido
por uma chamada tsql_query para um commando SQL do tipo
SELECT.
coluna : número da coluna do conjunto resultado(a
partir de zero)
O tamanho interno equivale ao número de bytes
que é retornado à uma aplicação.
tsql_field_displen – devolve o tamanho
de exibição de uma coluna
Descrição:
int tsql_field_length(resource id_resultado, int coluna);
retorna tamanho da coluna ou FALSE se erro
id_resultado : identificador de resultado devolvido
por uma chamada tsql_query para um commando SQL do tipo
SELECT.
coluna : número da coluna do conjunto resultado(a
partir de zero)
A função tsql_field_displen fornece o
número máximo de bytes necessários
para a exibição da coluna. Por exemplo
para um tipo DECIMAL, o tamanho de exibição
será igual ao tamanho interno acrescido de uma
posição, decorrente do ponto decimal.
No caso de um tipo CHAR, os tamanhos internos e de exibição
são iguais.
tsql_field_scale – devolve o tamanho
da escala de uma coluna
Descrição:
int tsql_field_length(resource id_resultado, int coluna);
retorna tamanho da escala da coluna ou FALSE se erro
id_resultado : identificador de resultado devolvido
por uma chamada tsql_query para um commando SQL do tipo
SELECT.
coluna : número da coluna do conjunto resultado(a
partir de zero)
A escala de uma coluna DECIMAL corresponde ao número
máximo de dígitos a direita do ponto decimal.
Para os outros tipos, a escala não é uma
informação relevante.
tsql_free_result - libera recursos
de um conjunto resultado
Descrição:
bool free_result ( resource id_resultado )
retorna sempre TRUE
id_resultado : identificador de um conjunto resultado
tsql_commit – fecha uma transação
Descrição:
bool tsql_commit(resource id_connexão);
retorna TRUE se sucesso, e FALSE se erro.
id_conexão : identificador de conexão.
O mesmo efeito pode ser obtido com a execução
do commando SQL, “COMMIT_WORK”. O tempo de execução
de tsql_commit é um pouco menor, tendo em vista
que não é necessário compilar um
commando SQL, e pode se justificar em um ambiente de
muitas transações em paralelo.
tsql_rollback – desfaz uma transação
Descrição:
bool tsql_rollback(resource id_conexão);
retorna TRUE se sucesso, e FALSE se erro.
id_conexão : identificador de conexão.
O mesmo efeito pode ser obtido com a execução
do commando SQL, ROLLBACK_WORK. O tempo de execução
de tsql_rollback é um pouco menor, tendo em vista
que não é necessário compilar um
comandoSQL, e pode se justificar em um ambiente de muitas
transações em paralelo.
tsql_last_error – Devolve a última
mensagem de erro produzida
Descrição:
string tsql_last_error();
retorna um string contendo a última mensagem
de erro gerada . Se não houve erro, uma mensagem
vazia é retornada.
|