From f84b07f2d001785b930e39418e1315a274d3c6de Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Grzegorz=20Ba=C5=84kowski?= Date: Sat, 7 Jun 2025 12:12:48 +0200 Subject: [PATCH] Sync language/wrappers with EN --- language/wrappers/audio.xml | 194 +++++++++++++++ language/wrappers/compression.xml | 143 +++++++++++ language/wrappers/data.xml | 142 +++++++++++ language/wrappers/expect.xml | 117 +++++++++ language/wrappers/file.xml | 125 ++++++++++ language/wrappers/ftp.xml | 158 ++++++++++++ language/wrappers/glob.xml | 144 +++++++++++ language/wrappers/http.xml | 188 ++++++++++++++ language/wrappers/phar.xml | 119 +++++++++ language/wrappers/php.xml | 397 ++++++++++++++++++++++++++++++ language/wrappers/rar.xml | 301 ++++++++++++++++++++++ language/wrappers/ssh2.xml | 302 +++++++++++++++++++++++ 12 files changed, 2330 insertions(+) create mode 100644 language/wrappers/audio.xml create mode 100644 language/wrappers/compression.xml create mode 100644 language/wrappers/data.xml create mode 100644 language/wrappers/expect.xml create mode 100644 language/wrappers/file.xml create mode 100644 language/wrappers/ftp.xml create mode 100644 language/wrappers/glob.xml create mode 100644 language/wrappers/http.xml create mode 100644 language/wrappers/phar.xml create mode 100644 language/wrappers/php.xml create mode 100644 language/wrappers/rar.xml create mode 100644 language/wrappers/ssh2.xml diff --git a/language/wrappers/audio.xml b/language/wrappers/audio.xml new file mode 100644 index 00000000..507141b6 --- /dev/null +++ b/language/wrappers/audio.xml @@ -0,0 +1,194 @@ + + + + + + + ogg:// + Strumienie audio + + + + &reftitle.description; + + Pliki otwierane do odczytu przez wrapper ogg:// + są traktowane jako skompresowane dane audio zakodowane przy użyciu kodeka OGG/Vorbis. + Podobnie, pliki otwierane do zapisu lub dołączania przez wrapper + ogg:// są zapisywane jako skompresowane dane audio. + Funkcja stream_get_meta_data, gdy zostanie użyta na pliku OGG/Vorbis + otwartym do odczytu, zwróci różne szczegóły dotyczące strumienia, + w tym znacznik vendor, wszelkie dołączone + comments, liczbę + channels, próbkowanie rate, + i zakres szybkości kodowania opisany przez: + bitrate_lower, bitrate_upper, + bitrate_nominal, i bitrate_window. + + + ogg:// (PECL) + + Ten wrapper nie jest domyślnie włączony + + Aby użyć wrappera ogg://, + rozszerzenie + OGG/Vorbis + dostępne z &link.pecl; musi być zainstalowane. + + + + + + &reftitle.usage; + + ogg://soundfile.ogg + ogg:///path/to/soundfile.ogg + ogg://http://www.example.com/path/to/soundstream.ogg + + + + + &reftitle.options; + + + Podsumowanie wrappera + + + + Atrybut + Obsługiwany + + + + + Zastrzeżone przez allow_url_fopen + Nie + + + Umożliwia odczytywanie + Tak + + + Umożliwia zapisywanie + Tak + + + Umożliwia dołączanie + Tak + + + Umożliwia jednocześnie odczytywanie i zapisywanie + Nie + + + Obsługuje stat + Nie + + + Obsługuje unlink + Nie + + + Obsługuje rename + Nie + + + Obsługuje mkdir + Nie + + + Obsługuje rmdir + Nie + + + +
+ + + + + Opcje kontekstu + + + + Nazwa + Użycie + Domyśnie + Tryb + + + + + pcm_mode + + Kodowanie PCM do zastosowania podczas odczytu, jedno z: + OGGVORBIS_PCM_U8, OGGVORBIS_PCM_S8, + OGGVORBIS_PCM_U16_BE, OGGVORBIS_PCM_S16_BE, + OGGVORBIS_PCM_U16_LE i OGGVORBIS_PCM_S16_LE. + (8 lub 16 bitów, ze znakiem lub bez znaku, duży lub mały endian) + + OGGVORBIS_PCM_S16_LE + Odczyt + + + rate + + Częstotliwość próbkowania danych wejściowych, wyrażona w Hz + + 44100 + Zapis/Dołączenie + + + bitrate + + Gdy podana jako liczba całkowita, stała szybkość transmisji bitów, przy której ma być kodowana. (16000 do 131072) + Podana jako liczba zmiennoprzecinkowa, zmienna jakość bitrate do użycia. (-1.0 do 1.0) + + 128000 + Zapis/Dołączenie + + + channels + + Liczba kanałów audio do zakodowania, zazwyczaj 1 (Mono) lub 2 (Stereo). + Może wynosić nawet 16. + + 2 + Zapis/Dołączenie + + + comments + + Tablica wartości ciągów znaków do zakodowania w nagłówku ścieżki. + + + Zapis/Dołączenie + + + +
+ + + + + + + diff --git a/language/wrappers/compression.xml b/language/wrappers/compression.xml new file mode 100644 index 00000000..46e7c16a --- /dev/null +++ b/language/wrappers/compression.xml @@ -0,0 +1,143 @@ + + + + + + + zlib:// + bzip2:// + zip:// + Strumienie kompresji + + + + &reftitle.description; + compress.zlib:// i compress.bzip2:// + + + zlib: działa jak gzopen, z wyjątkiem tego, że + strumień może być używany z funkcją fread i innymi + funkcjami systemu plików. Jest to przestarzałe z powodu + niejednoznaczności z nazwami plików zawierającymi znaki ':'; zamiast tego + należy użyć compress.zlib://. + + + + compress.zlib:// i + compress.bzip2:// odpowiednikami odpowiednio + gzopen i bzopen + i działają nawet na systemach, które nie obsługują + fopencookie. + + + + Rozszerzenie ZIP rejestruje wrapper zip:. Począwszy + od PHP 7.2.0 i libzip 1.2.0+, dodano obsługę haseł dla zaszyfrowanych archiwów, umożliwiając dostarczanie + haseł przez konteksty strumieni. Hasła można ustawić za pomocą opcji 'password' + kontekstu strumienia. + + + + + &reftitle.usage; + + compress.zlib://file.gz + compress.bzip2://file.bz2 + zip://archive.zip#dir/file.txt + + + + + &reftitle.options; + + + Wrapper Summary + + + + Atrybut + Obsługiwany + + + + + Zasrzeżony przez allow_url_fopen + Nie + + + Umożliwia odczytywanie + Tak + + + Umożliwia zapisywanie + Tak (oprócz zip://) + + + Umożliwia dołączanie + Tak (oprócz zip://) + + + Umożliwia jednocześnie odczytywanie i zapisywanie + Nie + + + Obsługuje stat + + Nie, użyj normalnego wrappera file:// + do uzyskania informacji o skompresowanych plikach. + + + + Obsługuje unlink + + Nie, użyj normalnego wrappera file:// + aby usuąć skompresowane pliki. + + + + Obsługuje rename + Nie + + + Obsługuje mkdir + Nie + + + Obsługuje rmdir + Nie + + + +
+ + + + + &reftitle.seealso; + + + + + + + + diff --git a/language/wrappers/data.xml b/language/wrappers/data.xml new file mode 100644 index 00000000..11040d6f --- /dev/null +++ b/language/wrappers/data.xml @@ -0,0 +1,142 @@ + + + + + + + data:// + Data (RFC 2397) + + + + &reftitle.description; + + + Wrapper strumienia data: (RFC + 2397). + + + + + &reftitle.usage; + + data://text/plain;base64, + + + + + &reftitle.options; + + + Podsumowanie Wrappera + + + + Atrybut + Obsługiwany + + + + + Zastrzeżony przezallow_url_fopen + Tak + + + Zastrzeżony przez allow_url_include + Tak + + + Umożliwia odczytywanie + Tak + + + Umożliwia zapisywanie + Nie + + + Umożliwia dołączanie + Nie + + + Umożliwia jednoczesny odczyt i zapis + Nie + + + Obsługuje stat + Nie + + + Obsługuje unlink + Nie + + + Obsługuje rename + Nie + + + Obsługuje mkdir + Nie + + + Obsługuje rmdir + Nie + + + +
+ + + + + &reftitle.examples; + + Drukowanie zawartości data:// + + +]]> + + + + + Pobierz typ Nieśnika + + +]]> + + + + + + + + diff --git a/language/wrappers/expect.xml b/language/wrappers/expect.xml new file mode 100644 index 00000000..6e37cf17 --- /dev/null +++ b/language/wrappers/expect.xml @@ -0,0 +1,117 @@ + + + + + + + expect:// + Strumienie interakcji procesów + + + + &reftitle.description; + + Strumienie otwarte przez wrapper expect:// zapewniają + dostęp do stdio, stdout i stderr procesu poprzez PTY. + + + Ten wrapper nie jest domyślnie włączony + + Aby użyć wrappera expect://, + rozszerzenie + Expect + dostępne z &link.pecl; musi być zainstalowane. + + + expect:// (PECL) + + + + &reftitle.usage; + + expect://command + + + + + &reftitle.options; + + + Podsumowanie Wrappera + + + + Atrybut + Obsługiwany + + + + + Zastrzeżon przez allow_url_fopen + Nie + + + Umożliwia odczytywanie + Tak + + + Umożliwia zapisywanie + Tak + + + Umożliwia dołączanie + Tak + + + Umożliwia jednocześnie odczytywanie i zapisywanie + Nie + + + Obsługuje stat + Nie + + + Obsługuje unlink + Nie + + + Obsługuje rename + Nie + + + Obsługuje mkdir + Nie + + + Obsługuje rmdir + Nie + + + +
+ + + + + + + diff --git a/language/wrappers/file.xml b/language/wrappers/file.xml new file mode 100644 index 00000000..a766e75a --- /dev/null +++ b/language/wrappers/file.xml @@ -0,0 +1,125 @@ + + + + + + + file:// + Dostęp do lokalnego systemu plików + + + + &reftitle.description; + + file:// jest domyślnym wrapperem używanym w PHP i + reprezentuje lokalny system plików. + Gdy określona jest ścieżka względna (ścieżka, która nie zaczyna się od + /, \, \\lub litery + dysku Windows) podana ścieżka zostanie zastosowana do bieżącego katalogu roboczego + working directory. W wielu przypadkach jest to katalog, w którym znajduje się skrypt, + chyba że został on zmieniony. Używając CLI + SAPI, domyślnie jest to katalog, z którego wywołano + skrypt. + + + W przypadku niektórych funkcji, takich jak fopen i + file_get_contents, include_path + może być również opcjonalnie przeszukiwany pod kątem ścieżek względnych. + + + + + &reftitle.usage; + + /path/to/file.ext + relative/path/to/file.ext + fileInCwd.ext + C:/path/to/winfile.ext + C:\path\to\winfile.ext + \\smbserver\share\path\to\winfile.ext + file:///path/to/file.ext + + + + + &reftitle.options; + + + Podsumowanie Wrappera + + + + Atrybut + Obsługiwany + + + + + Zastrzeżony przez allow_url_fopen + Nie + + + Umożliwia odczytywanie + Tak + + + Umożliwia zapisywanie + Tak + + + Umożliwia dołączanie + Tak + + + Umożliwia jednocześnie odczytywanie i zapisywanie + Tak + + + Obsługuje stat + Tak + + + Obsługuje unlink + Tak + + + Obsługuje rename + Tak + + + Obsługuje mkdir + Tak + + + Obsługuje rmdir + Tak + + + +
+ + + + + + + diff --git a/language/wrappers/ftp.xml b/language/wrappers/ftp.xml new file mode 100644 index 00000000..ad1d45d1 --- /dev/null +++ b/language/wrappers/ftp.xml @@ -0,0 +1,158 @@ + + + + + + + ftp:// + ftps:// + Uzyskiwanie dostępu do adresów URL FTP + + + + &reftitle.description; + + Umożliwia odczyt istniejących plików i tworzenie nowych plików + przez FTP. Jeśli serwer nie obsługuje trybu pasywnego ftp, + połączenie nie powiedzie się. + + + Można otwierać pliki do odczytu lub zapisu, ale nie jednocześnie + Jeśli zdalny plik już istnieje na serwerze ftp i próbujesz + otworzyć go do zapisu, ale nie określiłeś opcji kontekstu + overwrite, połączenie nie + powiedzie się. Jeśli chcesz nadpisać istniejące pliki przez ftp, + określ opcję overwrite w kontekście i + otwórz plik do zapisu. Alternatywnie można + użyj rozszerzenia FTP. + + + Jeśli ustawiono dyrektywę from + w &php.ini;, wartość ta zostanie wysłana jako anonimowe + hasło FTP. + + + + + &reftitle.usage; + + ftp://example.com/pub/file.txt + ftp://user:password@example.com/pub/file.txt + ftps://example.com/pub/file.txt + ftps://user:password@example.com/pub/file.txt + + + + + &reftitle.options; + + + Podsuowanie Wrappera + + + + Atrybut + Obsługiwany + + + + + Zastrzeżony przez allow_url_fopen + Tak + + + Umożliwia odczytywanie + Tak + + + Umożliwia zapisywanie + Tak (nowe pliki/istniejące pliki z overwrite) + + + Umożliwia dołączanie + Tak + + + Umożliwia jednocześnie odczytywanie i zapisywanie + Nie + + + Obsługuje stat + + Tylko dla elementów filesize, filemtime, + filetype, file_exists, + is_file i is_dir. + + + + Obsługuje unlink + Tak + + + Obsługuje rename + Tak + + + Obsługuje mkdir + Tak + + + Obsługuje rmdir + Tak + + + +
+ + + + + &reftitle.notes; + + + FTPS jest obsługiwany tylko wtedy, gdy rozszerzenie + openssl jest włączone. + + + Jeśli serwer nie obsługuje protokołu SSL, połączenie powraca do zwykłego + nieszyfrowanego protokołu ftp. + + + + Dołączanie + + Pliki mogą być dołączane za pośrednictwem wrappera URL ftp://. + + + + + + &reftitle.seealso; + + + + + + + + + diff --git a/language/wrappers/glob.xml b/language/wrappers/glob.xml new file mode 100644 index 00000000..a57252f7 --- /dev/null +++ b/language/wrappers/glob.xml @@ -0,0 +1,144 @@ + + + + + + + glob:// + Znajdź nazwy ścieżek pasujące do wzorca + + + + &reftitle.description; + + + Wrapper strumienia glob:. + + + + + &reftitle.usage; + + glob:// + + + + + &reftitle.options; + + + Podsumowanie Wrappera + + + + Atrybut + Obsługiwany + + + + + Zastrzeżony przez allow_url_fopen + Nie + + + Zastrzeżony przez allow_url_include + Nie + + + Umożliwia odczytywanie + Nie + + + Umożliwia zapisywanie + Nie + + + Umożliwia dołączanie + Nie + + + Umożliwia jednocześnie odczytywanie i zapisywanie + Nie + + + Obsługuje stat + Nie + + + Obsługuje unlink + Nie + + + Obsługuje rename + Nie + + + Obsługuje mkdir + Nie + + + Obsługuje rmdir + Nie + + + +
+ + + + + &reftitle.examples; + + Podstawowe użycie + +getFilename(), $f->getSize()/1024); +} +?> +]]> + + + + + + + + + + + diff --git a/language/wrappers/http.xml b/language/wrappers/http.xml new file mode 100644 index 00000000..71b81d95 --- /dev/null +++ b/language/wrappers/http.xml @@ -0,0 +1,188 @@ + + + + + + + http:// + https:// + Uzyskiwanie dostępu do adresów URL HTTP(s) + + + + &reftitle.description; + + Umożliwia dostęp tylko do odczytu do plików/zasobów przez HTTP. + Domyślnie używany jest protokół HTTP 1.0 GET. Nagłówek Host: jest wysyłany wraz z żądaniem + w celu obsługi wirtualnych hostów opartych na nazwach. Jeśli skonfigurowano ciąg + znaków user_agent za pomocą pliku + &php.ini; lub kontekstu strumienia, zostanie on również dołączony + do żądania. + + + Strumień umożliwia dostęp do ciała + zasobu; nagłówki są przechowywane w zmiennej + $http_response_header. + + + Jeśli ważne jest, aby znać adres URL zasobu, z którego pochodzi dokument + (po przetworzeniu wszystkich przekierowań), należy przetworzyć + serię nagłówków odpowiedzi zwróconych przez strumień. + + + Dyrektywa from zostanie użyta dla nagłówka + From:, jeśli zostanie ustawiona i nie zostanie nadpisana przez + . + + + + + &reftitle.usage; + + ht, tp://example.com + http://example.com/file.php?var1=val1&var2=val2 + http://user:password@example.com + https://example.com + https://example.com/file.php?var1=val1&var2=val2 + https://user:password@example.com + + + + + &reftitle.options; + + + Podsumowanie Wrappera + + + + Atrybut + Obsługiwany + + + + + Zastrzeżony przez allow_url_fopen + Tak + + + Umożliwia odczytywanie + Tak + + + Umożliwia zapisywanie + Nie + + + Umożliwia dołączanie + Nie + + + Umożliwia jednocześnie odczytywanie i zapisywanie + N/A + + + Obsługuje stat + Nie + + + Obsługuje unlink + Nie + + + Obsługuje rename + Nie + + + Obsługuje mkdir + Nie + + + Obsługuje rmdir + Nie + + + +
+ + + + + &reftitle.examples; + + Wykrywanie adresu URL, na który trafiliśmy po przekierowaniach + + +]]> + + + + + + &reftitle.notes; + + + HTTPS jest obsługiwany tylko wtedy, gdy rozszerzenie + openssl jest włączone. + + + + Połączenia HTTP są tylko do odczytu; zapisywanie danych lub kopiowanie + plików do zasobu HTTP nie jest obsługiwane. + + + Wysyłanie żądań POST i PUT można na przykład + wykonać za pomocą Kontekstów HTTP. + + + + + &reftitle.seealso; + + + $http_response_header + stream_get_meta_data + + + + + + + diff --git a/language/wrappers/phar.xml b/language/wrappers/phar.xml new file mode 100644 index 00000000..6b986312 --- /dev/null +++ b/language/wrappers/phar.xml @@ -0,0 +1,119 @@ + + + + + + + phar:// + Archiwum PHP + + + + &reftitle.description; + + + Wrapper strumienia phar://. + Zobacz szczegółowy opis Wrapper strumienia Phar + + + + + &reftitle.usage; + + phar:// + + + + + &reftitle.options; + + + Wrapper Summary + + + + Atrybut + Obsługiwany + + + + + Zastrzeżony przez allow_url_fopen + Nie + + + Zastrzeżony przez allow_url_include + Nie + + + Pozwala odczytywać + Tak + + + Pozwala zapisywać + Tak + + + Pozwala dołączać + Nie + + + Pozwala jednocześnie odczytywać i zapisywać + Tak + + + Obsługuje stat + Tak + + + Obsługuje unlink + Tak + + + Obsługuje rename + Tak + + + Obsługuje mkdir + Tak + + + Obsługuje rmdir + Tak + + + +
+ + + + + &reftitle.seealso; + + + + + + + + + diff --git a/language/wrappers/php.xml b/language/wrappers/php.xml new file mode 100644 index 00000000..c434be5a --- /dev/null +++ b/language/wrappers/php.xml @@ -0,0 +1,397 @@ + + + + + + + php:// + Dostęp do różnych strumieni I/O + + + + &reftitle.description; + + PHP udostępnia szereg różnych strumieni I/O, które umożliwiają dostęp do + własnych strumieni wejściowych i wyjściowych PHP, standardowych deskryptorów plików + wejściowych, wyjściowych i błędów, strumieni plików tymczasowych w pamięci i + na dysku oraz filtrów, które mogą manipulować innymi zasobami plików podczas + ich odczytu i zapisu. + + + + php://stdin, php://stdout i php://stderr + + php://stdin, php://stdout i + php://stderr umożliwiają bezpośredni dostęp do odpowiedniego + strumienia wejściowego lub wyjściowego procesu PHP. Strumień odwołuje się + do zduplikowanego deskryptora pliku, więc jeśli otworzysz php://stdin + i później go zamkniesz, zamkniesz tylko swoją kopię deskryptora - rzeczywisty + strumień, do którego odwołuje się STDIN pozostanie nienaruszony. + Zaleca się + po prostu użycie stałych STDIN, + STDOUT i STDERR zamiast ręcznego + otwierania strumieni przy użyciu tych wrapperów. + + + php://stdin jest tylko do odczytu, podczas gdy + php://stdout i php://stderr są tylko + do zapisu. + + + + + php://input + + php://input to strumień tylko do odczytu, który umożliwia + odczyt surowych danych z treści żądania. + php://input nie jest dostępny w żądaniach POST z + enctype="multipart/form-data", jeśli + włączona jest opcja enable_post_data_reading. + + + + + php://output + + php://output to strumień tylko do zapisu, który umożliwia + zapis do mechanizmu bufora wyjściowego w taki sam sposób jak + print i echo. + + + + + php://fd + + php://fd umożliwia bezpośredni dostęp do danego + deskryptora pliku. Na przykład php://fd/3 odnosi się + do deskryptora pliku 3. + + + + + php://memory i php://temp + + php://memory i php://temp to + strumienie do odczytu i zapisu, które umożliwiają przechowywanie danych + tymczasowych w wrapperze podobnym do pliku. Jedną z różnic między nimi jest to, + że php://memory będzie zawsze przechowywać swoje dane w pamięci, + podczas gdy php://temp użyje pliku tymczasowego, gdy + ilość przechowywanych danych osiągnie predefiniowany limit (domyślnie 2 MB). + Lokalizacja tego pliku tymczasowego jest określana w taki sam sposób jak + funcja sys_get_temp_dir. + + + Limit pamięci php://temp może być kontrolowany przez + dołączenie /maxmemory:NN, gdzie NN to + maksymalna ilość danych, które mają być przechowywane w pamięci przed użyciem + pliku tymczasowego, w bajtach. + + + + Niektóre rozszerzenia PHP mogą wymagać standardowego strumienia IO + i mogą próbować rzutować dany strumień na standardowy strumień IO. + Rzutowanie to może zakończyć się niepowodzeniem w przypadku strumieni pamięci, + ponieważ wymaga dostępności funkcji C fopencookie. + Ta funkcja C jest not dostępna w Windows. + + + + + + php://filter + + php://filter to rodzaj meta-wrappera zaprojektowanego + w celu umożliwienia zastosowania filters do + stream at the time of opening. strumienia w momencie jego otwarcia. + Jest to przydatne w przypadku funkcji plików typu „wszystko w jednym”, takich jak + readfile, file, and file_get_contents, + gdzie w przeciwnym razie nie ma możliwości zastosowania filtra do strumienia + przed odczytaniem zawartości. + + + Cel php://filter przyjmuje następujące parametry + jako część swojej ścieżki. Na jednej ścieżce można określić wiele łańuchów filtrów. + Szczegółowe informacje na temat korzystania z tych parametrów można znaleźć w przykładach. + + + + Parametry php://filter + + + + Nazwa + Opis + + + + + + resource=<strumień do filtrowania> + + + Ten parametr jest wymagany. Określa on strumień, który ma być + filtrowany. + + + + + read=<lista filtrów do zastosowania w łańcuchu odczytu> + + + Ten parametr jest opcjonalny. Można tu podać jedną lub więcej nazw filtrów, + oddzielonych znakiem potoku (|). + + + + + write=<lista filtrów do zastosowania w łańcuchu zapisu> + + + Ten parametr jest opcjonalny. Można tu podać jedną lub więcej nazw filtrów, + oddzielonych znakiem potoku (|). + + + + + <lista filtrów do zastosowania do obu łańcuchów> + + + Wszelkie listy filtrów, które nie są poprzedzone przez read= + lub write= zostaną zastosowane odpowiednio do łańcuchów + odczytu i zapisu. + + + + +
+ + + + + + &reftitle.options; + + + + Podsumowanie Wrappera (dla <literal>php://filter</literal>, odwołaj się do + podsumowania filtrowanego wrappera) + + + + + Atrybut + Obsługiwany + + + + + Zastrzeżony przez allow_url_fopen + Nie + + + Zastrzeżony przez allow_url_include + + tylko php://input, + php://stdin, + php://memory i + php://temp. + + + + Umożliwia odczytywanie + + tylko php://stdin, + php://input, + php://fd, + php://memory i + php://temp. + + + + Umożliwia zapisywanie + + tylko php://stdout, + php://stderr, + php://output, + php://fd, + php://memory i + php://temp. + + + + Umożliwia dołączanie + + Tylko php://stdout, + php://stderr, + php://output, + php://fd, + php://memory i + php://temp. (Odpowiednik do zapisywania) + + + + Umożliwia jednocześnie odczytywanie i zapisywanie + + Tylko php://fd, + php://memory i + php://temp. + + + + Obsługuje stat + + Nie. Jednak php://memory i + php://temp obsługują fstat. + + + + Obsługuje unlink + Nie + + + Obsługuje rename + Nie + + + Obsługuje mkdir + Nie + + + Obsługuje rmdir + Nie + + + Obsługuje stream_select + + Tylko php://stdin, + php://stdout, + php://stderr, + php://fd i + php://temp. + + + + +
+ + + + + &reftitle.examples; + + php://temp/maxmemory + + Ten opcjonalny parametr umożliwia ustawienie limitu pamięci, zanim + php://temp rozpocznie korzystanie z pliku tymczasowego. + + + +]]> + + + + php://filter/resource=<strumień do filtrowania> + + Ten parametr musi znajdować się na + końcu specyfikacji php://filter i powinien + wskazywać na strumień, który ma być filtrowany. + + + +]]> + + + + php://filter/read=<lista filtrów do zastosowania w łańcuchu odczytu> + + Ten parametr przyjmuje jedną lub więcej nazw filtrów + oddzielonych znakiem potoku |. + + + +]]> + + + + php://filter/write=<lista filtrów do zastosowania w łańcuchu zapisu> + + Ten parametr przyjmuje jedną lub więcej + nazw filtrów oddzielonych znakiem potoku |. + + + +]]> + + + + php://memory i php://temp nie są wielokrotnego użytku + + php://memory i php://temp + nie są wielokrotnego użytku, tj. po zamknięciu strumieni nie ma możliwości + ponownego odwołania się do nich. + + + + + + + + + + diff --git a/language/wrappers/rar.xml b/language/wrappers/rar.xml new file mode 100644 index 00000000..29dd26e7 --- /dev/null +++ b/language/wrappers/rar.xml @@ -0,0 +1,301 @@ + + + + + + + rar:// + RAR + + + + &reftitle.description; + + Wrapper przyjmuje zakodowaną w url ścieżkę do archiwum RAR (względną lub bezwzględną), + opcjonalną gwiazdkę (*), opcjonalny znak liczby + (#) i opcjonalną zakodowaną w url nazwę wpisu zapisaną w archiwum. + Określenie nazwy wpisu wymaga znaku liczby; wiodący ukośnik w nazwie wpisu jest + opcjonalny. + + + + Ten wrapper może otwierać zarówno pliki, jak i katalogi. Podczas otwierania katalogów + znak gwiazdki wymusza zwracanie niekodowanych nazw wpisów katalogów. Jeśli nie + zostanie określony, zostaną zwrócone zakodowane url - powodem tego jest umożliwienie + prawidłowego użycia wrappera z wbudowaną funkcjonalnością, taką jak + RecursiveDirectoryIterator w obecności nazw plików, które wydają się + być zakodowanymi danymi url. + + + + Jeśli znak funta i część nazwy wpisu nie zostaną uwzględnione, wyświetlony zostanie + katalog główny archiwum. Różni się to od zwykłych katalogów tym, że wynikowy strumień + nie będzie zawierał informacji takich jak czas modyfikacji, ponieważ katalog główny nie + jest przechowywany w indywidualnym wpisie w archiwum. + Użycie wrappera z RecursiveDirectoryIterator wymaga + uwzględnienia znaku liczby w adresie URL podczas uzyskiwania dostępu do katalogu głównego, + aby adresy URL katalogów podrzędnych mogły być poprawnie skonstruowane. + + + Ten wrapper nie jest domyślnie włączony + + Aby użyć wrappera rar://, + rozszerzenie + rar + dostępne z &link.pecl; musi być zainstalowane. + + + + rar:// + Dostępne od wersji PECL rar 3.0.0 + + + + + + &reftitle.usage; + + rar://<nazwa archiwum zakodowana w url>[*][#[<nazwa wpisu zakodowana w url>]] + + + + + &reftitle.options; + + + Podsumowanie Wrappera + + + + Atrybut + Obsługiwany + + + + + Zastrzeżony przez allow_url_fopen + Nie + + + Zastrzeżony przez allow_url_include + Nie + + + Umożliwia odczytywanie + Yes + + + Umożliwia zapisywanie + Nie + + + Umożliwia dołączanie + Nie + + + Umożliwia jednocześnie odczytywanie i zapisywanie + Nie + + + Obsługuje stat + Tak + + + Obsługuje unlink + Nie + + + Obsługuje rename + Nie + + + Obsługuje mkdir + Nie + + + Obsługuje rmdir + Nie + + + +
+ + + + + + Opcje kontekstu + + + + Nazwa + Użycie + Domyślnie + + + + + open_password + Hasło używane do szyfrowania nagłówków archiwum, jeśli takie + istnieją. WinRAR zaszyfruje wszystkie pliki tym samym hasłem, co hasło + nagłówków, jeśli jest ono obecne, więc dla archiwów z zaszyfrowanymi + nagłówkami, file_password będzie ignorowane. + + + + + file_password + Hasło używane do szyfrowania pliku, jeśli istnieje. Jeśli + nagłówki są również zaszyfrowane, opcja ta zostanie pominięta na rzecz + open_password. Powodem istnienia dwóch opcji + jest uwzględnienie możliwości obsługi archiwów z różnymi nagłówkami + i hasłami plików, jeśli takie archiwa powstaną. Należy pamiętać, + że jeśli archiwum nie ma zaszyfrowanych nagłówków, opcja + open_password będzie ignorowana i zamiast niej + należy użyć tej opcji, jeśli takie archiwa powstaną. + + + + + volume_callback + Wywołanie zwrotne w celu określenia ścieżki brakujących woluminów. Zobacz + RarArchive::open po więcej informacji. + + + + + +
+ + + + + &reftitle.examples; + + Przemierzanie archiwum RAR + +getSubPathName()) . + (is_dir(parent::current())?" [DIR]":""); + } +} + +$f = "rar://" . rawurlencode(dirname(__FILE__)) . + DIRECTORY_SEPARATOR . 'dirs_and_extra_headers.rar#'; + +$it = new RecursiveTreeIterator(new MyRecDirIt($f)); + +foreach ($it as $s) { + echo $s, "\n"; +} +?> +]]> + + &example.outputs.similar; + + + + + + Otwieranie zaszyfrowanego pliku (szyfrowanie nagłówka) + + + array( + 'open_password' => 'samplepassword' + ) + ) + ) + ); +var_dump(stream_get_contents($stream)); +/* data utworzenia i data ostatniego dostępu są opcjonalne w WinRAR, stąd większość + * plików ich nie posiada */ +var_dump(fstat($stream)); +?> +]]> + + &example.outputs.similar; + + 0 + [1] => 0 + [2] => 33206 + [3] => 1 + [4] => 0 + [5] => 0 + [6] => 0 + [7] => 26 + [8] => 0 + [9] => 1259550052 + [10] => 0 + [11] => -1 + [12] => -1 + [dev] => 0 + [iNie] => 0 + [mode] => 33206 + [nlink] => 1 + [uid] => 0 + [gid] => 0 + [rdev] => 0 + [size] => 26 + [atime] => 0 + [mtime] => 1259550052 + [ctime] => 0 + [blksize] => -1 + [blocks] => -1 +) +]]> + + + + + + + + diff --git a/language/wrappers/ssh2.xml b/language/wrappers/ssh2.xml new file mode 100644 index 00000000..434ff045 --- /dev/null +++ b/language/wrappers/ssh2.xml @@ -0,0 +1,302 @@ + + + + + + + ssh2:// + Secure Shell 2 + + + + &reftitle.description; + + ssh2.shell:// + ssh2.exec:// + ssh2.tunnel:// + ssh2.sftp:// + ssh2.scp:// + (PECL) + + + + Ten wrapper nie jest domyślnie włączony + + Aby używać wrapperów ssh2.*://, + rozszerzenie + SSH2 + dostępne z &link.pecl; musi być zainstalowane. + + + + + Oprócz akceptowania tradycyjnych danych logowania URI, wrappery ssh2 + będą również ponownie wykorzystywać otwarte połączenia, przekazując zasób + połączenia w części hosta adresu URL. + + + + + &reftitle.usage; + + ssh2.shell://user:pass@example.com:22/xterm + ssh2.exec://user:pass@example.com:22/usr/local/bin/somecmd + ssh2.tunnel://user:pass@example.com:22/192.168.0.1:14 + ssh2.sftp://user:pass@example.com:22/path/to/filename + + + + + &reftitle.options; + + + Podsumowanie Wrappera + + + + Atrybut + ssh2.shell + ssh2.exec + ssh2.tunnel + ssh2.sftp + ssh2.scp + + + + + Zastrzeżony przez allow_url_fopen + Tak + Tak + Tak + Tak + Tak + + + Umożliwia odczytywanie + Tak + Tak + Tak + Tak + Tak + + + Umożliwia zapisywanie + Tak + Tak + Tak + Tak + Nie + + + Umożliwia dołączanie + Nie + Nie + Nie + Tak (Gdy jest wspierany przez server) + Nie + + + Umożliwia jednocześnie odczytywanie i zapisywanie + Tak + Tak + Tak + Tak + Nie + + + Obsługuje stat + Nie + Nie + Nie + Tak + Nie + + + Obsługuje unlink + Nie + Nie + Nie + Tak + Nie + + + Obsługuje rename + Nie + Nie + Nie + Tak + Nie + + + Obsługuje mkdir + Nie + Nie + Nie + Tak + Nie + + + Obsługuje rmdir + Nie + Nie + Nie + Tak + Nie + + + +
+ + + + + + + Opcje kontekstu + + + + Name + Użycie + Domyślnie + + + + + session + Wstępnie połączony zasób ssh2 do ponownego użycia + + + + sftp + Wstępnie przydzielony zasób sftp do ponownego użycia + + + + methods + Wymiana kluczy, klucz hosta, szyfr, kompresja i metody MAC do użycia + + + + callbacks + + + + + username + Nazwa użytkownika do połączenia + + + + password + Hasło używane do uwierzytelniania hasłem + + + + pubkey_file + Nazwa pliku klucza publicznego używanego do uwierzytelniania + + + + privkey_file + Nazwa pliku klucza prywatnego używanego do uwierzytelniania + + + + env + Tablica asocjacyjna zmiennych środowiskowych do ustawienia + + + + term + Typ emulacji terminala do zażądania podczas przydzielania pty + + + + term_width + Szerokość terminala wymagana podczas przydzielania pty + + + + term_height + Wysokość terminala wymagana podczas przydzielania pty + + + + term_units + Jednostki używane z term_width i term_height + SSH2_TERM_UNIT_CHARS + + + +
+ + + + + &reftitle.examples; + + Otwieranie strumienia z aktywnego połączenia + + +]]> + + + + Ta zmienna <varname>$session</varname> musi być dostępna! + + Aby użyć wrapperów ssh2.*://$session, + zmienna zasobu $session musi zostać zachowana. + Poniższy kod nie przyniesie pożądanego efektu: + + + +]]> + + + unset() zamyka sesję, ponieważ $connection_string nie + przechowuje referencję do zmiennej $session a jedynie rzutowanie + ciągu znaków pochodzącego z niej. Dzieje się tak również, gdy unset jest niejawna + z powodu opuszczenia zakresu (jak w funkcji). + + + + + + + + +