phaser Wed May 15 09:45:57 2002 EDT
Added files:
/phpdoc-pt_BR/reference/pgsql functions.xml reference.xml
Log:
1st pt_BR version
Index: phpdoc-pt_BR/reference/pgsql/functions.xml
+++ phpdoc-pt_BR/reference/pgsql/functions.xml
&reference.pgsql.functions.pg-affected-rows;
&reference.pgsql.functions.pg-cancel-query;
&reference.pgsql.functions.pg-client-encoding;
&reference.pgsql.functions.pg-close;
&reference.pgsql.functions.pg-connect;
&reference.pgsql.functions.pg-connection-busy;
&reference.pgsql.functions.pg-connection-reset;
&reference.pgsql.functions.pg-connection-status;
&reference.pgsql.functions.pg-convert;
&reference.pgsql.functions.pg-copy-from;
&reference.pgsql.functions.pg-copy-to;
&reference.pgsql.functions.pg-dbname;
&reference.pgsql.functions.pg-delete;
&reference.pgsql.functions.pg-end-copy;
&reference.pgsql.functions.pg-escape-bytea;
&reference.pgsql.functions.pg-escape-string;
&reference.pgsql.functions.pg-fetch-array;
&reference.pgsql.functions.pg-fetch-object;
&reference.pgsql.functions.pg-fetch-result;
&reference.pgsql.functions.pg-fetch-row;
&reference.pgsql.functions.pg-field-is-null;
&reference.pgsql.functions.pg-field-name;
&reference.pgsql.functions.pg-field-num;
&reference.pgsql.functions.pg-field-prtlen;
&reference.pgsql.functions.pg-field-size;
&reference.pgsql.functions.pg-field-type;
&reference.pgsql.functions.pg-free-result;
&reference.pgsql.functions.pg-get-result;
&reference.pgsql.functions.pg-host;
&reference.pgsql.functions.pg-insert;
&reference.pgsql.functions.pg-last-error;
&reference.pgsql.functions.pg-last-notice;
&reference.pgsql.functions.pg-last-oid;
&reference.pgsql.functions.pg-lo-close;
&reference.pgsql.functions.pg-lo-create;
&reference.pgsql.functions.pg-lo-export;
&reference.pgsql.functions.pg-lo-import;
&reference.pgsql.functions.pg-lo-open;
&reference.pgsql.functions.pg-lo-read;
&reference.pgsql.functions.pg-lo-read-all;
&reference.pgsql.functions.pg-lo-seek;
&reference.pgsql.functions.pg-lo-tell;
&reference.pgsql.functions.pg-lo-unlink;
&reference.pgsql.functions.pg-lo-write;
&reference.pgsql.functions.pg-metadata;
&reference.pgsql.functions.pg-num-fields;
&reference.pgsql.functions.pg-num-rows;
&reference.pgsql.functions.pg-options;
&reference.pgsql.functions.pg-pconnect;
&reference.pgsql.functions.pg-port;
&reference.pgsql.functions.pg-put-line;
&reference.pgsql.functions.pg-query;
&reference.pgsql.functions.pg-result-error;
&reference.pgsql.functions.pg-result-status;
&reference.pgsql.functions.pg-select;
&reference.pgsql.functions.pg-send-query;
&reference.pgsql.functions.pg-set-client-encoding;
&reference.pgsql.functions.pg-trace;
&reference.pgsql.functions.pg-tty;
&reference.pgsql.functions.pg-untrace;
&reference.pgsql.functions.pg-update;
Index: phpdoc-pt_BR/reference/pgsql/reference.xml
+++ phpdoc-pt_BR/reference/pgsql/reference.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.3 Maintainer: phaser Status: ready -->
<reference id="ref.pgsql">
<title>Fun��es PostgreSQL</title>
<titleabbrev>PostgreSQL</titleabbrev>
<partintro>
<para>
Postgres, desenvolvida originalmente no Deparetamento de Ci�ncias
de Computa��o de Berkeley, foi pioneira em muitos dos conceitos de
relacionamento-objeto que agora est�o tornando-se dispon�veis em
alguns bancos de dados comerciais. Ele fornece suporte a linguagem
SQL92/SQL99, integridade de transa��es e extensibilidade de tipos.
Postgres � um descendente em c�digo aberto do c�digo original de
Berkeley.
</para>
<para>
O banco de dados PostgreSQL � um produto Open Source dispon�vel
sem nenhum custo. Para usar o suporte a PostgreSQL voc� precisa
do PostgreSQL 6.5 ou superior. PostgreSQL 7.0 ou superior para
habilitar todas as fun��es do m�dulo PostgreSQL. PostgreSQL suporta
muitos c�digos de caracteres incluindo a codifica��o de carcateres
multibyte. A vers�o atual e maiores informa��es sobre PostgreSQL
est� dispon�vel em <ulink url="&url.pgsql;">&url.pgsql;</ulink>.
</para>
<para>
Para habilitar o suporte a PostgreSQL a op��o de configura��o
<option role="configure">--with-pgsql[=DIR]</option> � exigida quando
voc� compila o PHP. Se o m�dulo compartilhado est� dispon�vel, o m�dulo
PostgreSQL pode ser carregado usando a diretiva
<link linkend="ini.extension">extension</link> no &php.ini; ou
a fun��o <function>dl</function>. Diretivas ini suportadas est�o descritas
em <filename>php.ini-dist</filename> que vem com a distribui��o.
</para>
<warning>
<para>
Usar o m�dulo PostgreSQL com o PHP 4.0.6 n�o � recomendado devido a
um bug no c�digo de manipula��o de mensagens de nota. Use o 4.1.0 ou
superior.
</para>
</warning>
<warning>
<para>
Os nomes das fun��es PostgreSQL ser�o alterados na vers�o 4.2.0 para
confirmar os padr�es de programa��o atuais. A maioria dos novos nomes
ter�o sublinhados adicionais, por exemplo pg_lo_open(). Algumas fun��es
foram renomeadas para uma maior consist�ncia, por exemplo pg_exec() que
mudou para pg_query(). Os nomes antigos podem ser usados na 4.2.0 e em
algumas poucas outras atualiza��es ap�s esta, mas eles ser�o deletados em
um futuro pr�ximo.
</para>
<table>
<title>Nomes de fun��es alterados</title>
<tgroup cols="2">
<thead>
<row>
<entry>Nomes antigos</entry>
<entry>Nomes novos</entry>
</row>
</thead>
<tbody>
<row>
<entry><function>pg_exec</function></entry>
<entry><function>pg_query</function></entry>
</row>
<row>
<entry><function>pg_getlastoid</function></entry>
<entry><function>pg_last_oid</function></entry>
</row>
<row>
<entry><function>pg_cmdtuples</function></entry>
<entry><function>pg_affected_rows</function></entry>
</row>
<row>
<entry><function>pg_numrows</function></entry>
<entry><function>pg_num_rows</function></entry>
</row>
<row>
<entry><function>pg_numfields</function></entry>
<entry><function>pg_num_fields</function></entry>
</row>
<row>
<entry><function>pg_fieldname</function></entry>
<entry><function>pg_field_name</function></entry>
</row>
<row>
<entry><function>pg_fieldsize</function></entry>
<entry><function>pg_field_size</function></entry>
</row>
<row>
<entry><function>pg_fieldnum</function></entry>
<entry><function>pg_field_num</function></entry>
</row>
<row>
<entry><function>pg_fieldprtlen</function></entry>
<entry><function>pg_field_prtlen</function></entry>
</row>
<row>
<entry><function>pg_fieldisnull</function></entry>
<entry><function>pg_field_is_null</function></entry>
</row>
<row>
<entry><function>pg_freeresult</function></entry>
<entry><function>pg_free_result</function></entry>
</row>
<row>
<entry><function>pg_result</function></entry>
<entry><function>pg_fetch_result</function></entry>
</row>
<row>
<entry><function>pg_loreadall</function></entry>
<entry><function>pg_lo_read_all</function></entry>
</row>
<row>
<entry><function>pg_locreate</function></entry>
<entry><function>pg_lo_create</function></entry>
</row>
<row>
<entry><function>pg_lounlink</function></entry>
<entry><function>pg_lo_unlink</function></entry>
</row>
<row>
<entry><function>pg_loopen</function></entry>
<entry><function>pg_lo_unlink</function></entry>
</row>
<row>
<entry><function>pg_loclose</function></entry>
<entry><function>pg_lo_close</function></entry>
</row>
<row>
<entry><function>pg_loread</function></entry>
<entry><function>pg_lo_read</function></entry>
</row>
<row>
<entry><function>pg_lowrite</function></entry>
<entry><function>pg_lo_write</function></entry>
</row>
<row>
<entry><function>pg_loimport</function></entry>
<entry><function>pg_lo_import</function></entry>
</row>
<row>
<entry><function>pg_loexport</function></entry>
<entry><function>pg_lo_export</function></entry>
</row>
</tbody>
</tgroup>
</table>
<para>
A antiga sintaxe <function>pg_connect</function>/<function>pg_pconnect</function>
ser� obsoleta para suportar conex�es ass�ncronas no futoro. Por favor use
a string de conex�o para <function>pg_connect</function>
e <function>pg_pconnect</function>.
</para>
</warning>
<para>
Nem todas as fun��es s�o suportadas por todas as compila��es. Isso vai
depender da vers�o do seu libpq (A interface C do cliente PostgreSQL) e
como o seu libpq foi compilado. Se h� alguma fun��o ausente, a libpq n�o
suporta a caracter�stica exigida pela fun��o.
</para>
<para>
Tamb�m � importante que voc� use uma libpq mais nova do que a que o
servidor espera. Se voc� usar uma libpq mais antiga do que a que o
servidor espera voc� poder� ter problemas.
</para>
<para>
Desde a vers�o 6.3 (03/02/1998) PostgreSQL usa sockets de dom�nio unix por
padr�o. A porta TCP n�o ser� aberta por padr�o. Uma tabela � mostrada
abaixo descrevendo essas novas possibilidades de conex�o. Este socket ser�
encontrado em <filename>/tmp/.s.PGSQL.5432</filename>.
Espa op��o pode ser habilitada com a chave '-i' para o
<command>postmaster</command> e seu significado �: "escute em sockets
TCP/IP assim como em sockets de dom�nio Unix".
<table>
<title>Postmaster e PHP</title>
<tgroup cols="3">
<thead>
<row>
<entry>Postmaster</entry>
<entry>PHP</entry>
<entry>Status</entry>
</row>
</thead>
<tbody>
<row>
<entry>postmaster &</entry>
<entry>pg_connect("dbname=MyDbName");</entry>
<entry>OK</entry>
</row>
<row>
<entry>postmaster -i &</entry>
<entry>pg_connect("dbname=MyDbName");</entry>
<entry>OK</entry>
</row>
<row>
<entry>postmaster &</entry>
<entry>pg_connect("host=localhost dbname=MyDbName");</entry>
<entry>
Unable to connect to PostgreSQL server: connectDB() failed:
Is the postmaster running and accepting TCP/IP (with -i)
connection at 'localhost' on port '5432'? in
/path/to/file.php on line 20.
</entry>
</row>
<row>
<entry>postmaster -i &</entry>
<entry>pg_connect("host=localhost dbname=MyDbName");</entry>
<entry>OK</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
<para>
Uma conex�o com o servidor PostgreSQL pode ser estabelecida com os
seguintes pares de valores definidos na string de comando: <command>$conn =
pg_connect("host=meuHost port=minhaPorta tty=meuTTY options=minhasOpcoes
dbname=meuDB user=meuUsuario password=minhaSenha ");
</command>
</para>
<para>
A sintaxe anterior de:
<command>
$conn = pg_connect ("host", "porta", "opcoes", "tty", "nomebd")
</command>
est� obsoleta.
</para>
<para>
Vari�veis de ambiente afetam o comportamento do servidor/cliente
PostgreSQL. Por exemplo, o m�dulo PostgreSQL ir� procurar pela vari�vel de
ambiente PGHOST quando o nome de host � omitido na string de conex�o. As
vari�veis de ambiente suportadas variam de vers�o para vers�o. Vide o
Manual de PRogramador do PostgreSQL (Programmer�s Manual) na se��o libpq -
Enviroment Variables para maiores detalhes.
</para>
<para>
Certifique-se que voc� definou as vari�veis de ambiente para o usu�rio
apropriado. Use <literal>$_ENV</literal> ou <function>getenv</function>
para verificar que vari�veis de ambiente est�o dispon�veis para o processo
atual.
</para>
<example>
<title>Definindo os par�metros padr�es</title>
<programlisting>
<![CDATA[
PGHOST=psgql.exmaple.com
PGPORT=7890
PGDATABASE=web-system
PGUSER=web-user
PGPASSWORD=secret
PGDATESTYLE=ISO
PGTZ=JST
PGCLIENTENCODING=EUC-JP
export PGHOST PGPORT PGDATABASE PGUSER PGPASSWORD PGDATESTYLE PGTZ PGCLIENTENCODING
]]>
</programlisting>
</example>
<para>
A partir do PostgreSQL 7.1.0, voc� pode armazenar at� 1GB dentro de um
campo do tipo texto. Em vers�es mais antigas, isto era limitado ao tamanho
do bloco (padr�o era 8KB e o m�ximo era 32KB definido em tempo de
compila��o)
</para>
<para>
Para usar a interface de objetos grandes (lo), � exigido que se encapsule
as fun��es de objetos grandes dentro de um bloco de transa��o. Um bloco de
transa��o inicia-se com a declara��o SQL <command>BEGIN</command> e se a
transa��o foi v�lida termina com <command>COMMIT</command> ou
<command>END</command>. Se a transa�o falhar, ela deve ser fechada com
<command>ROLLBACK</command> ou <command>ABORT</command>.
<>
<title>Usando Objetos Grandes</title>
<programlisting role="php">
<![CDATA[
<?php
$database = pg_connect ("dbname=jacarta");
pg_query ($database, "begin");
$oid = pg_lo_create ($database);
echo "$oid\n";
$handle = pg_lo_open ($database, $oid, "w");
echo "$handle\n";
pg_lo_write ($handle, "large object data");
pg_lo_close ($handle);
pg_query ($database, "commit");
?>
]]>
</programlisting>
</example>
Voc� n�o deve fechar a conex�o com o servidor PostgreSQL antes de fechar o
objeto grande.
</para>
</partintro>
&reference.pgsql.functions;
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
