略微加速

PHP官方手册 - 互联网笔记

PHP - Manual: PDO::pgsqlCopyFromArray

2024-12-20

PDO::pgsqlCopyFromArray

(PHP 5 >= 5.3.3, PHP 7, PHP 8)

PDO::pgsqlCopyFromArrayCopy data from PHP array into table

说明

public PDO::pgsqlCopyFromArray(
    string $table_name,
    array $rows,
    string $delimiter = "\t",
    string $null_as = "\\\\N",
    string $fields = ?
): bool

Copies data from rows array to table table_name using delimiter as fields delimiter and fields list

参数

table_name

String containing table name

rows

Array of strings with fields separated by delimiter

delimiter

Delimiter used in rows array

null_as

How to interpret null values

fields

List of fields to insert

返回值

Returns true on success, 或者在失败时返回 false.

add a noteadd a note

User Contributed Notes 1 note

up
3
Anonymous
6 years ago
If your $nullAs is '\\N', then you should use $nullAs as is in concatenation of cells of $rows, but send to pgsqlCopyFromArray() escaped version. Also fifth arg $fields should be a SQL-valid string for the column_names placeholder in COPY statement of PostgreSQL.

I provide my smart wrapper for pgsqlCopyFromArray() which do this automatically.

<?php
/**
*
* @param PDO $db
* @param string $tableName
* @param string[] $fields List of fields names.
* @param array[] $records Two-demension array of cells (array of rows).
* @return boolean
*/
function pgInsertByCopy (PDO $db, $tableName, array $fields, array $records) {
    static
$delimiter = "\t", $nullAs = '\\N';

   
$rows = [];

    foreach (
$records as $record) {
       
$record = array_map(
                function  (
$field) use( $record, $delimiter, $nullAs) {
                   
$value = array_key_exists($field, $record) ? $record[$field] : null;

                    if (
is_null($value)) {
                       
$value = $nullAs;
                    } elseif (
is_bool($value)) {
                       
$value = $value ? 't' : 'f';
                    }

                   
$value = str_replace($delimiter, ' ', $value);
                   
// Convert multiline text to one line.
                   
$value = addcslashes($value, "\0..\37");

                    return
$value;
                },
$fields);
       
$rows[] = implode($delimiter, $record) . "\n";
    }

    return
$db->pgsqlCopyFromArray($tableName, $rows, $delimiter, addslashes($nullAs), implode(',', $fields));
}
?>

官方地址:https://www.php.net/manual/en/pdo.pgsqlcopyfromarray.php

北京半月雨文化科技有限公司.版权所有 京ICP备12026184号-3