cvs: phpdoc-hu /reference/filesystem/functions fopen.xml

http://cvs.php.net/viewvc.cgi/phpdoc-hu/reference/filesystem/functions/fopen.xml?view=markup&rev=1.1
Index: phpdoc-hu/reference/filesystem/functions/fopen.xml
+++ phpdoc-hu/reference/filesystem/functions/fopen.xml
<?xml version="1.0" encoding="iso-8859-2"?>
<!-- EN-Revision: 1.30 Maintainer: chappy Status: ready -->
<!-- splitted from ./en/functions/filesystem.xml, last change in rev 1.2 -->
<refentry id="function.fopen">
 <refnamediv>
  <refname>fopen</refname>
  <refpurpose>Megnyit egy fájlt vagy URL-t</refpurpose>
 </refnamediv>
 <refsect1>
  <title>Leírás</title>
  <methodsynopsis>
   <type>resource</type><methodname>fopen</methodname>
   <methodparam><type>string</type><parameter>filename</parameter></methodparam>
   <methodparam><type>string</type><parameter>mode</parameter></methodparam>
   <methodparam choice="opt"><type>bool</type><parameter>use_include_path</parameter></methodparam>
   <methodparam choice="opt"><type>resource</type><parameter>context</parameter></methodparam>
  </methodsynopsis>
  <simpara>
   A <function>fopen</function> függvény beköti a <parameter>filename</parameter> paraméterben
   megnevezett erõforrást egy adatfolyamba. Ha a 
   <parameter>filename</parameter> paraméter "scheme://..." formájú,
   ezt a PHP URL-nek tekinti és megkeresi a megfelelõ protokollkezelõt 
   (ún. burkolót) a sémára. Ha nincs
   burkoló a megadott protokollra regisztrálva, a PHP kibocsát
   egy értesítést, hogy felkutathasd a lehetséges hibákat a programban, 
   és folyatatja a futást, a <parameter>filename</parameter>
   paramétert rendes fájlként feldolgozva.
  </simpara>
  <simpara>
   Ha a PHP szerint a <parameter>filename</parameter> helyi fájlra
   mutat, megpróbál egy adatfolyamot nyitni a fájlon.
   A fájlnok hozzáférhetõnek kell lennie a PHP számára, tehát gondoskodnod 
   kell a megfelelõ hozzáférési jogosultságokról.
   Ha a &safemode; 
   vagy <link linkend="ini.open-basedir">open_basedir</link>  be van kapcsolva, további
   korlátozások lehetségesek.
  </simpara>
  <simpara>
   Ha a PHP szerint a <parameter>filename</parameter> regisztrált protokollt tartalmaz,
   és a protokoll hálózati URL-ként van ragisztrálva, a 
   PHP ellenõrzi, hogy a 
   <link linkend="ini.allow-url-fopen">allow_url_fopen</link> be van-e
   kapcsolva. Ha ez ki van kapcsolva, a PHP figyelmeztetést bocsát ki és 
   az fájlmegnyitásí függvényhívás sikertelen lesz.
  </simpara>
  <note>
   <simpara>
    A támogatott protokollok listája megtalálható az <xref linkend="wrappers"/>-ben.
    Néhány protokoll (<literal>wrapper</literal>-ek) támogatja a 
    <literal>context</literal>-et és/vagy a &php.ini; opciókat.
    A beállítható opciókért lásd az adott protokoll oldalát a fenti linken. (pl.: a <literal>user_agent</literal> &php.ini; értéket
    a <literal>http</literal> burkoló használja).
   </simpara>
  </note>
  &note.context-support;
  <note>
   <simpara>
    As of PHP 4.3.2, the default mode is set to binary for all
    platforms that distinguish between binary and text mode.  If you are
    having problems with your scripts after upgrading, try using the
    <literal>'t'</literal> flag as a workaround until you have made your
    script more portable as mentioned below.
   </simpara>
  </note>
  <para>
   A <parameter>mode</parameter> paraméter megszabja a kért hozzáférés típusát az
   adatfolyamhoz. Ez bármely lehet a következõek közül:
   <table>
    <title>
     A <function>fopen</function> függvény lehetséges megnyitási módjainak a listája, a
     <parameter>mode</parameter> paramétert használva
    </title>
    <tgroup cols="2">
     <thead>
      <row>
       <entry><parameter>mode</parameter></entry>
       <entry>Leírás</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry><literal>'r'</literal></entry>
       <entry>
        Megnyit egy fájl csak olvasásra; a fájlpointer helyzete a fájl elején
        lesz.
       </entry>
      </row>
      <row>
       <entry><literal>'r+'</literal></entry>
       <entry>
        Megnyit egy fájlt olvasásra és írásra; a fájlpointer helyzete a fájl elején
        lesz.
       </entry>
      </row>
      <row>
       <entry><literal>'w'</literal></entry>
       <entry>
        Megnyit egy fájlt csak írásra; a fájlpointer helyzete a fájl elején
        lesz, és teljesen törli a fájl tartalmát. 
        Ha a fájl nem létezik, megpróbálja létrehozni.
       </entry>
      </row>
      <row>
       <entry><literal>'w+'</literal></entry>
       <entry>
        Megnyit egy fájlt olvasásra és írásra; a fájlpointer helyzete a fájl elején
        lesz, és teljesen törli a fájl tartalmát. 
        Ha a fájl nem létezik, megpróbálja létrehozni.
       </entry>
      </row>
      <row>
       <entry><literal>'a'</literal></entry>
       <entry>
        Megnyit egy fájlt csak írásra; a fájlpointer helyzete a fájl végén
        lesz. Ha a fájl nem létezik, megpróbálja létrehozni.
       </entry>
      </row>
      <row>
       <entry><literal>'a+'</literal></entry>
       <entry>
        Megnyit egy fájlt olvasásra és írásra; a fájlpointer helyzete a fájl végén
        lesz. Ha a fájl nem létezik, megpróbálja létrehozni.
       </entry>
      </row>
      <row>
       <entry><literal>'x'</literal></entry>
       <entry>
        Megnyit egy fájlt csak írásra; a fájlpointer helyzete a fájl elején
        lesz. Ha a fájl már létezik, a <function>fopen</function> 
        függvényhívás sikertelen lesz, és &false;-t ad vissza, és
        <constant>E_WARNING</constant> szintû hibát generál. Ha
        a fájl nem létezik, megpróbálja létrehozni. Ez a függvény ugyanaz, mintha a 
        <literal>open(2)</literal> rendszerfüggvényt hívnánk meg 
        <literal>O_EXCL|O_CREAT</literal> flagekkel. Ezt az opció csak
        a PHP 4.3.2-ban és a késõbbi változatokban érhetõ el, és csak helyi fájlok esetében mûküdik.
       </entry>
      </row>
      <row>
       <entry><literal>'x+'</literal></entry>
       <entry>
        Megnyit egy fájlt olvasásra és írásra; a fájlpointer helyzete a fájl elején
        lesz. Ha a fájl már létezik, a <function>fopen</function> 
        függvényhívás sikertelen lesz, és &false;-t ad vissza, és
        <constant>E_WARNING</constant> szintû hibát generál. Ha
        a fájl nem létezik, megpróbálja létrehozni. Ez a függvény ugyanaz, mintha a 
        <literal>open(2)</literal> rendszerfüggvényt hívnánk meg 
        <literal>O_EXCL|O_CREAT</literal> flagekkel. Ezt az opció csak
        a PHP 4.3.2-ban és a késõbbi változatokban érhetõ el, és csak helyi fájlok esetében mûküdik.
       </entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
  <note>
   <para>
    Different operating system families have different line-ending
    conventions.  When you write a text file and want to insert a line
    break, you need to use the correct line-ending character(s) for your
    operating system.  Unix based systems use <literal>\n</literal> as the
    line ending character, Windows based systems use <literal>\r\n</literal>
    as the line ending characters and Macintosh based systems use
    <literal>\r</literal> as the line ending character.
   </para>
   <para>
    If you use the wrong line ending characters when writing your files, you
    might find that other applications that open those files will "look
    funny".
   </para>
   <para>
    Windows offers a text-mode translation flag (<literal>'t'</literal>)
    which will transparently translate <literal>\n</literal> to
    <literal>\r\n</literal> when working with the file.  In contrast, you
    can also use <literal>'b'</literal> to force binary mode, which will not
    translate your data.  To use these flags, specify either
    <literal>'b'</literal> or <literal>'t'</literal> as the last character
    of the <parameter>mode</parameter> parameter.
   </para>
   <para>
    The default translation mode depends on the SAPI and version of PHP that
    you are using, so you are encouraged to always specify the appropriate
    flag for portability reasons.  You should use the <literal>'t'</literal>
    mode if you are working with plain-text files and you use
    <literal>\n</literal> to delimit your line endings in your script, but
    expect your files to be readable with applications such as notepad.  You
    should use the <literal>'b'</literal> in all other cases.
   </para>
   <para>
    If you do not specify the 'b' flag when working with binary files, you
    may experience strange problems with your data, including broken image
    files and strange problems with <literal>\r\n</literal> characters.
   </para>
  </note>
  <note>
   <para>
    For portability, it is strongly recommended that you always
    use the 'b' flag when opening files with <function>fopen</function>.
   </para>
  </note>
  <note>
   <para>
    Again, for portability, it is also strongly recommended that
    you re-write code that uses or relies upon the <literal>'t'</literal>
    mode so that it uses the correct line endings and
    <literal>'b'</literal> mode instead.
   </para>
  </note>
  <para>
   Az opcinális harmadik <parameter>use_include_path</parameter> paraméter
   beállítható '1'-ra vagy &true;-ra, ha  azt szeretnéd, hogy a fájlt a PHP az 
   <link linkend="ini.include-path">include_path</link>-ban is keresse.
  </para>
  <simpara>
   Ha a fájl megnyitása sikertelen, a függvény &false;-t ad vissza és 
   <constant>E_WARNING</constant> szintû hibát generál. Használhatod a 
   <link linkend="language.operators.errorcontrol">@</link> karatert e 
   figyelmeztetés elfojtásához.
  </simpara>
  <para>
   <example>
    <title><function>fopen</function> példák</title>
    <programlisting role="php">
<![CDATA[
<?php
$handle = fopen("/home/rasmus/file.txt", "r");
$handle = fopen("/home/rasmus/file.gif", "wb");
$handle = fopen("http://www.example.com/", "r");
$handle = fopen("ftp://user:[email protected]/somefile.txt", "w");
?>
]]>
    </programlisting>
   </example>
  </para>
  <simpara>
   Ha problémákat észlelsz a fájlok olvasása és írása közben, 
   és a PHP-t szerver modulként használod, emlékezz, hogy a 
   szerver folyamatnak hozzá kell férnie a használni kívánt
   fájlokhoz és könyvtárakhoz.
  </simpara>
  <para>
   Windowson vigyázni kell arra, hogy a fordított perjelek (\) a fájl elérési útvonalában 
   le legyenek védve, vagy használj sima perjeleket (/).
   <informalexample>
    <programlisting role="php">
<![CDATA[
<?php
$handle = fopen("c:\\data\\info.txt", "r");
?>
]]>
    </programlisting>
   </informalexample>
  </para>
  &warn.ssl-non-standard;
  &note.sm.uidcheck.dir;
  <simpara>
   Lásd még: <xref linkend="wrappers"/>,
   <function>fclose</function>,
   <function>fgets</function>,
   <function>fread</function>,
   <function>fwrite</function>,
   <function>fsockopen</function>,
   <function>file</function>,
   <function>file_exists</function>,
   <function>is_readable</function>,
   <function>stream_set_timeout</function>,
   <function>popen</function> és
   <function>stream_context_create</function>.
  </simpara>
 </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:"../../../../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
-->