Darmowe Forum

fopen

(PHP 4, PHP 5)

fopen — Otwiera plik lub URL

Opis 

resource fopen ( string $nazwa_pliku , string $tryb [, bool $uÂżyj_include_path [, resource 

$kontekst ]] )

fopen() wi¹¿e nazwany zasĂłb, okreÂślony przez nazwa_pliku, do strumienia.

Parametry

nazwa_pliku

JeÂśli nazwa_pliku jest w postaci "schemat://...", to przypuszczalnie jest to URL i PHP szuka 

protokoÂłu obsÂługi (takÂże zwanego wrapper'em) dla tego schematu. JeÂśli nie zarejestrowano 

Âżadnego wrapper'a dla tego protokoÂłu, PHP wyemituje notatkĂŞ, aby pomĂłc Tobie w wyÂśledzeniu 

potencajalnego problemu w Twoim skrypcie nastĂŞpnie bĂŞdzie kontynuowaĂŚ z podanym 

nazwa_pliku traktujÂąc go jako zwykÂły plik.

JeÂśli PHP zdecyduje, Âże nazwa_pliku 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 tryb bezpieczny lub open_basedir mogÂą 

mieĂŚ zastosowanie dodatkowe restrykcje.

JeÂśli PHP zdecyduje, Âże nazwa_pliku okreÂśla zarejestrowany protokó³ i ten protokó³ jest 

zarejestowany jako sieciowy URL, PHP sprawdzi allow_url_fopen czy jest w³¹czone. JeÂśli jest 

wy³¹czone (off), PHP wyÂświetli ostrzeÂżenie i wywoÂłanie fopen zakoĂączy siĂŞ niepowodzeniem.

Informacja:

ListĂŞ obsÂługiwanych protoko³ów moÂżesz znaleŸÌ w Supported Protocols and Wrappers. 

NiektĂłre protokoÂły (rĂłwnieÂż okreÂślane przez wrappery obsÂługujÂą kontekst 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œÌ user_agent uÂżywana przez wrapper http).

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).

<?php

     $handle = fopen("c:\\data\\info.txt", "r");

     ?>

Parametr tryb okreÂśla rodzaj dostĂŞpu jaki wymagasz do strumienia. MoÂże byĂŚ dowolny z 

nastĂŞpujÂących:

tryb Opis

'r' Otwiera tylko do odczytu; umieszcza wskaÂźnik pliku na jego poczÂątku.

'r+' Otwiera do odczytu i zapisu; umieszcza wskaÂźnik pliku na jego poczÂątku.

'w' 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ĂŚ.

'w+' 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ĂŚ.

'a'  Otwiera tylko do zapisu; umieszcza wskaÂźnik pliku na jego koĂącu.   

JeÂśli plik nie istnieje to prĂłbuje go utworzyĂŚ.

'a+' Otwiera do odczytu i zapisu; umieszcza wskaÂźnik pliku na jego koĂącu.   JeÂśli 

plik nie istnieje to prĂłbuje go utworzyĂŚ.

'x'  Tworzy i otwiera plik tylko do zapisu; umieszcza wskaÂźnik pliku na   

jego poczÂątku. JeÂśli plik juz istnieje, wywoÂłanie fopen()   nie powiedzie siĂŞ, 

zwrĂłci FALSE i wygeneruje b³¹d na poziomie   E_WARNING. JeÂśli plik nie 

istnieje, sprĂłbuje go   utworzyĂŚ. To jest rĂłwnowaÂżne z okreÂśleniem flag 

O_EXCL|O_CREAT stosowanym w wywoÂłaniu systemowym open(2).

'x+' Tworzy i otwiera plik odczytu i zapisu; umieszcza wskaÂźnik pliku na jego 

poczÂątku. JeÂśli plik juz istnieje, wywoÂłanie fopen() nie powiedzie siĂŞ, zwrĂłci 

FALSE i wygeneruje b³¹d na poziomie E_WARNING. JeÂśli plik nie istnieje, 

sprĂłbuje go utworzyĂŚ. To jest rĂłwnowaÂżne z okresleniem flag 

O_EXCL|O_CREAT stosowanym w wywoÂłaniu systemowym open(2). 

Informacja:

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Âą \n jako znaku koĂąca 

lini, systemy bazujÂące na Windowsie uÂżywajÂą \r\n jako znakĂłw koĂąca lini, a systemy Macintosh 

uÂżywajÂą \r jako znak koĂąca lini.

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".

Windows oferuje flagĂŞ ('t') konwertujÂącÂą tryb tekstowy, ktĂłra przezroczyÂście przekÂłada \n na \r\n 

kiedy pracujesz z plikiem. Dla kontrastu, moÂżesz takÂże uzyĂŚ 'b' aby wymusiĂŚ tryb binarny, wtedy 

nie bĂŞdzie konwertowaĂŚ twoich danych. Aby uÂżyĂŚ tych flag, wstaw 'b' lub 't' jako ostatni znak w 

parametrze tryb.

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 't' jeÂśli pracujesz 

ze zwykÂłymi plikami tekstowymi (plain­text)i uÂżywasz \n do ograniczenia koncĂłw lini w twoim 

skrypcie, ale wymagasz aby twĂłj plik byÂł czytelny w aplikacjach takich jak notatnik. PowinieneÂś 

uzyĂŚ 'b' w kaÂżdym innym przypadku.

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 \r\n.

Informacja:

Dla przenoÂśnoÂści, bardzo zalecane jest uÂżycie zawsze flagi 'b' kiedy otwierasz pliki za pomocÂą 

fopen().

Informacja:

Ponownie, dla przenoÂśnoÂści, jest rĂłwnieÂż bardzo zalecane abyÂś, przepisaÂł swĂłj kod, ktĂłry

uÂżywa lub polega na trybie 't' tak aby uÂżywaÂł poprawnego koĂąca lini oraz trybu 'b'.

uÂżyj_include_path

Opcjonalny trzeci parametr uÂżyj_include_path moÂże byĂŚ ustawiony na '1' lub TRUE jeÂśli chcesz

szukaĂŚ pliku takÂże w include_path.

kontekst

Informacja: ObsÂługa kontekstĂłw zostaÂła dodana w PHP 5.0.0. Opis kontekstĂłw znajduje siĂŞ w 

rozdziale Stream Funkcje.

Zwracane wartoÂści 

Zwraca wskaÂźnik pliku do zasobu w przypadku sukcesu lub FALSE przy b³êdzie.

B³êdy/WyjÂątki 

JeÂśli otwieranie siĂŞ nie powiedzie, funkcja wygeneruje b³¹d na poziomie E_WARNING. MoÂżesz 

uÂżyĂŚ @ aby zatuszowaĂŚ to ostrzeÂżenie.