PDOStatement::fetchAll()

PDOStatement::fetchAll

(PHP 5 >= 5.1.0, PHP 7, PHP 8, PECL pdo >= 0.1.0)

PDOStatement::fetchAll — Hämtar de återstående raderna från en resultatuppsättning

Beskrivning

public PDOStatement::fetchAll(int $mode = PDO::FETCH_DEFAULT): array
public PDOStatement::fetchAll(int $mode = PDO::FETCH_COLUMN, int $column): array
public PDOStatement::fetchAll(int $mode = PDO::FETCH_CLASS, string $class, ?array $constructorArgs): array
public PDOStatement::fetchAll(int $mode = PDO::FETCH_FUNC, callable $callback): array

Hämtar alla återstående rader från resultatuppsättningen kopplad till ett PDOStatement-objekt. Innehållet i den returnerade arrayen styrs av parametern mode, enligt samma principer som i PDOStatement::fetch.

Parametrar

mode

Styr innehållet i den returnerade arrayen. Standardvärdet är inställt på PDO::ATTR_DEFAULT_FETCH_MODE (som som standard är PDO::FETCH_BOTH).

• PDO::FETCH_COLUMN: Returnerar en array med värden från en enda kolumn i resultatuppsättningen. Kolumnen anges med parametern column.
• PDO::FETCH_UNIQUE: Indexerar den resulterande arrayen med värdet från en viss kolumn. Kolumnen måste innehålla unika värden, annars förloras data.
• PDO::FETCH_GROUP: Grupperar resultatet som en 3-dimensionell array där den första kolumnen används som index.
• PDO::FETCH_GROUP | PDO::FETCH_COLUMN: Grupperar resultatet som en 2-dimensionell array baserat på den första kolumnen. Arrayelementens värden är listor med motsvarande värden från den andra kolumnen.

column

Används med PDO::FETCH_COLUMN. Anger vilken 0-indexerad kolumn som ska hämtas.

class

Används med PDO::FETCH_CLASS. Returnerar instanser av den angivna klassen och mappar kolumnvärden till egenskaper i klassen.

constructorArgs

Används med PDO::FETCH_CLASS. Anger argument för klassens konstruktor.

callback

Används med PDO::FETCH_FUNC. Returnerar resultatet av att anropa en angiven funktion där varje rads kolumnvärden används som argument.

Returvärden

PDOStatement::fetchAll() returnerar en array som innehåller alla återstående rader i resultatet. Varje rad representeras som en array med kolumnvärden eller som ett objekt med egenskaper motsvarande kolumnnamnen. Om inga rader finns returneras en tom array.

Varning: Att använda denna metod för att hämta stora resultatmängder kan leda till hög resursförbrukning. Överväg att låta databasen filtrera och begränsa resultatet genom SQL-satser som WHERE och ORDER BY innan du hämtar och bearbetar data i PHP.

Fel/Uppslag

• Utlöser ett fel på nivån E_WARNING om attributet PDO::ATTR_ERRMODE är inställt på PDO::ERRMODE_WARNING.
• Kastar ett PDOException-fel om attributet PDO::ATTR_ERRMODE är inställt på PDO::ERRMODE_EXCEPTION.

Ändringslogg

Version

8.0.0 Denna metod returnerar alltid en array. Tidigare kunde den returnera false vid misslyckande.

Exempel

Exempel 1: Hämta alla återstående rader

<?php
$sth = $dbh->prepare("SELECT name, colour FROM fruit");
$sth->execute();

/* Hämta alla återstående rader */
print "Hämta alla återstående rader:\n";
$result = $sth->fetchAll();
print_r($result);
?>

Möjlig utdata:

Hämta alla återstående rader:
Array
(
    [0] => Array
        (
            [name] => apple
            [0] => apple
            [colour] => red
            [1] => red
        )

    [1] => Array
        (
            [name] => pear
            [0] => pear
            [colour] => green
            [1] => green
        )

    [2] => Array
        (
            [name] => watermelon
            [0] => watermelon
            [colour] => pink
            [1] => pink
        )
)

Exempel 2: Hämta värden från en enda kolumn

<?php
$sth = $dbh->prepare("SELECT name, colour FROM fruit");
$sth->execute();

/* Hämta alla värden från den första kolumnen */
$result = $sth->fetchAll(PDO::FETCH_COLUMN, 0);
var_dump($result);
?>

Möjlig utdata:

array(3) {
  [0] => string(5) "apple"
  [1] => string(4) "pear"
  [2] => string(10) "watermelon"
}

Exempel 3: Gruppera värden efter en kolumn

<?php
$insert = $dbh->prepare("INSERT INTO fruit(name, colour) VALUES (?, ?)");
$insert->execute(array('apple', 'green'));
$insert->execute(array('pear', 'yellow'));

$sth = $dbh->prepare("SELECT name, colour FROM fruit");
$sth->execute();

/* Gruppera värden efter första kolumnen */
var_dump($sth->fetchAll(PDO::FETCH_COLUMN|PDO::FETCH_GROUP));
?>

Möjlig utdata:

array(3) {
  ["apple"]=>
  array(2) {
    [0]=>
    string(5) "green"
    [1]=>
    string(3) "red"
  }
  ["pear"]=>
  array(2) {
    [0]=>
    string(5) "green"
    [1]=>
    string(6) "yellow"
  }
  ["watermelon"]=>
  array(1) {
    [0]=>
    string(5) "pink"
  }
}

Exempel 4: Instansiera en klass för varje rad

<?php
class fruit {
    public $name;
    public $colour;
}

$sth = $dbh->prepare("SELECT name, colour FROM fruit");
$sth->execute();

$result = $sth->fetchAll(PDO::FETCH_CLASS, "fruit");
var_dump($result);
?>

Möjlig utdata:

array(3) {
  [0]=>
  object(fruit)#1 (2) {
    ["name"]=>
    string(5) "apple"
    ["colour"]=>
    string(5) "green"
  }
  [1]=>
  object(fruit)#2 (2) {
    ["name"]=>
    string(4) "pear"
    ["colour"]=>
    string(6) "yellow"
  }
  [2]=>
  object(fruit)#3 (2) {
    ["name"]=>
    string(10) "watermelon"
    ["colour"]=>
    string(4) "pink"
  }
}

Exempel 5: Anropa en funktion för varje rad

<?php
function fruit($name, $colour) {
    return "{$name}: {$colour}";
}

$sth = $dbh->prepare("SELECT name, colour FROM fruit");
$sth->execute();

$result = $sth->fetchAll(PDO::FETCH_FUNC, "fruit");
var_dump($result);
?>

Möjlig utdata:

array(3) {
  [0]=>
  string(12) "apple: green"
  [1]=>
  string(12) "pear: yellow"
  [2]=>
  string(16) "watermelon: pink"
}

Se även

• PDO::query() - Förbereder och exekverar ett SQL-uttryck utan platshållare
• PDOStatement::fetch() - Hämtar nästa rad från en resultatuppsättning
• PDOStatement::fetchColumn() - Returnerar en enstaka kolumn från nästa rad i en resultatuppsättning
• PDO::prepare() - Förbereder ett uttryck för exekvering och returnerar ett statement-objekt
• PDOStatement::setFetchMode() - Ställer in standardhämtläget för detta statement

Sidslut

Orginalhemsidan på Engelska :https://www.php.net/manual/en/pdostatement.fetchall.php
PHP Funktioner Funktionsreferens Databas-tillägg

---

Det här är en maskinöversättning av PHP-manualen till svenska. Om du hittar fel är vi tacksamma om du rapporterar dem via formuläret som finns på https://www.linux.se/kontaka-linux-se/

Tack till Datorhjälp Huddinge som har sponsrat Linux.se med webbhotell.