196 PHP i MySQL dla każdego
Parametr nazwa to ciąg znaków, wskazujący nazwę pliku, który ma zostać otwarty; może on zawierać zarówno względną, jak i bezwzględną ścieżkę dostępu. Jeśli ścieżka odstępu nie zostanie podana, plik będzie poszukiwany w katalogu bieżącym. Prawidłowe są zatem przykładowe wartości parametru nazwa:
/us r/tmp/abc/pli kl.zi p ../bcd/płik2.zip .Zplik3.zip plik4.zip
Podczas określania ścieżki dostępu należy pamiętać o tym, że w systemach z rodziny Windows wygląda ona inaczej niż w systemach z rodziny Uniksa. W Windows jako separator poszczególnych elementów ścieżki dostępu występuje znak \, podczas gdy w systemach z rodziny Uniksa — znak /. W Windows często stosowane jest określenie dysku logicznego jako c:, d: itp., podczas gdy w Uniksie mamy katalog główny /. Warto jednak wiedzieć, że jeśli nawet PHP działa na serwerze opartym o system Windows, można stosować uniksowe separatory, np.:
c:/users/documents/
e:/php/temp/
Co więcej, można również zastosować ścieżkę odwołującą się do katalogu głównego /, np.:
/php/temp/
która w takim przypadku będzie oznaczała katalog php/tmp znajdujący się na logicznym dysku bieżącym. Jeżeli więc dyskiem bieżącym jest c:, określenie /php/temp/ będzie oznaczało w rzeczywistości c:\php\temp. Jeżeli zaś dyskiem bieżącym jest d:, będzie oznaczało w rzeczywistości d:\php\temp itd.
Parametr tryb określa tryb otwarcia pliku. Może on przyjmować wartości przedstawione w tabeli 7.1.
Parametr tryb może również zawierać określenie typu pliku: b — dla plików binarnych, bądź t — dla plików tekstowych. Określenie to ma znaczenie jedynie w przypadku systemów operacyjnych, które dokonują rozróżnienia między trybem binarnym i tekstowym (jak np. systemy Windows). W przypadku otwarcia w trybie binarnym dane są odczytywane i zapisywane w plikach bez żadnych modyfikacji. W przypadku otwarcia w trybie tekstowym przetwarzane są znaki końca linii. Dzieje się tak dlatego, że różne systemy w różny sposób określają koniec linii tekstu, np. w przypadku Windows jest to sekwencja \r\n, a w Uniksie znak \n. Począwszy od PHP w wersji 4.3.2 trybem domyślnym otwarcia pliku jest tryb binarny, nie ma zatem potrzeby stosowania znaku b w parametrze tryb.
Funkcja fopen zwraca deskryptor pliku, który służy do wykonywania na nim dalszych operacji, lub też wartość fal se, jeżeli otwarcie się nie powiodło. Po zakończeniu wykonywania operacji na pliku (np. odczytu) powinien on zostać zamknięty za pomocą funkcji fcl ose, której typowe wywołanie ma postać:
fclose(deskryptor)