Funções da MySQL
PHP Manual

mysql_fetch_assoc

(PHP 4 >= 4.0.3, PHP 5)

mysql_fetch_assocObtém um linha do resultado como uma matriz associativa

Descrição

array mysql_fetch_assoc ( resource $result )

Retorna uma matriz associativa 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 a matriz associativa.

Parâmetros

result

The result resource that is being evaluated. This result comes from a call to mysql_query().

Valor Retornado

Retorna uma matriz associativa de strings que corresponde a linha obtida, ou FALSE se não houverem mais linhas.

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

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 banco de dados: " 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 banco de dados: " mysql_error();
    exit;
}

if (
mysql_num_rows($result) == 0) {
    echo 
"Não foram encontradas linhas, nada para mostrar, assim eu estou saindo";
    exit;
}

// Enquanto uma linha de dados existir, coloca esta linha em $row como uma matriz associativa
// Nota: se você esta esperando apenas uma linha, não é necessário usar um loop
// Nota: se você colocar extract($row); dentro do loop, você então
//     irá criar $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: Nomes de campos nesta função diferenciam maiúsculas e minusculas.

Nota: Esta função assimila campos NULL para o o NULL do PHP.

Veja Também


Funções da MySQL
PHP Manual