Pdo\Pgsql::copyFromArray

(PHP 8 >= 8.4.0)

Pdo\Pgsql::copyFromArray — Copia dados de um array PHP para uma tabela

Descrição

public function Pdo\Pgsql::copyFromArray(
    string $tableName,
    array|Traversable $rows,
    string $separator = "\t",
    string $nullAs = "\\\\N",
    ?string $fields = null
): bool

Copia dados do array rows para a tabela tableName usando separator como delimitador de campos e uma lista de campos no parâmetro fields.

Parâmetros

tableName

String contendo o nome da tabela.

rows

Um array indexado (ou Traversable) de strings com campos separados por separator.

separator

Delimitador usado para separar campos em uma entrada do array rows.

nullAs

Como interpretar valores SQL NULL.

fields

Lista de campos a serem inseridos.

Valor Retornado

Retorna true em caso de sucesso ou false em caso de falha.

Registro de Alterações

Versão Descrição
8.5.0 rows agora aceira um Traversable; anteriormente somente um array era aceito.

Examples

Exemplo #1 Exemplo de Pdo\Pgsql::copyFromArray()

Cada elemento de rows é um registro cujos campos são conectados por separator (uma tabulação por padrão). 

<?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)');

$rows = [
    "1\tapple\t10",
    "2\tbanana\t20",
    "3\tcherry\t30",
];
$db->copyFromArray('fruits', $rows);

foreach ($db->query('SELECT * FROM fruits ORDER BY id') as $row) {
    echo "{$row['id']} {$row['name']} {$row['qty']}\n";
}
?>

O exemplo acima produzirá:

1 apple 10
2 banana 20
3 cherry 30

Veja também

Melhore Esta Página

Aprenda Como Melhorar Esta Página • Envie uma Solicitação de Modificação • Reporte um Problema
＋adicionar nota

Notas de Usuários

Não há notas de usuários para esta página.