Wej�cie - Wyj�cie

Przyjrzymy si�, jak PHP zarz�dza danymi wej�ciowymi i wyj�ciowymi. Zbadamy, w jaki spos�b mo�emy czyta� z systemu plik�w lub sieci lub z niego zapisywa�.

Pliki

Istniej� dwie g��wne grupy funkcji do obs�ugi plik�w: te, kt�re dzia�aj� z zasobami plik�w i te, kt�re dzia�aj� z nazw� pliku. Pami�taj, �e zas�b jest rodzajem zmiennej, kt�rej nie mo�na przechowywa� bezpo�rednio w PHP. Zas�b pliku to uchwyt pliku systemu operacyjnego. Wszystkie funkcje zajmuj�ce si� zasobami plik�w zaczynaj� si� od jednej litery f, a nast�pnie maj� czasownik opisuj�cy ich funkcj�. Na przyk�ad fopen() otwiera zas�b pliku. Funkcje, kt�re dzia�aj� z nazw� �a�cucha pliku, zaczynaj� si� od pliku s�owa, a po nim nast�puje czasownik opisuj�cy to, co robi�. Na przyk�ad file_get_contents() pobiera ci�g nazwy pliku i zwraca zawarto�� tego pliku.

Otwieranie plik�w

Funkcja fopen() s�u�y do otwierania plik�w. Zwraca zmienn� zasobu, kt�ra jest uchwytem do pliku. Musisz przekaza� dwa parametry do fopen():

• Nazwa pliku w systemie plik�w
• Tryb pliku, w kt�rym chcesz go otworzy�

Tryby plik�w

Pliki mo�na otwiera� w r�nych trybach. Tryby plik�w opisuj� spos�b interakcji z plikiem. Tryby plik�w dotycz� uprawnie� do plik�w systemu operacyjnego. Na przyk�ad, je�li u�ytkownik PHP ma dost�p tylko do odczytu pliku, pr�ba otwarcia go w trybie zapisu zostanie odrzucona przez system operacyjny. Je�li spr�bujemy z mniejszymi uprawnieniami (np. Tylko do odczytu), system operacyjny utworzy dla nas uchwyt pliku. Przekazujemy dwie informacje o tym, jak zamierzamy u�y� pliku, gdy okre�limy tryb:

• Czy czytamy, piszemy, czy jedno i drugie
• Czy chcemy umie�ci� wska�nik pliku na pocz�tku, czy koniec pliku Wska�nik pliku jest jak kursor iteratora. Przechowuje pozycj� pliku, kt�ra zostanie zwr�cona przy nast�pnym odczycie. Poni�sza tabela zawiera zestawienie popularnych tryb�w plik�w.

Tryb : Odczyt/Zapis : Wska�nik : Zachowanie

r : R : Start
r+ : RW : Start
w : W : Start : Obcina istniej�cy plik lub tworzy nowy plik, je�li jest nie istnieje
w+ : RW : Start
a : W : Start : Tworzy nowy plik, je�li nie istnieje i zachowuje bie��cy plik, je�li taki jest
a+ : RW : Start
x : W : Nie dotyczy : Pr�buje utworzy� nowy plik do zapisu; zwraca FALSE, je�li plik ju� istnieje i generuje E_WARNING
x+ : RW c : W : Start : Pr�buje utworzy� plik, je�li nie istnieje; je�li to istnieje, umieszcza kursor na pocz�tku pliku
c+ : RW

Zauwa�ysz, �e dodanie symbolu + do trybu pliku skutkuje wskazaniem, �e chcesz r�wnie� wykona� odwrotno�� trybu domy�lnego. Kiedy nadpisujemy plik, je�li dodamy symbol +, oznacza to, �e chcemy r�wnie� odczyta� plik. Zachowanie pozostaje jednak takie samo, dlatego pomin��em je w tabeli, aby u�atwi� czytanie. Podczas nadpisywania pliku za pomoc� tryb�w w PHP PHP skr�ci plik do zera bajt�w. Jest to przydatne, je�li chcesz mie� plik, kt�ry jest zast�powany nowymi danymi. Tryby x zwr�c� FALSE i wygeneruj� ostrze�enie, je�li plik ju� istnieje. Jest to przydatne, je�li chcesz unikn�� zast�powania danych, kt�re chcesz zachowa�. Tryb c utworzy plik, je�li istnieje lub otworzy istniej�cy plik. Wska�nik zostanie ustawiony na pocz�tku pliku dla istniej�cych plik�w.

Flagi trybu pliku

Istniej� dwie flagi, kt�re mo�na okre�li�, dodaj�c je na ko�cu ci�gu trybu. Domy�lna flaga jest zdefiniowana przez tw�j SAPI i wersj� PHP, kt�rej u�ywasz, wi�c dla cel�w kompatybilno�ci powiniene� je okre�li�. Mo�esz okre�li� flag� b, aby okre�li�, �e pracujesz z plikami binarnymi. Oznacza to, �e �adne znaki nie zostan� przet�umaczone. Jest to konieczne, gdy pracujesz z obrazami lub inne pliki binarne. Na serwerze Windows mo�esz okre�li� flag� t, aby przet�umaczy� \ n na \ r \ n.

Wskaz�wka : Aby zachowa� przeno�no�� kodu, nale�y u�y� flagi b i upewni� si�, �e kod zawiera prawid�owe zako�czenia linii.

Odczytywanie plik�w

Mo�esz czyta� z zasobu pliku za pomoc� funkcji fread().

< ?php
$handle = fopen('info.txt', 'r');
while (!feof($handle)) {
echo fread($handle,1024);
}

W tym przyk�adzie u�ywamy funkcji pliku feof (), kt�ra zwraca warto�� PRAWDA, gdy wska�nik pliku znajduje si� na ko�cu pliku, w przeciwnym razie NIEPRAWID�OWY. U�ywanie go w p�tli while powoduje kontynuowanie p�tli, a� dojdziemy do ko�ca pliku. Funkcja fread () przyjmuje dwa parametry. Pierwszy to zmienna przechowuj�ca zas�b pliku, a drugi to liczba bajt�w do odczytania. Je�li dojdzie do ko�ca pliku, fread () przestanie czyta�. Oto cztery dodatkowe funkcje PHP, kt�re u�atwiaj� czytanie plik�w:

Funkcja : U�ywana do

fgetcsv() : Odczytaj wiersz ze wska�nika pliku i parsuj dla p�l CSV
file_get_contents() : We� nazw� pliku i odczytaj wyniki w pliku
readfile() : Przeczytaj nazw� pliku i zapisz zawarto�� do plik bufora wyj�ciowego
file() : Przeczytaj ca�y plik do tablicy

Zapisywanie do plik�w

Zapis do pliku odbywa si� za pomoc� binarnie bezpiecznej funkcji fwrite (). fputs () jest aliasem tej funkcji. Funkcja fwrite () przyjmuje dwa parametry - zas�b pliku do zapisu i ci�g do zapisu do pliku. Istnieje funkcja zapisu dla funkcji fgetcsv (), a mianowicie fputcsv (), kt�ra formatuje tablic� jako CSV i zapisuje lini� do pliku. Opr�cz parametr�w zasobu pliku i tablicy, do zdefiniowania formatu CSV potrzebne s� parametry opcjonalne. Je�li chcesz zapisa� sformatowane ci�gi do pliku, powiniene� u�y� fprintf (), kt�ra dzia�a jak polecenie printf (). Je�li chcesz zrzuci� zawarto�� pliku do pod��czonego klienta, mo�esz u�y� fpassthru (). Ta funkcja uruchomi si� w bie��cej pozycji pliku i zapisze reszt� pliku w buforze wyj�ciowym. Wreszcie, istnieje wygodna funkcja szybkiego zapisywania ci�gu do pliku. Funkcja file_put_contents () nie wymaga podania zasobu pliku, a jedynie nazw� pliku i ci�g znak�w, kt�re chcesz zapisa�. Oto prosty przyk�ad u�ycia niekt�rych z tych funkcji:

< ?php
$filename = 'test.csv';
$dataString = '1,2,3,4,5';
file_put_contents($filename, $dataString);
$handle = fopen($filename, 'r');
$myData = fgetcsv($handle);
echo gettype($myData); // array
echo count($myData); // 5

W tym przyk�adzie u�ywamy funkcji skr�tu file_put_contents (), aby wyprowadzi� ci�g znak�w do pliku. Nie musimy mie� dost�pnego zasobu pliku, poniewa� file_put_contents () obs�uguje to za nas. Po napisaniu ci�gu otwieram zas�b pliku, aby go odczyta� i u�ywam fgetcsv () do odczytu z pliku. Ci�g by� prawid�ow� list� CSV i tak $myData zawiera tablic� pi�ciu element�w.

Funkcje systemu plik�w

PHP ma obszern� list� funkcji, kt�re ��cz� ci� z systemem plik�w. W tym rozdziale zajmiemy si� kilkoma z nich, ale jak to cz�sto robi�, odsy�am ci� do podr�cznika PHP w celu uzyskania wyczerpuj�cej listy.

Katalogi

Ta grupa funkcji umo�liwia przechodzenie, tworzenie i usuwanie katalog�w.

Funkcja : Zastosowanie

chdir() : Zmienia bie��cy katalog roboczy PHP.
chroot() : Zmienia katalog g��wny uruchomionego procesu na okre�lony katalog i ustawia katalog roboczy PHP na /.
rmdir() :Usuwa katalog.
readdir() : Zwraca nazw� nast�pnego wpisu w uchwycie katalogu przekazanym jako parametr. Wpisy s� zwracane w kolejno�ci, w jakiej s� przechowywane przez system plik�w.
scandir () Czyta katalog okre�lony przez parametr string i zwraca list� zawartych w nim plik�w i katalog�w

R�nica mi�dzy scandir() a readdir() jest parametrem, kt�ry przyjmuj�. Tam, gdzie readdir () u�ywa uchwytu katalogu, scandir() akceptuje nazw� katalogu jako ci�g znak�w.

Uwaga : Jest to prawdopodobnie myl�ce, poniewa� wydaje si�, �e konwencja nazewnictwa funkcji plik�w (f * versus file *) nie ma zastosowania do katalog�w.

Informacje o pliku

Wspomnieli�my o tych funkcjach w cz�ci po�wi�conej bezpiecze�stwu, ale istniej� inne przypadki u�ycia, w kt�rych musisz uzyska� informacje o pliku. PHP udost�pnia funkcj� finfo_open(), kt�ra zwraca now� instancj� zasobu fileinfo. Dostarczasz mu dwa parametry - predefiniowan� sta�� opcji i lokalizacj� ci�gu do pliku magicznej bazy danych. Plik magicznej bazy danych jest formatem u�ywanym do opisywania typ�w plik�w i jest tak�e u�ywany przez standardowe polecenie Uniksa, file. Je�li nie podasz �cie�ki do magicznej bazy danych, PHP u�yje tej, z kt�r� jest do��czona. Gdy PHP ju� wie, jak identyfikowa� pliki, mo�esz u�y� funkcji finfo_file() w celu uzyskania informacji o pliku. Wymaga co najmniej dw�ch parametr�w - w�a�nie utworzonego zasobu fileinfo i nazwy ci�gu pliku, kt�ry chcesz sprawdzi�. Oto przyk�ad z podr�cznika PHP:

< ?php
$finfo = finfo_open(FILEINFO_MIME_TYPE);
foreach (glob("*") as $filename) {
echo finfo_file($finfo, $filename) . "\n";
}
finfo_close($finfo);

Obie funkcje maj� styl obiektowy, jak w tym przyk�adzie z podr�cznika PHP:

< ?php
// finfo will return the mime type
$finfo = new finfo(FILEINFO_MIME, "/usr/share/misc/magic");
/* get mime-type for a specific file */
$filename = "/usr/local/something.txt";
echo $finfo->file($filename);

Zarz�dzanie plikami

Mo�esz u�ywa� PHP do zarz�dzania plikami. Niekt�re z typowych funkcji s� wymienione w tej tabeli.

Funkcja : Cel

copy : Kopiuje plik.
unlink : Usuwa plik.
rename : Zmienia nazw� pliku. Mo�esz u�y� tego do przeniesienia pliku mi�dzy katalogami.
chmod : Ustawia uprawnienia do plik�w.
chgrp : Zmienia grup� pliku.
chown : Zmienia w�a�ciciela pliku (tylko superuser).
umask : Zmienia bie��cy umask.

Okre�lanie typu obiektu systemu plik�w

Dobr� praktyk� programistyczn� jest sprawdzanie, czy istniej� pliki i katalogi oraz czy masz odpowiednie uprawnienia do korzystania z nich w zamierzony spos�b. PHP udost�pnia funkcje, kt�re zwracaj� warto�ci logiczne, je�li obiekt pasuj�cy do ci�gu przekazywanego jako parametr spe�nia test. Te funkcje pobieraj� parametr ci�gu, kt�ry jest nazw� pliku lub katalogu. W poni�szej tabeli kontrola dotyczy znalezionego obiektu pasuj�cego do nazwy podanej w parametrze.

Funkcja : Sprawdza

is_dir : Jest katalogiem
is_file : To plik
is_readable : Jest plikiem lub katalogiem i mo�na go odczyta�
is_writeable : To plik lub katalog i mo�na do niego zapisa�
is_executable Jest plikiem lub katalogiem i mo�na go wykona�
is_link : Jest dowi�zaniem symbolicznym
is_uploaded_file :Zosta� przes�any przez ��danie POST

Wszystkie funkcje zwr�c� FALSE, je�li nie znaleziono obiektu systemu plik�w, kt�ry pasowa�by do nazwy podanej w parametrze.

Magiczne sta�e pliku

PHP ma kilka magicznych sta�ych, kt�rych mo�esz u�y� w stosunku do aktualnie wykonywanego pliku. Sta�a: Odnosi si�

__LINE__ : Linia aktualnie wykonywanego pliku
__FILE__ : Pe�na �cie�ka i nazwa pliku
__FUNCTION__ : Nazwa bie��cej funkcji
__CLASS__ : Nazwa klasy w zakresie
__METHOD__ : Nazwa wykonywanej metody

Te sta�e s� bardzo przydatne podczas pisania dziennik�w debugowania. Na przyk�ad zwykle zaczynam wszystkie moje wiadomo�ci w dzienniku od znacznika __METHOD__, aby od razu by�o jasne, kt�ra klasa i metoda, w kt�rej generowany jest komunikat dziennika.

Strumienie

Strumienie w PHP to spos�b na uog�lnienie operacji na plikach, sieci, kompresji danych i innych operacji, kt�re dziel� zestaw typowych funkcji i zastosowa�. Strumie� jest prawie jak przeno�nik ta�mowy rzeczy, kt�re przychodz� do ciebie jedna po drugiej. W PHP mo�esz r�wnie� przeskakiwa� wzd�u� ta�my przeno�nika i szuka� pozycji zamiast czeka�, a� do ciebie dotrze. Strumienie s� przywo�ywane w formacie, kt�ry mo�na rozpozna�:

schemat: // cel

Na przyk�ad http://www.php.net okre�la schemat http i cel jako adres URL strony internetowej PHP.

Strumieniowe owijanie

Opakowania s� obiektami kodu, kt�re t�umacz� strumie� na okre�lone kodowanie lub protok�. Podr�cznik PHP3 zawiera list� opakowa�, kt�re s� zaimplementowane w j�zyku, a funkcja stream_wrapper_register() pozwala ci zdefiniowa� w�asne.

Protok� : Wykorzystanie

file: // - Dost�p do lokalnego systemu plik�w
http: // - Uzyskiwanie dost�pu do adres�w URL HTTP
ftp: // - Uzyskiwanie dost�pu do adres�w URL FTP
php: // - Uzyskiwanie dost�pu do r�nych strumieni we / wy
compress.zlib: // - Strumienie kompresji
data: // - Data (RFC 2397)
glob: // - Znajd� �cie�ki pasuj�ce do wzorca
phar: // - archiwum PHP
ssh2: // - Secure Shell 2
rar: // - RAR
ogg: // - strumienie audio
expect: // - Przetwarzaj strumienie interakcji

Strumienie PHP, do kt�rych mo�na uzyska� dost�p, to stdin, stdout, stderr, input, output, fd, memory, temp i filter. Pami�taj, �e w celu poprawy czytelno�ci pomin��em protok� dla wszystkich tych strumieni. Kiedy ich u�ywasz, wszystkie powinny by� poprzedzone protoko�em php: //, na przyk�ad stdin to php: // stdin. Jako przyk�ad czytania strumienia przyjrzyjmy si�, jak odczyta� tre�� dania PUT. W pewnym momencie swojej kariery b�dziesz kodowa� interfejs API REST i b�dziesz musia� przeczyta� i przeanalizowa� tre�� da� PUT wysy�anych przez klient�w na Tw�j serwer. Nie ma superglobalno�ci dla tego typu ��dania, podobnie jak dla GET i POST, wi�c jak to si� robi? Odpowied� znajduje si� w strumieniu wej�ciowym php: //!

< ? php
// odczytuje tre�� PUT
$ input = file_get_contents ('php: // input');
// analizuje dane wej�ciowe w tablicy
parse_str ($ input, $ params);
print_r ($ params);

Filtry

Filtry strumieniowe mo�na stosowa� do strumieni i przeprowadza� operacje transformacji danych opuszczaj�c strumie�.

Filtr : Funkcja

string.rot13 Koduje dane za pomoc� ROT13 string.toupper : Konwertuje ci�g na wielkie litery
string.tolower : Konwertuje ci�g na ma�e litery
string.strip_tags : Usuwa tagi XML z �a�cucha
convert. * : Konwertuje dane na przyk�ad zgodnie z algorytmem
mcrypt. * : Zapewnia szyfrowanie symetryczne przy u�yciu libmcrypt
mdecrypt. * : Filtr deszyfruj�cy u�ywaj�cy libmcrypt
zlib. * : U�ywa biblioteki ZLIB do kompresji i dekompresji danych

Te filtry s� do��czone do strumienia za pomoc� funkcji stream_filter_append (). Mo�esz zastosowa� filtr niezale�nie do kierunk�w odczytu i zapisu strumienia.

< ?php
stream_filter_append($handle, 'string.rot13');
$handle = fopen("files.php", 'a+');
while (!feof($handle)) {
echo fread($handle,1024);
}

Mo�esz poda� trzeci parametr do stream_filter_append (), aby do��czy� go do odczytu lub zapisu strumienia. Ten parametr jest jedn� z predefiniowanych sta�ych STREAM_FILTER_READ, STREAM_FILTER_WRITE lub STREAM_FILTER_ALL. Domy�lnie filtr jest do��czany do odczytu i zapisu. Ten przyk�ad wy�wietli co� takiego:

< ?cuc
$ unaqyr = sbcra ("svyrf.cuc", 'n +');
fgernz_svygre_nccraq ($ unaqyr, 'fgevat.ebg13');
juvyr (! srbs ($ unaqyr)) {
rpub sernq ($ unaqyr, 1024);
}

Strumieniowe konteksty
br> Konteksty strumienia s� opakowaniami dla zestawu opcji, kt�re mog� modyfikowa� zachowanie strumienia. Kontekst tworzy si� za pomoc� funkcji stream_context_create(). Przekazujesz jej dwa opcjonalne parametry, z kt�rych oba s� tablicami asocjacyjnymi. Pierwszy parametr to opcje, a drugi to tablica parametr�w kontekstu. Ka�dy typ strumienia ma sw�j w�asny zestaw opcji kontekstowych. Podr�cznik PHP ma ich wyczerpuj�c� list�. Jedynym dost�pnym obecnie parametrem jest wywo�anie, kt�re zostanie wywo�ane, gdy zdarzenie wyst�pi w strumieniu. Wszystkie zdarzenia s� predefiniowanymi sta�ymi STREAM_NOTIFY_ *. Prototyp funkcji wywo�ania zwrotnego znajduje si� w podr�czniku PHP wraz z przyk�adem zdarze� powiadomie� dla strumienia HTTP. Na przyk�ad, je�li pobierasz plik, mo�esz skonfigurowa� funkcj� wywo�ania zwrotnego, aby reagowa�a na zdarzenie STREAM_NOTIFY_FILE_SIZE_IS i przerwa�a pobieranie, je�li jest ono zbyt du�e. Ten przyk�ad uniemo�liwia nam pobranie strony g��wnej www.example.com, je�li jest ona wi�ksza ni� kilobajt.

< ?php
function callback($notification_code,
$severity,
$message,
$message_code,
$bytes_transferred,
$bytes_max)
{
if ($notification_code == STREAM_NOTIFY_FILE_SIZE_IS) {
if ($bytes_max > 1024) {
die("Download too big!");
}
}
}
$context = stream_context_create();
stream_context_set_params($context, ["notification" => "callback"]);
$handle = fopen('http://www.example.com', 'r', false, $context);
fpassthru($handle);

Mo�esz zmieni� opcje i parametry za pomoc� funkcji stream_context_set_params(), a stream_context_get_params() zwr�ci bie��ce parametry strumienia.

QUIZ

P1: Za��my, �e u�ytkownik serwera WWW jest w�a�cicielem pliku data.csv i zawiera ci�g "Hello World" przed uruchomieniem tego skryptu. Jakie b�d� wyniki tego kodu?

< ?php
file_put_contents('data.csv', '1,2,3,4,5');
$handle = fopen('data.csv', 'c+');
$data = fgetcsv($handle, 2);
var_dump($data[1]);

---------------------------------
string(0) ""
string(1) ","
string(1) "1"
string(1) "2"
To spowoduje b��d

P2: Jakie b�d� dane wyj�ciowe tego kodu?

< ?php
file_put_contents('test.csv', '1,2,3,4,5');
$handle = fopen('test.csv', 'c');
fputcsv($handle, ['6', '7', '8']);
fclose($handle);
echo file_get_contents('test.csv');
---------------------------------
To stworzy b��d
1,2,3,4,5,6,7,8
6,7,8,1,2,3,4,5
6,7,8
1,2,3,4,5
6,7,8,1,2,3,4,5
1,2,3,4,5
6,7,8

P3: Je�li piszesz interfejs REST i potrzebujesz odczyta� parametry wys�ane w ��daniu PUT, jak mo�esz to zrobi�?

---------------------------------
Odwo�aj si� do superglobala $ _REQUEST
Odwo�aj si� do superglobala $ _POST
Oczytaj strumie� php: // input
Odczytaj strumie� http: // input

P4: Chc� zapisa� wpisy dziennika do pliku, gdy m�j program PHP dzia�a. Nie chc� straci� starych wpis�w w dzienniku i potrzebuj�, aby moje wpisy by�y w odpowiedniej kolejno�ci dat, a najnowsze wpisy nast�powa�y po starszych wpisach. W jakim trybie pliku powinienem otworzy� plik?

---------------------------------
r
a
x
c

P5: Za��my, �e plik, kt�ry odzyskuj�, jest prawid�owym obrazem w formacie GIF i �e korzystam z PHP w Linuksie. Jakie b�d� wyniki tego kodu?

< ?php
// To jest poprawny obrazek GIF
$url = ' https://goo.gl/QycgqH';
file_put_contents('earth.gif', file_get_contents($url));
if (!rename('earth.gif', 'earth.jpeg')) {
throw new RuntimeException('Could not rename the file.');
}
$finfo = new finfo();
echo $finfo->file('earth.jpeg') . PHP_EOL;
---------------------------------
To powoduje b��d
Dane obrazu GIF, wersja 89a, 400 x 400
Dane obrazu JPEG, 400 x 400
obraz / gif
image / jpeg
Nie mo�na zmieni� nazwy pliku
�adne z powy�szych

ODPOWIEDZI

• string(0) ""

• 6,7,8 ; 1,2,3,4,5

• Oczytaj strumie� php: // input

• a

• Dane obrazu GIF, wersja 89a, 400 x 400

Certyfikat ZendPHP

Wej�cie - Wyj�cie

QUIZ

ODPOWIEDZI