Copie des données d'une table dans un fichier

# Pdo\Pgsql::copyToFile

(PHP 8 >= 8.4.0)

Pdo\Pgsql::copyToFile — Copie des données d'une table dans un fichier

### Description

public function Pdo\Pgsql::copyToFile(
string `$tableName`,
string `$filename`,
string `$separator` = "\t",
string `$nullAs` = "\\\\N",
?string `$fields` = `null`
): bool

Copie des données de la table dans le fichier spécifié par `filename` en utilisant `separator` comme délimiteur de champs et la liste `fields`.

### Liste de paramètres

`tableName`
  Une chaîne de caractères contenant le nom de la table.
`filename`
  Le nom du fichier où exporter les données.
`separator`
  Un délimiteur utilisé pour séparer les champs dans une entrée du tableau `rows`.
`nullAs`
  Comment interpréter les valeurs `NULL`.
`fields`
  La liste des champs à exporter.

### Valeurs de retour

Cette fonction retourne `true` en cas de succès ou `false` si une erreur survient.

### Erreurs / Exceptions

Si `filename` ne peut pas être ouvert en écriture, ou ne peut pas être écrit, l'échec est signalé via la gestion des erreurs de la connexion (voir `PDO::ATTR_ERRMODE`) ; avec `PDO::ERRMODE_EXCEPTION`, une PDOException est levée.

### Exemples

Exemple #1 Exemple avec Pdo\Pgsql::copyToFile()

La table est écrite dans `filename`, un enregistrement par ligne, les champs étant joints par `separator`.

    <?php
    $db = new Pdo\Pgsql('pgsql:dbname=test host=localhost', $user, $pass);
    $db->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
    $db->exec('CREATE TABLE fruits (id int, name text, qty int)');
    $db->exec("INSERT INTO fruits VALUES (1, 'apple', 10), (2, 'banana', 20)");

    $db->copyToFile('fruits', '/tmp/fruits.tsv');
    echo file_get_contents('/tmp/fruits.tsv');
    ?>

L'exemple ci-dessus va afficher :

    1	apple	10
    2	banana	20

### Voir aussi

- Pdo\Pgsql::copyFromFile() - Copie des données d'un fichier dans une table
- Pdo\Pgsql::copyFromArray() - Copie des données d'un tableau PHP dans une table
- Pdo\Pgsql::copyToArray() - Copie des données d'une table dans un tableau PHP

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open