initial translation in eio/functions

php · Feb 9, 2025 · f7339ab · f7339ab
1 parent bc728ff
commit f7339ab
Show file tree

Hide file tree

Showing 5 changed files with 753 additions and 0 deletions.
diff --git a/reference/eio/functions/eio-init.xml b/reference/eio/functions/eio-init.xml
@@ -0,0 +1,58 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 3cfbd573de5775bc5a15dc96768a6bd9f6332e44 Maintainer: leonardolara Status: ready -->
+
+<refentry xml:id="function.eio-init" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>eio_init</refname>
+  <refpurpose>(Re-)inicializa a Eio</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>void</type><methodname>eio_init</methodname>
+   <void />
+  </methodsynopsis>
+  <para>
+   <function>eio_init</function> (re-)inicializa a Eio. Aloca memória para estruturas internas da libeio e da própria Eio. <function>eio_init</function> pode ser chamada antes da utilização de funções Eio. De qualquer forma, ela será chamada internamente na primeira vez que um função Eio seja invocada em um processo.
+  </para>
+  <note>
+   <para>
+    Esta função foi removida na versão 3.0.0RC1 da extensão Eio para o PHP versão 8 e superiores.
+   </para>
+  </note>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  &no.function.parameters;
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   &return.void;
+  </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
+-->
diff --git a/reference/eio/functions/eio-link.xml b/reference/eio/functions/eio-link.xml
@@ -0,0 +1,163 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: b38591439b2afe309740774f5fa41cafe32c72b9 Maintainer: leonardolara Status: ready -->
+
+<refentry xml:id="function.eio-link" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>eio_link</refname>
+  <refpurpose>Cria uma ligação física para um arquivo</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>resource</type><methodname>eio_link</methodname>
+   <methodparam><type>string</type><parameter>path</parameter></methodparam>
+   <methodparam><type>string</type><parameter>new_path</parameter></methodparam>
+   <methodparam
+   choice="opt"><type>int</type><parameter>pri</parameter><initializer>EIO_PRI_DEFAULT</initializer></methodparam>
+   <methodparam
+   choice="opt"><type>callable</type><parameter>callback</parameter><initializer>NULL</initializer></methodparam>
+   <methodparam
+   choice="opt"><type>mixed</type><parameter>data</parameter><initializer>NULL</initializer></methodparam>
+  </methodsynopsis>
+  <para>
+  <function>eio_link</function> cria uma ligação física
+  <parameter>new_path</parameter> para o arquivo especificado por
+  <parameter>path</parameter>.
+  </para>
+
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term><parameter>path</parameter></term>
+    <listitem>
+     <para>
+      Caminho do arquivo de origem.
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>new_path</parameter></term>
+    <listitem>
+     <para>
+      Caminho do arquivo de destino.
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>pri</parameter></term>
+    <listitem>
+     &eio.request.pri.values;
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>callback</parameter></term>
+    <listitem>
+     &eio.callback.proto;
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>data</parameter></term>
+    <listitem>
+     <para>
+      Variável arbitrária passada para <parameter>callback</parameter>.
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example>
+   <title>Exemplo de <function>eio_link</function></title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+$filename = dirname(__FILE__)."/symlink.dat";
+touch($filename);
+$link = dirname(__FILE__)."/symlink.link";
+$hardlink = dirname(__FILE__)."/hardlink.link";
+
+function my_hardlink_cb($data, $result) {
+    global $link, $filename;
+    var_dump(file_exists($data) && !is_link($data));
+    @unlink($data);
+
+    eio_symlink($filename, $link, EIO_PRI_DEFAULT, "my_symlink_cb", $link);
+}
+
+function my_symlink_cb($data, $result) {
+    global $link, $filename;
+    var_dump(file_exists($data) && is_link($data));
+
+    if (!eio_readlink($data, EIO_PRI_DEFAULT, "my_readlink_cb", NULL)) {
+        @unlink($link);
+        @unlink($filename);
+    }
+}
+
+function my_readlink_cb($data, $result) {
+    global $filename, $link;
+    var_dump($result);
+
+    @unlink($link);
+    @unlink($filename);
+}
+
+eio_link($filename, $hardlink, EIO_PRI_DEFAULT, "my_hardlink_cb", $hardlink);
+eio_event_loop();
+?>
+]]>
+   </programlisting>
+   &example.outputs.similar;
+   <screen>
+<![CDATA[
+bool(true)
+bool(true)
+string(%d) "%ssymlink.dat"
+]]>
+   </screen>
+  </example>
+ </refsect1>
+
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <simplelist>
+   <member><function>eio_symlink</function></member>
+  </simplelist>
+ </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
+-->
diff --git a/reference/eio/functions/eio-lstat.xml b/reference/eio/functions/eio-lstat.xml
@@ -0,0 +1,162 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: e41806c30bf6975e452c0d4ce35ab0984c2fa68c Maintainer: leonardolara Status: ready -->
+
+<refentry xml:id="function.eio-lstat" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>eio_lstat</refname>
+  <refpurpose>Obtém status de arquivo</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>resource</type><methodname>eio_lstat</methodname>
+   <methodparam><type>string</type><parameter>path</parameter></methodparam>
+   <methodparam><type>int</type><parameter>pri</parameter></methodparam>
+   <methodparam><type>callable</type><parameter>callback</parameter></methodparam>
+   <methodparam
+   choice="opt"><type>mixed</type><parameter>data</parameter><initializer>NULL</initializer></methodparam>
+  </methodsynopsis>
+  <para>
+   <function>eio_lstat</function> retorna informação de status de arquivo no argumento
+   <parameter>result</parameter> da função <parameter>callback</parameter>.
+  </para>
+
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term><parameter>path</parameter></term>
+    <listitem>
+     <para>
+      O caminho do arquivo.
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>pri</parameter></term>
+    <listitem>
+     &eio.request.pri.values;
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>callback</parameter></term>
+    <listitem>
+     &eio.callback.proto;
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>data</parameter></term>
+    <listitem>
+     <para>
+      Variável arbitrária passada para <parameter>callback</parameter>.
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   <function>eio_lstat</function> retorna o recurso da requisição em caso de sucesso or &false; on error.
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example>
+   <title>Exemplo de <function>eio_lstat</function></title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+$tmp_filename = dirname(__FILE__). "/eio-file.tmp";
+touch($tmp_filename);
+
+function my_res_cb($data, $result) {
+    var_dump($data);
+    var_dump($result);
+}
+
+function my_open_cb($data, $result) {
+    eio_close($result);
+    eio_event_loop();
+
+    @unlink($data);
+}
+
+eio_lstat($tmp_filename, EIO_PRI_DEFAULT, "my_res_cb", "eio_lstat");
+eio_open($tmp_filename, EIO_O_RDONLY, NULL,
+  EIO_PRI_DEFAULT, "my_open_cb", $tmp_filename);
+eio_event_loop();
+?>
+]]>
+   </programlisting>
+   &example.outputs.similar;
+   <screen>
+<![CDATA[
+string(9) "eio_lstat"
+array(12) {
+ ["st_dev"]=>
+  int(2050)
+  ["st_ino"]=>
+  int(2099197)
+  ["st_mode"]=>
+  int(33188)
+  ["st_nlink"]=>
+  int(1)
+  ["st_uid"]=>
+  int(1000)
+  ["st_gid"]=>
+  int(100)
+  ["st_rdev"]=>
+  int(0)
+  ["st_blksize"]=>
+  int(4096)
+  ["st_blocks"]=>
+  int(0)
+  ["st_atime"]=>
+  int(1318235777)
+  ["st_mtime"]=>
+  int(1318235777)
+  ["st_ctime"]=>
+  int(1318235777)
+}
+]]>
+   </screen>
+  </example>
+ </refsect1>
+
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <simplelist>
+   <member><function>eio_stat</function></member>
+   <member><function>eio_fstat</function></member>
+  </simplelist>
+ </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
+-->