Na most j�n a sava-borsa...
A f�ggv�nyek haszn�lata a PHP n�lk�l�zhetetlen �s igen hasznos r�sz�t k�pezik. Seg�ts�g�kkel - ha az ism�tl�d� k�dr�szekre f�ggv�nyt �runk - �sszetettebb k�donk jelent�sen ler�vid�thet�, amit tetsz�s szerinti helyekr�l h�vhatunk meg. A PHP mindig rendelkez�sre �ll� be�p�tett f�ggv�nyei is sok munk�t�l k�m�lhetnek meg.

Mi a f�ggv�ny?

A f�ggv�nyek �n�ll� k�dr�szletek, amik csak akkor futnak le, ha erre a megh�v�sukkal utas�t�st adunk - de egy f�ggv�nyt egy programon bel�l ak�r t�bbsz�r is lefuttathatunk. Fut�suk k�zben a bemenet�k�n �t k�z�lt adatokat feldolgozz�k �s az eredm�nyt a kimenetre tov�bb�tj�k. A teljes program a f�ggv�nyt egy z�rt doboznak tekinti, amivel a be- �s a kimenet�n kereszt�l kommunik�l.

A f�ggv�nyek alapvet� szintaxisa edig �gy n�z ki:

<?php

function fuggvenyem(adat_bemenet)
   {
   ... f�ggv�ny t�rzs ...
   ... itt dolgozza fel az adatokat ...
   
   return kimenet;   // a feldolgoz�s eredm�nye megjelenik a kimeneten
   }

?>

K�zel 4000 gyakrabban haszn�lt f�ggv�ny el�re defini�lt a PHP-ban, ezeknek teljes list�j�t a PHP k�zik�nyv tartalmazza itt. Ugyanitt minden f�ggv�ny helyes haszn�lat�t is bemutatj�k.
Speci�lis c�lra defini�lhat a programoz� is f�ggv�nyt. Tov�bbiakban ezeken kereszt�l mutatjuk be a f�ggv�nyek haszn�lat�t.

fel...

Felhaszn�l� �ltal defini�lt f�ggv�nyek

N�zz�k az el�z� p�ld�nkat egy m�k�d� f�ggv�ny k�p�ben:

<?php

function fuggvenyem($bemenet)
   {
   $kimenet = $bemenet * 2;   // itt csin�l valamit a bemeneti adattal
   
   return $kimenet;   // az eredm�ny megjelenik a kimeneten
   }

?>

Mit l�tunk?

• A f�ggv�nydeklar�ci�t mindig a function sz�val vezetj�k be.
• Ezut�n megadjuk a f�ggv�ny�nk nev�t - f�ggv�nyk�nt m�g nem szerepl� nevet v�lasszunk a v�ltoz�n�v k�pz�s szab�lyai szerint.
• V�g�l egy kerek z�r�jel p�r () tartalmazza a bemeneti adatokat.
• A f�ggv�ny k�dj�nak lefut�s�val keletkezett eredm�nnyel fog a f�ggv�ny visszat�rni a f�ggv�ny�nk.

A f�ggv�ny csak akkor fog lefutni, amikor azt a programban valahol megh�vjuk, p�ld�ul �gy:

<?php

$a = 12;
print $a . " dupl�ja: " . fuggvenyem($a);

?>

L�tjuk: itt h�vjuk meg a f�ggv�nyt, bemenetek�nt megadtuk az $a v�ltoz�t, amit a f�ggv�ny bel�lr�l mint bemeneti adatot l�t. Lefut a k�dja �s az eredm�nyt a return kifejez�sbe teszi. K�v�lr�l a program ezt az �rt�ket l�tja azon a helyen, ahova a f�ggv�nyt behelyettes�tett�k (hisz azt m�r megbesz�lt�k hogy a f�ggv�nyt a program eg�sze egy z�rt dobozk�nt kezeli, nem l�t bele).

A p�ld�t m�k�d�s k�zben is megn�zheted itt (10/1. p�lda).

fel...

Bemeneti adatok

A f�ggv�ny a k�rnyezet�t�l a bemenet�n kereszt�l kapja meg a feldolgozand� adatokat. Ezeket a f�ggv�ny neve ut�ni kerek z�r�jel-p�r k�z� kell be�rni. Bemeneti adatot nem k�telez� megadni - ez esetben csak az �res z�r�jelp�r szerepel - illetve megadhat� egy, vagy t�bb bemeneti param�ter is. T�bb param�ter eset�n azokat vessz�vel kell elv�lasztani. A bemeneti param�terek b�rmilyen adatt�pus�ak lehetnek.

B�r a z�r�jeleket mindig k�telez� kitenni, n�h�ny be�p�tett PHP f�ggv�ny az�rt kiv�tel ez al�l. P�ld�ul a print(), include() f�ggv�nyek haszn�lhat�k z�r�jelekkel �s an�lk�l is. (Ez azon kiv�telek egyike is, ahol nem lehet tapasztalni a programnyelv m�shol szigor� logik�j�t.)

Hab�r alap�rtelmezetten a f�ggv�nynek �tadott v�ltoz� �rt�k m�solata ker�l a f�ggv�ny bemenet�re �s annak f�ggv�nyen bel�li v�ltoz�sa nincs hat�ssal a v�ltoz� eredeti �rt�k�re, itt is m�dunk van ett�l elt�rni. A m�dszert kor�bban m�r megismert�k: a & jellel itt is hivatkozhatunk az eredeti v�ltoz�ra. Ilyen esetben a v�ltoz� f�ggv�nyen bel�li m�dosul�sa hat�ssal lesz az eredeti v�ltoz� �rt�k�re is.

<?php

function fgv_extrakkal(&$string)
   {
   $string .= "�s a sz�ks�ges plusssz.";
   }

$str = "Ez egy karakterf�z�r, ";
fgv_extrakkal($str);
print $str;   // ki�rja: Ez egy karakterf�z�r, �s a sz�ks�ges plusssz.

?>

A p�ld�t m�k�d�s k�zben is megn�zheted itt (10/2. p�lda).

A param�tereknek lehet alap�rtelmezett �rt�ke is. Ha nem adunk meg ilyen param�tert a f�ggv�ny h�v�sakor, akkor a annak lefut�sakor az alap�rtelmezett �rt�kkel fog sz�molni.

<?php

function kavet_csinal ($tipus = "cappucino")
   {
   return "Csin�lok egy poh�r " . $tipus . "t. <br />\n";
   }

print kavet_csinal ();             // ki�rja: Csin�lok egy poh�r cappucinot.
print kavet_csinal ("espresso");   // ki�rja: Csin�lok egy poh�r espressot.

?>

A p�ld�t m�k�d�s k�zben is megn�zheted itt (10/3. p�lda).

Az alap�rtelmezett �rt�kkel rendelkez� param�tereket a param�terlista v�g�re kell tenni:

function fuggvenyem($egy, $ketto, $harom = "h�rom")

fel...

A f�ggv�ny visszat�r�si �rt�ke

A f�ggv�ny kimenet�n megjelen� �rt�ket a f�ggv�ny visszat�r�si �rt�k�nek nevezz�k.

A f�ggv�ny az elv�gzett m�velet eredm�ny�t a return kifejez�s seg�ts�g�vel adhatja �t a programnak a beilleszt�s hely�n, de az eredm�ny jelentkezhet az eg�sz programon k�v�l is, p�ld�ul a print() seg�ts�g�vel (ami maga is egy f�ggv�ny) a param�terek�nt megadott karaktersort ki�rja a k�perny�re - azaz k�zvetlen�k a HTML kimenetre k�ldi - vagy ak�r f�jlba �r, kukit helyez el, vagy b�rmi m�st csin�l.

A return-al �tadott visszat�r�si �rt�k b�rmilyen t�pus� lehet.

A return el�r�sekor a f�ggv�ny �tadja a vez�rl�st a program soron k�vetkez� r�sz�nek. Ha nincs return utas�t�s, akkor a f�ggv�ny kimeneti �rt�ke az utols� ki�rt�kelt kifejez�s �rt�ke lesz.

Az al�bbi gyakorlatiasabb p�ld�nak nincs return utas�t�sa, a kimenetet a print() sag�ts�g�vel a k�perny�re k�ldj�k.

<?php

function paros($bemenet)
   {
   if ($bemenet % 2 == 0)
      print "A " . $bemenet . " p�ros sz�m. <br />\n";
   else
      print "A " . $bemenet . " p�ratlan sz�m. <br />\n";
   }

paros(1);
paros(2);
paros(3);
paros(4);
?>

A p�ld�t m�k�d�s k�zben is megn�zheted itt (10/4. p�lda).

Ha a f�ggv�nynek referenci�val kell visszat�rnie, akkor az & referencia oper�tort kell alkalmaznod a f�ggv�ny deklar�s�kor �s a a visszat�r�si �rt�k megad�sakor is.

<?php

function &referenciat_ad_vissza()
   {
   return &$valtozo;
   }

$hivatkozas = &referenciat_ad_vissza();

?>

fel...

V�ltoz�k hat�k�re a f�ggv�nyben

M�r eml�tett�k, alapelv, hogy a programunk sz�m�ra a f�ggv�ny egy �n�ll� egys�g, egy "fekete doboz", ami csak a bemenet�n �s a kimenet�n kereszt�l kommunik�l a k�rnyzet�vel.
Ennek a k�vetkezm�nye, hogy a program k�v�lr�l nem l�tja a f�ggv�nyen bel�l l�trehozott v�ltoz�kat, a bemenet�n beadott v�ltoz�k m�dos�t�sait. Igaz viszont, hogy a f�ggv�nyen bel�lr�l sem l�tszanak a programk�rnyezet k�ls� v�ltoz�i. Ez a jellemz� sokszor j�l j�het, mert nem kell �gyeln�nk a k�l�nb�z� f�ggv�nyekben �s az eg�sz programban l�v� azonos nev� v�ltoz�k �tk�z�s�re.

A global kolcssz�:
N�ha azonban j�l j�nne, ha bizonyos v�ltoz�kat m�gis el lehetne �rni a f�ggv�nyen bel�l is.
Erre tal�lt�k ki a global kulcssz�t, mint kiv�tel-kezel�st. A probl�ma szeml�ltet�s�re n�zz�k meg ezt a p�ld�t:

<?php

function korod()
   {
   print "1-�letkorod: " . $kor . " �v.\n";
   }

$kor = 15;
print korod();

?>

A k�d eredm�nye itt l�that� (10/5. p�lda).

Amint l�tjuk, nem l�tunk semmit. Azaz a f�ggv�ny nem l�tja a $kor v�ltoz�t, mert az a f�ggv�nyen k�v�l van. De ha haszn�ljuk a global kulcssz�t, mindj�rt megjavul a k�dunk:

<?php

function korod2()
   {
   global $kor;
   print "2-�letkorod: " . $kor . " �v.\n";
   }

$kor = 15;
print korod2();

?>

N�zz�k meg ezt is (10/6. p�lda).

A magyar�zat egyszer�: a global kulcssz�val glob�liss� tett�k a f�ggv�ny�nk sz�m�ra a megnevezett k�rnyezeti helyi v�ltoz�t. T�bb v�ltoz�t is felsorolhatunk a global kulcssz� ut�n egym�st�l vessz�vel elv�lasztva �ket.

A glob�lis �s szuperglob�lis v�ltoz�k (ilyenek p�ld�ul a $_GET, $_POST, $_COOKIE...) el�rhet�k a global kulcssz� n�lk�l is.

A static kulcssz�:
A f�ggv�ny minden h�v�sa kezdetekor egy alaphelyzetb�l indul. Ha egy programban t�bbsz�r h�vjuk meg ugyanazt a f�ggv�nyt, el�fordulhat, hogy sz�ks�g�nk lenne a legutols� fut�skor felvett �llapot meg�rz�s�re, p�ld�ul, ha valamit megsz�molunk.
Erre k�n�l a PHP egy kieg�sz�t� lehet�s�get, a static kulcssz�val. A t�rolni k�v�nt adatot megjegyzi �s a f�ggv�ny k�vetkez� fut�sakor nem az alap�rtelmezettel, hanem az utolj�ra be�ll�tottal fog sz�molni.

Az al�bbi p�ld�ban bekezd�seket fogunk sorsz�mozni ezzel a m�dszerrel.

<?php

function szamozott_sorok($szoveg)
   {
   static $hivasok_szama = 0;   // alap�rtelmezett �rt�k
   $hivasok_szama++;            // n�velj�k eggyel
   print $hivasok_szama.". sor - ".$szoveg."<br />\n";
   }

// a f�ggv�nyt t�bbsz�r is megh�vjuk:
szamozott_sorok("valami sz�veg");
szamozott_sorok("ak�rmi st�veg");
szamozott_sorok("b�rmi sz�veg");

?>

Fejezet�nk utols� p�ld�j�t itt l�thatjuk m�k�d�s k�zben. (10/7. p�lda).

===> adat bemenet	f � g g v � n y	===> eredm�ny kimenet