Fisierele de tip CSV (Comma-Separated Values) pot fi foarte utile, in special pentru ca este mult mai usor sa citesti un fisier CSV fata de un xls de exemplu, ca sa nu mai vorbim de schimbarea standardului.

Cam toate aplicatiile, care se respecta, de calcul tabelar au export si import CSV, deci nu trebuie sa stai cu grija ca nu ai ultima de versiune de Excel pe calculator.

De ce ai face totusi asa ceva? Pentru a gestiona un volum foarte mare de date, cum este o lista de preturi, o lista de clienti etc.

Sa incepem cu cititul, pentru ca de generat un CSV din Excel sau OpenOffice.org este relativ simplu.

 1// calea catre fisier
 2$fisier = 'test.csv';
 3
 4// deschidem fisierul pentru citire
 5if($fp = fopen($fisier, 'r')) {
 6  // extragem cate un rand si specificam delimitatoarele,
 7  // in acest caz fiind cele default de la MS Excel.
 8  // 1024 este marimea maxima a randului
 9  while($row = fgetcsv($fp, 1024, ',', '"')) {
10    // aici ar trebui sa fie prelucrarile pe date,
11    // dar pentru exemplu doar afisez randul
12    var_dump($row);
13  }
14
15  // inchidem fisierul
16  fclose($fp);
17}

Se astepta cineva la ceva mai complicat? Asta e cam toata citirea. Ar mai fi prelucrarea datelor, dar sa zicem ca primul camp din tabela este ID-ul produsului, atunci nu mai trebuie decat facuta interogarea in baza de date dupa aceasta cheie.

Scrierea unui fisier CSV. Daca citirea nu pare complicata, atunci nici scrierea nu va fi:

 1// fisierul destinatie
 2$fisier = 'fisier.csv';
 3
 4// datele, intr-un caz real acestea probabil se vor extrage direct din baza de date
 5$date = array(
 6             array('1', 'Calculator', 520),
 7             array('2', 'Mouse', 20)
 8           );
 9
10// deschidem fisierul in modul de scriere
11// PS: trebuie sa aveti drepturi de scriere pe fisier
12if($fp = fopen($fisier, 'w')) {
13        // parcurgem array-ul date
14	foreach($date as $valori) {
15                // array-ul rezultat se introduce in fisierul CSV
16		fputcsv($fp, $valori, ',', '"');
17	}
18        // inchidem fisierul
19	fclose($fp);
20}

Practic este ca orice alta scriere si citire a unui fisier doar ca se folosesc functii specifice pentru CSV.

Aceste doua functii, respectiv fgetcsv si fputcsv sunt foarte utile in special prin modul in care se pot modifica specificatile fisierului CSV.

Daca se doreste afisarea fisierului rezultat, eventual pentru download, nimic mai simplu:

1$fisier = 'fisier.csv';
2
3// header cu tipul fisierului
4header("Content-type: application/octet-stream");
5// header cu numele fisierului pentru download
6header("Content-Disposition: attachment; filename=\"fisier.csv\"");
7
8// citire fisier in string si afisare
9echo file_get_contents($fisier);

Preactic exemplul de mai sus nu este neaparat pentru un fisier CSV, este mai mult un exemplu general de citire si afisare a unui fisier.

Cam asta e tot cu fisierele CSV folosind PHP.

Afisarea lunilor nu este de loc o problema dificila, de asta si modurile de rezolvare nu sunt mereu eficiente.

In primul rand avem nevoie de luna, sa zicem luna curenta folosind functia date():

1// preia timestampul curent
2$timestamp = time();
3
4// afisaza luna in numere de la 1 la 12
5echo date('n', $timestamp);
6// in cazul curent va afisa "3"

Evident este inutila variabila $timestamp pentru ca acesta este oricum implicit data curenta, dar am zis sa fie mai clar.

Daca se dorea afisarea numelui lunii curente in engleza se poate folosi:

1echo date('F', $timestamp);
2// in cazul curent va afisa "March"

Acum vine dilema, cel mai “sanatos” dupa parerea mea este crearea unei functii separate.

Cazul cel mai nefericit este:

 1function getLuna($luna) {
 2  $ret = '';
 3  if($luna==1) {
 4    $ret = 'Ianuarie';
 5  } elseif($luna==2) {
 6    $ret = 'Februarie';
 7  } elseif($luna==3) {
 8    $ret = 'Martie';
 9  } elseif($luna==4) {
10    $ret = 'Aprilie';
11  } elseif($luna==5) {
12    $ret = 'Mai';
13  } elseif($luna==6) {
14    $ret = 'Iunie';
15  } elseif($luna==7) {
16    $ret = 'Iulie';
17  } elseif($luna==8) {
18    $ret = 'August';
19  } elseif($luna==9) {
20    $ret = 'Septembrie';
21  } elseif($luna==10) {
22    $ret = 'Octombrie';
23  } elseif($luna==11) {
24    $ret = 'Noiembrie';
25  } elseif($luna==12) {
26    $ret = 'Decembrie';
27  }
28
29  return $ret;
30}

Spun ca este cel mai “nefericit” pentru ca in luna decembrie vor fi executate 12 operatii if, evident nu o sa crape serverul dar il va incetinii, iar cu cat aceasta functie este apelata mai des, cu atat serverul va fi mai afectat.

Varianta numarul 2, o abordare mai usoara:

 1function getLuna($luna) {
 2  $ret = '';
 3
 4  switch($luna) {
 5    case 1:
 6       $ret = 'Ianuarie';
 7    break;
 8    case 2:
 9       $ret = 'Februarie';
10    break;
11    case 3:
12       $ret = 'Martie';
13    break;
14    case 4:
15       $ret = 'Aprilie';
16    break;
17    case 5:
18       $ret = 'Mai';
19    break;
20    case 6:
21       $ret = 'Iunie';
22    break;
23    case 7:
24       $ret = 'Iulie';
25    break;
26    case 8:
27       $ret = 'August';
28    break;
29    case 9:
30       $ret = 'Septembrie';
31    break;
32    case 10:
33       $ret = 'Octombrie';
34    break;
35    case 11:
36       $ret = 'Noiembrie';
37    break;
38    case 12:
39       $ret = 'Decembrie';
40    break;
41
42  }
43  return $ret;
44}

Aceasta varianta este putin mai buna pentru ca foloseste un singur swith fata de 12 if-uri imbricate. Aceasta varianta mi se pare una care este relativ suficient de frumos scrisa, dar… se poate si mai bine.

Varianta 3, o abordare simpla si concisa:

 1function getLuna($luna) {
 2  $luni = array(
 3               '',
 4               'Ianuarie',
 5               'Februarie',
 6               'Martie',
 7               'Aprilie',
 8               'Mai',
 9               'Iunie',
10               'Iulie',
11               'August',
12               'Septembrie',
13               'Octombrie',
14               'Noiembrie',
15               'Decembrie',
16           );
17
18  return $luni[$luna];
19}

Mult mai putin scris, mult mai putina batai de cap si dupa parerea mea mult mai usor de inteles. Am vrut sa scriu acest post incare de acum cateva luni cand am gasit intr-o bucata de cod prima abordare (cu if-uri) si in afara de faptul ca este slaba ca performanta este si greu de citit.

M-am folosit de aceasta functie de afisare a lunii pentru a pune in evidenta aceste 3 abordari, dar sunt multe pasaje de cod care merita revizuite pentru a se folosi o astfel de abordare.

Redimensionarea imaginilor folosind PHP si GD este foarte utila din doua motive:

1. dimensiunea imaginilor este chiar dimensiunea asteptata, adica imaginile nu trebuie redimensionate fortat de catre browser si la calitatea la care browserul poate sa o faca,
2. imaginea ocupa mai putin spatiu pe disk si implicit la transfer, rezultand in pagini mai rapide.

De obicei redimensionarea se face in doua moduri, redimensionare si afisare pe ecran sau redimensionare si salvare pe disk.

Metoda de a redimensiona si afisa pe ecran nu este foarte populara si exista niste motive bune pentru asta. In primul rand ca sa redimenionezi in functie de trebuinta o imagine inseamna sa ai deja pe server o imagine la dimensiunea initiala, de multe ori aceasta imagine unica ocupa mai mult spatiu pe disc decat doua imagini redimensionate (imagine mare si thumnail). De asemenea redimensionarea unei imagini de fiecare data cand este nevoie consuma foarte multe resurse de sistem, daca memoria nu este dezalocata corespunzator scriptul poate sa ramana fara memorie de lucru inainte de a se termina executia acestuia.

A doua metoda, cu salvare pe disk, este mult mai populara, avanjaul principal este ca imaginile redimensionate chiar exista pe disk, nu este nevoie redimensionarea acestora de fiecare data cand se ruleaza scriptul.

Redimensionarea se face in 4 pasi:

1. incarcarea imaginii de redimensionat
2. calcularea dimensiunii finale
3. redimensionarea propriuzisa
4. afisarea/salvarea pe disk a imaginii

Incarcarea imaginii de redimensionat:

 1// locatia unde se afla imaginea, presupunem ca imaginea exista acolo
 2$url = 'picture.jpg';
 3
 4// extragem informatile legate de imagine
 5$img_info = getimagesize($url);
 6
 7// in functie de tipul imaginii se va incarca imaginea
 8switch($img_info[2]) {
 9	// tipul jpeg
10	case IMAGETYPE_JPEG:
11		$imagine = imagecreatefromjpeg($url);
12	break;
13	// tipul gif
14	case IMAGETYPE_GIF:
15		$imagine = imagecreatefromgif($url);
16	break;
17	// tipul png
18	case IMAGETYPE_PNG:
19		$imagine = imagecreatefrompng($url);
20	break;
21	// tipul bmp
22	case IMAGETYPE_BMP:
23		$imagine = imagecreatefromwbmp($url);
24	break;
25}

Practic in codul de mai sus se vor extrage informatile legate de imagine apoi se va incarca imaginea propriuzisa in memorie.

Nota In functie de rezolutia si calitatea imaginii scriptul poate sa ramana fara memorie la incarcarea imaginii. Nu va bazati pe faptul ca pe disk imaginea ocupa sub 1MB!

Functia getimagesize intoarce un array cu informatile legate de imagine, eventual rulati un var_dump($img_info); ca sa vedeti cam ce informatii sunt disponibile.

In functie de tipul imaginii aceasta se va incarca in memorie folosind functia corespunzatoare, in cazul de mai sus va fi imagecreatefromjpeg();

Calcularea dimensiunii finale:

Calculul dimensiunii finale se rezuma de cele mai multe ori la geometrie. Mai jos voi prezenta calculul cand imaginea este redimensionata in functie de latura maxima:

 1// latura maxima a imaginii finale
 2$max = 200;
 3
 4// latimea
 5$x = $img_info[0];
 6
 7// inaltimea
 8$y = $img_info[1];
 9
10// aflarea laturei cu dimensiunea maxima
11$latMax = max($x, $y);
12
13if($latMax == $x) { // cazul cand latimea este maxima
14   // se calculeaza proportional inaltimea si se rotunjeste
15   $y2 = round($y*$max/$x);
16   // latimea va fi latura maxima
17   $x2 = $max;
18} elseif($latMax == $y) { // cazul cand inaltimea este maxima
19   // se calculeaza proportional latimea si se rotunjeste
20   $x2 = round($x*$max/$y);
21   // inaltimea va fi latura maxima
22   $y2 = $max;
23}

Acum in $x si $y sunt dimensiunile originale ale imaginii, iar in $x2 si $y2 dimensiunile pentru imaginea redimensionata.

Redimensionarea propriuzisa:

1// construim imaginea care va rezulta
2$img_finala = imagecreatetruecolor($x2, $y2);
3
4// redimensionam imaginea
5imagecopyresampled($img_finala, $imagine, 0, 0, 0, 0, $x2, $y2, $x, $y);
6
7// dezalocam imaginea initiala
8imagedestroy($imagine);

Mai multe despre imagecopyresample(); in manual.

Afisarea/salvarea pe disk a imaginii
In cazul in care se doreste salvarea imaginii pe disk:

1// locatia unde va fi salvata
2$destinatie = 'new-picture.jpg';
3
4// salvarea imaginii pe disk la noua destinatie
5imagejpeg($img_finala, $destinatie);

In cazul in care se doreste doar afisarea pe ecran a imaginii:

1// se afisaza headerul corespunzator pentru tipul imaginii
2header('Content-Type: image/jpeg');
3
4// se afisaza continutul imaginii in browser
5imagejpeg($img_finala);

In functie de tipul imaginii salvate se pot folosi si alte functii sau headere. Dar pentru exemplul curent cam asta e tot.

Nota Nu uitati ca trebuie sa aveti drepturi de scriere pe folderul unde salvati imaginea.

Acum ceva vreme m-am lovit de un scenariu care pe cat este de bizar pe atat este de realist. Pe un anumit server a unei anumite mare companie de cablu se afla site-ul unei anumite companii. Pana aici nimic nou, dar cand incercam sa urc fisiere cu file managerul site-ului fisierele nu se puteau urca. Pe scurt problema era ca user-ul Apache si user-ul de FTP nu aveau aceleasi drepturi. Stand si analizand problema pana la urma nu este o idee rea si cu toate astea, eu cum fac cu fisierelele? Solutia era simpla, fisierele pur si simplu trebuiau urcate prin ftp.

In primul rand am realizat in acel moment ca este o idee buna realizarea unei clase de abstractizare pentru operatiile cu fisiere, dar nu voi vorbi despre asta, voi incerca doar sa schitez operatiile principale cu fisiere, oricum este un secenariu putin bizar dupa parerea mea.

Dupa ce am rasfoit putin manualul am vazut si cam de ce este nevoie.

In primul rand avem nevoie de o conexiune FTP:

 1// conectarea la server-ul ftp
 2$ftp = ftp_connect("ftp.example.com") or die("nu se conecteaza la server");
 3
 4// face login-ul propriuzis
 5$login_result = ftp_login($ftp, FTP_USER, FTP_PASS) or die("nu face log-in");
 6
 7// aici vor fi operatiile
 8
 9// se inchide conexiunea la server
10ftp_close($ftp);

Copiere
Fata de metoda “traditionala” cand copierea era facuta simplu cu functii precum copy() sau move_uploaded_file(), prin ftp trebuie sa mai luam in calcul directorul unde se face aceasta:

1// schimbam locatia in directorul destinatie
2ftp_chdir($ftp, 'director/destinatie/');
3
4// se copiaza fisierul care a fost urcat pe server in mod binar
5ftp_put($ftp, 'fisier-destinatie.tip', $_FILES['fisier']['tmp_name'] ,
6   FTP_BINARY) or die("nu copiaza");

Ceva mai mult parametri dar destul de direct. In exemplul de mai sus am folosit un fisier care a fost urcat printr-un formular POST. Iar dupa cum se poate vedea mie imi place sa folosesc “or die()” in loc de if(), dar in productie nu este cea mai buna idee.

Modificare drepturi
Se face folosind o functie similara cu chmod():

1ftp_chmod($ftp, 0644, 'fisier.tip') or die("eroare in schimbarea drepturilor");

Destul de simplu, nu? Fata de chmod() practic mai apare si conexiunea.
Redenumire
Ca si mai devreme foarte similara cu rename():

1ftp_rename($ftp, 'nume_vechi.tip', 'nume_nou.tip')
2     or die("eroare la redenumire");

Crearea de foldere
Similar cu mkdir():

1ftp_mkdir($ftp, 'director') or die("eroare creare director");

Stergere
Foarte similar cu unlink():

1ftp_delete($ftp, 'fisier') or die("eroare la stergere");

Concluzionand functile sunt foarte similare cu cele de baza, iar cu ajutorul lor se pot face relativ usor clase de abstractizare.

PS: Am mai gasit un scenariu pentru care e interesanta folositea unei astfel de abordari, daca exista fisiere intr-un director pe server si trebuie modificate drepturile acestora doar pentru fisiere specifice, de exemplu intr-un director cu poze.

Acum ceva vreme am primit un task sa realizez o forma de prezentare a unei oferte de produse. Nu trebuia sa fie un catalog, trebuia pur si simplu sa fie o lista de produse. Clientul m-a lasat sa decid eu intre xls si pdf. Nu am stat pe ganduri si am ales pdf dar… era problema ce sa folosesc. De dragul portabilitatii am zis sa nu folosesc modulul php_pdflib ca sa nu apara probleme daca incerc sa refac aplicatia cu alta ocazie.

Dar Google ca de obicei mi-a dat si solutia: fpdf! Fpdf este o clasa php, total independenta realizata in php4. Trebuie sa recunosc ca mi-a luat cateva ore pana am ajuns sa realizez fisierul dar sunt foarte multimit de rezultat si chiar daca a durat putin mai mult decat estimasem initial o data ce m-am prins ce am de facut a iesit totul bine.

In principiu cam tot ce este nevoie este in manual.

Foarte multimit de rezultat am vrut sa trec la pasul 2, factura in format pdf.

Ca si in html eram obisnuit ca atunci cand informatia este tabelara sa o formatez ca atare, dar in fpdf nu exista tabele proprizise, exista celulele separate printr-un rand nou. Iar o alta problema este legata de formatarea tabelara, celulele nu se redimensioneaza dupa continut ca in html.

Prima problema este simplu de rezolvat, put si simplu se apeleaza metoda Ln() cand se doreste trecerea pe un nou rand, dar pentru ca celulele nu sunt chiar celule se pot intersecta destul de usor folosind latimea celulei:

 1require('fpdf.php');
 2
 3// instantiaza clasa
 4$pdf=new FPDF();
 5
 6// seteaza fontul
 7$pdf->SetFont('Arial','',5);
 8
 9//adauga o noua pagina
10$pdf->AddPage();
11
12// primele doua celule, primii 2 parametrii sunt latimea si inaltimea
13$pdf->Cell(20, 10, "celula 1", 1, 0, "C");
14$pdf->Cell(20, 10, "celula 2", 1, 0, "C");
15
16// un nou rand pentru a trece pe randul urmator
17$pdf->Ln();
18
19// celula a treia cu latimea cat primele doua celule, echivalentul lui
20// "rowspan" din html
21$pdf->Cell(40, 10, "celula 3", 1, 0, "C");
22
23// afisarea rezultatului
24$pdf->Output();

Rezultatul arata cam asa:

Pana aici totul pare ok, eu in momentul asta priveam plin de optimism la pasul urmator din factura, afisarea campurilor facturii. Aici a aparut problema, campurile nu se redimensioneaza si arata cel putin bizar. De exemplu doua celule arata cam asta:

1$pdf->Cell(20, 10, "Lorem ipsum dolor sit amet", 1, 0, "L");
2$pdf->Cell(20, 10, "celula 2", 1, 0, "C");

Va rezultata:

Iar in momentul asta mi-a cazut lumea in cap, mai ales ca imi aduceam aminte de o proforma primita in posta unde era aceasi problema. Solutia nu este foarte dificila dar a durat destul de mult “scotocit” ca sa o gasesc: in afara de metoda Cell() mai exista si metoda MultiCell() care suporta redimensionarea, chiar intr-un mod relativ elegant. Problema este ca aceste doua elemente trebuie combinate in fpdf pentru a genera un tabel de proforma:

 1// latimea primei celule
 2$w1 = 20;
 3
 4// latimea cele de a doua celule
 5$w2 = 20;
 6
 7// aflam coordonatele curente a le cursorului
 8$y1 = $pdf->GetY();
 9$x1 = $pdf->GetX();
10
11// celula multiCell care se redimensioneaza automat pe inaltime
12$pdf->MultiCell($w1, 10, "Lorem ipsum dolor sit amet", 1, "L"); 
13
14// aflam coordonatele cursorului dupa ce a fost afisata prima celula
15$y2 = $pdf->GetY();
16
17// aflam inaltimea primei celule
18$hCell = $y2 - $y1;
19
20// setam coordonatele cursorului la noua locatie calculata
21$pdf->SetXY($x1+$w1, $pdf->GetY() - $hCell);
22
23//afisam a doua celula
24$pdf->Cell($w2, $hCell, "celula 2", 1, 0, "C");

Rezultatul este:

Pana aici deja zambetul incepea sa revina. Ultimul pas este pozitionarea primei celule, celula cu numar de ordine in fata celor doua celule. In exemplul urmator latimile celule au fost decalate cu 1. Practic trebuie sa mutam cursorul la dreapta cu latimea primei celule, sa afisam celula care se va lati si sa calculam inaltimea ei. Dupa ce am calculat inaltimea celulei redimensionata putem sa potitionam cursorul din nou in pozitia initiala sa afisam prima celula, dupa care sa multam cursorul dupa a doua celula si sa continuam cu celelalte celule asa cum se inampla in mod normal. Exemplu:

 1// latimea primei celule
 2$w1 = 10;
 3
 4// latimea cele de a doua celule
 5$w2 = 20;
 6
 7// latimea cele de a treia celula
 8$w3 = 20;
 9
10// aflam coordonatele curente a le pointerului
11$y1 = $pdf->GetY();
12$x1 = $pdf->GetX();
13
14$pdf->SetXY($x1+$w1, $pdf->GetY());
15
16// celula multiCell care se redimensioneaza automat pe inaltime
17$pdf->MultiCell($w2, 10, "Lorem ipsum dolor sit amet", 1, "L"); 
18
19// aflam coordonatele pointerului dupa ce a fost afisata prima celula
20$y2 = $pdf->GetY();
21
22// aflam inaltimea celulei de tip MultiCell
23$hCell = $y2 - $y1;
24
25// setam coordonatele la pozitia initiala pentru a afisa prima celula
26$pdf->SetXY($x1, $y1);
27
28// afisam prima celula
29$pdf->Cell($w1, $hCell, "celula 1", 1, 0, "C");
30
31// setam coordonatele pointerului la noua locatie calculata
32$pdf->SetXY($x1+$w1+$w2, $y1);
33
34//afisam a treia celula
35$pdf->Cell($w3, $hCell, "celula 3", 1, 0, "C");
36
37// un nou rand pentru a trece pe randul urmator
38$pdf->Ln();

Rezultatul este:

De aici problema este rezolvata. De aici nu este decat o problema de a multiplica randul in functie de cate inregistrari se afla in factura. Daca folositi fpdf nu uitati sa treceti prin manual, este foarte simplu si concis.