Sophie

Sophie

distrib > Mandriva > 2008.1 > i586 > by-pkgid > 703d980c580707c382b4e43e25965bc5 > files > 12019

php-manual-pt_BR-5.2.4-1mdv2008.1.noarch.rpm

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>Funções do MySQL</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
TITLE="Manual do PHP"
HREF="index.html"><LINK
REL="UP"
TITLE="Referência das Funções"
HREF="funcref.html"><LINK
REL="PREVIOUS"
TITLE="muscat_setup"
HREF="function.muscat-setup.html"><LINK
REL="NEXT"
TITLE="mysql_affected_rows"
HREF="function.mysql-affected-rows.html"><META
HTTP-EQUIV="Content-type"
CONTENT="text/html; charset=UTF-8"></HEAD
><BODY
CLASS="reference"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>Manual do PHP</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="function.muscat-setup.html"
ACCESSKEY="P"
>Anterior</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="function.mysql-affected-rows.html"
ACCESSKEY="N"
>Próxima</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="reference"
><A
NAME="ref.mysql"
></A
><DIV
CLASS="TITLEPAGE"
><H1
CLASS="title"
>XCVIII. Funções do MySQL</H1
><DIV
CLASS="PARTINTRO"
><A
NAME="AEN128898"
></A
><DIV
CLASS="section"
><H1
CLASS="section"
><A
NAME="mysql.intro"
>Introdução</A
></H1
><P
>&#13;     Estas funções permitem a você acessar os servidoes de banco de dados MySQL.
     maiores informações sobre o MySQL podem ser encontradas em <A
HREF="http://www.mysql.com/"
TARGET="_top"
>http://www.mysql.com/</A
>.
    </P
><P
>&#13;     A documentação para o MySQL pode ser encontrada em <A
HREF="http://dev.mysql.com/doc/"
TARGET="_top"
>http://dev.mysql.com/doc/</A
>.
    </P
></DIV
><DIV
CLASS="section"
><H1
CLASS="section"
><A
NAME="mysql.requirements"
>Dependências</A
></H1
><P
>&#13;     Para ter estas funções disponíveis, você deve compilar o PHP
     com suporte a MySQL.
    </P
></DIV
><DIV
CLASS="section"
><H1
CLASS="section"
><A
NAME="mysql.installation"
>Instalação</A
></H1
><P
>&#13;  Para compilar, simplesmente use a opção de configuração 
  <CODE
CLASS="option"
>--with-mysql[=DIR]</CODE
>
  aonde o parãmetro opcional <TT
CLASS="literal"
>[DIR]</TT
> aponta para o
  diretório onde o MySQL esta instalado.
 </P
><P
> 
  Mesmo sendo esta extensão MySQL compativel com MySQL 4.1.0 e posterior, 
  ela não suporta a funcionalidade extra que estas versões proveem. 
  Para isto, use a extensão <A
HREF="ref.mysqli.html"
>MySQLi</A
>.
 </P
><P
>&#13;  Se você quiser instalar a extensão mysql em conjuno com a extnsão mysqli
  você deve usar a mesma biblioteca de cliente para evitar quaisquer conflitos.
 </P
><DIV
CLASS="section"
><H2
CLASS="section"
><A
NAME="mysql.installation.linux"
>Instalação em Sistemas Linux</A
></H2
><DIV
CLASS="section"
><H3
CLASS="section"
><A
NAME="AEN128918"
>PHP 4</A
></H3
><P
>&#13;    A opção <CODE
CLASS="option"
>--with-mysql</CODE
> é
    ativada por padrão. Este é o funcionamento padrão e pode ser desabilitado
    com a opção de configuração <CODE
CLASS="option"
>--without-mysql</CODE
>.
    Se o MySQL for ativado sem especificar o caminho para o diretório de 
    instalação do MySQL, o PHP irá usar a biblioteca de cliente MySQL embutida.
   </P
><P
>&#13;    Usuários que executam outras aplicações que usam o MySQL (por exemplo,
    auth-mysql) não devem usar a biblioteca embutida, mas ao invés especificar
    o caminho para o diretório de instalação do MySQL, assim:
    <CODE
CLASS="option"
>--with-mysql=/path/to/mysql</CODE
>.
    Isto irá forçar o PHP a usar as bibliotecas de cliente instaladas pelo MySQL, assim
    evitando quaisquer conflitos.
   </P
></DIV
><DIV
CLASS="section"
><H3
CLASS="section"
><A
NAME="AEN128925"
>PHP 5+</A
></H3
><P
>&#13;    O MySQL não esta ativo por padrão, nem a biblioteca MySQL é
    embutida com o PHP. Leia este <A
HREF="faq.databases.html#faq.databases.mysql.php5"
>&#13;    FAQ</A
> para detalhes sobre o motivo. Use a opção de configuração 
    <CODE
CLASS="option"
>--with-mysql[=DIR]</CODE
>
    Para incluir o suporte a MySQL.
    Você pode baixar <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>cabeçalhos e bibliotecas</I
></SPAN
> a partir de 
    <A
HREF="http://www.mysql.com/"
TARGET="_top"
>MySQL</A
>.
   </P
></DIV
></DIV
><DIV
CLASS="section"
><H2
CLASS="section"
><A
NAME="mysql.installation.windows"
>Instalação em Sistemas Windows</A
></H2
><DIV
CLASS="section"
><H3
CLASS="section"
><A
NAME="AEN128934"
>PHP 4</A
></H3
><P
>&#13;    A extensão do PHP MySQL é compilada no PHP.
   </P
></DIV
><DIV
CLASS="section"
><H3
CLASS="section"
><A
NAME="AEN128937"
>PHP 5+</A
></H3
><P
>&#13;    O MySQL não é mais ativado por padrão, assim a DLL 
    <TT
CLASS="filename"
>php_mysql.dll</TT
> deve ser ativada dentro do 
    <TT
CLASS="filename"
>php.ini</TT
>. Também,  o PHP precisa acessar a biblioteca de cliente do MySQL. Um arquivo
    chamado <TT
CLASS="filename"
>libmysql.dll</TT
> é incluso na distribuição PHP do Windows
    e para permitir que o PHP converse com o MySQL este arquivo precisa estar
    disponível para o sistema Windows na variavél de ambiênte <CODE
CLASS="envar"
>PATH</CODE
>. Veja o Faq
    entitulado "<A
HREF="faq.installation.html#faq.installation.addtopath"
>Como eu adiciono o meu 
    diretório PHP no PATh no Windows</A
>" para informação de como fazer isto.
    Mesmo que copiar <TT
CLASS="filename"
>libmysql.dll</TT
> para o diretório de 
    sistema do Windows também (porque o diretório de sistema esta por padrão
    no <CODE
CLASS="envar"
>PATH</CODE
> do sistema), isto não é recomendado.
   </P
><P
>&#13;    Do mesmo jeito que ativar qualquer extensão do PHP (como 
    <TT
CLASS="filename"
>php_mysql.dll</TT
>), a diretiva do PHP
    <A
HREF="ini.core.html#ini.extension-dir"
>extension_dir</A
> deve estar definida para o diretório
    aonde as extensões do PHP estão localizadas. Veja também 
    <A
HREF="install.windows.manual.html"
>Instruções de instalação Manual
    no Windows</A
>. Como um exemplo de valor para extension_dir para o PHP 5 é
    <TT
CLASS="literal"
>c:\php\ext</TT
>
   </P
><DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>Nota: </B
>
     Se ao iniciar o servidor web acontecer um erro similar a este:
     <TT
CLASS="literal"
>"Unable to load dynamic library './php_mysql.dll'"</TT
>, 
     isto é porque <TT
CLASS="filename"
>php_mysql.dll</TT
> e/ou 
     <TT
CLASS="filename"
>libmysql.dll</TT
> não pode ser encontrada pelo sistema.
    </P
></BLOCKQUOTE
></DIV
></DIV
></DIV
><DIV
CLASS="section"
><H2
CLASS="section"
><A
NAME="mysql.installation.notes"
>Notas de Instalação do MySQL</A
></H2
><DIV
CLASS="warning"
><P
></P
><TABLE
CLASS="warning"
BORDER="1"
WIDTH="100%"
><TR
><TD
ALIGN="CENTER"
><B
>Atenção</B
></TD
></TR
><TR
><TD
ALIGN="LEFT"
><P
>&#13;     Quebras e problemas de inicilização do PHP podem ser encontrados ao
     carregar esta extensão em conjunto com a extensão recode.
     Veja a extensão <A
HREF="ref.recode.html"
>recode</A
> para
     maiores informações.
    </P
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>Nota: </B
>
     Se você precisar de conjuntos de caracteres diferntes de <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>latin</I
></SPAN
> 
     (padrão), você terá que instalar um libmysql externa (não embutida) com o
     suporte ao conjunto de caracteres compilado.
    </P
></BLOCKQUOTE
></DIV
></DIV
></DIV
><DIV
CLASS="section"
><H1
CLASS="section"
><A
NAME="mysql.configuration"
>Configurações em execução</A
></H1
><P
>&#13;O comportamento dessas funções podem ser modificado pelas configurações do <TT
CLASS="filename"
>php.ini</TT
>.
</P
><P
>&#13;  <DIV
CLASS="table"
><A
NAME="AEN128970"
></A
><P
><B
>Tabela 1. Opções de configuração do MySQL</B
></P
><TABLE
BORDER="1"
CLASS="CALSTABLE"
><COL><COL><COL><COL><COL><THEAD
><TR
><TH
>Nome</TH
><TH
>Padrão</TH
><TH
>Modificável</TH
><TH
>Modificações</TH
><TD
>&nbsp;</TD
></TR
></THEAD
><TBODY
><TR
><TD
>mysql.allow_persistent</TD
><TD
>"On"</TD
><TD
>PHP_INI_SYSTEM</TD
><TD
>&nbsp;</TD
><TD
>&nbsp;</TD
></TR
><TR
><TD
>mysql.max_persistent</TD
><TD
>"-1"</TD
><TD
>PHP_INI_SYSTEM</TD
><TD
>&nbsp;</TD
><TD
>&nbsp;</TD
></TR
><TR
><TD
>mysql.max_links</TD
><TD
>"-1"</TD
><TD
>PHP_INI_SYSTEM</TD
><TD
>&nbsp;</TD
><TD
>&nbsp;</TD
></TR
><TR
><TD
>mysql.default_port</TD
><TD
>NULL</TD
><TD
>PHP_INI_ALL</TD
><TD
>&nbsp;</TD
><TD
>&nbsp;</TD
></TR
><TR
><TD
>mysql.trace_mode</TD
><TD
>"0"</TD
><TD
>PHP_INI_ALL</TD
><TD
>Disponível desde o PHP 4.3.0.</TD
><TD
>&nbsp;</TD
></TR
><TR
><TD
>mysql.default_socket</TD
><TD
>NULL</TD
><TD
>PHP_INI_ALL</TD
><TD
>&nbsp;</TD
><TD
>&nbsp;</TD
></TR
><TR
><TD
>mysql.default_host</TD
><TD
>NULL</TD
><TD
>PHP_INI_ALL</TD
><TD
>Disponível desde o PHP 4.0.1.</TD
><TD
>&nbsp;</TD
></TR
><TR
><TD
>mysql.default_user</TD
><TD
>NULL</TD
><TD
>PHP_INI_ALL</TD
><TD
>&nbsp;</TD
><TD
>&nbsp;</TD
></TR
><TR
><TD
>mysql.default_password</TD
><TD
>NULL</TD
><TD
>PHP_INI_ALL</TD
><TD
>&nbsp;</TD
><TD
>&nbsp;</TD
></TR
><TR
><TD
>mysql.connect_timeout</TD
><TD
>"60"</TD
><TD
>PHP_INI_ALL</TD
><TD
>PHP_INI_SYSTEM in PHP &#60;= 4.3.2. Available since PHP 4.3.0.</TD
><TD
>&nbsp;</TD
></TR
></TBODY
></TABLE
></DIV
>
   Para mais detalhes e definições das constantes
 PHP_INI_*, veja <A
HREF="ini.html"
>Apêndice H</A
>.
</P
><P
>Breve descrição das
 diretivas de configuração.</P
><P
>&#13; <P
></P
><DIV
CLASS="variablelist"
><DL
><DT
><A
NAME="ini.mysql.allow-persistent"
></A
><CODE
CLASS="parameter"
>mysql.allow_persistent</CODE
>
    <A
HREF="language.types.boolean.html"
><B
CLASS="type"
>boolean</B
></A
></DT
><DD
><P
>&#13;     Quando permitir
     <A
HREF="features.persistent-connections.html"
>conexões persistentes</A
>
     para o MySQL.
    </P
></DD
><DT
><A
NAME="ini.mysql.max-persistent"
></A
><CODE
CLASS="parameter"
>mysql.max_persistent</CODE
>
    <A
HREF="language.types.integer.html"
><B
CLASS="type"
>integer</B
></A
></DT
><DD
><P
>&#13;     O número máximo de conexões persistentes com o MySQL
     por processo.
    </P
></DD
><DT
><A
NAME="ini.mysql.max-links"
></A
><CODE
CLASS="parameter"
>mysql.max_links</CODE
>
    <A
HREF="language.types.integer.html"
><B
CLASS="type"
>integer</B
></A
></DT
><DD
><P
>&#13;     O número maximo de conexões com o MYSQL por processo, incluindo
     conexões persistentes.
    </P
></DD
><DT
><A
NAME="ini.mysql.trace-mode"
></A
><CODE
CLASS="parameter"
>mysql.trace_mode</CODE
>
    <A
HREF="language.types.boolean.html"
><B
CLASS="type"
>boolean</B
></A
></DT
><DD
><P
>&#13;      Trace mode. Quando <TT
CLASS="literal"
>mysql.trace_mode</TT
> esta ativado, avisos
      para procuras table/index scans, conjuntos de resultados não liberados, e erros de SQL
      serão exibidos. (Introduzido no PHP 4.3.0)
     </P
></DD
><DT
><A
NAME="ini.mysql.default-port"
></A
><CODE
CLASS="parameter"
>mysql.default_port</CODE
>
    <A
HREF="language.types.string.html"
><B
CLASS="type"
>string</B
></A
></DT
><DD
><P
>&#13;    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 <CODE
CLASS="envar"
>MYSQL_TCP_PORT</CODE
>,
    da entrada <TT
CLASS="literal"
>mysql-tcp</TT
> em
     <TT
CLASS="filename"
>/etc/services</TT
> ou da constante da compilação
     <TT
CLASS="constant"
><B
>MYSQL_PORT</B
></TT
>, nesta ordem. Windows irá usar somente
     a constante <TT
CLASS="constant"
><B
>MYSQL_PORT</B
></TT
>.
    </P
></DD
><DT
><A
NAME="ini.mysql.default-socket"
></A
><CODE
CLASS="parameter"
>mysql.default_socket</CODE
>
    <A
HREF="language.types.string.html"
><B
CLASS="type"
>string</B
></A
></DT
><DD
><P
>&#13;     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.
    </P
></DD
><DT
><A
NAME="ini.mysql.default-host"
></A
><CODE
CLASS="parameter"
>mysql.default_host</CODE
>
    <A
HREF="language.types.string.html"
><B
CLASS="type"
>string</B
></A
></DT
><DD
><P
>&#13;     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
      <A
HREF="ini.core.html#ini.sql.safe-mode"
>Modo seguro de SQL</A
>.
    </P
></DD
><DT
><A
NAME="ini.mysql.default-user"
></A
><CODE
CLASS="parameter"
>mysql.default_user</CODE
>
    <A
HREF="language.types.string.html"
><B
CLASS="type"
>string</B
></A
></DT
><DD
><P
>&#13;     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
     <A
HREF="ini.core.html#ini.sql.safe-mode"
>Modo seguro de SQL</A
>.
    </P
></DD
><DT
><A
NAME="ini.mysql.default-password"
></A
><CODE
CLASS="parameter"
>mysql.default_password</CODE
>
    <A
HREF="language.types.string.html"
><B
CLASS="type"
>string</B
></A
></DT
><DD
><P
>&#13;     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
     <A
HREF="ini.core.html#ini.sql.safe-mode"
>Modo seguro de SQL</A
>.
    </P
></DD
><DT
><A
NAME="ini.mysql.connect-timeout"
></A
><CODE
CLASS="parameter"
>mysql.connect_timeout</CODE
>
    <A
HREF="language.types.integer.html"
><B
CLASS="type"
>integer</B
></A
></DT
><DD
><P
>&#13;     Limite de tempo da conexão em segundos. No Linux este limite é também usado para
     a espera da primeira resposta do servidor.
    </P
></DD
></DL
></DIV
>
 </P
></DIV
><DIV
CLASS="section"
><H1
CLASS="section"
><A
NAME="mysql.resources"
>Tipos Resource</A
></H1
><P
>&#13;     Existem dois tipos de recursos usados no módulo MySQL. O primeiro
     é o identificador de conexão com o banco de dados, e o segundo é o recurso
     o qual guarda o resultado de uma consulta.
    </P
></DIV
><DIV
CLASS="section"
><H1
CLASS="section"
><A
NAME="mysql.constants"
>Constantes pré-definidas</A
></H1
><P
>&#13;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.
</P
><P
>&#13;  Desde PHP 4.3.0 é possivel especificar opções adicionais para as funções
  <A
HREF="function.mysql-connect.html"
><B
CLASS="function"
>mysql_connect()</B
></A
> and <A
HREF="function.mysql-pconnect.html"
><B
CLASS="function"
>mysql_pconnect()</B
></A
>
  As seguintes constantes são definidas:
  <DIV
CLASS="table"
><A
NAME="mysql.client-flags"
></A
><P
><B
>Tabela 2. Constante do cliente MySQL</B
></P
><TABLE
BORDER="1"
CLASS="CALSTABLE"
><COL><COL><THEAD
><TR
><TH
>Constante</TH
><TH
>Descrição</TH
></TR
></THEAD
><TBODY
><TR
><TD
>MYSQL_CLIENT_COMPRESS</TD
><TD
>Usa o protocolo de compressão</TD
></TR
><TR
><TD
>MYSQL_CLIENT_IGNORE_SPACE</TD
><TD
>Permite espaço após o nome de função</TD
></TR
><TR
><TD
>MYSQL_CLIENT_INTERACTIVE</TD
><TD
>Permite interactive_timeout segundos (ao inves de wait_timeout) de inatividade
              antes de fechar a conexão.</TD
></TR
><TR
><TD
>MYSQL_CLIENT_SSL</TD
><TD
>Usar encriptação SSL. Esta opção esta disponível apenas com a versão
        4.x da biblioteca de cliente MySQL ou mais nova. A versão 3.23.x é distribuida
        com o PHP 4 e com os binários Windows do PHP 5.
        </TD
></TR
></TBODY
></TABLE
></DIV
>
 </P
><P
>&#13;  A função <A
HREF="function.mysql-fetch-array.html"
><B
CLASS="function"
>mysql_fetch_array()</B
></A
> usa uma constante para
  cada diferentes tipos de matrizes de resultado. As seguintes constantes são
  definidas:
  <DIV
CLASS="table"
><A
NAME="AEN129134"
></A
><P
><B
>Tabela 3. MySQL fetch constants</B
></P
><TABLE
BORDER="1"
CLASS="CALSTABLE"
><COL><COL><THEAD
><TR
><TH
>Constante</TH
><TH
>Descrição</TH
></TR
></THEAD
><TBODY
><TR
><TD
>MYSQL_ASSOC</TD
><TD
>&#13;       As colunas são retornadas na matriz tendo o nome do campo como índice
       da matriz.
      </TD
></TR
><TR
><TD
>MYSQL_BOTH</TD
><TD
>&#13;       As colunas são retornadas na matriz tendo ambos os indices: um numérico e 
       o um com o nome do campo.
      </TD
></TR
><TR
><TD
>MYSQL_NUM</TD
><TD
>&#13;       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.
      </TD
></TR
></TBODY
></TABLE
></DIV
>
 </P
></DIV
><DIV
CLASS="section"
><H1
CLASS="section"
><A
NAME="mysql.notes"
>Notas</A
></H1
><DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>Nota: </B
>
      A maioria das funções MySQL aceitam <CODE
CLASS="parameter"
>link_identifier</CODE
> como
      o último parâmetro opcional. Se este não for dados, a última
      conexão aberta é usada. Se não existir, é tentado estabelecer uma conexão
      com os valores padrão definidos no <TT
CLASS="filename"
>php.ini</TT
>. Se não for possível,
      a função retornará <TT
CLASS="constant"
><B
>FALSE</B
></TT
>.
     </P
></BLOCKQUOTE
></DIV
></DIV
><DIV
CLASS="section"
><H1
CLASS="section"
><A
NAME="mysql.examples"
>Exemplos</A
></H1
><P
>&#13;     Este exemplo simples mostra como conectar, executar uma consulta, mostrar
     as linhas do resultado e disconectar do banco de dados MySQL.
     <TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN129161"
></A
><P
><B
>Exemplo 1. Exemplo de visão geral da extensão MySQL</B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB">&lt;?php<br /></font><font color="#FF8000">// Conectando, escolhendo o banco de dados<br /></font><font color="#0000BB">$link </font><font color="#007700">= </font><font color="#0000BB">mysql_connect</font><font color="#007700">(</font><font color="#DD0000">'mysql_host'</font><font color="#007700">, </font><font color="#DD0000">'mysql_user'</font><font color="#007700">, </font><font color="#DD0000">'mysql_password'</font><font color="#007700">)<br />&nbsp;&nbsp;&nbsp;&nbsp;or die(</font><font color="#DD0000">'Não foi possível conectar: ' </font><font color="#007700">. </font><font color="#0000BB">mysql_error</font><font color="#007700">());<br />echo </font><font color="#DD0000">'Conexão bem sucedida'</font><font color="#007700">;<br /></font><font color="#0000BB">mysql_select_db</font><font color="#007700">(</font><font color="#DD0000">'my_database'</font><font color="#007700">) or die(</font><font color="#DD0000">'Não foi possível selecionar o banco da dados'</font><font color="#007700">);<br /><br /></font><font color="#FF8000">// Executando a consulta SQL<br /></font><font color="#0000BB">$query </font><font color="#007700">= </font><font color="#DD0000">'SELECT * FROM my_table'</font><font color="#007700">;<br /></font><font color="#0000BB">$result </font><font color="#007700">= </font><font color="#0000BB">mysql_query</font><font color="#007700">(</font><font color="#0000BB">$query</font><font color="#007700">) or die(</font><font color="#DD0000">'A consulta falhou!: ' </font><font color="#007700">. </font><font color="#0000BB">mysql_error</font><font color="#007700">());<br /><br /></font><font color="#FF8000">// Exibindo os resultados em HTML<br /></font><font color="#007700">echo </font><font color="#DD0000">"&lt;table&gt;\n"</font><font color="#007700">;<br />while (</font><font color="#0000BB">$line </font><font color="#007700">= </font><font color="#0000BB">mysql_fetch_array</font><font color="#007700">(</font><font color="#0000BB">$result</font><font color="#007700">, </font><font color="#0000BB">MYSQL_ASSOC</font><font color="#007700">)) {<br />&nbsp;&nbsp;&nbsp;&nbsp;echo </font><font color="#DD0000">"\t&lt;tr&gt;\n"</font><font color="#007700">;<br />&nbsp;&nbsp;&nbsp;&nbsp;foreach (</font><font color="#0000BB">$line </font><font color="#007700">as </font><font color="#0000BB">$col_value</font><font color="#007700">) {<br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;echo </font><font color="#DD0000">"</font><font color="#007700">\t\t</font><font color="#DD0000">&lt;td&gt;$col_value&lt;/td&gt;</font><font color="#007700">\n</font><font color="#DD0000">"</font><font color="#007700">;<br />&nbsp;&nbsp;&nbsp;&nbsp;}<br />&nbsp;&nbsp;&nbsp;&nbsp;echo </font><font color="#DD0000">"\t&lt;/tr&gt;\n"</font><font color="#007700">;<br />}<br />echo </font><font color="#DD0000">"&lt;/table&gt;\n"</font><font color="#007700">;<br /><br /></font><font color="#FF8000">// Liberar o conjunto de resultados<br /></font><font color="#0000BB">mysql_free_result</font><font color="#007700">(</font><font color="#0000BB">$result</font><font color="#007700">);<br /><br /></font><font color="#FF8000">// Fechar a conexão<br /></font><font color="#0000BB">mysql_close</font><font color="#007700">(</font><font color="#0000BB">$link</font><font color="#007700">);<br /></font><font color="#0000BB">?&gt;</font>
</font>
</code></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
>
    </P
></DIV
></DIV
><DIV
CLASS="TOC"
><DL
><DT
><B
>Índice</B
></DT
><DT
><A
HREF="function.mysql-affected-rows.html"
>mysql_affected_rows</A
>&nbsp;--&nbsp;Obtém o número de linhas atingidas na operação anterior do MySQL</DT
><DT
><A
HREF="function.mysql-change-user.html"
>mysql_change_user</A
>&nbsp;--&nbsp;Muda o usuário da conexão ativa</DT
><DT
><A
HREF="function.mysql-client-encoding.html"
>mysql_client_encoding</A
>&nbsp;--&nbsp;Retorna o nome do conjunto de caracteres</DT
><DT
><A
HREF="function.mysql-close.html"
>mysql_close</A
>&nbsp;--&nbsp;Fecha a conexão MySQL</DT
><DT
><A
HREF="function.mysql-connect.html"
>mysql_connect</A
>&nbsp;--&nbsp;Abre uma conexão com um servidor MySQL</DT
><DT
><A
HREF="function.mysql-create-db.html"
>mysql_create_db</A
>&nbsp;--&nbsp;Cria um banco de dados MySQL</DT
><DT
><A
HREF="function.mysql-data-seek.html"
>mysql_data_seek</A
>&nbsp;--&nbsp;Move o ponteiro interno do resultado</DT
><DT
><A
HREF="function.mysql-db-name.html"
>mysql_db_name</A
>&nbsp;--&nbsp;Obtém dados do resultado(nome de banco de dados)</DT
><DT
><A
HREF="function.mysql-db-query.html"
>mysql_db_query</A
>&nbsp;--&nbsp;Envia uma consulta MySQL</DT
><DT
><A
HREF="function.mysql-drop-db.html"
>mysql_drop_db</A
>&nbsp;--&nbsp;Exclui um banco de dados MySQL</DT
><DT
><A
HREF="function.mysql-errno.html"
>mysql_errno</A
>&nbsp;--&nbsp;Retorna o valor numérico da mensagem de erro da operação MySQL anterior</DT
><DT
><A
HREF="function.mysql-error.html"
>mysql_error</A
>&nbsp;--&nbsp;Retorna o texto da mensagem de erro da operação MySQL anterior</DT
><DT
><A
HREF="function.mysql-escape-string.html"
>mysql_escape_string</A
>&nbsp;--&nbsp;Escapa uma string para usar em uma consulta MySQL</DT
><DT
><A
HREF="function.mysql-fetch-array.html"
>mysql_fetch_array</A
>&nbsp;--&nbsp;Obtém uma linha como uma matriz associativa, uma matriz numérica, ou ambas</DT
><DT
><A
HREF="function.mysql-fetch-assoc.html"
>mysql_fetch_assoc</A
>&nbsp;--&nbsp;Obtém um linha do resultado como uma matriz associativa</DT
><DT
><A
HREF="function.mysql-fetch-field.html"
>mysql_fetch_field</A
>&nbsp;--&nbsp;Obtém informações sobre uma coluna de um resultado e retorna como um objeto</DT
><DT
><A
HREF="function.mysql-fetch-lengths.html"
>mysql_fetch_lengths</A
>&nbsp;--&nbsp;Obtém o tamanho de cada saída no resultado </DT
><DT
><A
HREF="function.mysql-fetch-object.html"
>mysql_fetch_object</A
>&nbsp;--&nbsp;Obtém o resultado de uma linha como um objeto</DT
><DT
><A
HREF="function.mysql-fetch-row.html"
>mysql_fetch_row</A
>&nbsp;--&nbsp;Obtém uma linha como uma array numérica</DT
><DT
><A
HREF="function.mysql-field-flags.html"
>mysql_field_flags</A
>&nbsp;--&nbsp;Obtém as flags associadas ao campo especificado em um resultado</DT
><DT
><A
HREF="function.mysql-field-len.html"
>mysql_field_len</A
>&nbsp;--&nbsp;Retorna o tamanho do campo especificado</DT
><DT
><A
HREF="function.mysql-field-name.html"
>mysql_field_name</A
>&nbsp;--&nbsp;Obtém o nome do campo especificado em um resultado</DT
><DT
><A
HREF="function.mysql-field-seek.html"
>mysql_field_seek</A
>&nbsp;--&nbsp;Define o ponteiro do resultado para o índice de campo especificado</DT
><DT
><A
HREF="function.mysql-field-table.html"
>mysql_field_table</A
>&nbsp;--&nbsp;Obtém o nome da tabela na qual o campo especificado esta</DT
><DT
><A
HREF="function.mysql-field-type.html"
>mysql_field_type</A
>&nbsp;--&nbsp;Obtém o tipo do campo especificado em um resultado</DT
><DT
><A
HREF="function.mysql-free-result.html"
>mysql_free_result</A
>&nbsp;--&nbsp;Libera um resultado da memória</DT
><DT
><A
HREF="function.mysql-get-client-info.html"
>mysql_get_client_info</A
>&nbsp;--&nbsp;Obtém informações do cliente MySQL</DT
><DT
><A
HREF="function.mysql-get-host-info.html"
>mysql_get_host_info</A
>&nbsp;--&nbsp;Obtém informações do servidor MySQL</DT
><DT
><A
HREF="function.mysql-get-proto-info.html"
>mysql_get_proto_info</A
>&nbsp;--&nbsp;Obtém informações do protocolo MySQL</DT
><DT
><A
HREF="function.mysql-get-server-info.html"
>mysql_get_server_info</A
>&nbsp;--&nbsp;Obtém informações do servidor MySQL</DT
><DT
><A
HREF="function.mysql-info.html"
>mysql_info</A
>&nbsp;--&nbsp;Obtém informação sobre a consulta mais recente</DT
><DT
><A
HREF="function.mysql-insert-id.html"
>mysql_insert_id</A
>&nbsp;--&nbsp;Obtém o ID gerado pela operação INSERT anterior</DT
><DT
><A
HREF="function.mysql-list-dbs.html"
>mysql_list_dbs</A
>&nbsp;--&nbsp;Lista os bancos de dados disponíveis em um servidor MySQL</DT
><DT
><A
HREF="function.mysql-list-fields.html"
>mysql_list_fields</A
>&nbsp;--&nbsp;Lista os campos de uma tabela MySQL</DT
><DT
><A
HREF="function.mysql-list-processes.html"
>mysql_list_processes</A
>&nbsp;--&nbsp;Lista os processos MySQL</DT
><DT
><A
HREF="function.mysql-list-tables.html"
>mysql_list_tables</A
>&nbsp;--&nbsp;Lista as tabelas em um banco de dados MySQL</DT
><DT
><A
HREF="function.mysql-num-fields.html"
>mysql_num_fields</A
>&nbsp;--&nbsp;Obtém o numero de campos em um resultado</DT
><DT
><A
HREF="function.mysql-num-rows.html"
>mysql_num_rows</A
>&nbsp;--&nbsp;Obtém o número de linhas em um resultado</DT
><DT
><A
HREF="function.mysql-pconnect.html"
>mysql_pconnect</A
>&nbsp;--&nbsp;Abre uma conexão persistente com um servidor MySQL</DT
><DT
><A
HREF="function.mysql-ping.html"
>mysql_ping</A
>&nbsp;--&nbsp;pinga uma conexão com o servidor ou reconecta se não houver conexão</DT
><DT
><A
HREF="function.mysql-query.html"
>mysql_query</A
>&nbsp;--&nbsp;Envia uma consulta MySQL</DT
><DT
><A
HREF="function.mysql-real-escape-string.html"
>mysql_real_escape_string</A
>&nbsp;--&nbsp;
     Escapa os caracteres especiais numa string para usar em um comando SQL, levando em conta o conjunto atual de caracteres.
    </DT
><DT
><A
HREF="function.mysql-result.html"
>mysql_result</A
>&nbsp;--&nbsp;Retorna dados do resultado</DT
><DT
><A
HREF="function.mysql-select-db.html"
>mysql_select_db</A
>&nbsp;--&nbsp;Seleciona um banco de dados MySQL</DT
><DT
><A
HREF="function.mysql-stat.html"
>mysql_stat</A
>&nbsp;--&nbsp;Retorna o status atual do sistema</DT
><DT
><A
HREF="function.mysql-tablename.html"
>mysql_tablename</A
>&nbsp;--&nbsp;Retorna o nome da tabela do campo</DT
><DT
><A
HREF="function.mysql-thread-id.html"
>mysql_thread_id</A
>&nbsp;--&nbsp;Returna o ID da thread atual</DT
><DT
><A
HREF="function.mysql-unbuffered-query.html"
>mysql_unbuffered_query</A
>&nbsp;--&nbsp;
     Envia uma query para o MySQL, sem retornar e colocar em buffer as linhas do resultado
    </DT
></DL
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="function.muscat-setup.html"
ACCESSKEY="P"
>Anterior</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Principal</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="function.mysql-affected-rows.html"
ACCESSKEY="N"
>Próxima</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>muscat_setup</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="funcref.html"
ACCESSKEY="U"
>Acima</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>mysql_affected_rows</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>