Instructiuni PHP

Instructiuni uzuale folosite in PHP  

Pe langa instructiunile comune amintite in lectiile anteriorare - instructiunile de afisare, instructiunile de control, instructiunile pentru vectori, string-uri sau timp - exista o serie de alte functii ale limbajului PHP care sunt folosite cu precadere de orice programator.

Detaliem in cele ce urmeaza cateva dintre ele.

Functia mail()

PHP poate trimite emailuri daca pe serverul curent este instalata si o aplicatie de email (un server de email). Nu este nevoie de configurari suplimentare atat timp cat serverul de email nu are restrictii si poate fi accesat de aplicatiile locale. Intr-o instalare pe calculatorul personal, cum este cea descrisa in primele pagini ale acestui tutorial, nu este posibila trimiterea de mesage email, iar functia mail va returna o eroare. Pe un web-server configurat complet si corect, cum sunt serverele ce ofera gazduirea site-urilor, functia mail functioneaza corect.

<?php
// trimitere mesaj simplu
mail('adresa@exemple.com', 'Subiect mesaj', 'Mesaj simplu');
 
// trimiterea unui mesaj in care se specifica date aditionale
$to      = 'adresa@example.com';
$subject = 'Subiect mesaj';
$message = 'Mesaj simplu cu date aditionale';
$headers = 'From: punctsivirgula@example.com' . "\r\n" .
           'Reply-To: punctsivirgula@example.com' . "\r\n" .
           'X-Mailer: PHP/' . phpversion();
 
mail($to, $subject, $message, $headers);
?>

Functii matematice

Limbajul PHP dispune de majoritatea functiilor matematice uzuale. Cateva dintre ele sunt prezentate mai jos cu titlu exemplificativ. Lista completa poate fi gasita pe site-ul de documentatie PHP.

<?php
echo abs(-7);   // functia "valoare absoluta", afiseaza 7
echo sin(60);   // functia "sinus", afiseaza -0.304810621 ...
echo decbin(12);   // returneaza reprezentarea binara a numarului, afiseaza 1100
echo base_convert('7DB', 16, 10);   // returneaza convesia dintr-o baza in alta, afiseaza 2011
echo round(12.3); // returneaza o rotunjire la cel mai apropiat intreg, afiseaza 12
 
echo rand(); // afiseaza un numar aleator
echo rand(10, 70); // afiseaza un numar aleator din intervalul specificat
?>

Functia set_time_limit()

Functia set_time_limit se foloseste pentru a configura timpul maxim cat scriptul curent are voie sa se execute. Este utila atunci cand codul PHP trebuie sa execute un volum mare de operatii care ar putea dura cateva zeci de secunde (spre exemplu la un upload de fisiere). Daca dupa expirarea timpului scriptul inca se afla in executie, serverul va intrerupe executia fi va returna o eroare.

<?php
set_time_limit(50); // seteaza limita la 50 secunde
 
set_time_limit(0); // dezactiveaza limita - scriptul poate rula la nesfarsit
?>

Functia flush()

Functia flush trimite catre browser tot ceea ce a fost afisat deja de script. In mod normal, rezultatul unui script PHP este trimis catre browser pentru afisare doar la finalul executiei intregului script. Aceasta functie ofera posibilitatea trimiterii catre browser a rezultatului pe parcurs ce acesta este printat in PHP. Asta inseamna ca pagina poate fi afisata partiala in timp ce inca se incarca.

<?php
echo 'Text 1<br />';
echo 'Text 2<br />';
flush();
?>

Terminarea executiei

Sunt situatii in care se doreste oprirea executiei unui script PHP. Acest lucru este posibil folosind una din cele doua functii de mai jos.

Testeaza

<?php
exit( "Script terminat" );
die( "Script terminat" );
 
print "Acesta linie nu se afiseaza niciodata";
?>

Nota: instructiunile die si exit sunt echivalente.

Functii de transformare base64

Functiile de codificare base64 sunt folosite pentru codificarea/decodificarea unui text in si din formatul Base64.

<?php
$text = 'Tutorial PHP in limba romana';
echo base64_encode($text); // afiseaza VHV0b3JpYWwgUEhQIGluIGxpbWJhIHJvbWFuYQ==
echo base64_decode('VHV0b3JpYWwgUEhQIGluIGxpbWJhIHJvbWFuYQ==');  // Tutorial PHP in limba romana
?>

Functia phpinfo()

Functia phpinfo ofera informatii despre instalarea PHP curenta si despre serverul pe care aceasta este executata. Rolul acestei functii este pur informativ; functia nu poate fi folosita intr-un script care are un alt scop bine definit. De aceea, este recomandata apelarea acestei functii intr-un script PHP separat, intrucat aceasta creaza o pagina HTML completa.

<?php
phpinfo();  // returneaza o pagina HTML cu informatii despre instalarea PHP 
?>

O alta functie, ce poate fi utila in scripturile voastre, este phpversion - aceasta returneaza doar versiunea curenta a interpretorului PHP. Un exemplu al folosirii acestei functii este mai sus la functia mail.

Extensii ale limbajului PHP   

Pe langa functiile de baza, limbajul PHP ofera posibilitatea extinderii capacitatilor sale prin folosirea extensiilor. Extensiile sunt librarii dezvoltate de regula de cei care au creat limbajul PHP si care ofera functionalitati aditionale, cum ar fi posibilitatea de a manipula anumite tipuri de fisiere (PDF, Excel, Word), posibilitatea de a crea imagini, de a comunica cu alte aplicatii, etc.

Extensiile cele mai uzuale sunt activate implicit la instalarea interpretorului PHP, dar cele mai multe trebuie activate manual prin modificarea configurarii PHP. Intrucat in acest tutorial nu vom folosi nici o functionalitate care sa necesite vreo extensie a PHP-ului, nu vom insista asupra acestora. E bine de stiut doar ca pentru operatiuni specializate si/sau avansate, sunt sanse mari sa existe o extensie care sa usureze lucrul.

Functii in PHP    4  

Functiile sunt blocuri de cod PHP (secvente de cod) bine delimitate si identificate printr-un nume, ce executa un set de operatii. Functiile pot fi executate de mai multe ori in cadrul unui script prin simpla apelare a numelui lor.

Exista functii predefinite, specifice limbajului PHP (cum ar fi print, empty, etc) ce poti fi folosite in orice moment, fara a fi nevoie de vreo actiune speciala; si exista functii definite de utilizator, scrise practic de programatori. Pentru ca acestea sa poata fi folosite este nevoie sa fie declarate (si implementate).

Exemplu de functie definita de utilizator:

<?php
 
# functiile se declara folosind cuvantul cheie "function" urmat de numele functiei
# numele functiei trebuie sa fie orice identificator valid (adica sa inceapa cu 
# litere sau cu caracterul _ ) si sa nu contina caractere speciale sau spatiu
# dupa numele functiei se pun paranteze rotunde
# corpul functiei (implementarea) trebuie incadrata in acolade
function afisLuna()
{
 $luni = array( 'Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul',
  'Aug', 'Sep', 'Oct', 'Nov', 'Dec');
 echo '<select>';
 for( $i = 0; $i < 12; $i++ ) {
  # intrucat se cunosc nr de pasi, se foloseste structura repetitiva for
  echo "<option>{$luni[ $i ]}</option>\n";
 }
 echo '</select>';
}
 
# mai jos vom folosi functia pentru a afisa un drop-down cu lunile anului:
echo 'Luna inceperii activitatii: ';
afisLuna();
 
echo '<br /><br />Luna terminarii activitatii: ';
afisLuna();
 
?>

Rezultatul codului PHP este reprezentat mai jos:

Luna inceperii activitatii: Jan Feb Mar Apr May Jun Jul Aug Sep Oct Nov Dec 

Luna terminarii activitatii: Jan Feb Mar Apr May Jun Jul Aug Sep Oct Nov Dec 

Am scris, asadar, o singura data codul care afiseaza lunile anului si l-am apelat de cate ori am avut nevoie. Apelarea functiei se face prin specificarea numelui urmat de paranteze. Intre paranteze se pot specifica parametrii, dupa cum vom vedea mai jos. Alternativ, o functie definita de utilizator se poate apela folosind instructiunea call_user_func

# vom rescrie ultima parte a codului
echo 'Luna inceperii activitatii: ';
call_user_func( 'afisLuna' );
 
echo '<br /><br />Luna terminarii activitatii: ';
call_user_func( 'afisLuna' );

Instructiunea call_user_func este utila atunci cand numele functiei este furnizat de o variabila, cu ajutorul caruia se poate apela dinamic o functie. Exemplu:

<?php
 
# definesc 2 functii diferite
function unu() {
 print 'Azi suntem in intai!<br />';
}
 
function alta() {
 print 'Azi e o zi obisnuita<br />';
}
 
# declar o variabila care sa aiba ca valoare numele functiei
$functie = 'unu';
 
# variabila $functie poate sa se schimbe in functie de diferite conditii
# in cazul nostru, daca ziua curenta e prima zi din luna, valoarea va fi 'unu'
if( date( 'd' ) == 1 ) $functie = 'unu';
else $functie = 'alta';
 
# la final apelez dinamic functia data de variabila
# Interpretorul nu stie exact care functie va fi - el doar executa ce-i transmite variabila
 
# eventual pot face niste validari:
#  - function_exists verifica daca functia transmisa a fost definita
#  - is_callable verifica daca variabila transmisa poate fi apelata ca functie
 
if( function_exists( $functie ) && is_callable( $functie ) ) {
 call_user_func( $functie );
} else {
 echo "Nu pot apela functia $functie";
}
// Rezultat (live): Azi e o zi obisnuita
?>

Foarte important de stiut este faptul ca variabilele definite in afara functiilor nu sunt disponibile in interiorul lor. Astfel, codul de mai jos nu va functiona asa cum ne asteptam:

<?php
 
# declar o variabila
$a = "Afara e frumos";
 
# definesc o functie
function afisMesaj() {
 echo $a;
}
 
# apelez functia
afisMesaj(); // nu va afisa nimic!!
 
?>

Functia nu va afisa mesajul, asa cum v-ati fi gandit la prima vedere. Asta pentru ca ce este definit in afara functiei nu este recunoscut in interior. In mod similar, variabilele definite in interiorul unei functii se pierd si NU sunt disponibile in afara acesteia.

Exista totusi o modalitate prin care variabilele definite in afara unei functii sa fie 'aduse' in interiorul ei: folosind intructiunea global.

<?php
 
# declar o variabila
$a = "Afara e frumos";
 
# definesc o functie
function afisMesaj() {
 # folosind cuvantul 'global' ii spun interpretorului PHP ca  
 # vreau sa folosesc o variabila din afara functiei
 global $a;
 echo $a;
}
 
# apelez functia
afisMesaj(); // va afisa Afara e frumos
 
?>

Daca e nevoie sa se foloseasca mai multe variabile globale in cadrul unei functii, acestea se pot specifica toate intr-o singura instructiune global:

global $a, $b, $Vector;

De ce sunt folosite functiile?    

Printre avantajele folosirii functiilor, se numara:

• reutilizarea codului
  Spre exemplu, daca este nevoie sa se execute aceeasi secventa de cod in mai multe parti ale unui programm sau script, pentru a nu se rescrie codul de fiecare data, se defineste o functie care este apelata de mai multe ori, asa cum am facut in primul exemplu de mai sus
• modularizare
  Odata cu aparitia functiilor (a subprogramelor, in general) s-a introdus si conceptul de modularizare care presupune impartirea (spargerea) problemei ce trebuie rezolvata in probleme mai mici. Fiecare modul problema mai mica reprezinta un subprogram, implementat intr-o functie care contribuie la rezultatul final.
  Spre exemplu, avem o operatie (relativ) complexa: afisarea inbox-ului unui utilizator. Aceasta problema poate fi impartita in parti mai mici/simple. Pentru fiecare parte s-ar defini cate o functie in loc sa se scrie un singur script foarte mare, iar la final codul va arata cam in felul urmator:

  preluareDateAutentificare();
  verificareDate();
  preluareMesajeInbox();
  afisareInbox();

• mentinerea usoara a codului si intelegerea mai usoara a logicii aplicatiei sau a scriptului
  Acestea sunt urmari imediate ale primelor 2 puncte. Daca scriptul este structurat, impartit in bucati mai mici, in care aceleasi secvente de cod nu se repeta atunci va fi mai usor si de inteles si de modificat sau intretinut.

Valori returnate. Parametri   

De multe ori este nevoie ca o functie sa returneze o valoare. Majoritatea functiilor predefinite fac lucrul asta; spre exemplu empty returneaza TRUE sau FALSE in functie de starea si continutul unei variabile transmise ca parametru.

Si functiile definite de utilizator pot returna o valoare, cu ajutorul instructiunii return. Exemplu:

<?php
 
function formatareData() {
 $rezultat = date( 'd-m-Y' );
 return $rezultat;
}
 
# rezultatul returnat de functie poate fi folosit in diferite moduri:
$azi = formatareData(); // atribuirea rezultatului
print formatareData(); // afisarea rezultatului
formatareData(); // rezultatul nu este folosit - daca functia nu printeaza ceva
// atunci apelul nu are nici un efect vizibil
 
?>

De asemenea, functiile pot primi date ce pot fi folosite in interiorul lor pentru diverse prelucrari. Acestedate de intrare sunt transmise sub forma de parametrii.

Pentru ca o functie sa poata primi parametrii, aceasta trebuie sa ii declare intre parantezele rounde, ca in exemplul de mai jos

<?php
 
# functia este declarata sa primeasca 2 parametrii ce vor fi prelucrati
# functia returneaza si o valoare, in functie de datele de intrare
function minim($a, $b) {
 if( $a < $b ) return $a;
 else return $b;
}
 
# la apelul functiei, este obligatoriu sa se transmita 2 parametrii
# parametrii pot fi orice expresie (variabile, constante, rezultatul altor functii, etc)
 
print minim( 3, 4 ); // parametrii sunt 2 valori numerice
 
$x = 1; $y = 4;
print minim( $x, $y ); // parametrii sunt 2 variabile
 
$x = 4; $a = 3; $b = 5;
print minim( $x, minim( $a, $b ) ); // parametrii primului apel sunt: variabila $x
// si rezultatul unui alt apel cu 2 parametrii diferiti
 
?>

Nota: intrucat functia minim() returneaza o valoare, ea poate fi folosita ca si cum ar fi un numar normal. De aceea apelul de mai sus este valid. Alte exemple valide sunt mai jos:

<?php
 
$a = 1 + minim( 4, 3 );
 
if( minim( $a, 4 ) > 5 ) { echo "If-ul este True"; }
else { echo "If-ul este False"; }
 
?>

O facilitate avansata oferita de limbajul PHP este folosirea valorilor predefinite pentru parametrii functiilor. Aceasta permite ca o functie sa nu fie apelata cu toti parametrii ei, urmand ca pentru valorile care lipsesc sa fie folosite valorile predefinite. Functia minim() definita mai sus poate fi rescrisa in felul urmator:

<?php
 
function minim($a = 1, $b = 2) {
 if( $a < $b ) return $a;
 else return $b;
}
 
?>

Declararea functiei de mai sus se traduce in felul urmator: daca functia minim() nu este apelata cu toti parametrii, atunci foloseste valoarea 1 pt $a si valoarea 2 pt $b in calculele din interiorul functiei. In acest caz, functia se poate apela in felul urmator:

<?php
 
echo minim(); // echivalent cu echo minim(1,2);
echo minim(7); // echivalent cu echo minim(7,2);
echo minim(7,8); // apel normal cu toti parametrii
 
?>