Pdo\Pgsql::copyToFile

(PHP 8 >= 8.4.0)

Pdo\Pgsql::copyToFile — Копирует данные из таблицы в файл

Описание

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

Метод соединяет значения списка полей fields из таблицы filename разделителем separator и копирует данные в файл.

Список параметров

tableName: Строка с названием таблицы.
filename: Имя файла для экспорта данных.
separator: Разделитель, по которому записи массива rows разбираются на значения полей.
nullAs: Строка, которая интерпретируется как SQL-значение NULL.
fields: Список полей для экспорта.

Возвращаемые значения

Функция возвращает true, если выполнилась успешно, или false, если возникла ошибка.

Ошибки

При ошибке открытия файла filename для чтения или записи о сбое сообщается через механизм обработки ошибок соединения, который устанавливается через атрибут PDO::ATTR_ERRMODE; в режиме PDO::ERRMODE_EXCEPTION выбрасывается исключение PDOException.

Примеры

Пример #1 Пример копирования данных в файл методом Pdo\Pgsql::copyToFile()

Значения полей таблицы соединяются разделителем separator и записываются в файл filename по одной записи на каждой строке.

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

Результат выполнения приведённого примера:

1	apple	10
2	banana	20

Смотрите также

Pdo\Pgsql::copyFromFile() - Копирует данные из файла в таблицу
Pdo\Pgsql::copyFromArray() - Копирует данные из PHP-массива в таблицу
Pdo\Pgsql::copyToArray() - Копирует данные из таблицы базы данных в PHP-массив

Нашли ошибку?

Инструкция • Исправление • Сообщение об ошибке

＋Добавить

Примечания пользователей

Пользователи ещё не добавляли примечания для страницы