Sophie

Sophie

distrib > Mandriva > 2008.1 > x86_64 > by-pkgid > 05cd670d8a02b2b4a0ffb1756f2e8308 > files > 8518

php-manual-zh-5.2.4-1mdv2008.1.noarch.rpm

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>oci_pconnect</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
TITLE="PHP 手册"
HREF="index.html"><LINK
REL="UP"
TITLE="Oracle 函数"
HREF="ref.oci8.html"><LINK
REL="PREVIOUS"
TITLE="oci_password_change"
HREF="function.oci-password-change.html"><LINK
REL="NEXT"
TITLE="oci_result"
HREF="function.oci-result.html"><META
HTTP-EQUIV="Content-type"
CONTENT="text/html; charset=UTF-8"></HEAD
><BODY
CLASS="refentry"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>PHP 手册</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="function.oci-password-change.html"
ACCESSKEY="P"
>上一页</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="function.oci-result.html"
ACCESSKEY="N"
>下一页</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><H1
><A
NAME="function.oci-pconnect"
></A
>oci_pconnect</H1
><DIV
CLASS="refnamediv"
><A
NAME="AEN158992"
></A
><P
>    (PHP 5)</P
>oci_pconnect&nbsp;--&nbsp;使用一个持久连接连到 Oracle 数据库</DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN158995"
></A
><H2
>说明</H2
>resource <B
CLASS="methodname"
>oci_pconnect</B
> ( string username, string password [, string db [, string charset [, int session_mode]]] )<BR
></BR
><P
>&#13;   <B
CLASS="function"
>oci_pconnect()</B
> 创建一个到 Oracle
   服务器的持久连接并登录。持久连接会被缓冲并在请求之间重复使用,可以降低每个页面加载的消耗。一个典型的
   PHP 应用程序对于每个 Apache 子进程(或者 PHP FastCGI/CGI
   进程)会有一个打开的持久连接到 Oracle 服务器。更多信息见<A
HREF="features.persistent-connections.html"
>数据库持久连接</A
>一节。
  </P
><DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>注意: </B
>
    自 OCI8 扩展库版本 1.1 起,持久 Oracle
    连接的生命周期和最大数目可以通过设定以下配置选项来调整:<A
HREF="ref.oci8.html#ini.oci8.persistent_timeout"
>oci8.persistent_timeout</A
>,<A
HREF="ref.oci8.html#ini.oci8.ping_interval"
>oci8.ping_interval</A
>
    和 <A
HREF="ref.oci8.html#ini.oci8.max_persistent"
>oci8.max_persistent</A
>。
   </P
></BLOCKQUOTE
></DIV
><P
>&#13;   可选的第三个参数可以是本地 Oracle 实例的名字或者是在
   <TT
CLASS="filename"
>tnsnames.ora</TT
>
   的条目中的名字。如果没有指定第三个参数, PHP 使用环境变量
   <TT
CLASS="literal"
>ORACLE_SID</TT
> 和 <TT
CLASS="literal"
>TWO_TASK</TT
>
   来分别确定本地 Oracle 实例的名字和
   <TT
CLASS="filename"
>tnsnames.ora</TT
> 的位置。
  </P
><P
>&#13;   <CODE
CLASS="parameter"
>session_mode</CODE
> 参数自版本 1.1
   起可用并接受如下值:<TT
CLASS="constant"
><B
>OCI_DEFAULT</B
></TT
>,<TT
CLASS="constant"
><B
>OCI_SYSOPER</B
></TT
>
   和 <TT
CLASS="constant"
><B
>OCI_SYSDBA</B
></TT
>。如果指定了
   <TT
CLASS="constant"
><B
>OCI_SYSOPER</B
></TT
> 或 <TT
CLASS="constant"
><B
>OCI_SYSDBA</B
></TT
>
   其中之一,<A
HREF="function.oci-new-connect.html"
><B
CLASS="function"
>oci_new_connect()</B
></A
>
   将尝试使用外部认证信息建立特权连接。特权连接默认被禁止。要启用,需要将
   <A
HREF="ref.oci8.html#ini.oci8.privileged_connect"
>oci8.privileged_connect</A
>
   设为 On。
  </P
><DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>注意: </B
>
    如果 PHP 用的是 Oracle Instant
    Client,可以用容易的命名连接方法,说明见这里:<A
HREF="http://download-west.oracle.com/docs/cd/B12037_01/network.101/b10775/naming.htm#i498306"
TARGET="_top"
>http://download-west.oracle.com/docs/cd/B12037_01/network.101/b10775/naming.htm#i498306</A
>。基本上这意味着可以指定
    "//db_host[:port]/database_name"
    作为数据库名。但如果想用命名的旧方法则<SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>必须</I
></SPAN
>设定
    <TT
CLASS="constant"
><B
>ORACLE_HOME</B
></TT
> 或 <TT
CLASS="constant"
><B
>TNS_ADMIN</B
></TT
> 二者之一。
   </P
></BLOCKQUOTE
></DIV
><P
>使用 Oracle 服务器 9.2 或更高版本,可以指定
<CODE
CLASS="parameter"
>charset</CODE
> 参数,其将被用于新的连接。如果使用
Oracle 服务器低于 9.2 的版本,本参数将被忽略并以
NLS_LANG 环境变量替代之。</P
><P
>&#13;   <B
CLASS="function"
>oci_pconnect()</B
> 返回连接标识符,出错则返回 <TT
CLASS="constant"
><B
>FALSE</B
></TT
>。
  </P
><DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>注意: </B
>
    在 PHP 5.0.0 之前的版本必须使用 <A
HREF="function.ociplogon.html"
><B
CLASS="function"
>ociplogon()</B
></A
>
    替代本函数。该函数名仍然可用,为向下兼容作为
    <B
CLASS="function"
>oci_pconnect()</B
> 的别名。不过其已被废弃,不推荐使用。
   </P
></BLOCKQUOTE
></DIV
><P
>&#13;   参见 <A
HREF="function.oci-connect.html"
><B
CLASS="function"
>oci_connect()</B
></A
> 和
   <A
HREF="function.oci-new-connect.html"
><B
CLASS="function"
>oci_new_connect()</B
></A
>。
  </P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="function.oci-password-change.html"
ACCESSKEY="P"
>上一页</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>起始页</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="function.oci-result.html"
ACCESSKEY="N"
>下一页</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>oci_password_change</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="ref.oci8.html"
ACCESSKEY="U"
>上一级</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>oci_result</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>