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

From: Date: Mon, 28 Feb 2005 01:12:33 +0000
Subject: cvs: phpdoc-pl /reference/filesystem/functions fopen.xml
Groups: php.doc.pl 
Request: Send a blank email to doc-pl+get-495@lists.php.net to get a copy of this message
leszek Sun Feb 27 20:12:33 2005 EDT Modified files: /phpdoc-pl/reference/filesystem/functions fopen.xml Log: [adi] update to rev 1.25

http://cvs.php.net/diff.php/phpdoc-pl/reference/filesystem/functions/fopen.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc-pl/reference/filesystem/functions/fopen.xml diff -u phpdoc-pl/reference/filesystem/functions/fopen.xml:1.5 phpdoc-pl/reference/filesystem/functions/fopen.xml:1.6 --- phpdoc-pl/reference/filesystem/functions/fopen.xml:1.5 Sun Feb 2 21:25:07 2003 +++ phpdoc-pl/reference/filesystem/functions/fopen.xml Sun Feb 27 20:12:30 2005 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.2 Maintainer: adi Status: ready --> -<!-- $Revision: 1.5 $ --> - <refentry id="function.fopen"> +<!-- EN-Revision: 1.25 Maintainer: adi Status: ready --> +<!-- $Revision: 1.6 $ --> + <refentry id="function.fopen"> <refnamediv> <refname>fopen</refname> <refpurpose>Otwiera plik lub URL</refpurpose> @@ -9,157 +9,258 @@ <refsect1> <title>Opis</title> <methodsynopsis> - <type>int</type><methodname>fopen</methodname> + <type>resource</type><methodname>fopen</methodname> <methodparam><type>string</type><parameter>nazwa_pliku</parameter></methodparam> <methodparam><type>string</type><parameter>tryb</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>u¿yj_include_path</parameter></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>u¿yj_include_path</parameter></methodparam> + <methodparam choice="opt"><type>resource</type><parameter>zkontekst</parameter></methodparam> </methodsynopsis> <simpara> - Je¶li <parameter>nazwa_pliku</parameter> zaczyna siê od "http://" (nie - jest rozró¿niana wielko¶æ liter), jest otwierane po³±czenie HTTP 1.0 - do wybranego serwera, strona jest ¿±dana u¿ywaj±c metody HTTP GET - i wska¼nik pliku jest ustawiany na pocz±tku cia³a odpowiedzi. - Nag³ówek 'Host:' jest wysy³any z ¿±daniem pozwalaj±cym - uchwyciæ oparte o nazwê wirtualne hosty. - </simpara> - <simpara> - W PHP 4.3.0 (jeszcze nie udostêpnionym), je¶li masz wkompilowane wsparcie dla - OpenSSL, mo¿esz u¿yæ "https://" aby otworzyæ po³±czenie HTTP po SSL. - </simpara> - <simpara> - Zauwa¿, ¿e wska¼nik pliku pozwala tobie odczytaæ tylko - <emphasis>cia³o</emphasis> odpowiedzi; aby uzyskaæ nag³ówek HTTP - musisz u¿yæ wersji PHP 4.0.5 lub nowszej. - Nag³ówki s± przechowywane w zmiennej $http_response_header. - W PHP 4.3.0 (jeszcze nie udostêpnionym), informacja z nag³owka mo¿e - byæ pobrana u¿ywaj±c funkcji <function>file_get_wrapper_data</function>. - </simpara> - <simpara> - Po³±czenia HTTP s± tylko do odczytu, nie mo¿esz zapisaæ danych lub - kopiowaæ plików do zasobu HTTP. - </simpara> - <simpara> - Wersje przed PHP 4.0.5 nie obs³uguj± przekierowañ HTTP. Z tego powodu - katalogi musz± zawieraæ koñcz±ce slashe. - </simpara> - <simpara> - Je¶li <parameter>nazwa_pliku</parameter> zaczyna siê od "ftp://" - (nie jest rozró¿niana wielko¶æ znaków), jest otwierane po³±czenie - ftp do podanego serwera i zwracany jest wska¼nik do ¿±danego pliku. - je¶li serwer nie obs³uguje trybu pasywnego ftp, ta funkcja zawiedzie. - Mo¿esz otwieraæ pliki albo do odczytu lub zapisu przez ftp (ale nie - oba tryby równocze¶nie). Je¶li zdalny plik ju¿ istnieje na serwerze FTP - i spróbujesz otworzyæ go do zapisu, ta funkcja zawiedzie. - je¶li potrzebujesz zmodyfikowaæ istniej±ce pliki przez FTP, u¿yj - <function>ftp_connect</function>. - </simpara> - <simpara> - Je¶li <parameter>nazwa_pliku</parameter> jest jedn± z mo¿liwo¶ci - "php://stdin", "php://stdout" lub "php://stderr" zostanie otworzony - odpowiedni strumieñ stdio. (To zosta³o wprowadzone w PHP 3.0.13; - we wcze¶niejszych wersjach, aby dostaæ siê do strumienia stdio - - nazwa_pliku musi mieæ postaæ "/dev/stdin" lub "/dev/fd/0".) - </simpara> - <simpara> - Je¶li <parameter>nazwa_pliku</parameter> zaczyna siê czymkolwiek innym - zostanie otworzony plik z systemu plików i zostanie zwrócony wska¼nik - pliku. - </simpara> - <simpara> - Je¶li otwieranie siê nie powiedzie, funkcja zwróci &false;. - </simpara> + <function>fopen</function> wi±¿e nazwany zasób, okre¶lony przez + przez <parameter>nazwa_pliku</parameter> do strumienia. Je¶li + <parameter>nazwa_pliku</parameter> jest w formacie "schemat://...", + PHP przyjmuje, ¿e to jest URL i rozpoczyna poszukiwanie programu + obs³ugi protoko³u (róznie¿ zwanego wrapperem) dla tego schematu. + Je¶li nie ma zarejestrowanego wrappera dla tego protoko³u, PHP + wy¶wietli wiadomo¶æ aby pomóc Tobie namierzyæ potencjalne + problemy w Twoim skrypcie i bêdzie kontynuowaæ pracê, traktuj±c + podany <parameter>nazwa_pliku</parameter> jako zwyk³y plik. + </simpara> + <simpara> + Je¶li PHP zdecyduje, ¿e <parameter>nazwa_pliku</parameter> okre¶la + lokalny plik, wtedy spróbuje otworzyæ strumieñ na tym pliku. + Plik musi byæ dostêpny dla PHP, wiêc musisz zapewniæ prawa + dostêpu do pliku pozwalaj±ce na tak± operacjê. + Je¶li masz w³±czone &safemode; lub <link linkend="ini.open-basedir">open_basedir</link> + mog± mieæ zastosowanie dodatkowe restrykcje. + </simpara> + <simpara> + Je¶li PHP zdecyduje, ¿e <parameter>nazwa_pliku</parameter> okre¶la + zarejestrowany protokó³ i ten protokó³ jest zarejestowany jako + sieciowy URL, PHP sprawdzi <link linkend="ini.allow-url-fopen">allow_url_fopen</link> + czy jest w³±czone. Je¶li jest wy³±czone (off), PHP wy¶wietli ostrze¿enie + i wywo³anie fopen zakoñczy siê niepowodzeniem. + </simpara> + <note> + <simpara> + Listê obs³ugiwanych protoko³ów mo¿esz znale¼æ w <xref linkend="wrappers"/>. + Niektóre protoko³y (równie¿ okre¶lane przez <literal>wrappery</literal> obs³uguj± + <literal>kontekst</literal> lub/i opcje &php.ini;. + Odwo³aj siê do konkretnej strony protoko³u aby uzyskaæ listê opcji jakie + mog± zostaæ ustawione (np. &php.ini; warto¶æ + <literal>user_agent</literal> u¿ywana przez wrapper <literal>http</literal>). + Po opis of <literal>kontekstów</literal> i parametru <parameter>zkontekst</parameter>, + zajrzyj do <xref linkend="ref.stream"/>. + </simpara> + </note> + &note.context-support; + <note> + <simpara> + Od PHP 4.3.2 domy¶lny tryb ustawiany jest na binarny, dla wszystkich + platform, które rozró¿niaj± tryby binarne i tekstowe. Je¶li masz + problemy ze skryptem po aktualizacji, spróbuj u¿yæ flagi <literal>'t'</literal> + jako obej¶cie dopóki nie uczynisz Twojego skryptu bardziej przeno¶nym + jak opisano ni¿ej. + </simpara> + </note> <para> - <parameter>tryb</parameter> mo¿e byæ dowolny z poni¿szych: - <itemizedlist> - <listitem> - <simpara> - 'r' - Otwórz tylko do odczytu; ustawia wska¼nik pliku na pocz±tku - pliku. - </simpara> - </listitem> - <listitem> - <simpara> - 'r+' - Otwórz do odczytu i zapisu; ustawia wska¼nik pliku na pocz±tku - pliku. - </simpara> - </listitem> - <listitem> - <simpara> - 'w' - Otwórz tylko do zapisu; ustawia wska¼nik pliku na pocz±tku - pliku i obcina plik (zeruje) do 0 d³ugo¶ci. - Je¶li plik nie istnieje to próbuje go utworzyæ. - </simpara> - </listitem> - <listitem> - <simpara> - 'w+' - Otwórz do odczytu i zapisu; ustawia wska¼nik pliku na pocz±tku - pliku i obcina plik (zeruje) do 0 d³ugo¶ci. - Je¶li plik nie istnieje to próbuje go utworzyæ. - </simpara> - </listitem> - <listitem> - <simpara> - 'a' - Otwórz tylko do zapisu; ustawia wska¼nik pliku na koñcu - pliku. Je¶li plik nie istnieje to próbuje go utworzyæ. - </simpara> - </listitem> - <listitem> - <simpara> - 'a+' - Otwórz do odczytu i zapisu; ustawia wska¼nik pliku na koñcu - pliku. Je¶li plik nie istnieje to próbuje go utworzyæ. - </simpara> - </listitem> - </itemizedlist> + Parametr <parameter>tryb</parameter> okre¶la rodzaj dostêpu jaki + wymagasz do strumienia. Mo¿e byæ dowolny z nastêpuj±cych: + <table> + <title> + Lista mo¿liwych trybów dla <function>fopen</function> + u¿ywaj±c <parameter>tryb</parameter> + </title> + <tgroup cols="2"> + <thead> + <row> + <entry><parameter>tryb</parameter></entry> + <entry>Opis</entry> + </row> + </thead> + <tbody> + <row> + <entry><literal>'r'</literal></entry> + <entry> + Otwiera tylko do odczytu; umieszcza wska¼nik pliku na jego pocz±tku. + </entry> + </row> + <row> + <entry><literal>'r+'</literal></entry> + <entry> + Otwiera do odczytu i zapisu; umieszcza wska¼nik pliku na jego pocz±tku. + </entry> + </row> + <row> + <entry><literal>'w'</literal></entry> + <entry> + Otwiera tylko do zapisu; umieszcza wska¼nik pliku na jego pocz±tku + i obcina plik do zerowej d³ugo¶ci. Je¶li plik nie istnieje to + próbuje go utworzyæ. + </entry> + </row> + <row> + <entry><literal>'w+'</literal></entry> + <entry> + Otwiera do odczytu i zapisu; umieszcza wska¼nik pliku na jego pocz±tku + i obcina plik do zerowej d³ugo¶ci. Je¶li plik nie istnieje to + próbuje go utworzyæ. + </entry> + </row> + <row> + <entry><literal>'a'</literal></entry> + <entry> + Otwiera tylko do zapisu; umieszcza wska¼nik pliku na jego koñcu. + Je¶li plik nie istnieje to próbuje go utworzyæ. + </entry> + </row> + <row> + <entry><literal>'a+'</literal></entry> + <entry> + Otwiera do odczytu i zapisu; umieszcza wska¼nik pliku na jego koñcu. + Je¶li plik nie istnieje to próbuje go utworzyæ. + </entry> + </row> + <row> + <entry><literal>'x'</literal></entry> + <entry> + Tworzy i otwiera plik tylko do zapisu; umieszcza wska¼nik pliku na + jego pocz±tku. Je¶li plik juz istnieje, wywo³anie <function>fopen</function> + nie powiedzie siê, zwróci &false; i wygeneruje b³±d na poziomie + <constant>E_WARNING</constant>. Je¶li plik nie istnieje, spróbuje go + utworzyæ. To jest równowa¿ne z okre¶leniem flag <literal>O_EXCL|O_CREAT</literal> + stosowanym w wywo³aniu systemowym <literal>open(2)</literal>. Ta opcja + jest obs³ugiwana w PHP 4.3.2 i pó¼niejszych i dzia³a tylko na plikach + lokalnych. + </entry> + </row> + <row> + <entry><literal>'x+'</literal></entry> + <entry> + Tworzy i otwiera plik odczytu i zapisu; umieszcza wska¼nik pliku na + jego pocz±tku. Je¶li plik juz istnieje, wywo³anie <function>fopen</function> + nie powiedzie siê, zwróci &false; i wygeneruje b³±d na poziomie + <constant>E_WARNING</constant>. Je¶li plik nie istnieje, spróbuje go + utworzyæ. To jest równowa¿ne z okresleniem flag <literal>O_EXCL|O_CREAT</literal> + stosowanym w wywo³aniu systemowym <literal>open(2)</literal>. Ta opcja + jest obs³ugiwana w PHP 4.3.2 i pó¼niejszych i dzia³a tylko na plikach + lokalnych. + </entry> + </row> + </tbody> + </tgroup> + </table> </para> <note> <para> - Parametr <parameter>tryb</parameter> mo¿e zawieraæ literê - 'b'. To jest u¿yteczne tylko na systemach, które rozró¿niaj± - pliki pomiêdzy binarne i tekstowe (np. Windows. To jest - bezu¿yteczne na Unixach) - Je¶li nie potrzebne zostanie zignorowane. - </para> + Ró¿ne rodziny systemów operacyjnych stosuja rózne konwencje koñca lini. + Kiedy zapisujesz plik tekstowy i chcesz wstawiæ ³amanie lini, musisz + u¿yæ poprawnych dla twojego systemu operacyjnego znak(ów) koñca lini. + Systemy bazuj±ce na Uniksie u¿ywaj± <literal>\n</literal> jako + znaku koñca lini, systemy bazuj±ce na Windowsie u¿ywaj± <literal>\r\n</literal> + jako znaków koñca lini, a systemy Macintosh u¿ywaj± <literal>\r</literal> + jako znak koñca lini. + </para> + <para> + Je¶li u¿yjesz nieprawid³owego koñca lini do zapisu pliku, mo¿esz + zaobserwowaæ, w innych aplikacjach otwieraj±c ten plik, ¿e "wygl±da on + zabawnie". + </para> + <para> + Windows oferuje flagê (<literal>'t'</literal>) konwertuj±c± tryb tekstowy, + która przezroczy¶cie przek³ada <literal>\n</literal> na + <literal>\r\n</literal> kiedy pracujesz z plikiem. Dla kontrastu, mo¿esz + tak¿e uzyæ <literal>'b'</literal> aby wymusiæ tryb binarny, wtedy + nie bêdzie konwertowaæ twoich danych. Aby u¿yæ tych flag, wstaw + <literal>'b'</literal> lub <literal>'t'</literal> jako ostatni + znak w parametrze <parameter>tryb</parameter>. + </para> + <para> + Domy¶lnie tryb konwersji zale¿y od SAPI i wersji PHP jakiej u¿ywasz, + wiêc namawiamy aby zawsze podawaæ stosown± flage w celu przeno¶no¶ci. + Powiniene¶ u¿yæ trybu <literal>'t'</literal> je¶li pracujesz ze + zwyk³ymi plikami tekstowymi (plain-text)i u¿ywasz <literal>\n</literal> + do ograniczenia konców lini w twoim skrypcie, ale wymagasz aby twój + plik by³ czytelny w aplikacjach takich jak notatnik. Powiniene¶ uzyæ + <literal>'b'</literal> w ka¿dym innym przypadku. + </para> + <para> + Je¶li nie podasz flagi 'b' kiedy pracujesz na binarnych plikach, mo¿esz + do¶wiadczyæ dziwnych problemów z twoimi danymi, w³±czaj±c uszkodzone pliki + graficzne i dziwne problemy ze znakami <literal>\r\n</literal>. + </para> + </note> + <note> + <para> + Dla przeno¶no¶ci, bardzo zalecane jest u¿ycie zawsze flagi 'b' + kiedy otwierasz pliki za pomoc± <function>fopen</function>. + </para> + </note> + <note> + <para> + Ponownie, dla przeno¶no¶ci, jest równie¿ bardzo zalecane aby¶, + przepisa³ swój kod, który u¿ywa lub polega na trybie <literal>'t'</literal> + tak aby u¿ywa³ poprawnego koñca lini oraz trybu <literal>'b'</literal>. + </para> </note> <para> - Mo¿esz u¿yæ opcjonalnego 3 parametru i ustawiæ go na "1", je¶li - chcesz szukaæ pliku tak¿e w - <link linkend="ini.include-path">include_path</link>. + Opcjonalny trzeci parametr <parameter>u¿yj_include_path</parameter> + mo¿e byæ ustawiony na '1' lub &true; je¶li chcesz szukaæ pliku tak¿e w + <link linkend="ini.include-path">include_path</link>. </para> + <simpara> + Je¶li otwieranie siê nie powiedzie, funkcja zwróci &false; i + wygenerowany zostanie b³±d na poziomie <constant>E_WARNING</constant>. + Mo¿esz u¿yæ <link linkend="language.operators.errorcontrol">@</link> aby + zatuszowaæ to ostrze¿enie. + </simpara> <para> <example> - <title><function>fopen</function> przyk³ad</title> + <title><function>fopen</function> przyk³ady</title> <programlisting role="php"> <![CDATA[ -$fp = fopen ("/home/rasmus/file.txt", "r"); -$fp = fopen ("/home/rasmus/file.gif", "wb"); -$fp = fopen ("http://www.example.com/", "r"); -$fp = fopen ("ftp://user:password@example.com/", "w"); +<?php +$handle = fopen("/home/rasmus/plik.txt", "r"); +$handle = fopen("/home/rasmus/plik.gif", "wb"); +$handle = fopen("http://www.przyklad.com/", "r"); +$handle = fopen("ftp://uzytkownik:haslo@przyklad.com/jakisplik.txt", "w"); +?> ]]> </programlisting> </example> </para> <simpara> - Je¶li do¶wiadczasz problemów z czytaniem i zapisywaniem do plików - i u¿ywasz PHP jako modu³ serwera, pamiêtaj, ¿e pliki i katalogi - które u¿ywasz musz± byæ osi±galne dla procesu serwera. - </simpara> + Je¶li do¶wiadczasz problemów z odczytem lub zapisywaniem do plików i + u¿ywasz PHP w postaci modu³u serwera, pamiêtaj, ¿eby siê upewniæ, ¿e + pliki i katalogi, których u¿ywasz s± dostêpne dla procesu serwera. + </simpara> <para> - Na platformach Windows, uwa¿aj na zastosowanie znaków ucieczki - dla wszystkich u¿ytych w ¶cie¿ce do pliku backslashy, lub - u¿yj slash'y. + Na platformie Windows, dbaj aby wstawiaæ znaki ucieczki (escape) + przed wszystkimi lewymi uko¶nikami (backslash) u¿ytymi w ¶cie¿ce do + pliku lub u¿ywaæ uko¶ników (slash). <informalexample> <programlisting role="php"> <![CDATA[ -$fp = fopen ("c:\\data\\info.txt", "r"); +<?php +$handle = fopen("c:\\data\\info.txt", "r"); +?> ]]> </programlisting> </informalexample> </para> + &warn.ssl-non-standard; + &note.sm.uidcheck.dir; <simpara> - Patrz tak¿e: <function>fclose</function>, + Patrz tak¿e: <xref linkend="wrappers"/>, + <function>fclose</function>, + <function>fgets</function>, + <function>fread</function>, + <function>fwrite</function>, <function>fsockopen</function>, - <function>socket_set_timeout</function> i + <function>file</function>, + <function>file_exists</function>, + <function>is_readable</function>, + <function>stream_set_timeout</function> i <function>popen</function>. </simpara> </refsect1> @@ -184,4 +285,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +-->
« previous php.doc.pl (#495) next »