From 4b4f2da7119662ce7f6fc34bf7adec490999602b Mon Sep 17 00:00:00 2001 From: leonardolara Date: Wed, 4 Dec 2024 15:59:57 -0300 Subject: [PATCH] sync reference/pdo* with en revision --- reference/pdo/pdo/construct.xml | 7 +- reference/pdo_dblib/reference.xml | 5 +- reference/pdo_firebird/constants.xml | 11 +- reference/pdo_firebird/reference.xml | 5 +- reference/pdo_mysql/configure.xml | 15 +- reference/pdo_mysql/constants.xml | 180 +++++------- reference/pdo_mysql/reference.xml | 5 +- reference/pdo_odbc/constants.xml | 74 ++--- reference/pdo_odbc/reference.xml | 5 +- .../pdo_pgsql/PDO/pgsqlCopyFromArray.xml | 79 +----- reference/pdo_pgsql/PDO/pgsqlCopyFromFile.xml | 79 +----- reference/pdo_pgsql/PDO/pgsqlCopyToArray.xml | 70 +---- reference/pdo_pgsql/PDO/pgsqlCopyToFile.xml | 79 +----- reference/pdo_pgsql/PDO/pgsqlGetNotify.xml | 52 +--- reference/pdo_pgsql/PDO/pgsqlGetPid.xml | 24 +- reference/pdo_pgsql/PDO/pgsqlLOBCreate.xml | 93 +------ reference/pdo_pgsql/PDO/pgsqlLOBOpen.xml | 100 +------ reference/pdo_pgsql/PDO/pgsqlLOBUnlink.xml | 81 +----- reference/pdo_pgsql/constants.xml | 31 +-- reference/pdo_pgsql/reference.xml | 10 +- .../pdo_sqlite/PDO/sqliteCreateAggregate.xml | 259 +----------------- .../pdo_sqlite/PDO/sqliteCreateCollation.xml | 89 +----- .../pdo_sqlite/PDO/sqliteCreateFunction.xml | 180 +----------- reference/pdo_sqlite/reference.xml | 5 +- 24 files changed, 257 insertions(+), 1281 deletions(-) diff --git a/reference/pdo/pdo/construct.xml b/reference/pdo/pdo/construct.xml index 4d3a9d4a8..2c5dc5158 100644 --- a/reference/pdo/pdo/construct.xml +++ b/reference/pdo/pdo/construct.xml @@ -1,5 +1,5 @@ - + PDO::__construct @@ -114,8 +114,9 @@ &reftitle.errors; - PDO::__construct lança uma exceção PDOException se a tentativa - de conexão ao banco de dados requisitado falhar, independente de qual PDO::ATTR_ERRMODE estiver definido. + Uma PDOException é lançada se a tentativa + de conexão ao banco de dados requisitado falhar, + independente de qual PDO::ATTR_ERRMODE estiver definido. diff --git a/reference/pdo_dblib/reference.xml b/reference/pdo_dblib/reference.xml index d387fd98f..8579ee6f7 100644 --- a/reference/pdo_dblib/reference.xml +++ b/reference/pdo_dblib/reference.xml @@ -1,5 +1,5 @@ - + @@ -7,7 +7,7 @@ MS SQL Server (PDO) -
+
&reftitle.intro; PDO_DBLIB é um driver que implementa a interface @@ -120,6 +120,7 @@ dblib:host=localhost;dbname=testdb + &reference.pdo-dblib.pdo-dblib; -
+ +
&reftitle.constants; &pdo.driver-constants; @@ -11,7 +11,7 @@ - Define o formato de data. + &Alias; Pdo\Firebird::ATTR_DATE_FORMAT. @@ -22,7 +22,7 @@ - Define o formato de horário. + &Alias; Pdo\Firebird::ATTR_TIME_FORMAT. @@ -33,13 +33,12 @@ - Define o formato de timestamp. + &Alias; Pdo\Firebird::ATTR_TIMESTAMP_FORMAT.
- + @@ -7,7 +7,7 @@ Firebird (PDO) -
+
&reftitle.intro; PDO_FIREBIRD é um driver que implementa a interface aos Objetos de Dados PHP (PDO) @@ -128,6 +128,7 @@ firebird:dbname=localhost:/var/lib/firebird/2.5/data/teste.fdb;charset=utf-8;dia + &reference.pdo-firebird.pdo-firebird; +
&reftitle.install; @@ -48,11 +48,14 @@ $ ./configure --with-pdo-mysql --with-mysql-sock=/var/mysql/mysql.sock - O suporte a SSL pode ser habilitado usando as constantes PDO_MySQL apropriadas, - que é o equivalente a chamar a função mysql_ssl_set() da API C do MySQL. - Além disso, o SSL não pode ser habilitado com PDO::setAttribute porque a conexão - já existirá. Consulte também a documentação do MySQL sobre conexão ao - MySQL com SSL. + O suporte a SSL é habilitado usando as constantes + Pdo\Mysql::ATTR_SSL_* apropriadas, + que é o equivalente a chamar a + função mysql_ssl_set() da API C do MySQL. + Além disso, o SSL não pode ser habilitado com PDO::setAttribute + porque a conexão já existirá. + Consulte também a documentação do MySQL sobre + conexão ao MySQL com SSL.
diff --git a/reference/pdo_mysql/constants.xml b/reference/pdo_mysql/constants.xml index 175abc80e..6ad828999 100644 --- a/reference/pdo_mysql/constants.xml +++ b/reference/pdo_mysql/constants.xml @@ -1,6 +1,6 @@ - -
+ +
&reftitle.constants; &pdo.driver-constants; @@ -11,29 +11,8 @@ - Por padrão todas as instruções são executadas com - buffer ativo. - Se este atributo for definido para &false; em um objeto - PDO, o driver MySQL usará o modo - sem buffer. + &Alias; Pdo\Mysql::ATTR_USE_BUFFERED_QUERY. - - Configurando o modo sem buffer no MySQL - -setAttribute(PDO::MYSQL_ATTR_USE_BUFFERED_QUERY, false); - -$unbufferedResult = $pdo->query("SELECT Nome FROM Cidades"); -foreach ($unbufferedResult as $row) { - echo $row['Nome'] . PHP_EOL; -} -?> -]]> - - - @@ -42,45 +21,32 @@ foreach ($unbufferedResult as $row) { (int) - - Habilita LOAD LOCAL INFILE. - - - Observe que essa constante só pode ser usada no array driver_options - ao construir um novo manipulador de banco de dados. - + + &Alias; Pdo\Mysql::ATTR_LOCAL_INFILE + PDO::MYSQL_ATTR_LOCAL_INFILE_DIRECTORY - (string) + (int) - - Permite restringir o carregamento através de "LOCAL DATA" a arquivos localizados neste - diretório designado. Disponível a partir do PHP 8.1.0. - - - Observe que esta constante só pode ser usada no array driver_options - ao construir um novo manipulador de banco de dados. - + + &Alias; Pdo\Mysql::ATTR_LOCAL_INFILE_DIRECTORY. + Disponível a partir do PHP 8.1.0. + PDO::MYSQL_ATTR_INIT_COMMAND - (string) + (int) - - Comando para executar ao se conectar no servidor MySQL. Irá - ser executado novamente ao reconectar. - - - Observe que essa constante só pode ser usada no array driver_options - ao construir um novo manipulador de banco de dados. - + + &Alias; Pdo\Mysql::ATTR_INIT_COMMAND. + @@ -89,12 +55,9 @@ foreach ($unbufferedResult as $row) { (int) - - Lê configurações do arquivo definido nas opções ao invés do arquivo - my.cnf. Essa opção não está disponível se - o mysqlnd for usado, porque o mysqlnd não lê os arquivos de - configurações do mysql. - + + &Alias; Pdo\Mysql::ATTR_READ_DEFAULT_FILE. + @@ -103,12 +66,9 @@ foreach ($unbufferedResult as $row) { (int) - - Lê configurações do grupo nomeado em my.cnf ou no - arquivo especificado com MYSQL_READ_DEFAULT_FILE. Essa opção - não está disponível se o mysqlnd for usado, porque o mysqlnd não lê os arquivos de - configurações do mysql. - + + &Alias; Pdo\Mysql::ATTR_READ_DEFAULT_GROUP. + @@ -117,10 +77,9 @@ foreach ($unbufferedResult as $row) { (int) - - Tamanho máximo do buffer. O padrão é 1 MiB. Essa constante não é suportada quando - o mysqlnd é utilizado. - + + &Alias; Pdo\Mysql::ATTR_MAX_BUFFER_SIZE. + @@ -129,9 +88,9 @@ foreach ($unbufferedResult as $row) { (int) - - Executa consultas diretamente, não usa instruções preparadas. - + + &Alias; PDO::ATTR_EMULATE_PREPARES. + @@ -140,10 +99,9 @@ foreach ($unbufferedResult as $row) { (int) - - Retorna a quantidade de linhas correspondidas, e não a - quantidade de linhas modificadas. - + + &Alias; Pdo\Mysql::ATTR_FOUND_ROWS. + @@ -152,10 +110,9 @@ foreach ($unbufferedResult as $row) { (int) - - Permite espaços depois do nome das funções. Torna o nome de todas as funções - palavras reservadas. - + + &Alias; Pdo\Mysql::ATTR_IGNORE_SPACE. + @@ -164,9 +121,21 @@ foreach ($unbufferedResult as $row) { (int) - - Habilita a compressão na comunicação de rede. - + + &Alias; Pdo\Mysql::ATTR_COMPRESS. + + + + + + + PDO::MYSQL_ATTR_SERVER_PUBLIC_KEY + (int) + + + + &Alias; Pdo\Mysql::ATTR_SERVER_PUBLIC_KEY. + @@ -176,9 +145,9 @@ foreach ($unbufferedResult as $row) { (int) - - Caminho para o arquivo da autoridade certificadora (CA) SSL. - + + &Alias; Pdo\Mysql::ATTR_SSL_CA. + @@ -188,10 +157,9 @@ foreach ($unbufferedResult as $row) { (int) - - Caminho para o diretório que contém os certificados SSL confiáveis da autoridade - certificadora (CA), armazenados no formato PEM. - + + &Alias; Pdo\Mysql::ATTR_SSL_CAPATH. + @@ -201,9 +169,9 @@ foreach ($unbufferedResult as $row) { (int) - - Caminho para o certificado SSL. - + + &Alias; Pdo\Mysql::ATTR_SSL_CERT. + @@ -213,10 +181,9 @@ foreach ($unbufferedResult as $row) { (int) - - Uma lista de uma ou mais cifras admissíveis para usar na encriptação SSL, em um formato - compreendido pelo OpenSSL. Por exemplo: DHE-RSA-AES256-SHA:AES128-SHA - + + &Alias; Pdo\Mysql::ATTR_SSL_CIPHER. + @@ -226,9 +193,9 @@ foreach ($unbufferedResult as $row) { (int) - - Caminho para a chave SSL. - + + &Alias; Pdo\Mysql::ATTR_SSL_KEY. + @@ -238,13 +205,9 @@ foreach ($unbufferedResult as $row) { (int) - - Fornece uma maneira de desabilitar verificação do certificado SSL do servidor. - Esta opção está disponível somente com mysqlnd. - - - &version.exists.asof; 7.0.18 and PHP 7.1.4. - + + &Alias; Pdo\Mysql::ATTR_SSL_VERIFY_SERVER_CERT. + @@ -254,14 +217,9 @@ foreach ($unbufferedResult as $row) { (int) - - Desabilita a execução de consultas múltiplas nas funções PDO::prepare - e PDO::query quando definido como &false;. - - - Note que essa constante só pode ser usada no array driver_options - ao construir um novo manipulador de banco de dados. - + + &Alias; Pdo\Mysql::ATTR_MULTI_STATEMENTS. + diff --git a/reference/pdo_mysql/reference.xml b/reference/pdo_mysql/reference.xml index 672ba6227..11c530ce0 100644 --- a/reference/pdo_mysql/reference.xml +++ b/reference/pdo_mysql/reference.xml @@ -1,5 +1,5 @@ - + @@ -7,7 +7,7 @@ MySQL (PDO) -
+
&reftitle.intro; PDO_MYSQL é um driver que implementa a interface PHP @@ -167,6 +167,7 @@ mysql:unix_socket=/tmp/mysql.sock;dbname=testdb +&reference.pdo-mysql.pdo-mysql; + -
+
&reftitle.constants; &pdo.driver-constants; @@ -22,31 +22,42 @@ (int) - - Esta opção controla se a biblioteca de cursores ODBC é usada. A biblioteca de cursores - ODBC oferece suporte a alguns recursos ODBC avançados (por exemplo, cursores roláveis ​​em bloco), que - podem não estar implementados pelo driver. Os seguintes valores são suportados: - - - - PDO::ODBC_SQL_USE_IF_NEEDED (o padrão): - usa a biblioteca de cursores ODBC quando necessário. - - - - - PDO::ODBC_SQL_USE_DRIVER: - nunca usa a biblioteca de cursores ODBC - - - - - PDO::ODBC_SQL_USE_ODBC: - sempre usa a biblioteca de cursores ODBC - - - - + + &Alias; Pdo\Odbc::ATTR_USE_CURSOR_LIBRARY. + + + + + + PDO::ODBC_SQL_USE_IF_NEEDED + (int) + + + + &Alias; Pdo\Odbc::SQL_USE_IF_NEEDED. + + + + + + PDO::ODBC_SQL_USE_DRIVER + (int) + + + + &Alias; Pdo\Odbc::SQL_USE_DRIVER. + + + + + + PDO::ODBC_SQL_USE_ODBC + (int) + + + + &Alias; Pdo\Odbc::SQL_USE_ODBC. + @@ -55,12 +66,9 @@ (bool) - - Somente Windows. Se &true;, os dados de caracteres codificados em UTF-16 (CHAR, - VARCHAR e LONGVARCHAR) serão convertidos para - UTF-8 ao ler ou gravar dados no banco de dados. - Se &false; (o padrão), a conversão da codificação de caracteres pode ser feita pelo driver. - + + &Alias; Pdo\Odbc::ATTR_ASSUME_UTF8. + diff --git a/reference/pdo_odbc/reference.xml b/reference/pdo_odbc/reference.xml index 9a1d5515b..b10d7c938 100644 --- a/reference/pdo_odbc/reference.xml +++ b/reference/pdo_odbc/reference.xml @@ -1,5 +1,5 @@ - + @@ -7,7 +7,7 @@ ODBC e DB2 (PDO) -
+
&reftitle.intro; PDO_ODBC é um driver que implementa a interface aos Objetos @@ -160,6 +160,7 @@ odbc:Driver={Microsoft Access Driver (*.mdb)};Dbq=C:\\db.mdb;Uid=Admin +&reference.pdo-odbc.pdo-odbc; + PDO::pgsqlCopyFromArray - Copia dados de array PHP para tabela + + &Alias; Pdo\Pgsql::copyFromArray + &reftitle.description; - public bool PDO::pgsqlCopyFromArray - stringtable_name + public boolPDO::pgsqlCopyFromArray + stringtableName arrayrows - stringdelimiter"\t" - stringnull_as"\\\\N" - stringfields + stringseparator"\t" + stringnullAs"\\\\N" + stringnullfields&null; - - Copia dados do array rows para a tabela table_name - usando delimiter como delimitador de campos e a lista de campos fields. - - - - - &reftitle.parameters; - - - - table_name - - - String contendo o nome da tabela - - - - - rows - - - Array de strings com campos separados por delimiter - - - - - delimiter - - - Delimitador usado no array rows - - - - - null_as - - - Define como os valores nulos devem ser interpretados - - - - - fields - - - Lista de campos a serem inseridos - - - - - - - - - &reftitle.returnvalues; - - Retorna &true; em caso de sucesso,&return.falseforfailure;. - + + &info.method.alias; Pdo\Pgsql::copyFromArray. + - + PDO::pgsqlCopyFromFile - Copia dados de arquivo para tabela + + &Alias; Pdo\Pgsql::copyFromFile + &reftitle.description; - public bool PDO::pgsqlCopyFromFile - stringtable_name + public boolPDO::pgsqlCopyFromFile + stringtableName stringfilename - stringdelimiter"\t" - stringnull_as"\\\\N" - stringfields + stringseparator"\t" + stringnullAs"\\\\N" + stringnullfields&null; - - Copia dados do arquivo especificado por filename na tabela table_name - usando delimiter como delimitador de campos e a lista de campos fields. - - - - - &reftitle.parameters; - - - - table_name - - - String contendo o nome da tabela - - - - - filename - - - Nome do arquivo contendo dados a serem importados - - - - - delimiter - - - Delimitador usado no arquivo especificado por filename - - - - - null_as - - - Define como os valores nulos devem ser interpretados - - - - - fields - - - Lista de campos a serem inseridos - - - - - - - - - &reftitle.returnvalues; - - Retorna &true; em caso de sucesso,&return.falseforfailure;. - + + &info.method.alias; Pdo\Pgsql::copyFromFile. + - + PDO::pgsqlCopyToArray - Copia dados de tabela do banco de dados para array PHP + + &Alias; Pdo\Pgsql::copyToArray + &reftitle.description; - public arrayfalse PDO::pgsqlCopyToArray - stringtable_name - stringdelimiter"\t" - stringnull_as"\\\\N" - stringfields + public arrayfalsePDO::pgsqlCopyToArray + stringtableName + stringseparator"\t" + stringnullAs"\\\\N" + stringnullfields&null; - - Copia dados da tabela table para um array usando delimiter como delimitador de campos e a lista de campos em fields. - - - - - &reftitle.parameters; - - - - table_name - - - String contendo o nome da tabela - - - - - delimiter - - - Delimitador usado nas linhas - - - - - null_as - - - Define como os valores nulos devem ser interpretados - - - - - fields - - - Lista de campos a exportar - - - - - - - - - &reftitle.returnvalues; - - Retorna um array de linhas,&return.falseforfailure;. - + + &info.method.alias; Pdo\Pgsql::copyToArray. + - + PDO::pgsqlCopyToFile - Copia dados de tabela para arquivo + + &Alias; Pdo\Pgsql::copyToFile + &reftitle.description; - public bool PDO::pgsqlCopyToFile - stringtable_name + public boolPDO::pgsqlCopyToFile + stringtableName stringfilename - stringdelimiter"\t" - stringnull_as"\\\\N" - stringfields + stringseparator"\t" + stringnullAs"\\\\N" + stringnullfields&null; - - Copia dados da tabela para o arquivo especificado por filename usando - delimiter como delimitador de campos e a lista de campos em fields. - - - - - &reftitle.parameters; - - - - table_name - - - String contendo o nome da tabela - - - - - filename - - - Nome do arquivo onde os dados serão exportados - - - - - delimiter - - - Delimitador usado no arquivo especificado por filename - - - - - null_as - - - Define como os valores nulos devem ser interpretados - - - - - fields - - - Lista de campos a inserir - - - - - - - - - &reftitle.returnvalues; - - Retorna &true; em caso de sucesso,&return.falseforfailure;. - + + &info.method.alias; Pdo\Pgsql::copyToFile. + - + PDO::pgsqlGetNotify - Obtém notificação assíncrona + + &Alias; Pdo\Pgsql::getNotify + &reftitle.description; public arrayfalsePDO::pgsqlGetNotify - intresult_typePDO::FETCH_USE_DEFAULT - intms_timeout0 + intfetchModePDO::FETCH_DEFAULT + inttimeoutMilliseconds0 - - Retorna um conjunto de resultados representando uma notificação assíncrona pendente. - - - - - &reftitle.parameters; - - - - result_type - - - O formato no qual o conjunto de resultados deve ser retornado, representando como uma - constante - PDO::FETCH_*. - - - - - ms_timeout - - - O tempo a esperar por uma resposta, em milissegundos. - - - - - - - - - &reftitle.returnvalues; - - Se uma ou mais notificações estiverem pendentes, retorna uma única linha, com os campos - message e pid, caso contrário retorna - &false;. - + + &info.method.alias; Pdo\Pgsql::getNotify. + - + PDO::pgsqlGetPid - Obtém o PID do servidor + + &Alias; Pdo\Pgsql::getPid + &reftitle.description; @@ -11,21 +13,9 @@ public intPDO::pgsqlGetPid - - Retorna o PID do servidor. - - - - - &reftitle.parameters; - &no.function.parameters; - - - - &reftitle.returnvalues; - - O PID do servidor. - + + &info.method.alias; Pdo\Pgsql::getPid. + - + PDO::pgsqlLOBCreate - Cria um novo objeto grande + + &Alias; Pdo\Pgsql::lobCreate + &reftitle.description; @@ -12,91 +13,11 @@ public stringPDO::pgsqlLOBCreate - - PDO::pgsqlLOBCreate cria um objeto grande e - retorna o OID desse objeto. Pode-se então abrir um fluxo no objeto - usando PDO::pgsqlLOBOpen para ler ou gravar dados - nele. O OID pode ser armazenado em colunas do tipo OID e usado para fazer referência - ao objeto grande, sem fazer com que a linha cresça arbitrariamente. - O objeto grande continuará no banco de dados até - ser removido chamando PDO::pgsqlLOBUnlink. - - - Objetos grandes podem ter até 2 GB de tamanho, mas são complicados de usar; é necessário - garantir que PDO::pgsqlLOBUnlink seja chamado antes - de excluir a última linha que referencia seu OID no banco de dados. - Além disso, objetos grandes não possuem controles de acesso. Como alternativa, - pode-se experimentar o tipo de coluna bytea; versões recentes do PostgreSQL permitem colunas - bytea de até 1 GB de tamanho e gerenciam o armazenamento de forma transparente para - obter o tamanho de linha ideal. - - - - Esta função deve ser chamada dentro de uma transação. - - + + &info.method.alias; Pdo\Pgsql::lobCreate. + - - &reftitle.parameters; - - PDO::pgsqlLOBCreate não tem nenhum parâmetro. - - - - - &reftitle.returnvalues; - - Retorna o OID do objeto grande recentemente criado em caso de sucesso ou &false; - em caso de falha. - - - - - &reftitle.examples; - - - Um exemplo de <function>PDO::pgsqlLOBCreate</function> - - Este exemplo cria um novo objeto grande e copia nele o - conteúdo de um arquivo. O OID é então armazenado em uma tabela. - - -setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION); -$db->beginTransaction(); -$oid = $db->pgsqlLOBCreate(); -$stream = $db->pgsqlLOBOpen($oid, 'w'); -$local = fopen($filename, 'rb'); -stream_copy_to_stream($local, $stream); -$local = null; -$stream = null; -$stmt = $db->prepare("INSERT INTO BLOBS (ident, oid) VALUES (?, ?)"); -$stmt->execute(array($some_id, $oid)); -$db->commit(); -?> -]]> - - - - - - - - &reftitle.seealso; - - - PDO::pgsqlLOBOpen - PDO::pgsqlLOBUnlink - pg_lo_create - - - - - - - + PDO::pgsqlLOBOpen - Abre um fluxo de objeto grande existente + + &Alias; Pdo\Pgsql::lobOpen + &reftitle.description; @@ -13,98 +14,11 @@ stringoid stringmode"rb" - - PDO::pgsqlLOBOpen abre um fluxo para acessar os dados - referenciados pelo oid. Se mode - for igual a r, o fluxo é aberto para leitura, se - mode for igual a w, o fluxo será - aberto para escrita. Pode-se usar todas as funções de sistema de arquivo usuais, - como, por exemplo, fread, fwrite e - fgets, para manipular o conteúdo do fluxo. - - - - Esta função, e todas as manipulações do objeto grande, - devem ser chamadas e executadas dentro de uma transação. - - - - - &reftitle.parameters; - - - - oid - - - Um identificador de objeto grande. - - - - - mode - - - Se for igual a r, abra o fluxo para leitura. - Se for igual a w, abra o fluxo para escrita. - - - - - + + &info.method.alias; Pdo\Pgsql::lobOpen. + - - &reftitle.returnvalues; - - Retorna um recurso de fluxo em caso de sucesso&return.falseforfailure;. - - - - - &reftitle.examples; - - - Um exemplo de <function>PDO::pgsqlLOBOpen</function> - - Seguindo o exemplo de PDO::pgsqlLOBCreate, - este trecho de código recupera o objeto grande do - banco de dados e o envia para o navegador. - - -setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION); -$db->beginTransaction(); -$stmt = $db->prepare("select oid from BLOBS where ident = ?"); -$stmt->execute(array($some_id)); -$stmt->bindColumn('oid', $oid, PDO::PARAM_STR); -$stmt->fetch(PDO::FETCH_BOUND); -$stream = $db->pgsqlLOBOpen($oid, 'r'); -header("Content-type: application/octet-stream"); -fpassthru($stream); -?> -]]> - - - - - - - - &reftitle.seealso; - - - PDO::pgsqlLOBCreate - PDO::pgsqlLOBUnlink - pg_lo_open - - - - - - - + PDO::pgsqlLOBUnlink - Remove o objeto grande + + &Alias; Pdo\Pgsql::lobUnlink + &reftitle.description; @@ -12,79 +13,11 @@ public boolPDO::pgsqlLOBUnlink stringoid - - Remove um objeto grande, identificado pelo OID, do banco de dados. - - - - Esta função deve ser chamada dentro de uma transação. - - - + + &info.method.alias; Pdo\Pgsql::lobUnlink. + - - &reftitle.parameters; - - - - oid - - - Um identificador de objeto grande - - - - - - - - &reftitle.returnvalues; - - &return.success; - - - - - &reftitle.examples; - - - Um exemplo de <function>PDO::pgsqlLOBUnlink</function> - - Este exemplo desvincula um objeto grande do banco de dados antes de excluir - a linha que faz referência a ele da tabela de BLOBs usada nos exemplos - de PDO::pgsqlLOBCreate e - PDO::pgsqlLOBOpen. - - -setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION); -$db->beginTransaction(); -$db->pgsqlLOBUnlink($oid); -$stmt = $db->prepare("DELETE FROM BLOBS where ident = ?"); -$stmt->execute(array($some_id)); -$db->commit(); -?> -]]> - - - - - - - &reftitle.seealso; - - - PDO::pgsqlLOBOpen - PDO::pgsqlLOBCreate - - - - - - -
+ +
&reftitle.constants; &pdo.driver-constants; - PDO::PGSQL_ATTR_DISABLE_PREPARES (int) - - Envia a consulta e os parâmetros para o servidor juntos em uma única - chamada, evitando a necessidade de criar uma instrução preparada nomeada separadamente. - Se a consulta for executada apenas uma vez, isso pode reduzir a latência - evitando uma ida e volta desnecessária do servidor. - + + &Alias; Pdo\Pgsql::ATTR_DISABLE_PREPARES. + - - - - PDO::PGSQL_ATTR_RESULT_MEMORY_SIZE - (int) - - - - Retorna a quantidade de memória, em bytes, alocada para a instância - PDOStatement de resultado da consulta especificada, - ou &null; se nenhum resultado existir antes da consulta ser executada. - Disponível a partir do PHP 8.4.0. - - - -
- + @@ -7,7 +7,7 @@ PostgreSQL (PDO) -
+
&reftitle.intro; PDO_PGSQL é um driver que implementa a interface @@ -16,7 +16,7 @@
-
+
&reftitle.resources; Esta extensão define um recurso de fluxo retornado por @@ -27,7 +27,7 @@ &reference.pdo-pgsql.configure; &reference.pdo-pgsql.constants; -
+
Notas gerais @@ -153,7 +153,7 @@ pgsql:host=/tmp;port=5432;dbname=testdb;user=bruce;password=mypass &reference.pdo-pgsql.entities.PDO; - + &reference.pdo-pgsql.pdo-pgsql; + PDO::sqliteCreateAggregate - Registra uma função de agregação definida pelo usuário para uso em declarações SQL + &Alias; Pdo\Sqlite::createAggregate @@ -12,257 +12,16 @@ &reftitle.description; public boolPDO::sqliteCreateAggregate - stringfunction_name - callablestep_func - callablefinalize_func - intnum_args + stringname + callablestep + callablefinalize + intnumArgs-1 - &warn.experimental.func; - - Este método é semelhante a , - exceto que registra funções que podem ser usadas para calcular um resultado - agregado através de todas as linhas de uma consulta. - - - A principal diferença entre este método e - - é que duas funções são necessárias para gerenciar a agregação. - + + &info.method.alias; Pdo\Sqlite::createAggregate. + - - - &reftitle.parameters; - - - - function_name - - - O nome da função usada nas declarações SQL. - - - - - step_func - - - Função callback chamada para cada linha do conjunto de resultados. - A função PHP deve acumular o resultado e armazená-lo no contexto de - agregação. - - - Esta função precisa ser definida como: - - mixedstep - mixedcontext - intrownumber - mixedvalue - mixedvalues - - - - context - - - &null; para a primeira linha; nas linhas subsequentes terá o valor - que foi retornado anteriormente da função step; isso deve ser usado - para manter o estado de agregação. - - - - - rownumber - - - O número da linha atual. - - - - - value - - - O primeiro argumento passado para a agregação. - - - - - values - - - Outros argumentos passados para a agregação. - - - - - O valor retornado desta função será usado como o argumento - context na próxima chamada das funções step ou - finalize. - - - - - finalize_func - - - Função de chamada de retorno para agregar os dados "passados" de cada linha. - Depois que todas as linhas forem processadas, esta função será chamada e - deverá então pegar os dados do contexto de agregação e retornar o - resultado. Esta função deve retornar um tipo reconhecido pelo SQLite - (ou seja, um - tipo escalar). - - - Esta função precisa ser definida como: - - mixedfini - mixedcontext - introwcount - - - - context - - - Contém o valor retornado da última chamada à função step. - - - - - rowcount - - - Contém o número de linhas nas quais a agregação foi executada. - - - - - O valor retornado desta função será usado como valor retornado da - agregação. - - - - - num_args - - - Indica ao analisador SQLite se a função callback aceita um número - predeterminado de argumentos. - - - - - - - - - &reftitle.returnvalues; - - &return.success; - - - - - &reftitle.examples; - - - Exemplo de função de agregação max_length - - exec("CREATE TABLE strings(a)"); -$insert = $db->prepare('INSERT INTO strings VALUES (?)'); -foreach ($dados as $string) { - $insert->execute(array($string)); -} -$insert = null; - -function max_len_step($context, $rownumber, $string) -{ - if (strlen($string) > $context) { - $context = strlen($string); - } - return $context; -} - -function max_len_finalize($context, $rowcount) -{ - return $context === null ? 0 : $context; -} - -$db->sqliteCreateAggregate('max_len', 'max_len_step', 'max_len_finalize'); - -var_dump($db->query('SELECT max_len(a) from strings')->fetchAll()); - -?> -]]> - - - - - Neste exemplo, está sendo criada uma função de agregação que irá calcular o - comprimento da string mais longa de uma das colunas da tabela. - Para cada linha, a função max_len_step é chamada e recebe - um parâmetro $context. O parâmetro de contexto - é como qualquer outra variável PHP e pode conter um array ou até - mesmo um valor de objeto. Neste exemplo, ele está sendo usado apenas para - manter o comprimento máximo visto até agora; se a - $string tiver um comprimento maior que o máximo - atual, o contexto será atualizado para conter esse novo comprimento máximo. - - - Após todas as linhas terem sido processadas, o SQLite chama a função - max_len_finalize para determinar o resultado agregado. - Aqui, algum tipo de cálculo poderia ser realizado com base nos dados - encontrados no parâmetro $context. - Porém, neste exemplo simples, o resultado foi calculado à medida que a - consulta avançava, portanto é necessário apenas retornar o valor do contexto. - - - - NÃO é recomendado armazenar uma cópia dos valores no - contexto e depois processá-los no final, pois isso faria com que o SQLite - usasse muita memória para processar a consulta - basta pensar em quanta - memória seria necessária se um milhão linhas fossem armazenadas na memória, - cada uma contendo uma string de 32 bytes de comprimento. - - - - - e - - podem ser usados para substituir funções SQL nativas do SQLite. - - - - - - - &reftitle.seealso; - - - - sqlite_create_function - sqlite_create_aggregate - - - - - + PDO::sqliteCreateCollation - Registra uma Função Definida pelo Usuário para uso como função de collation em declarações SQL + &Alias; Pdo\Sqlite::createCollation @@ -15,90 +15,11 @@ stringname callablecallback - &warn.experimental.func; - - - - &reftitle.parameters; - - - - name - - - Nome da função de collation SQL a ser criada ou redefinida. - - - - - callback - - - O nome de uma função PHP ou função definida pelo usuário a ser aplicada como chamada de retorno, definindo o comportamento da collation. Ela deve aceitar duas strings e retornar como strcmp(), ou seja, deve retornar -1, 1 ou 0 se a primeira string for ordenada antes, depois ou for igual à segunda. - - - Esta função precisa ser definida como: - - intcollation - stringstring1 - stringstring2 - - - - - - - - - - &reftitle.returnvalues; - - &return.success; - - - - - &reftitle.examples; - - - Exemplo de <function>PDO::sqliteCreateCollation</function> - -exec("CREATE TABLE test (col1 string)"); -$db->exec("INSERT INTO test VALUES ('a1')"); -$db->exec("INSERT INTO test VALUES ('a10')"); -$db->exec("INSERT INTO test VALUES ('a2')"); - -$db->sqliteCreateCollation('NATURAL_CMP', 'strnatcmp'); -foreach ($db->query("SELECT col1 FROM test ORDER BY col1") as $row) { - echo $row['col1'] . "\n"; -} -echo "\n"; -foreach ($db->query("SELECT col1 FROM test ORDER BY col1 COLLATE NATURAL_CMP") as $row) { - echo $row['col1'] . "\n"; -} -?> -]]> - - &example.outputs; - - - - - + + &info.method.alias; Pdo\Sqlite::createCollation. + - + PDO::sqliteCreateFunction - Registra uma Função Definida pelo Usuário para uso em declarações SQL + &Alias; Pdo\Sqlite::createFunction @@ -17,101 +17,9 @@ intnum_args-1 intflags0 - &warn.experimental.func; - - - Este método permite registrar uma função PHP com o SQLite como uma - UDF (Função Definida pelo Usuário), para que possa ser - chamada a partir das declarações SQL. - - - A UDF pode ser usada em qualquer declaração SQL que possa chamar funções, - como declarações SELECT e UPDATE e também em triggers. - - - - - &reftitle.parameters; - - - - function_name - - - O nome da função usada nas declarações SQL. - - - - - callback - - - Função de retorno para tratar a função SQL definida. - - - - A função de retorno deve retornar um tipo reconhecido pelo SQLite - (ou seja, um tipo escalar). - - - - Esta função precisa ser definida como: - - mixedcallback - mixedvalue - mixedvalues - - - - value - - - O primeiro argumento passado para a função SQL. - - - - - values - - - Argumentos adicionais passados para a função SQL. - - - - - - - - - num_args - - - O número de argumentos que a função SQL utiliza. - Se este parâmetro for -1, então a função SQL poderá - receber qualquer número de argumentos. - - - - - flags - - - Uma conjunção bit a bit de flags. - Atualmente, apenas PDO::SQLITE_DETERMINISTIC é - suportada, o que especifica que a função sempre retorna o mesmo resultado - dadas as mesmas entradas em uma única instrução SQL. - - - - - - - - - &reftitle.returnvalues; - - &return.success; - + + &info.method.alias; Pdo\Sqlite::createFunction. + @@ -135,85 +43,7 @@ - - - &reftitle.examples; - - - Exemplo de <function>PDO::sqliteCreateFunction</function> - -sqliteCreateFunction('md5rev', 'md5_and_reverse', 1); -$rows = $db->query('SELECT md5rev(filename) FROM files')->fetchAll(); -?> -]]> - - - - - Neste exemplo, existe uma função que calcula a soma md5 de uma string e - depois a inverte. Quando a instrução SQL é executada, ela - retorna o valor do nome do arquivo transformado pela função. Os dados - retornados em $rows contêm o resultado processado. - - - A elegância desta técnica é que não existe necessidade de processar o - resultado usando um laço &foreach; após os dados terem sido consultados. - - - - - e - podem ser usados para - substituir funções SQL nativas do SQLite. - - - - - - &reftitle.seealso; - - - - sqlite_create_function - sqlite_create_aggregate - - - - - + @@ -7,7 +7,7 @@ SQLite (PDO) -
+
&reftitle.intro; PDO_SQLITE é um driver que implementa a Interface @@ -91,6 +91,7 @@ sqlite: &reference.pdo-sqlite.entities.PDO; + &reference.pdo-sqlite.pdo-sqlite;