diff --git a/reference/filesystem/functions/basename.xml b/reference/filesystem/functions/basename.xml index efb4d748..00424561 100644 --- a/reference/filesystem/functions/basename.xml +++ b/reference/filesystem/functions/basename.xml @@ -1,19 +1,19 @@ - + - - + + basename Zwraca nazwę pliku, będącego składową ścieżki - + &reftitle.description; stringbasename - stringścieżka - stringprzyrostek + stringpath + stringsuffix"" Z podanego łańcucha zawierającego ścieżkę do pliku, funkcja @@ -31,6 +31,8 @@ basename bierze pod uwagę obecnią lokalizację systemu, więc aby widzieć prawidłowe basename ze ścieżek zawierających znaki spoza alfabetu łacińskiego, musi zostać ustawiona odpowiednia lokalizacja przy pomocy funkcji setlocale. + Jeśli parametr path zawiera znaki, które są nieprawidłowe dla + bieżących ustawień regionalnych, zachowanie basename jest niezdefiniowane. @@ -40,7 +42,7 @@ - ścieżka + path Ścieżka @@ -53,10 +55,10 @@ - przyrostek + suffix - Jeśli plik kończy się przyrostkiem to także zostanie on + Jeśli plik kończy się przyrostkiem suffix to także zostanie on obcięty. @@ -115,7 +117,6 @@ echo "6) ".basename("/"); - + - - + + clearstatcache Czyści bufor statusu pliku - + &reftitle.description; voidclearstatcache - boolclear_realpath_cachefalse - stringnazwa_pliku + boolclear_realpath_cache&false; + stringfilename"" Kiedy używasz stat, lstat lub @@ -31,7 +31,7 @@ Jeśli wywołasz file_exists na pliku, który nie istnieje zostanie zwrócone &false; dopóki nie stworzysz tego pliku. Jeśli go utworzysz funkcja zwróci &true; nawet jeśli go później skasujesz. - Jednakże unlink czyści automatycznie bufor. + Jednakże unlink czyści automatycznie bufor. @@ -71,12 +71,12 @@ clear_realpath_cache - Czy czyścić bufor o prawdziwej ścieżce, czy nie. + Czy czyścić również bufor ścieżki prawdziwej. - nazwa_pliku + filename Czyści bufor o prawdziwej ścieżce tylko dla podanego pliku; tylko jeśli @@ -95,31 +95,6 @@ - - &reftitle.changelog; - - - - - - &Version; - &Description; - - - - - 5.3.0 - - Dodano opcjonalne parametry clear_realpath_cache - i filename. - - - - - - - - &reftitle.examples; @@ -162,7 +137,6 @@ UID @ Sun, 12 Oct 2008 20:48:28 +0100: ross - + + copy Kopiuje plik - + &reftitle.description; boolcopy - stringźródło - stringprzeznaczenie - resourcekontekst + stringfrom + stringto + resourcenull + context&null; - Kopiuje plik z źródło do - przeznaczenie. + Kopiuje plik z parametru from do + parametru to. Jeśli chcesz przenieść plik, użyj funkcji rename. @@ -29,7 +31,7 @@ - źródło + from Ścieżka do pliku źródłowego. @@ -37,10 +39,10 @@ - przeznaczenie + to - Ścieżka docelowa. Jeśli przeznaczenie jest URLem, + Ścieżka docelowa. Jeśli parametr to jest URLem, operacja kopiowania może się niepowieść, jeśli wrapper nie obsługuje nadpisywania istniejących plików. @@ -71,48 +73,9 @@ - - &reftitle.changelog; - - - - - - &Version; - &Description; - - - - - 5.3.4 - - Parametr kontekst faktycznie ma wpływ. - Wcześniej dowolny kontekst był ignorowany. - - - - 5.3.0 - - Dodano obsługę kontekstu. - - - - 4.3.0 - - Zarówno źródło i przeznaczenie - mogą być URLami jeśli "wrappery fopen" zostały włączone. - Zobacz fopen w celu poznania więcej szczegółów. - - - - - - - - - + &reftitle.examples; - + <function>copy</function> przykład @@ -137,7 +100,7 @@ if (!copy($file, $newfile)) { move_uploaded_file rename - Rozdział podręcznika dotyczącyRozdział podręcznika dotyczącyobsługi wgrywania plików diff --git a/reference/filesystem/functions/delete.xml b/reference/filesystem/functions/delete.xml index 70395d22..c247358f 100644 --- a/reference/filesystem/functions/delete.xml +++ b/reference/filesystem/functions/delete.xml @@ -1,19 +1,20 @@ - + - + + delete Zobacz unlink lub unset - + &reftitle.description; - To jest ślepy wpis aby zadowolić ludzi którzy szukają - unlink lub unset - w nie właściwym miejscu. + W języku PHP nie ma słowa kluczowego ani funkcji delete. + Jeśli trafiłeś na tę stronę w celu usunięcia pliku, wypróbuj funkcję unlink. + Aby usunąć zmienną z zakresu lokalnego, sprawdź funkcję unset. @@ -26,7 +27,7 @@ - + + + dirname @@ -11,8 +12,8 @@ &reftitle.description; stringdirname - stringścieżka - intpoziomy1 + stringpath + intlevels1 Z podanego łańcucha zawierającego ścieżkę do pliku, funkcja ta @@ -28,9 +29,16 @@ - dirname bierze pod uwagę ustawioną lokalizację i aby widzieć - prawidłową nazwę katalogu z ścieżek z wielobajtowymi znakami, musi zostać - ustawiona właściwa lokalizacja, za pomocą funkcji setlocale. + W systemie Windows, dirname przyjmuje aktualnie ustawioną stronę kodową, + więc aby zobaczyć poprawną nazwę katalogu z wielobajtowymi ścieżkami znakowymi, + musi być ustawiona odpowiednia strona kodowa. + Jeśli parametr path zawiera znaki, które są nieprawidłowe + dla bieżącej strony kodowej, zachowanie dirname jest niezdefiniowane. + + + W innych systemach dirname zakłada, że parametr path + jest zakodowany w kodowaniu zgodnym z ASCII. W przeciwnym razie zachowanie funkcji + jest niezdefiniowane. @@ -43,7 +51,7 @@ path - A path. + Ścieżka. W Windows jako separator katalogu używany jest znak slash @@ -53,7 +61,7 @@ - poziomy + levels Ilość katalogów w górę, które należy przejść. @@ -70,12 +78,31 @@ &reftitle.returnvalues; - Zwraca nazwę katalogu. Jeśli, w ścieżce nie znajdują się + Zwraca nazwę katalogu. Jeśli w parametrze path nie znajdują się ukośniki to zwracana jest kropka ('.'), oznaczająca - bieżący katalog. W innym przypadku, zwracany jest łańcuch znaków - ścieżka z usuniętymi wszystkimi koncowymi - /komponentami. + bieżący katalog. W innym przypadku, zwracany jest łańcuch znaków + parametru path z usuniętymi wszystkimi końcowymi + /komponentami. + + + + Należy zachować ostrożność podczas korzystania z tej funkcji w pętli, która może dotrzeć do + katalogu najwyższego poziomu, ponieważ może to spowodować nieskończoną pętlę. + + + +]]> + + + + @@ -93,13 +120,7 @@ 7.0.0 - Dodano opcjonalny parametr poziomy. - - - - 5.0.0 - - dirname od teraz jest binarnie bezpieczna + Dodano opcjonalny parametr levels. diff --git a/reference/filesystem/functions/disk-free-space.xml b/reference/filesystem/functions/disk-free-space.xml index a35314d9..64514768 100644 --- a/reference/filesystem/functions/disk-free-space.xml +++ b/reference/filesystem/functions/disk-free-space.xml @@ -1,6 +1,7 @@ - + + disk_free_space @@ -10,8 +11,8 @@ &reftitle.description; - floatdisk_free_space - stringkatalog + floatfalsedisk_free_space + stringdirectory Podając łańcuch zawierający katalog, funkcja zwróci liczbę @@ -25,7 +26,7 @@ - katalog + directory Katalog w systemie plików lub partycji dysku. diff --git a/reference/filesystem/functions/disk-total-space.xml b/reference/filesystem/functions/disk-total-space.xml index a00d71a7..42c43fc1 100644 --- a/reference/filesystem/functions/disk-total-space.xml +++ b/reference/filesystem/functions/disk-total-space.xml @@ -1,17 +1,18 @@ - + + disk_total_space Zwraca całkowity rozmiar systemu plików lub partycji dysku - + &reftitle.description; - floatdisk_total_space - stringkatalog + floatfalsedisk_total_space + stringdirectory Podając łańcuch zawierający katalog, funkcja ta zwróci całkowitą @@ -24,7 +25,7 @@ - katalog + directory Katalog w systemie plików lub partycji dysku. diff --git a/reference/filesystem/functions/fclose.xml b/reference/filesystem/functions/fclose.xml index d0b648d5..134c85b0 100644 --- a/reference/filesystem/functions/fclose.xml +++ b/reference/filesystem/functions/fclose.xml @@ -1,7 +1,8 @@ - + - + + fclose Zamyka otwarty wskaźnik pliku @@ -11,10 +12,10 @@ &reftitle.description; boolfclose - resourceuchwyt + resourcestream - Zamyka wskaźnik pliku uchwyt. + Zamyka pliku wskazany przez strumień stream. @@ -23,7 +24,7 @@ - uchwyt + stream Wskaźnik pliku musi byc prawidłowy i musi wskazywać na plik poprawnie @@ -51,9 +52,9 @@ ]]> @@ -73,7 +74,6 @@ fclose($uchwyt); - + - + + feof Sprawdza czy wskaźnik pliku jest na końcu pliku (EOF) @@ -11,7 +12,7 @@ &reftitle.description; boolfeof - resourceuchwyt + resourcestream Sprawdza czy wskaźnik pliku jest na końcu pliku (EOF). @@ -23,7 +24,7 @@ - uchwyt + stream &fs.validfp.all; @@ -83,7 +84,7 @@ while(!safe_feof($fp, $start) && (microtime(true) - $start) < $timeout) - + - + + fflush - Przekierowuje wyjście do pliku + Przekierowuje wyjście do fileu &reftitle.description; boolfflush - resourceuchwyt + resourcestream Ta funkcja wymusza zapis całego zbuforowanego wyjścia do zasobu wskazywanego - przez plik uchwyt. + przez file stream. @@ -24,7 +25,7 @@ - uchwyt + stream &fs.validfp.all; @@ -39,30 +40,30 @@ &return.success; - + &reftitle.examples; - Przykład zapisu do pliku używając <function>fflush</function> + Przykład zapisu do fileu używając <function>fflush</function> ]]> - + &reftitle.seealso; @@ -74,7 +75,6 @@ fclose($plik); - + - + + fgetc Pobiera znak ze wskaźnika pliku - + &reftitle.description; - stringfgetc - resourceuchwyt + stringfalsefgetc + resourcestream Pobiera znak ze wskaźnika pliku. @@ -23,7 +24,7 @@ - uchwyt + stream &fs.validfp.all; @@ -36,7 +37,7 @@ &reftitle.returnvalues; Zwraca łańcuch znaków zawierający pojedynczy znak odczytany z pliku wskazanego - przez uchwyt. Zwraca &false; lub EOF. + przez parametr stream. Zwraca &false; lub EOF. &return.falseproblem; @@ -49,9 +50,9 @@ - + + fgetcsv @@ -10,12 +11,12 @@ &reftitle.description; - arrayfgetcsv - resourceuchwyt - intdługość0 - stringdelimiter"," - stringogranicznik'"' - stringucieczka"\" + arrayfalsefgetcsv + resourcestream + intnulllength&null; + stringseparator"," + stringenclosure"\"" + stringescape"\\" Działa podobnie do fgets tylko, że @@ -23,6 +24,13 @@ w formacie CSV i zwraca tablicę zawierającą odczytane pola. + + + Ta funkcja uwzględnia ustawienia regionalne. Jeśli stała + LC_CTYPE ma wartość np. en_US.UTF-8, pliki w + kodowaniu jednobajtowym mogą być błędnie odczytywane przez tę funkcję. + + @@ -30,53 +38,68 @@ - uchwyt + stream - Ważny uchwyt pliku, poprawnie otwartego za pomocą - fopen, popen lub + Ważny uchwyt pliku, poprawnie otwartego za pomocą + fopen, popen lub fsockopen. - długość + length Musi być większy niż najdłuższa linia (w znakach), która znajduje się w pliku CSV (wliczając znaki końca lini). W przeciwnym wypadku linia - jest dzielona na kawałki o podanej długośći, + jest dzielona na kawałki o podanej lengthi, chyba że linia miałaby być podzielona wewnątrz ogranicznika. - Opuszczenie tego parametru (lub ustawienie go na 0 w PHP - 5.1.0 lub późniejszym) spowoduje, że maksymalna długość lini nie jest limitowana, + Pominięcie tego parametru (lub ustawienie go na 0 lub &null; w PHP + 8.0.0 lub późniejszym) spowoduje, że maksymalna długość lini nie jest limitowana, co jest nieznacznie wolniejsze. - delimiter + separator - Ustawia delimeter (tylko jeden znak) pól. + Opcjonalny parametr separator ustawia separator pola + (tylko jeden znak jednobajtowy). - ogranicznik + enclosure - Ustawia znak ograniczający pole. + Opcjonalny parametr enclosure ustawia znak obudowy pola + (tylko jeden znak jednobajtowy). - ucieczka + escape - Ustawia znak ucieczki (tylko jeden znak). Domyślnie jest to odwrotny ukośnik. - + Opcjonalny parametr escape ustawia znak ucieczki (co najwyżej jeden znak jednobajtowy). + Pusty ciąg znaków ("") wyłącza zastrzeżony mechanizm ucieczki. + + + + Zazwyczaj znak enclosure jest unikany wewnątrz pola + poprzez jego podwojenie; jednak znak escape + może być użyty jako alternatywa. Tak więc dla domyślnych wartości + parametrów "" i \" mają takie samo + znaczenie. Poza umożliwieniem ucieczki przed znakiem + enclosure, znak + escape nie specjalnego znaczenia; nie jest nawet + przeznaczony do ucieczki przed samym sobą. + + @@ -86,7 +109,7 @@ &reftitle.returnvalues; - Zwraca indeksowaną tablicę zawierającą odczytane pola. + Zwraca indeksowaną tablicę zawierającą odczytane pola w przypadku powodzenia, &return.falseforfailure;. @@ -96,11 +119,6 @@ ¬e.line-endings; - - fgetcsv zwraca &null; jeśli dostarczono - niewłaściwy uchwyt lub &false; w przypadku innego błędu, - włączając w to koniec pliku. - @@ -116,22 +134,16 @@ - 5.3.0 + 8.0.0 - Dodano parametr ucieczka + Parametrlength akceptuje teraz wartość null. - 5.1.0 + 7.4.0 - Parametr długość stał się opcjonalny. - Domyślnie ustawiony na 0, co oznacza brak limitu. - - - - 4.3.5 - - fgetcsv stał się bezpiecznym dla danych binarnych + Parametr escape akceptuje teraz również pusty + ciąg znaków, aby wyłączyć zastrzeżony mechanizm ucieczki. @@ -152,16 +164,16 @@ $num pól w lini $row:

\n"; + echo "

$num fields in line $row:

\n"; $row++; for ($c=0; $c < $num; $c++) { echo $data[$c] . "
\n"; } } -fclose ($uchwyt); +fclose ($handle); } ?> ]]> @@ -170,18 +182,6 @@ fclose ($uchwyt); - - &reftitle.notes; - - - Ustawienia lokale są brane pod uwagę przez tę funkcję. Jeśli - LANG jest ustawione na np. en_US.UTF-8, - pliki z jedno bajtowym kodowaniem zostaną nieprawidłowo odczytane - przez funkcję. - - - - &reftitle.seealso; @@ -196,7 +196,6 @@ fclose ($uchwyt); - + + fgets Pobiera linię ze wskaźnika pliku - + &reftitle.description; - stringfgets - resourceuchwyt - intdługość + stringfalsefgets + resourcestream + intnull + length&null; Pobiera linię ze wskaźnika pliku. @@ -24,28 +26,20 @@ - uchwyt + stream &fs.validfp.all; - długość + length - Kończy czytanie gdy przeczytano długość - 1 bajtów, + Kończy czytanie gdy przeczytano length - 1 bajtów, na znaku nowej linii (który jest dołączony do zwracanej wartości), lub na końcu pliku (EOF) (cokolwiek wystąpi wcześniej). Jeśli, nie określono długości, czytanie ze strumienia będzie kontynuowane do czasu osiągnięcia końca linii. - - - Do wersji PHP 4.3.0, pominięcie powodowało ustawienie długości na 1024. - Jeśli większość linii w pliku jest dłuższa od 8KB, - dużo efektywniejsze jest podanie maksymalnej - długości linii. - - @@ -55,8 +49,8 @@ &reftitle.returnvalues; - Zwraca łańcuch znaków o długości - 1 bajtów odczytanych ze - wskaźnika pliku wskazanego przez uchwyt. Jeśli nie ma więcej danych + Zwraca łańcuch znaków o długości length - 1 bajtów odczytanych ze + wskaźnika pliku wskazanego przez stream. Jeśli nie ma więcej danych do przeczytania ze wskaźnika pliku to zwraca &false; @@ -64,30 +58,6 @@ - - &reftitle.changelog; - - - - - - &Version; - &Description; - - - - - 4.3.0 - - fgets stał się bezpieczny dla danych binarnych - - - - - - - - &reftitle.examples; @@ -96,15 +66,15 @@ ]]> diff --git a/reference/filesystem/functions/fgetss.xml b/reference/filesystem/functions/fgetss.xml index 8dfafdfb..dd8ac28e 100644 --- a/reference/filesystem/functions/fgetss.xml +++ b/reference/filesystem/functions/fgetss.xml @@ -1,25 +1,32 @@ - + - + fgetss Pobiera linię ze wskaźnika pliku i usuwa znaczniki HTML + + &warn.deprecated.function-7-3-0.removed-8-0-0; + + &reftitle.description; stringfgetss - resourceuchwyt - intdługość - stringdozwolone_tagi + resourcehandle + intlength + stringallowable_tags Działa identycznie jak fgets, oprócz tego że fgetss próbuje usunąć wszystkie bajty NUL, znaczniki HTML i PHP z tekstu, który przeczyta. + Funkcja zachowuje stan parsowania od wywołania do wywołania i jako taka nie jest + równoważna wywołaniu funkcji strip_tags na wartości zwracanej + przez funkcję fgets. @@ -28,13 +35,13 @@ - uchwyt + handle &fs.validfp.all; - długość + length Długość danych do pobrania. @@ -42,7 +49,7 @@ - dozwolone_tagi + allowable_tags Możesz użyć opcjonalnego trzeciego parametru do określenia które znaczniki nie powinny @@ -59,8 +66,8 @@ &reftitle.returnvalues; - Zwraca łańcuch znaków o długości - 1 bajtów odczytanych ze - wskaźnika pliku wskazanego przez uchwyt, pozbawionego całego + Zwraca łańcuch znaków o długości length - 1 bajtów odczytanych ze + wskaźnika pliku wskazanego przez handle, pozbawionego całego kodu HTML i PHP. @@ -69,6 +76,7 @@ + &reftitle.examples; Czytanie pliku PHP linia po linii @@ -81,15 +89,15 @@ $str = << Tekst po za blokiem HTML. EOD; -file_put_contents('przyklad.php', $str); +file_put_contents('sample.php', $str); -$uchwyt = @fopen("przyklad.php", "r"); -if ($uchwyt) { - while (!feof($uchwyt)) { - $bufor = fgetss($uchwyt, 4096); +$handle = @fopen("sample.php", "r"); +if ($handle) { + while (!feof($handle)) { + $bufor = fgetss($handle, 4096); echo $bufor; } - fclose($uchwyt); + fclose($handle); } ?> ]]> @@ -120,6 +128,8 @@ Tekst po za blokiem HTML. popen fsockopen strip_tags + SplFileObject::fgetss + The string.strip_tags filter diff --git a/reference/filesystem/functions/file-get-contents.xml b/reference/filesystem/functions/file-get-contents.xml index 4298d1fd..f867eb34 100644 --- a/reference/filesystem/functions/file-get-contents.xml +++ b/reference/filesystem/functions/file-get-contents.xml @@ -1,28 +1,32 @@ - + - - + + - file_get_contents + file_get_contents Odczytuje cały plik i zwraca łańcuch znaków &reftitle.description; - stringfile_get_contents - stringnazwa_pliku - booluse_include_pathfalse - resourcekontekst + stringfalsefile_get_contents + stringfilename + booluse_include_path&false; + + resourcenull + context&null; intoffset0 - intmaksymalna_dlugosc + intnull + length&null; - + Ta funkcja jest stosunkowo podobna do file, z tą różnicą, że - file_get_contents zwraca zawartość pliku jako + file_get_contents zwraca zawartość pliku jako string, rozpoczynając od miejsca określonego w argumencie offset, - aż do maksymalna_dlugosc. W przypadku niepowodzenia + aż do length. W przypadku niepowodzenia file_get_contents zwróci &false;. @@ -43,7 +47,7 @@ - nazwa_pliku + filename Ścieżka do otwieranego pliku. @@ -55,17 +59,21 @@ - Od PHP 5 można skorzystać ze stałej FILE_USE_INCLUDE_PATH + Stała FILE_USE_INCLUDE_PATH może być użyta, aby aktywować szukanie w include path. - + Nie można użyć tej stałej, jeśli ścisłe typowanie + jest włączone, ponieważ stała FILE_USE_INCLUDE_PATH jest typem + int. Zamiast tego należy użyć &true; + - kontekst + context - Właściwy zasób kontekstu utworzony z pomocą funkcji + Właściwy zasób kontekstu utworzony z pomocą funkcji stream_context_create. Jeżeli nie ma konieczności stosowania własnego kontekstu, można pominąć ten parametr podając &null;. @@ -76,7 +84,7 @@ Określa offset, od którego ma rozpocząć się czytanie w pliku. - Ujemne offsety liczą od końca strumienia danych. + Ujemne offsety liczą od końca strumienia danych. Szukanie (offset) nie jest możliwe dla plików zdalnych. @@ -86,7 +94,7 @@ - maksymalna_dlugosc + length Maksymalna długść danych do odczytania. Domyślnie, funkcja będzie czytać @@ -110,9 +118,44 @@ &reftitle.errors; - Błąd o poziomie E_WARNING występuje gdy plik określony jako nazwa_pliku nie zostanie znaleziony, maksymalna_dlugosc + Błąd o poziomie E_WARNING występuje gdy plik określony jako filename nie zostanie znaleziony, length jest mniejsza od zera lub jeśli szukanie do określonego offsetu nie powiedzie się. + + Gdy funkcja file_get_contents jest wywoływana na katalogu, + generowany jest błąd poziomu E_WARNING w systemie Windows, + od PHP 7.4 także w innych systemach operacyjnych. + + + + + &reftitle.changelog; + + + + + + &Version; + &Description; + + + + + 8.0.0 + + Parametr length akceptuje teraz wartość null. + + + + 7.1.0 + + Dodano obsługę ujemnych wartości dla parametru offset. + + + + + + @@ -134,9 +177,9 @@ echo $homepage; PHP 5 +// W przeciwnym razie $file = file_get_contents('./people.txt', FILE_USE_INCLUDE_PATH); ?> ]]> @@ -148,7 +191,7 @@ $file = file_get_contents('./people.txt', FILE_USE_INCLUDE_PATH); ]]> @@ -156,7 +199,7 @@ var_dump($section); &example.outputs.similar; @@ -184,37 +227,6 @@ $file = file_get_contents('http://www.example.com/', false, $context); - - - &reftitle.changelog; - - - - - - &Version; - &Description; - - - - - 7.1.0 - - Dodano wsparcie dla ujemnych offsetów. - - - - 5.1.0 - - Dodano parametry offset i - maksymalna_dlugosc. - - - - - - - &reftitle.notes; diff --git a/reference/filesystem/functions/file-put-contents.xml b/reference/filesystem/functions/file-put-contents.xml index ebaa5cdb..e4d2a9dc 100644 --- a/reference/filesystem/functions/file-put-contents.xml +++ b/reference/filesystem/functions/file-put-contents.xml @@ -1,30 +1,31 @@ - + - + - file_put_contents - Zapisuje łańcuch znaków do pliku + file_put_contents + Zapisuje dane do pliku &reftitle.description; - intfile_put_contents - stringnazwa_pliku - mixeddane + intfalsefile_put_contents + stringfilename + mixeddata intflagi0 - resourcekontekst + resourcenull + context&null; - - Ta funkcja działa identycznie jak kolejne wywołanie fopen, + + Ta funkcja działa identycznie jak kolejne wywołanie funkcji fopen, fwrite i fclose, aby zapisać dane do pliku. - Jeżeli nazwa_pliku nie istnieje, plik jest tworzony. - W przeciwnym wypadku plik jest nadpisywany, dopóki nie ustawiono flagi + Jeżeli plik filename nie istnieje, plik jest tworzony. + W przeciwnym wypadku plik jest nadpisywany, dopóki nie ustawiono flagi FILE_APPEND. @@ -34,7 +35,7 @@ - nazwa_pliku + filename Ścieżka do pliku, w którym zapisać dane. @@ -42,19 +43,19 @@ - dane + data Dane do zapisania. Może być typu string, array lub stream. - Jeżeli dane są typu stream, + Jeżeli parmetr data jest typu stream, pozostały bufor tego strumienia będzie skopiowany do określonego pliku. Jest to adekwatne do użycia stream_copy_to_stream. - W parametrze dane można podać jednowymiarową + W parametrze data można podać jednowymiarową tablicę. Jest do adekwatne do użycia kodu file_put_contents($filename, implode('', $array)). @@ -64,7 +65,7 @@ flagi - Wartość parametru flagi może być dowolną kombinacją + Wartość parametru flagi może być dowolną kombinacją następujących flag połączonych przez binarny operator OR (|). @@ -83,7 +84,7 @@ FILE_USE_INCLUDE_PATH - Szuka nazwa_pliku w katalogu dołączania. + Szuka pliku filename w katalogu dołączania. Zobacz include_path, aby uzyskać więcej informacji. @@ -93,7 +94,7 @@ FILE_APPEND - Jeżeli nazwa_pliku już istnieje, dane zostaną + Jeżeli plik filename już istnieje, dane zostaną dopisane do pliku, zamiast go nadpisywać. @@ -102,10 +103,10 @@ LOCK_EX - Funkcja nabywa wyłączną blokadę na pliku podczas + Funkcja nabywa wyłączną blokadę na pliku podczas zapisu do niego. Innymi słowy, wywołanie flock występuje pomiędzy wywołaniem fopen a fwrite. - Nie jest to identyczne z wywołaniem funkcji fopen w trybie "x". + Nie jest to identyczne z wywołaniem funkcji fopen w trybie "x". @@ -115,10 +116,10 @@ - kontekst + context - Poprawny zasób kontekstu utworzony przy użyciu + Poprawny zasób kontekstu utworzony przy użyciu stream_context_create. @@ -163,7 +164,7 @@ file_put_contents($file, $current); $file = 'people.txt'; // Nowa osoba do dodania do pliku $person = "John Smith\n"; -// Zapisz zawartość do pliku +// Zapisz zawartość do pliku // używając flagi FILE_APPEND, aby dopisać zawartość na koniec pliku // i flagi LOCK_EX, aby zapobiec równoczesnemu zapisowi do tego pliku przez kogoś innego file_put_contents($file, $person, FILE_APPEND | LOCK_EX); @@ -174,31 +175,6 @@ file_put_contents($file, $person, FILE_APPEND | LOCK_EX); - - &reftitle.changelog; - - - - - - &Version; - &Description; - - - - - 5.1.0 - - Dodano wsparcie dla LOCK_EX i możliwość przekazania - zasobu strumienia do parametru dane - - - - - - - - &reftitle.notes; ¬e.bin-safe; diff --git a/reference/filesystem/functions/fileatime.xml b/reference/filesystem/functions/fileatime.xml index 7af56bfe..c2e57a95 100644 --- a/reference/filesystem/functions/fileatime.xml +++ b/reference/filesystem/functions/fileatime.xml @@ -1,17 +1,18 @@ - + + fileatime Zwraca czas ostatniego dostępu do pliku - + &reftitle.description; - intfileatime - stringnazwa_pliku + intfalsefileatime + stringfilename Zwraca czas ostatniego dostępu do pliku. @@ -23,7 +24,7 @@ - nazwa_pliku + filename Ścieżka do pliku. @@ -42,6 +43,11 @@ + + &reftitle.errors; + &fs.emits.warning.on.failure; + + &reftitle.examples; @@ -65,11 +71,6 @@ if (file_exists($filename)) { - - &reftitle.errors; - &fs.emits.warning.on.failure; - - &reftitle.notes; diff --git a/reference/filesystem/functions/fileinode.xml b/reference/filesystem/functions/fileinode.xml index 25a6c0bd..2981e694 100644 --- a/reference/filesystem/functions/fileinode.xml +++ b/reference/filesystem/functions/fileinode.xml @@ -1,6 +1,7 @@ - + + fileinode @@ -10,8 +11,8 @@ &reftitle.description; - intfileinode - stringnazwa_pliku + intfalsefileinode + stringfilename Zwraca numer i-węzła pliku lub &false; w przypadku błędu. @@ -23,7 +24,7 @@ - nazwa_pliku + filename Ścieżka do pliku. @@ -41,6 +42,11 @@ + + &reftitle.errors; + &fs.emits.warning.on.failure; + + &reftitle.examples; @@ -60,11 +66,6 @@ if (getmyinode() == fileinode($filename)) { - - &reftitle.errors; - &fs.emits.warning.on.failure; - - &reftitle.notes; ¬e.clearstatcache; diff --git a/reference/filesystem/functions/filemtime.xml b/reference/filesystem/functions/filemtime.xml index 3fda142a..a57dc8e1 100644 --- a/reference/filesystem/functions/filemtime.xml +++ b/reference/filesystem/functions/filemtime.xml @@ -1,16 +1,17 @@ - + + filemtime Pobiera czas ostatniej modyfikacji pliku - &reftitle.description; + &reftitle.description; - intfilemtime - stringnazwa_pliku + intfalsefilemtime + stringfilename Ta funkcja zwraca czas kiedy bloki danych pliku zostały @@ -23,7 +24,7 @@ - nazwa_pliku + filename Ścieżka do pliku. @@ -41,10 +42,15 @@ Czas jest zwracany w postaci unix'owego znacznika czasu, który jest odpowiedni dla funkcji date. - + + + + &reftitle.errors; + &fs.emits.warning.on.failure; + - - &reftitle.examples; + + &reftitle.examples; <function>filemtime</function> przykład @@ -64,11 +70,6 @@ if (file_exists($filename)) { - - &reftitle.errors; - &fs.emits.warning.on.failure; - - &reftitle.notes; ¬e.filesystem-time-res; diff --git a/reference/filesystem/functions/fileowner.xml b/reference/filesystem/functions/fileowner.xml index 4f7c6524..7dee364f 100644 --- a/reference/filesystem/functions/fileowner.xml +++ b/reference/filesystem/functions/fileowner.xml @@ -1,17 +1,18 @@ - + + fileowner Pobiera właściciela pliku - + &reftitle.description; - intfileowner - stringnazwa_pliku + intfalsefileowner + stringfilename Pobiera właściciela pliku. @@ -23,7 +24,7 @@ - nazwa_pliku + filename Ścieżka do pliku. @@ -43,6 +44,11 @@ + + &reftitle.errors; + &fs.emits.warning.on.failure; + + &reftitle.examples; @@ -60,11 +66,6 @@ print_r(posix_getpwuid(fileowner($filename))); - - &reftitle.errors; - &fs.emits.warning.on.failure; - - &reftitle.notes; ¬e.clearstatcache; diff --git a/reference/filesystem/functions/filesize.xml b/reference/filesystem/functions/filesize.xml index 1f51859b..c0096186 100644 --- a/reference/filesystem/functions/filesize.xml +++ b/reference/filesystem/functions/filesize.xml @@ -1,17 +1,18 @@ - + - + + filesize Zwraca rozmiar pliku - + &reftitle.description; - intfilesize - stringnazwa_pliku + intfalsefilesize + stringfilename Zwraca rozmiar podanego pliku. @@ -23,7 +24,7 @@ - nazwa_pliku + filename Ścieżka do pliku. @@ -43,6 +44,11 @@ &fs.file.32bit; + + &reftitle.errors; + &fs.emits.warning.on.failure; + + &reftitle.examples; @@ -64,11 +70,6 @@ echo $filename . ': ' . filesize($filename) . ' bajty'; - - &reftitle.errors; - &fs.emits.warning.on.failure; - - &reftitle.notes; ¬e.clearstatcache; @@ -85,7 +86,6 @@ echo $filename . ': ' . filesize($filename) . ' bajty'; - + - + + ftruncate Przycina plik do podanej długości @@ -12,12 +13,12 @@ &reftitle.description; boolftruncate - resourceuchwyt - introzmiar + resourcestream + intsize - Przyjmuje uchwyt do pliku i przycina go do - długości rozmiar. + Przyjmuje stream do pliku i przycina go do + długości size. @@ -26,31 +27,31 @@ - uchwyt + stream Uchwyt do pliku. - Podany uchwyt musi zostać otwarty do zapisu. + Podany stream musi zostać otwarty do zapisu. - rozmiar + size Rozmiar, do którego zostanie przycięty plik. - Jeżeli rozmiar jest większy niż plik, to plik - zostanie wypełniony pustymi bajtami do podanego rozmiaru. + Jeżeli parametr size jest większy niż plik, to plik + zostanie wypełniony pustymi bajtami do podanego sizeu. - Jeżeli rozmiar jest mniejszy niż plik, to plik + Jeżeli parametr size jest mniejszy niż plik, to plik jest przycinany do tej długości. @@ -97,7 +98,7 @@ fclose($handle); - + &reftitle.seealso; @@ -108,7 +109,6 @@ fclose($handle); - + + is_executable Sprawdza czy podany plik jest wykonywalny - + &reftitle.description; boolis_executable - stringnazwa_pliku + stringfilename Sprawdza czy podany plik jest wykonywalny. @@ -23,7 +24,7 @@ - nazwa_pliku + filename Ścieżka do pliku. @@ -38,10 +39,16 @@ &reftitle.returnvalues; Zwraca &true; jeżeli plik istnieje i jest wykonywalny lub &false; w - wypadku błędu. + wypadku błędu. W systemach POSIX plik jest wykonywalny, jeśli ustawiony jest bit + wykonywalności uprawnień pliku. W przypadku systemu Windows, patrz uwaga poniżej. + + &reftitle.errors; + &fs.emits.warning.on.failure; + + &reftitle.examples; @@ -66,15 +73,21 @@ if (is_executable($file)) { - - &reftitle.errors; - &fs.emits.warning.on.failure; - - &reftitle.notes; ¬e.clearstatcache; &tip.fopen-wrapper.stat; + + + W systemie Windows plik jest uważany za wykonywalny, jeśli jest poprawnie wykonywalnym + plikiem zgłoszonym przez Win API GetBinaryType(); z podowdów BC + pliki z rozszerzeniem .bat lub .cmd + są również uważane za wykonywalne. Przed PHP 7.4.0, każdy niepusty plik + z rozszerzeniem .exe lub .com + był uważany za wykonywalny. Zauważ, że zmienna środowiskowa PATHEXT + nie ma znaczenia dla funkcji is_executable. + + diff --git a/reference/filesystem/functions/is-file.xml b/reference/filesystem/functions/is-file.xml index 92e9d9b2..73eab85b 100644 --- a/reference/filesystem/functions/is-file.xml +++ b/reference/filesystem/functions/is-file.xml @@ -1,17 +1,18 @@ - + + is_file Sprawdza czy podany plik jest zwykłym plikiem - + &reftitle.description; boolis_file - stringnazwa_pliku + stringfilename Sprawdza czy podany plik jest zwykłym plikiem. @@ -23,7 +24,7 @@ - nazwa_pliku + filename Ścieżka do pliku. @@ -37,12 +38,17 @@ &reftitle.returnvalues; - Zwraca &true; jeżeli nazwa_pliku istnieje i jest zwykłym plikiem oraz &false; + Zwraca &true; jeżeli plik filename istnieje i jest zwykłym plikiem oraz &false; w przeciwnym wypadku. &fs.file.32bit; + + &reftitle.errors; + &fs.emits.warning.on.failure; + + &reftitle.examples; @@ -67,11 +73,6 @@ bool(false) - - &reftitle.errors; - &fs.emits.warning.on.failure; - - &reftitle.notes; ¬e.clearstatcache; @@ -84,6 +85,7 @@ bool(false) is_dir is_link + SplFileInfo diff --git a/reference/filesystem/functions/is-writable.xml b/reference/filesystem/functions/is-writable.xml index 84d8bed6..006423c1 100644 --- a/reference/filesystem/functions/is-writable.xml +++ b/reference/filesystem/functions/is-writable.xml @@ -1,27 +1,27 @@ - + + is_writable Sprawdza czy można zapisać do pliku - + &reftitle.description; boolis_writable - stringnazwa_pliku + stringfilename - Zwraca &true; jeżeli plik nazwa_pliku istnieje i jest + Zwraca &true; jeżeli plik filename istnieje i jest zapisywalny. Jako ten argument można podać nazwę katalogu, aby sprawdzić czy katalog jest zapisywalny. Miej świadomość, że PHP będzie próbował uzyskać dostęp do pliku jako użytkownik, - pod którym jest uruchamiany serwer (często 'nobody'). Ograniczenia trybu - bezpiecznego nie są brane pod uwagę. + pod którym jest uruchamiany serwer (często 'nobody'). @@ -30,7 +30,7 @@ - nazwa_pliku + filename Nazwa sprawdzanego pliku lub katalogu. @@ -40,11 +40,11 @@ - + &reftitle.returnvalues; - Zwraca &true; jeżeli nazwa_pliku istnieje + Zwraca &true; jeżeli filename istnieje i jest zapisywalny. @@ -77,11 +77,11 @@ if (is_writable($filename)) { &reftitle.notes; - + ¬e.clearstatcache; &tip.fopen-wrapper.stat; - + &reftitle.seealso; diff --git a/reference/filesystem/functions/pathinfo.xml b/reference/filesystem/functions/pathinfo.xml index b17b6b30..d2aedcf5 100644 --- a/reference/filesystem/functions/pathinfo.xml +++ b/reference/filesystem/functions/pathinfo.xml @@ -1,7 +1,7 @@ - + - + pathinfo @@ -11,14 +11,15 @@ &reftitle.description; - mixedpathinfo - stringścieżka - intopcjePATHINFO_DIRNAME | PATHINFO_BASENAME | PATHINFO_EXTENSION | PATHINFO_FILENAME + arraystringpathinfo + stringpath + intflags + PATHINFO_ALL pathinfo zwraca informacje o ścieżce: tablicę asocjacyjną lub łańcuch znaków, - zależnie od paramtetru opcje. + zależnie od paramtetru flags. @@ -27,6 +28,20 @@ zastrzeżone zmienne predefiniowane. + + + pathinfo działa naiwnie na ciągu wejściowym + i nie jest świadoma rzeczywistego systemu plików lub komponentów ścieżki, + takich jak "..". + + + + + Tylko w systemach Windows znak \ będzie interpretowany + jako separator katalogów. W innych systemach będzie on traktowany jak każdy + inny znak. + + pathinfo bierze pod uwagę na ustawienia lokalizacji, więc aby poprawnie @@ -41,7 +56,7 @@ - ścieżka + path Ścieżka do sparsowania @@ -49,7 +64,7 @@ - opcje + flags Jeżeli podano, określa konkretny element ścieżki do zwrócenia; @@ -60,7 +75,7 @@ PATHINFO_FILENAME. - Jeżeli opcje nie zostały określone, + Jeżeli parametr flags nie został określony, funkcja zwraca wszystkie elementy. @@ -80,7 +95,7 @@ - Jeżeli ścieżka ma więcej niż jedno rozszerzenie, + Jeżeli parametr path ma więcej niż jedno rozszerzenie, PATHINFO_EXTENSION zwraca tylko ostatnie, a PATHINFO_FILENAME ucina tylko ostatnie. Spójrz na przykłady poniżej. @@ -88,7 +103,7 @@ - Jeśli ścieżka nie zawiera rozszerzenia, + Jeśli parametr path nie zawiera rozszerzenia, element extension nie będzie zwrócony (zobacz drugi przykład poniżej). @@ -102,35 +117,11 @@ - Jeśli parametr opcje jest obecny, funkcja zwróci + Jeśli parametr flags jest obecny, funkcja zwróci string zawierający określony element. - - &reftitle.changelog; - - - - - - &Version; - &Description; - - - - - 5.2.0 - - Została dodana stała PATHINFO_FILENAME. - - - - - - - - &reftitle.examples; @@ -144,7 +135,7 @@ $path_parts = pathinfo('/www/htdocs/inc/lib.inc.php'); echo $path_parts['dirname'], "\n"; echo $path_parts['basename'], "\n"; echo $path_parts['extension'], "\n"; -echo $path_parts['filename'], "\n"; // od PHP 5.2.0 +echo $path_parts['filename'], "\n"; ?> ]]> @@ -204,6 +195,32 @@ Array [extension] => test [filename] => ) +]]> + + + + + + <function>pathinfo</function> example with array dereferencing + + Parametr flags maską bitową. Może być podana tylko + jedna wartość. Aby wybrać tylko ograniczony zestaw przeanalizowanych wartości, + użyj destrukturyzacji tablicy w następujący sposób: + + + $basename, 'dirname' => $dirname] = pathinfo('/www/htdocs/inc/lib.inc.php'); + +var_dump($basename, $dirname); +?> +]]> + + &example.outputs.similar; + + @@ -223,7 +240,6 @@ Array - + + realpath_cache_get Pobiera pamięć podręczną realpath - + &reftitle.description; @@ -18,6 +19,11 @@ + + &reftitle.parameters; + &no.function.parameters; + + &reftitle.returnvalues; diff --git a/reference/filesystem/functions/realpath-cache-size.xml b/reference/filesystem/functions/realpath-cache-size.xml index 1a2fe712..bdec0c86 100644 --- a/reference/filesystem/functions/realpath-cache-size.xml +++ b/reference/filesystem/functions/realpath-cache-size.xml @@ -1,12 +1,13 @@ - + + realpath_cache_size Pobiera rozmiar pamięci podręcznej realpath - + &reftitle.description; @@ -18,6 +19,11 @@ + + &reftitle.parameters; + &no.function.parameters; + + &reftitle.returnvalues; diff --git a/reference/filesystem/functions/realpath.xml b/reference/filesystem/functions/realpath.xml index 9b411fce..8c3dc170 100644 --- a/reference/filesystem/functions/realpath.xml +++ b/reference/filesystem/functions/realpath.xml @@ -1,22 +1,23 @@ - + - + + realpath Zwraca kanoniczną ścieżkę abslutną - + &reftitle.description; - stringrealpath + stringfalserealpath stringścieżka realpath rozszerza wszystkie łącza symboliczne i - rozwiązuje odwołania do '/./', '/../' i dodatkowych znaków '/' w wejściowym - parametrze ścieżka i zwraca kanoniczną ścieżkę + rozwiązuje odwołania do /./, /../ i dodatkowych znaków + / w wejściowym parametrze ścieżka i zwraca kanoniczną ścieżkę absolutną. @@ -32,7 +33,7 @@ Sprawdzana ścieżka. - Podczas gdy ścieżka musi być określona, wartość może być pusta lub ustawiona na &null; + Podczas gdy ścieżka musi być określona, wartość może być pustym ciągiem znaków. W tym wypadku wartość jest interpretowana jako aktualny katalog. @@ -42,13 +43,13 @@ - + &reftitle.returnvalues; - Zwraca kanoniczną ścieżkę absolutną w wypadku powodzenia. Wynikowa ścieżka - nie będzie miała symbolicznych linków ani znaków '/./' lub '/../'. Końcowe - ograniczniki, takie jak \ czy /, też są usuwane. + Zwraca kanoniczną ścieżkę absolutną w wypadku powodzenia. Wynikowa ścieżka + nie będzie miała symbolicznych linków, ani /./ lub /../. Końcowe + ograniczniki, takie jak \ i /, też są usuwane. realpath zwraca &false; w wypadku błędu, np. gdy @@ -67,43 +68,21 @@ może lecz nie musi normalizować wielkości znaków. + + + Funkcja realpath nie będzie działać dla pliku znajdującego się wewnątrz Phara, + ponieważ taka ścieżka byłaby ścieżką wirtualną, a nie rzeczywistą. + + + + + On Windows, junctions and symbolic links to directories are only expanded by + one level. + + &fs.file.32bit; - - &reftitle.changelog; - - - - - - &Version; - &Description; - - - - - 5.3.0 - - Do tego wydania, jeżeli tylko ostatni komponent ścieżki - nie istniał, realpath nie kończyła się niepowodzeniem na - systemach *BSD. realpath od teraz zwraca błąd w takim wypadku. - - - - 5.2.1 - - Przed tą wersją funkcja realpath zwracała &false; - jeśli ścieżka była pustym stringiem lub &null;. - - - - - - - - - &reftitle.examples; @@ -135,9 +114,9 @@ echo realpath('/tmp/') . PHP_EOL; ]]> @@ -164,7 +143,6 @@ C:\Program Files - + + touch @@ -12,13 +13,15 @@ booltouch stringnazwa_pliku - intczastime() - intdczas + intnull + mtime&null; + intnull + atime&null; Próbuje ustawić czas dostępu i modyfikacji pliku o nazwie nazwa_pliku na wartość podaną przez - czas. + mtime. Zauważ, że czas dostępu jest zawsze modyfikowany, niezależnie od ilości parametrów. @@ -40,22 +43,22 @@ - czas + mtime - Czas modyfikacji. Jeśli czas nie został podany, + Czas modyfikacji. Jeśli parametr mtime ma wartość &null;, zostanie użyty bieżący czas systemowy. - dczas + atime - Jeśli podano, to czas dostępu do podanego pliku zostanie ustawiony - na wartość dczas. W przeciwnym wypadku zostanie ustawiony na - wartość przekazaną w parametrze time. - Jeśli, żaden nie występuje, zostanie użyty bieżący czas. + Jeśli nie mm wartości &null;, to czas dostępu do podanego pliku zostanie ustawiony + na wartość atime. W przeciwnym wypadku zostanie ustawiony na + wartość przekazaną w parametrze mtime. + Jeśli, oba mają wartość &null;, zostanie użyty bieżący czas. @@ -72,27 +75,25 @@ &reftitle.changelog; - - - - - - &Version; - &Description; - - - - - 5.3.0 - - Możliwa jest zmiana czasu modyfikacji katalogu - pod Windows. - - - - - - + + + + + &Version; + &Description; + + + + + 8.0.0 + + Parametr mtime i atime + akceptują teraz wartość null. + + + + + @@ -115,7 +116,7 @@ if (touch($filename)) { - <function>touch</function> użycie parametru <parameter>czas</parameter> + <function>touch</function> użycie parametru <parameter>mtime</parameter> &reftitle.notes; ¬e.filesystem-time-res; - - - Przed wersją PHP 5.3.0 nie istniała mozliwość zmiany czasu modyfikacji - katalogu za pomocą tej funkcji pod systemem Windows. - - diff --git a/reference/filesystem/functions/unlink.xml b/reference/filesystem/functions/unlink.xml index 8d8a7585..82819255 100644 --- a/reference/filesystem/functions/unlink.xml +++ b/reference/filesystem/functions/unlink.xml @@ -1,23 +1,25 @@ - + + unlink Kasowanie pliku - + &reftitle.description; boolunlink - stringnazwa_pliku - resourcekontekst + stringfilename + resourcenull + context&null; - Kasuje nazwa_pliku. Podobnie do uniksowej funkcji C + Kasuje filename. Podobnie do uniksowej funkcji C unlink(). W przypadku porażki zostanie wygenerowany błąd na poziomie - E_WARNING. + E_WARNING. @@ -26,11 +28,16 @@ - nazwa_pliku + filename Ścieżka do pliku. + + Jeśli plik jest dowiązaniem symbolicznym, dowiązanie symboliczne zostanie usunięte. + W systemie Windows, aby usunąć dowiązanie symboliczne do katalogu, należy użyć funkcji + rmdir. + @@ -52,29 +59,27 @@ &reftitle.changelog; - - - - - - &Version; - &Description; - - - - - 5.0.0 - - Od PHP 5.0.0 unlink może być również użyty z - niektórymi osłonami (wrapperami) URL. Zajrzyj do aby uzyskać listę wrapperów, które obsługuje - unlink. - - - - - - + + + + + &Version; + &Description; + + + + + 7.3.0 + + W systemie Windows możliwe jest teraz użycie funkcji unlink + na plikach z uchwytami w użyciu, podczas gdy wcześniej kończyło się to niepowodzeniem. + Jednak nadal nie jest możliwe ponowne utworzenie usuniętego pliku, dopóki wszystkie + uchwyty do niego nie zostaną zamknięte. + + + + +