Requisitos
Para
ter
estas
funções
disponiveis
,
você
deve
compilar
o
PHP
com
suporte
a
MySQL
.
Instalação
Usando
a
opção
de
configuração
--with-mysql
você
permite
ao
PHP
acessar
banco
de
dados
do
MySQL
.
Se
você
usar
esta
opção
sem
especificar
o
caminho
para
o
MySQL
,
o
PHP
usará
as
bibliotecas
do
cliente
que
vem
com
ele
.
Com
o
PHP4
,
o
suporte
a
MySQL
esta
sempre
ativado
;
se
você
não
especificar
a
opção
de
configuração
,
as
bibliotecas
que
vem
com
o
PHP
serão
usadas
.
Usuários
que
usam
outras
aplicações
que
usam
MySQL
(
por
exemplos
,
executando
PHP3
e
PHP4
como
modulos
do
apache
,
ou
auth-mysql
)
devem
sempre
espicificar
o
caminho
para
o
MySQL
:
--with-mysql=
/
caminho
/
para
/
mysql
.
Isto
irá
forçar
o
PHP
a
usar
as
bibliotecas
de
cliente
instaladas
com
o
MySQL
,
evitando
quaisquer
conflitos
.
Atenção
|
Quebras
e
problemas
de
inicialização
do
PHP
podem
ser
encontrados
quando
carrega-se
esta
extensão
em
conjunto
com
a
extensão
recode
.
Veja
a
extensão
recode
para
maiores
informações
.
|
Configuração
durante
execução
O
comportamento
dessas
funções
podem
ser
modificado
pelas
configurações
do
php.ini
.
Tabela
1
.
Opções
de
configuração
do
MySQL
Para maiores detalhes e deinição de constantes PHP_INI_*
veja
ini_set()
.
Aqui
esta
uma
pequena
explicação
das
diretivas
de
configuração
.
-
mysql.allow_persistent
boolean
-
Quando
permitir
conexões
persistentes
para
o
MySQL
.
-
mysql.max_persistent
integer
-
O
número
máximo
de
conexões
persistentes
com
o
MySQL
por
processo
.
-
mysql.max_links
integer
-
O
número
maximo
de
conexões
com
o
MYSQL
por
processo
,
incluindo
conexões
persistentes
.
-
mysql.default_port
string
-
O
número
padrão
da
porta
TCP
a
usar
quando
conectar
com
o
servidor
do
banco
de
dados
se
nenhuma
outra
porta
for
especificada
.
Se
nenhum
padrão
for
especificado
,
aporta
será
obtida
da
variavel
de
ambiente
MYSQL_TCP_PORT
,
da
entrada
mysql-tcp
em
/
etc
/
services
ou
da
constante
da
compilação
MYSQL_PORT
,
nesta
ordem
.
Windows
irá
usar
somente
a
constante
MYSQL_PORT
.
-
mysql.default_socket
string
-
O
nome
padrão
do
socket
para
usar
quando
conectar
com
um
servidor
de
banco
de
dados
local
se
outro
nome
de
socket
não
for
especificado
.
-
mysql.default_host
string
-
O
servidor
padrão
para
usar
quando
conectar
com
um
servidor
de
banco
de
dados
se
outro
servidor
não
for
encontrado
.
Não
se
aplica
em
safe
mode
.
-
mysql.default_user
string
-
O
nome
padrão
de
usuário
para
conectar
ao
servidor
de
banco
de
dados
se
outro
nome
não
for
especificado
.
Não
se
aplica
em
safe
mode
.
-
mysql.default_password
string
-
A
senha
padrão
para
usar
ao
conectar
ao
servidor
de
banco
de
dados
se
outra
senha
não
for
especificada
.
Não
se
aplica
em
safe
mode
.
-
mysql.connect_timeout
integer
-
Limite
de
tempo
da
conexão
em
segundos
.
No
Linux
este
limite
é
também
usado
para
a
espera
da
primeira
resposta
do
servidor
.
Tipos
Resource
Há
dois
tipos
de
recursos
usados
no
modulo
MySql
.
O
primeiro
é
a
identificação
do
link
da
conexão
com
o
banco
de
dados
,
o
segundo
é
o
que
guarda
o
resultado
de
uma
query
.
Constantes
Predefinidas
As
contantes
abaixo
são
definidas
por
esta
extensão
e
somente
estarão
disponíveis
quando
a
extensão
foi
compilada
com
o
PHP
ou
carregada
dinamicamente
durante
a
execução
.
Desde
PHP
4.3.0
é
possivel
especificar
opções
adicionais
para
as
funções
mysql_connect(
)
and
mysql_pconnect(
)
As
seguintes
constantes
são
definidas
:
Tabela
2
.
Constante
do
cliente
MySQL
constante
|
descrição
|
|
usa
o
protocolo
de
compressão
|
|
Permite
espaço
após
o
nome
de
função
|
|
Permite
interactive_timeout
segundos
(
ao
inves
de
wait_timeout
)
de
inatividade
antes
de
fechar
a
conexão
.
|
A
função
mysql_fetch_array(
)
usa
uma
constante
para
cada
diferentes
tipos
de
matrizes
de
resultado
.
As
seguintes
constantes
são
definidas
:
Tabela
3
.
constante
|
descrição
|
|
As
colunas
são
retornadas
na
matriz
tendo
o
nome
do
campo
como
índice
da
matriz
.
|
|
As
colunas
são
retornadas
na
matriz
tendo
ambos
os
indices
:
um
numérico
e
o
um
com
o
nome
do
campo
.
|
|
As
colunas
são
retornadas
numa
matriz
tendo
um
indice
numérico
dos
campos
.
Este
indice
começa
com
0
,
o
primeiro
campo
no
resultado
.
|
Exemplos
Este
exemplo
simples
mostra
como
conectar
,
executar
uma
query
,
mostrar
o
resultado
e
desconectar
do
banco
de
dados
do
MySQL
.
Exemplo
1
.
Exemplo
da
extensão
do
MySQL
?php
/
*
Conectando
,
escolhendo
o
banco
de
dados
*
/
$link
=
mysql_connect(
"mysql_host"
,
"mysql_user"
,
"mysql_password"
)
or
die("Não
pude
conectar")
;
print
"Conexão
bem
sucedida"
;
mysql_select_db("my_database"
)
or
die("Não
pude
selecionar
o
banco
de
dados")
;
/
*
Fazendo
a
query
SQL*
/
$query
=
"SELECT
*
FROM
my_table"
;
$result
=
mysql_query($query
)
or
die("Query
falhou")
;
/
*
Mostrando
os
resultados
em
HTML
*
/
print
"
table
\n"
;
while
($line
=
mysql_fetch_array($result
,
MYSQL_ASSOC)
)
{
print
"\t
tr
\n"
;
foreach
($line
as
$col_value
)
{
print
"\t\t
td
$col_value
/
td
\n"
;
}
print
"\t
/
tr
\n"
;
}
print
"
/
table
\n"
;
/
*
Liberando
o
resultado
*
/
mysql_free_result($result)
;
/
*
Fechando
a
conexão
*
/
mysql_close($link)
;
?
|
|