<?xml version="1.0" encoding="utf-8"?>

<refentry xml:id="function.pfsockopen" xmlns="http://docbook.org/ns/docbook">

<refnamediv>

<refname>pfsockopen</refname>

<refpurpose>打开持久的 Internet 或 Unix 套接字连接</refpurpose>

</refnamediv>

<refsect1 role="description">

&reftitle.description;

<methodsynopsis>

<type class="union"><type>resource</type><type>false</type></type><methodname>pfsockopen</methodname>

<methodparam><type>string</type><parameter>hostname</parameter></methodparam>

<methodparam choice="opt"><type>int</type><parameter>port</parameter><initializer>-1</initializer></methodparam>

<methodparam choice="opt"><type>int</type><parameter role="reference">error_code</parameter><initializer>&null;</initializer></methodparam>

<methodparam choice="opt"><type>string</type><parameter role="reference">error_message</parameter><initializer>&null;</initializer></methodparam>

<methodparam choice="opt"><type class="union"><type>float</type><type>null</type></type><parameter>timeout</parameter><initializer>&null;</initializer></methodparam>

</methodsynopsis>

<para>

这个函数的作用与 <function>fsockopen</function>

完全一样，不同的地方在于当在脚本执行完后，连接一直不会关闭。可以说它是

<function>fsockopen</function> 的长连接版本。

</para>

</refsect1>

<refsect1 role="parameters">

&reftitle.parameters;

<para>

对于其参数的信息，请参考 <function>fsockopen</function> 的文档。

</para>

</refsect1>

<refsect1 role="returnvalues">

&reftitle.returnvalues;

<para>

<function>pfsockopen</function> 返回文件指针，可以跟其他文件函数（比如

<function>fgets</function>、<function>fgetss</function>、<function>fwrite</function>、<function>fclose</function>

和 <function>feof</function>）一起使用，&return.falseforfailure;。

</para>

</refsect1>

<refsect1 role="changelog">

&reftitle.changelog;

<informaltable>

<tgroup cols="2">

<thead>

<row>

<entry>&Version;</entry>

<entry>&Description;</entry>

</row>

</thead>

<tbody>

<row>

<entry>8.0.0</entry>

<entry>

<parameter>timeout</parameter> 现在可以为 null。

</entry>

</row>

</tbody>

</tgroup>

</informaltable>

</refsect1>

<refsect1 role="seealso">

&reftitle.seealso;

<para>

<simplelist>

<member><function>fsockopen</function></member>

</simplelist>

</para>

</refsect1>

</refentry>