<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/set.mysqlinfo.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'pt_BR',
  ),
  'this' => 
  array (
    0 => 'book.mysqli.php',
    1 => 'MySQLi',
    2 => 'Extens&atilde;o MySQL Melhorada',
  ),
  'up' => 
  array (
    0 => 'set.mysqlinfo.php',
    1 => 'MySQL',
  ),
  'prev' => 
  array (
    0 => 'mysqlinfo.concepts.charset.php',
    1 => 'Conjuntos de caracteres',
  ),
  'next' => 
  array (
    0 => 'mysqli.overview.php',
    1 => 'Vis&atilde;o Geral',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'pt_BR',
    'path' => 'reference/mysqli/book.xml',
  ),
  'history' => 
  array (
  ),
  'extra_header_links' => 
  array (
    'rel' => 'alternate',
    'href' => '/manual/en/feeds/book.mysqli.atom',
    'type' => 'application/atom+xml',
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="book.mysqli" class="book">
 

 <h1 class="title">Extensão MySQL Melhorada</h1>

 



 <div id="intro.mysqli" class="preface">
  <h1 class="title">Introdução</h1>
  <p class="para">
   A extensão <code class="literal">mysqli</code> permite a você acessar a funcionalidade
   provida pelo MySQL 4.1 e posterior. Maiores informações sobre o servidor de
   banco de dados MySQL podem ser encontradas em
   <a href="http://www.mysql.com/" class="link external">&raquo;&nbsp;http://www.mysql.com/</a>
  </p>

  <p class="para">
   Uma visão geral de software disponível para usar MySQL através do PHP
   pode ser encontrada em <a href="mysqli.overview.php" class="xref">Vis&atilde;o Geral</a>
  </p>

  <p class="para">
   Documentação para o MySQL pode ser encontrada em
   <a href="http://dev.mysql.com/doc/" class="link external">&raquo;&nbsp;http://dev.mysql.com/doc/</a>.
  </p>

  <p class="para">
   Partes desta documentação foram incluídas do manual do MySQL com a permissão
   de Oracle Corporation.
  </p>

  <p class="para">
   Os exemplos usam tanto o banco de dados
   <a href="http://dev.mysql.com/doc/world-setup/en/index.html" class="link external">&raquo;&nbsp;world</a> quanto o banco de dados
   <a href="http://dev.mysql.com/doc/sakila/en/index.html" class="link external">&raquo;&nbsp;sakila</a>, que estão disponíveis livremente.
  </p>

 </div>



 



 



 







 




 




 






 





 




 




 




 




 




 




 










<ul class="chunklist chunklist_book"><li><a href="mysqli.overview.php">Vis&atilde;o Geral</a></li><li><a href="mysqli.quickstart.php">Guia de in&iacute;cio r&aacute;pido</a><ul class="chunklist chunklist_book chunklist_children"><li><a href="mysqli.quickstart.dual-interface.php">Interface dupla, procedural e orientada a objetos</a></li><li><a href="mysqli.quickstart.connections.php">Conex&otilde;es</a></li><li><a href="mysqli.quickstart.statements.php">Executando instru&ccedil;&otilde;es</a></li><li><a href="mysqli.quickstart.prepared-statements.php">Instru&ccedil;&otilde;es Preparadas</a></li><li><a href="mysqli.quickstart.stored-procedures.php">Procedimentos Armazenados</a></li><li><a href="mysqli.quickstart.multiple-statement.php">Instru&ccedil;&otilde;es M&uacute;ltiplas</a></li><li><a href="mysqli.quickstart.transactions.php">Suporte da API para transa&ccedil;&otilde;es</a></li><li><a href="mysqli.quickstart.metadata.php">Metadados</a></li></ul></li><li><a href="mysqli.setup.php">Instala&ccedil;&atilde;o/Configura&ccedil;&atilde;o</a><ul class="chunklist chunklist_book chunklist_children"><li><a href="mysqli.requirements.php">Depend&ecirc;ncias</a></li><li><a href="mysqli.installation.php">Instala&ccedil;&atilde;o</a></li><li><a href="mysqli.configuration.php">Configura&ccedil;&otilde;es em Execu&ccedil;&atilde;o</a></li></ul></li><li><a href="mysqli.persistconns.php">A extens&atilde;o mysqli e conex&otilde;es persistentes</a></li><li><a href="mysqli.constants.php">Constantes predefinidas</a></li><li><a href="mysqli.notes.php">Notas</a></li><li><a href="mysqli.summary.php">Resumo da Fun&ccedil;&atilde;o de Extens&atilde;o do MySQLi</a></li><li><a href="class.mysqli.php">mysqli</a> — A classe mysqli<ul class="chunklist chunklist_book chunklist_children"><li><a href="mysqli.affected-rows.php">mysqli::$affected_rows</a> — Retorna o n&uacute;mero de linhas afetadas pela opera&ccedil;&atilde;o MySQL anterior</li><li><a href="mysqli.autocommit.php">mysqli::autocommit</a> — Ativa ou desativa a grava&ccedil;&atilde;o autom&aacute;tica das modifica&ccedil;&otilde;es no banco de dados</li><li><a href="mysqli.begin-transaction.php">mysqli::begin_transaction</a> — Inicia uma transa&ccedil;&atilde;o</li><li><a href="mysqli.change-user.php">mysqli::change_user</a> — Altera o usu&aacute;rio da conex&atilde;o com o banco de dados</li><li><a href="mysqli.character-set-name.php">mysqli::character_set_name</a> — Retorna o conjunto de caracteres atual da conex&atilde;o com o banco de dados</li><li><a href="mysqli.close.php">mysqli::close</a> — Fecha uma conex&atilde;o ao banco de dados previamente aberta</li><li><a href="mysqli.commit.php">mysqli::commit</a> — Grava a transa&ccedil;&atilde;o atual</li><li><a href="mysqli.connect-errno.php">mysqli::$connect_errno</a> — Retorna o c&oacute;digo de erro da &uacute;ltima chamada de conex&atilde;o</li><li><a href="mysqli.connect-error.php">mysqli::$connect_error</a> — Retorna uma descri&ccedil;&atilde;o do &uacute;ltimo erro de conex&atilde;o</li><li><a href="mysqli.construct.php">mysqli::__construct</a> — Abre uma nova conex&atilde;o com o servidor MySQL</li><li><a href="mysqli.debug.php">mysqli::debug</a> — Realiza opera&ccedil;&otilde;es de depura&ccedil;&atilde;o</li><li><a href="mysqli.dump-debug-info.php">mysqli::dump_debug_info</a> — Descarrega informa&ccedil;&atilde;o de debug no log</li><li><a href="mysqli.errno.php">mysqli-&gt;errno</a> — Retorna o c&oacute;digo de erro para a chamada de fun&ccedil;&atilde;o mais recente</li><li><a href="mysqli.error.php">mysqli-&gt;error</a> — Retorna uma string descrevendo o &uacute;ltimo erro</li><li><a href="mysqli.error-list.php">mysqli::$error_list</a> — Retorna uma lista de erros do &uacute;ltimo comando executado</li><li><a href="mysqli.execute-query.php">mysqli::execute_query</a> — Prepara, vincula par&acirc;metros e executa a instru&ccedil;&atilde;o SQL</li><li><a href="mysqli.field-count.php">mysqli::$field_count</a> — Retorna o n&uacute;mero de campos para a consulta mais recente</li><li><a href="mysqli.get-charset.php">mysqli::get_charset</a> — Retorna um objeto de conjunto de caracteres</li><li><a href="mysqli.get-client-info.php">mysqli::$client_info</a> — Obt&eacute;m informa&ccedil;&atilde;o do cliente MySQL</li><li><a href="mysqli.get-client-version.php">mysqli::$client_version</a> — Retorna a vers&atilde;o do cliente MySQL como um inteiro</li><li><a href="mysqli.get-connection-stats.php">mysqli::get_connection_stats</a> — Retorna estat&iacute;sticas sobre a conex&atilde;o do cliente</li><li><a href="mysqli.get-host-info.php">mysqli::$host_info</a> — Retorna uma string representando o tipo de conex&atilde;o utilizada</li><li><a href="mysqli.get-proto-info.php">mysqli::$protocol_version</a> — Retorna a vers&atilde;o do protocolo MySQL usada</li><li><a href="mysqli.get-server-info.php">mysqli::$server_info</a> — Retorna a vers&atilde;o do servidor MySQL</li><li><a href="mysqli.get-server-version.php">mysqli::$server_version</a> — Retorna a vers&atilde;o do servidor MySQL como um inteiro</li><li><a href="mysqli.get-warnings.php">mysqli::get_warnings</a> — Obt&eacute;m o resultado de SHOW WARNINGS</li><li><a href="mysqli.info.php">mysqli::$info</a> — Recupera informa&ccedil;&atilde;o sobre a recente consulta executada</li><li><a href="mysqli.init.php">mysqli::init</a> — Inicializa o MySQLi e retorna um objeto a ser utilizado com mysqli_real_connect()</li><li><a href="mysqli.insert-id.php">mysqli::$insert_id</a> — Retorna o valor gerado para uma coluna AUTO_INCREMENT pela &uacute;ltima consulta</li><li><a href="mysqli.kill.php">mysqli::kill</a> — Solicita ao servidor o encerramento de um thread do MySQL</li><li><a href="mysqli.more-results.php">mysqli::more_results</a> — Verifica se h&aacute; mais algum resultado de uma consulta m&uacute;ltipla</li><li><a href="mysqli.multi-query.php">mysqli::multi_query</a> — Executa uma ou mais consultas no banco de dados</li><li><a href="mysqli.next-result.php">mysqli::next_result</a> — Prepara o pr&oacute;ximo resultado de multi_query</li><li><a href="mysqli.options.php">mysqli::options</a> — Define op&ccedil;&otilde;es</li><li><a href="mysqli.ping.php">mysqli::ping</a> — Faz ping em uma conex&atilde;o de servidor ou tenta reconectar se a conex&atilde;o cair</li><li><a href="mysqli.poll.php">mysqli::poll</a> — Sondagem de conex&otilde;es</li><li><a href="mysqli.prepare.php">mysqli::prepare</a> — Prepara uma instru&ccedil;&atilde;o SQL para execu&ccedil;&atilde;o</li><li><a href="mysqli.query.php">mysqli::query</a> — Executa uma consulta no banco de dados</li><li><a href="mysqli.real-connect.php">mysqli::real_connect</a> — Abre uma conex&atilde;o a um servidor MySQL</li><li><a href="mysqli.real-escape-string.php">mysqli::real_escape_string</a> — Escape caracteres especiais em uma string para uso em uma instru&ccedil;&atilde;o SQL, levando em considera&ccedil;&atilde;o o conjunto de caracteres atual da conex&atilde;o</li><li><a href="mysqli.real-query.php">mysqli::real_query</a> — Executa uma consulta SQL</li><li><a href="mysqli.reap-async-query.php">mysqli::reap_async_query</a> — Obtenha o resultado da consulta ass&iacute;ncrona</li><li><a href="mysqli.refresh.php">mysqli::refresh</a> — Atualiza</li><li><a href="mysqli.release-savepoint.php">mysqli::release_savepoint</a> — Remove o ponto de salvamento nomeado do conjunto de pontos de salvamento da transa&ccedil;&atilde;o atual</li><li><a href="mysqli.rollback.php">mysqli::rollback</a> — Reverte a transa&ccedil;&atilde;o atual</li><li><a href="mysqli.savepoint.php">mysqli::savepoint</a> — Define um ponto de salvamento de transa&ccedil;&atilde;o nomeado</li><li><a href="mysqli.select-db.php">mysqli::select_db</a> — Seleciona o banco de dados padr&atilde;o para consultas de banco de dados</li><li><a href="mysqli.set-charset.php">mysqli::set_charset</a> — Define o conjunto de caracteres do cliente</li><li><a href="mysqli.sqlstate.php">mysqli::$sqlstate</a> — Retorna o erro SQLSTATE da opera&ccedil;&atilde;o MySQL anterior</li><li><a href="mysqli.ssl-set.php">mysqli::ssl_set</a> — Usado para estabelecer conex&otilde;es seguras usando SSL</li><li><a href="mysqli.stat.php">mysqli::stat</a> — Obt&eacute;m o status atual do sistema</li><li><a href="mysqli.stmt-init.php">mysqli::stmt_init</a> — Inicializa uma instru&ccedil;&atilde;o e retorna um objeto para uso com mysqli_stmt_prepare</li><li><a href="mysqli.store-result.php">mysqli::store_result</a> — Transfere um conjunto de resultados da &uacute;ltima consulta</li><li><a href="mysqli.thread-id.php">mysqli::$thread_id</a> — Retorna o ID da thread para a conex&atilde;o atual</li><li><a href="mysqli.thread-safe.php">mysqli::thread_safe</a> — Retorna se a seguran&ccedil;a de thread &eacute; dada ou n&atilde;o</li><li><a href="mysqli.use-result.php">mysqli::use_result</a> — Iniciar uma recupera&ccedil;&atilde;o de conjunto de resultados</li><li><a href="mysqli.warning-count.php">mysqli::$warning_count</a> — Retorna o n&uacute;mero de alertas gerados pela consulta mais recente</li></ul></li><li><a href="class.mysqli-stmt.php">mysqli_stmt</a> — A classe mysqli_stmt<ul class="chunklist chunklist_book chunklist_children"><li><a href="mysqli-stmt.affected-rows.php">mysqli_stmt::$affected_rows</a> — Retorna o n&uacute;mero total de linhas modificadas, apagadas, inseridas ou
   correspondidas pela &uacute;ltima instru&ccedil;&atilde;o executada</li><li><a href="mysqli-stmt.attr-get.php">mysqli_stmt::attr_get</a> — Usado para obter o valor atual de um atributo de instru&ccedil;&atilde;o</li><li><a href="mysqli-stmt.attr-set.php">mysqli_stmt::attr_set</a> — Usado para modificar o comportamento de uma instru&ccedil;&atilde;o preparada</li><li><a href="mysqli-stmt.bind-param.php">mysqli_stmt::bind_param</a> — Liga vari&aacute;veis a uma declara&ccedil;&atilde;o preparada como par&acirc;metros</li><li><a href="mysqli-stmt.bind-result.php">mysqli_stmt::bind_result</a> — Liga vari&aacute;veis a uma declara&ccedil;&atilde;o preparada para armazenamento de resultado</li><li><a href="mysqli-stmt.close.php">mysqli_stmt::close</a> — Fecha uma instru&ccedil;&atilde;o preparada</li><li><a href="mysqli-stmt.construct.php">mysqli_stmt::__construct</a> — Constr&oacute;i um novo objeto mysqli_stmt</li><li><a href="mysqli-stmt.data-seek.php">mysqli_stmt::data_seek</a> — Ajusta o ponteiro de resultado para uma linha arbitr&aacute;ria no resultado com buffer</li><li><a href="mysqli-stmt.errno.php">mysqli_stmt::$errno</a> — Retorna o c&oacute;digo de erro para a chamada de instru&ccedil;&atilde;o mais recente</li><li><a href="mysqli-stmt.error.php">mysqli_stmt::$error</a> — Retorna uma descri&ccedil;&atilde;o em string para o &uacute;ltimo erro de instru&ccedil;&atilde;o</li><li><a href="mysqli-stmt.error-list.php">mysqli_stmt::$error_list</a> — Retorna uma lista de erros da &uacute;ltima instru&ccedil;&atilde;o executada</li><li><a href="mysqli-stmt.execute.php">mysqli_stmt::execute</a> — Executa uma instru&ccedil;&atilde;o preparada</li><li><a href="mysqli-stmt.fetch.php">mysqli_stmt::fetch</a> — Recebe resultados de uma instru&ccedil;&atilde;o preparada nas vari&aacute;veis vinculadas</li><li><a href="mysqli-stmt.field-count.php">mysqli_stmt::$field_count</a> — Retorna o n&uacute;mero de colunas na instru&ccedil;&atilde;o informada</li><li><a href="mysqli-stmt.free-result.php">mysqli_stmt::free_result</a> — Libera mem&oacute;ria do resultado armazenado para o manipulador de instru&ccedil;&atilde;o informado</li><li><a href="mysqli-stmt.get-result.php">mysqli_stmt::get_result</a> — Obt&eacute;m um resultado de uma instru&ccedil;&atilde;o preparada como um objeto mysqli_result</li><li><a href="mysqli-stmt.get-warnings.php">mysqli_stmt::get_warnings</a> — Obt&eacute;m o resultado de SHOW WARNINGS</li><li><a href="mysqli-stmt.insert-id.php">mysqli_stmt::$insert_id</a> — Obt&eacute;m o ID gerado pela opera&ccedil;&atilde;o INSERT anterior</li><li><a href="mysqli-stmt.more-results.php">mysqli_stmt::more_results</a> — Verifica se h&aacute; mais resultados de uma consulta m&uacute;ltipla</li><li><a href="mysqli-stmt.next-result.php">mysqli_stmt::next_result</a> — L&ecirc; o pr&oacute;ximo resultado de uma consulta m&uacute;ltipla</li><li><a href="mysqli-stmt.num-rows.php">mysqli_stmt::$num_rows</a> — Retorna o n&uacute;mero de linhas recebidas pelo servidor</li><li><a href="mysqli-stmt.param-count.php">mysqli_stmt::$param_count</a> — Retorna o n&uacute;mero de par&acirc;metros para uma instru&ccedil;&atilde;o fornecida</li><li><a href="mysqli-stmt.prepare.php">mysqli_stmt::prepare</a> — Prepara uma declara&ccedil;&atilde;o SQL para execu&ccedil;&atilde;o</li><li><a href="mysqli-stmt.reset.php">mysqli_stmt::reset</a> — Redefine uma instru&ccedil;&atilde;o preparada</li><li><a href="mysqli-stmt.result-metadata.php">mysqli_stmt::result_metadata</a> — Retorna os metadados de resultado de uma instru&ccedil;&atilde;o preparada</li><li><a href="mysqli-stmt.send-long-data.php">mysqli_stmt::send_long_data</a> — Envia dados em blocos</li><li><a href="mysqli-stmt.sqlstate.php">mysqli_stmt::$sqlstate</a> — Retorna o erro SQLSTATE da opera&ccedil;&atilde;o da instru&ccedil;&atilde;o anterior</li><li><a href="mysqli-stmt.store-result.php">mysqli_stmt::store_result</a> — Armazena um conjunto de resultados em um buffer interno</li></ul></li><li><a href="class.mysqli-result.php">mysqli_result</a> — A classe mysqli_result<ul class="chunklist chunklist_book chunklist_children"><li><a href="mysqli-result.construct.php">mysqli_result::__construct</a> — Constr&oacute;i um objeto mysqli_result</li><li><a href="mysqli-result.current-field.php">mysqli_result::$current_field</a> — Obt&eacute;m o deslocamento atual de campo de um ponteiro de resultado</li><li><a href="mysqli-result.data-seek.php">mysqli_result::data_seek</a> — Ajusta o ponteiro do resultado para uma linha arbrit&aacute;ria no resultado</li><li><a href="mysqli-result.fetch-all.php">mysqli_result::fetch_all</a> — Recebe todas as linhas de resultado como array associativo, num&eacute;rico, ou ambos</li><li><a href="mysqli-result.fetch-array.php">mysqli_result::fetch_array</a> — Recebe a pr&oacute;xima linha de resultado como array associativo, num&eacute;rico, ou ambos</li><li><a href="mysqli-result.fetch-assoc.php">mysqli_result::fetch_assoc</a> — Obt&eacute;m a pr&oacute;xima linha do conjunto de resultados como um array associativo</li><li><a href="mysqli-result.fetch-column.php">mysqli_result::fetch_column</a> — Recebe uma &uacute;nica coluna da pr&oacute;xima linha de um resultado</li><li><a href="mysqli-result.fetch-field.php">mysqli_result::fetch_field</a> — Retorna o pr&oacute;ximo campo no conjunto de resultados</li><li><a href="mysqli-result.fetch-field-direct.php">mysqli_result::fetch_field_direct</a> — Recebe metadados para um &uacute;nico campo</li><li><a href="mysqli-result.fetch-fields.php">mysqli_result::fetch_fields</a> — Retorna um array de objetos representando os campos em um conjunto de resultados</li><li><a href="mysqli-result.fetch-object.php">mysqli_result::fetch_object</a> — Recebe a pr&oacute;xima linha de um resultado como um objeto</li><li><a href="mysqli-result.fetch-row.php">mysqli_result::fetch_row</a> — Obt&eacute;m a pr&oacute;xima linha de um resultado como um array enumerado</li><li><a href="mysqli-result.field-count.php">mysqli_result::$field_count</a> — Obt&eacute;m o n&uacute;mero de campos no conjunto de resultados</li><li><a href="mysqli-result.field-seek.php">mysqli_result::field_seek</a> — Move o ponteiro do resultado para um campo especificado</li><li><a href="mysqli-result.free.php">mysqli_result::free</a> — Libera mem&oacute;ria associada a um resultado</li><li><a href="mysqli-result.getiterator.php">mysqli_result::getIterator</a> — Obt&eacute;m um iterador externo</li><li><a href="mysqli-result.lengths.php">mysqli_result::$lengths</a> — Retorna os comprimentos das colunas da linha atual do resultado</li><li><a href="mysqli-result.num-rows.php">mysqli_result::$num_rows</a> — Obt&eacute;m o n&uacute;mero de linhas no resultado</li></ul></li><li><a href="class.mysqli-driver.php">mysqli_driver</a> — A classe mysqli_driver<ul class="chunklist chunklist_book chunklist_children"><li><a href="mysqli-driver.embedded-server-end.php">mysqli_driver::embedded_server_end</a> — Para o servidor incorporado</li><li><a href="mysqli-driver.embedded-server-start.php">mysqli_driver::embedded_server_start</a> — Inicializa e dispara o servidor incorporado</li><li><a href="mysqli-driver.report-mode.php">mysqli_driver::$report_mode</a> — Define o modo de relat&oacute;rio de erros do mysqli</li></ul></li><li><a href="class.mysqli-warning.php">mysqli_warning</a> — A classe mysqli_warning<ul class="chunklist chunklist_book chunklist_children"><li><a href="mysqli-warning.construct.php">mysqli_warning::__construct</a> — Construtor privado para proibir instancia&ccedil;&atilde;o direta</li><li><a href="mysqli-warning.next.php">mysqli_warning::next</a> — Busca o pr&oacute;ximo aviso</li></ul></li><li><a href="class.mysqli-sql-exception.php">mysqli_sql_exception</a> — A classe mysqli_sql_exception<ul class="chunklist chunklist_book chunklist_children"><li><a href="mysqli-sql-exception.getsqlstate.php">mysqli_sql_exception::getSqlState</a> — Retorna o c&oacute;digo de erro SQLSTATE</li></ul></li><li><a href="ref.mysqli.php">Apelidos e Fun&ccedil;&otilde;es descontinuadas da Mysqli</a><ul class="chunklist chunklist_book chunklist_children"><li><a href="function.mysqli-connect.php">mysqli_connect</a> — Sin&ocirc;nimo de mysqli::__construct</li><li><a href="function.mysqli-escape-string.php">mysqli::escape_string</a> — Sin&ocirc;nimo de mysqli_real_escape_string</li><li><a href="function.mysqli-execute.php">mysqli_execute</a> — Sin&ocirc;nimo de mysqli_stmt_execute</li><li><a href="function.mysqli-get-client-stats.php">mysqli_get_client_stats</a> — Retorna as estat&iacute;sticas do cliente por processo</li><li><a href="function.mysqli-get-links-stats.php">mysqli_get_links_stats</a> — Retorna informa&ccedil;&otilde;es sobre links abertos e em cache</li><li><a href="function.mysqli-report.php">mysqli_report</a> — Sin&ocirc;nimo de mysqli_driver-&gt;report_mode</li><li><a href="function.mysqli-set-opt.php">mysqli::set_opt</a> — Sin&ocirc;nimo de mysqli_options</li></ul></li><li><a href="changelog.mysqli.php">Registro de Altera&ccedil;&otilde;es</a></li></ul></div><?php manual_footer($setup); ?>