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

<!-- $Revision$ -->

<!-- EN-Revision: 0c9c2dd669fe9395eaa73d487fbd160f9057429a Maintainer: PhilDaiguille Status: ready -->

<!-- Reviewed: no -->

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

<refnamediv>

<refname>popen</refname>

<refpurpose>Crea un puntero de archivo de proceso</refpurpose>

</refnamediv>

<refsect1 role="description">

&reftitle.description;

<methodsynopsis>

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

<methodparam><type>string</type><parameter>command</parameter></methodparam>

<methodparam><type>string</type><parameter>mode</parameter></methodparam>

</methodsynopsis>

<para>

Crea un puntero de archivo de proceso, ejecutado mediante un fork

de la orden proporcionada por el argumento <parameter>command</parameter>.

</para>

</refsect1>

<refsect1 role="parameters">

&reftitle.parameters;

<para>

<variablelist>

<varlistentry>

<term><parameter>command</parameter></term>

<listitem>

<para>

La orden

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><parameter>mode</parameter></term>

<listitem>

<para>

El modo. Puede ser <literal>'r'</literal> para lectura, o <literal>'w'</literal>

para escritura.

</para>

<para>

En Windows, <function>popen</function> utiliza el modo texto por defecto,

es decir, todo carácter <literal>\n</literal> escrito o leído del pipe será

traducido a <literal>\r\n</literal>.

Si esto no es deseado, el modo binario puede ser forzado definiendo

el <parameter>mode</parameter> a <literal>'rb'</literal> y

<literal>'wb'</literal>, respectivamente.

</para>

</listitem>

</varlistentry>

</variablelist>

</para>

</refsect1>

<refsect1 role="returnvalues">

&reftitle.returnvalues;

<para>

Devuelve un puntero de archivo idéntico al devuelto por

<function>fopen</function>, excepto que será

unidireccional (solo lectura, o solo escritura), y debe ser

cerrado mediante <function>pclose</function>. Este puntero puede ser

utilizado con <function>fgets</function>, <function>fgetss</function>

y <function>fwrite</function>. Cuando el modo es 'r', el puntero de archivo

devuelto equivale al STDOUT de la orden, y cuando el modo es 'w', el

puntero de archivo devuelto equivale al STDIN de la orden.

</para>

<para>

Si ocurre un error, la función devolverá &false;.

</para>

</refsect1>

<refsect1 role="examples">

&reftitle.examples;

<para>

<example>

<title>Ejemplo con <function>popen</function></title>

<programlisting role="php">

<![CDATA[

<?php

$handle = popen("/bin/ls", "r");

?>

]]>

</programlisting>

</example>

</para>

<para>

Si la orden a ejecutar no ha podido ser encontrada, se devolverá

un recurso válido. Esto puede parecer extraño, pero es práctico.

Esto permite acceder a los mensajes de error que han sido

devueltos por el Shell:

<example>

<title>Ejemplo con <function>popen</function></title>

<programlisting role="php">

<![CDATA[

<?php

error_reporting(E_ALL);

/* Añade una redirección para que pueda leer stderr. */

$handle = popen('/path/to/executable 2>&1', 'r');

echo "'$handle'; " . gettype($handle) . "\n";

$read = fread($handle, 2096);

echo $read;

pclose($handle);

?>

]]>

</programlisting>

</example>

</para>

</refsect1>

<refsect1 role="notes">

&reftitle.notes;

<note>

<para>

Si se desea un soporte bidireccional (two-way), utilice

la función <function>proc_open</function>.

</para>

</note>

</refsect1>

<refsect1 role="seealso">

&reftitle.seealso;

<para>

<simplelist>

<member><function>pclose</function></member>

<member><function>fopen</function></member>

<member><function>proc_open</function></member>

</simplelist>

</para>

</refsect1>

</refentry>

<!-- 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:"~/.phpdoc/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

-->