array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.mysql-fetch-assoc.php', 1 => 'mysql_fetch_assoc', 2 => 'Obtém uma linha do resultado como um array associativo', ), 'up' => array ( 0 => 'ref.mysql.php', 1 => 'Funções da MySQL', ), 'prev' => array ( 0 => 'function.mysql-fetch-array.php', 1 => 'mysql_fetch_array', ), 'next' => array ( 0 => 'function.mysql-fetch-field.php', 1 => 'mysql_fetch_field', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/mysql/functions/mysql-fetch-assoc.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

mysql_fetch_assoc

(PHP 4 >= 4.0.3, PHP 5)

mysql_fetch_assoc — Obtém uma linha do resultado como um array associativo

Aviso

Esta extensão foi descontinuada a partir do PHP 5.5.0 e foi removida no PHP 7.0.0. Em vez disso, as extensões MySQLi ou PDO_MySQL devem ser usadas. Veja também o guia MySQL: escolhendo uma API. Alternativas a esta função incluem:

Descrição

mysql_fetch_assoc(resource $result): array

Retorna um array associativo que corresponde a linha obtida e move o ponteiro interno dos dados adiante. mysql_fetch_assoc() é equivalente a utilizar mysql_fetch_array() com MYSQL_ASSOC para o segunto parâmetro, que é opcional. Ela apenas retorna um array associativo.

Parâmetros

result

O resource do resultado que está sendo avaliado. Este resultado vem de uma chamada a mysql_query().

Valor Retornado

Retorna um array associativo de strings que corresponde à linha obtida, ou false se não houver mais linhas.

Se duas ou mais colunas do resultado tiverem o mesmo nome de campo, a ultima coluna terá precedencia. Para acessar as outras colunas com o mesmo nome, é necessário acessar os outros resultados usando índices numéricos com mysql_fetch_row() ou adicionar apelidos. Veja o exemplo em mysql_fetch_array() para uma descrição sobre apelidos.

Exemplos

Exemplo #1 Um exemplo expandido de mysql_fetch_assoc()

<?php

$conn = mysql_connect("localhost", "mysql_user", "mysql_password");

if (!$conn) {
echo "Não foi possível conectar ao DB: " . mysql_error();
exit;
}

if (!mysql_select_db("mydbname")) {
echo "Não foi possível selecionar mydbname: " . mysql_error();
exit;
}

$sql = "SELECT id as userid, fullname, userstatus
FROM sometable
WHERE userstatus = 1";

$result = mysql_query($sql);

if (!$result) {
echo "Não foi possível executar a consulta ($sql) no DB: " . mysql_error();
exit;
}

if (mysql_num_rows($result) == 0) {
echo "Nenhuma linha encontrada, nada para exibir, saindo...";
exit;
}

// Enquanto uma linha de dados existir, coloque essa linha em $row como um array associativo
// Observação: Se for esperada apenas uma linha, não é necessário usar um loop
// Observação: Se for colocado extract($row); dentro do loop a seguir, serão
// criados $userid, $fullname e $userstatus
while ($row = mysql_fetch_assoc($result)) {
echo $row["userid"];
echo $row["fullname"];
echo $row["userstatus"];
}

mysql_free_result($result);

?>

Notas

Nota: Performance
Uma coisa importante para notar é que usar mysql_fetch_assoc() não é significativamente mais lento do que usar mysql_fetch_row(), enquanto provê um valor agregado significante.

Nota: Os nomes de campos retornados por esta função diferenciam maiúsculas e minúsculas.

Nota: Esta função define campos NULL como o valor null do PHP.

Veja Também