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 tornou-se defasada 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 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 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 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 com mysql_fetch_row() ou adicionar alias (apelidos). 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     "Unable to connect to DB: " . mysql_error();
    exit;
    }

    if (!    mysql_select_db("mydbname")) {
    echo     "Unable to select mydbname: " . mysql_error();
    exit;
    }

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

    $result = mysql_query($sql);

    if (!    $result) {
    echo     "Could not successfully run query ($sql) from DB: " . mysql_error();
    exit;
    }

    if (    mysql_num_rows($result) == 0) {
    echo     "No rows found, nothing to print so am exiting";
    exit;
    }

    // While a row of data exists, put that row in $row as an associative array
    // Note: If you're expecting just one row, no need to use a loop
    // Note: If you put extract($row); inside the following loop, you'll
    // then create $userid, $fullname, and $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

    To Top