fgetcsv
fgetss
Funkcje Systemu plików
PHP Manual

# fgets

(PHP 4, PHP 5)

fgets — Pobiera linię ze wskaźnika pliku

### Opis

string fgets ( resource `$uchwyt` [, int `$długość` ] )

Pobiera linię ze wskaźnika pliku.

### Parametry

`uchwyt`

  Wskaźnik na plik musi być poprawny i musi wskazywać na plik pomyślnie otwarty przez funkcję fopen() lub fsockopen() (a jednocześnie nie zamknięty jeszcze przez fclose()).

`długość`

  Kończy czytanie gdy przeczytano `długość` - 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.

  > Informacja:

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

### Zwracane wartości

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 do przeczytania ze wskaźnika pliku to zwraca `FALSE`

W przypadku błędu zwraca `FALSE`.

### Rejestr zmian

Wersja | Opis
--- | ---
4.3.0 | fgets() stał się bezpieczny dla danych binarnych
4.2.0 | Parametr `długość` stał się opcjonalny.

### Przykłady

Przykład #1 Oczyt pliku linia po linii

`<?php
$uchwyt = @fopen("/tmp/plik_wejsciowy.txt", "r");
if ($uchwyt) {
while (($bufor = fgets($uchwyt, 4096)) !== false) {
echo $bufor;
}
if (!feof($uchwyt)) {
echo "Błąd: niespodziewany błąd fgets()\n";
}
fclose($uchwyt);
}
?>`

### Notatki

> Informacja: Jeśli PHP niewłaściwie rozpoznaje znaki końca linii podczas odczytu plików stworzonych lub znajdujących się na komputerach Macintosh, problem może rozwiązać włączenie dyrektywy konfiguracyjnej auto_detect_line_endings .

> Informacja:

> Osoby przyzwyczajone do semantyki 'C' powinny zauważyć różnicę w sposobie zwracania EOF przez fgets().

### Zobacz też:

- fgetss() - Pobiera linię ze wskaźnika pliku i usuwa znaczniki HTML
- fread() - Odczyt pliku binarnie bezpieczy
- fgetc() - Pobiera znak ze wskaźnika pliku
- stream_get_line() - Gets line from stream resource up to a given delimiter
- fopen() - Otwiera plik lub URL
- popen() - Otwiera wskaźnik pliku do procesu
- fsockopen() - Open Internet or Unix domain socket connection
- stream_set_timeout() - Set timeout period on a stream

fgetcsv
fgetss
Funkcje Systemu plików
PHP Manual