Manual do PHP
Anterior |  | Próxima

# mysql_fetch_assoc

(PHP 4 >= 4.0.3, PHP 5)

mysql_fetch_assoc -- Obté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`

  O resulatado resource que esta sendo avaliado. Este resultado vem de uma chamada a mysql_query().

## Valores de retornado

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

> 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

mysql_fetch_row()
mysql_fetch_array()
mysql_data_seek()
mysql_query()
mysql_error()

Anterior | Principal | Próxima
mysql_fetch_array | Acima | mysql_fetch_field