# pg_copy_from

(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

pg_copy_from — Insère des lignes dans une table à partir d'un tableau

### Description

pg_copy_from(
PgSql\Connection `$connection`,
string `$table_name`,
array `$rows`,
string `$separator` = "\t",
string `$null_as` = "\\\\N"
): bool

pg_copy_from() insère les éléments du tableau `rows` dans une table. Cette fonction utilise la commande SQL interne `COPY FROM`.

### Liste de paramètres

`connection`

  Une instance PgSql\Connection.

`table_name`

  Nom de la table dans laquelle `rows` sera copié.

`rows`

  Un tableau de données à être copié à l'intérieur de `table_name`. Chaque valeur dans `rows` devient une ligne dans `table_name`. Chaque valeur dans `rows` devrait être une chaîne délimitée par des valeurs à insérer à l'intérieur de chaque champ. Les valeurs doivent être terminées par un saut à la ligne.

`separator`

  Le marqueur qui sépare les valeurs pour chaque champ dans chaque élément de `rows`. Par défaut `\t`.

`null_as`

  Comment les valeurs `NULL` de SQL sont représentées dans `rows`. Par défaut `\\N` (`"\\\\N"`).

### Valeurs de retour

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

### Historique

Version | Description
--- | ---
8.1.0 | Le paramètre `connection` attend désormais une instance de PgSql\Connection ; auparavant, une resource était attendu.

### Exemples

Exemple #1 Exemple avec pg_copy_from()

`<?php
$db = pg_connect("dbname=publisher") or die("Connexion impossible");
$rows = pg_copy_to($db, $table_name);
pg_query($db, "DELETE FROM $table_name");
pg_copy_from($db, $table_name, $rows);
?>`

### Voir aussi

- pg_copy_to() - Copie une table dans un tableau