Introduction à PHPExcel

Nous allons mettre en forme une cellule en fonction des critères suivants :

• en gras ;
• de taille 12 ;
• de police 'Arial' ;
• de couleur verte.

Pour ce faire il suffit d'écrire le code suivant :

$workbook = new MaitrePylosExcel();

$sheet = $workbook->getActiveSheet();

$styleA1 = $sheet->getStyle('A1');
$styleFont = $styleA1->getFont();
$styleFont->setBold(true);
$styleFont->setSize(12);
$styleFont->setName('Arial');
$styleFont->getColor()->setARGB(PHPExcel_Style_Color::COLOR_GREEN);
$sheet->setCellValue('A1','MaitrePylos');

$workbook->affiche('Excel2007','MonPremierFichier');

Nous allons passer en revue ce code bien comprendre ce qu'il se passe.

$styleA1 = $sheet->getStyle('A1');

getStyle() est une méthode de la classe PHPExcel_Worksheet qui instancie la classe PHPExcel_Style (que nous verrons plus tard), on lui passe en paramètre la cellule visée.

$styleFont = $styleA1->getFont();

getFont() est donc une méthode de la classe PHPExcel_Style, qui instancie la classe PHPExcel_Style_Font.
À partir de cette instanciation, nous pouvons utiliser les méthodes de PHPExcel_Style_Font.

$styleFont->setBold(true);//passage à true de façon à activer la graisse.
$styleFont->setSize(12);//taille de la police
$styleFont->setName('Arial');//nom de la police
$styleFont->getColor()->setARGB(PHPExcel_Style_Color::COLOR_GREEN);

Pour la couleur, c'est un peu plus compliqué, il faut repasser par une nouvelle classe PHPExcel_Style_Color
Celle-ci définit un certain nombre de constantes que voici :

Ainsi que deux méthodes : setARGB(), que vous connaissez déjà (voir exemple ci-dessus) et qui prend en paramètre une des constantes.
setRGB(), qui, elle prend en paramètre le code HTML de la couleur :

$styleFont->getColor()->setRGB('FF00FF00');

Il y a moyen d'alléger ce code. En effet, la classe PHPExcel_Style_Font propose une méthode applyFromArray() qui prend un tableau en paramètre afin de ne pas utiliser les setter et getter de la classe et de rendre le code plus lisible.
Les mots clés de ce tableau sont :

• name ;
• bold ;
• italic ;
• underline ;
• strike ;
• color ;
• size ;
• superScript ;
• subScript.

Les noms sont fort proches des méthodes, et pour cause, elles utiliseront celles-ci, pour définir notre style de cellule.
Notre nouveau code sera donc :

$styleA1 = $sheet->getStyle('A1');
$styleFont = $styleA1->getFont()
->applyFromArray(array(
  'bold'=>true,
  'size'=>12,
  'name'=>Arial,
  'color'=>array(
    'rgb'=>'FF00FF00')));

Ce simple tableau remplace tous les appels aux méthodes de PHPExcel_Style_Font, puisqu'il le fait lui-même.
Vous remarquerez que color demande un nouveau tableau, parce que la classe PHPExcel_Style_Color a également une méthode applyFromArray, avec soit rgb ou argb.

PHPExcel_Style dispose également d'une méthode applyFromArray contenant le tableau suivant :

• fill ;
• font ;
• borders ;
• alignment ;
• numberformat ;
• protection.

Notre code deviendra dès lors :

$styleA1 = $sheet->getStyle('A1');
$styleA1->applyFromArray(array(
  'font'=>array(
    'bold'=>true,
    'size'=>12,
    'name'=>Arial,
    'color'=>array(
      'rgb'=>'FF00FF00'))
  ));

On veut parfois obtenir un format d'affichage spécifique pour une cellule, par exemple les dates, on pourrait vouloir le format « yy-mm-dd » ou encore « dd/mm/yyyy ».
Pour cela la classe PHPExcel_Style_NumberFormat vient à notre secours, et ce, de la même façon que vu au chapitre 4, traitant de la mise en forme.

$sheet->getStyle('B43')->getNumberFormat()->applyFromArray(
      array(
        'code' => PHPExcel_Style_NumberFormat::FORMAT_DATE_DDMMYYYY
      )
    );
    $sheet->setCellValue('B43', '=TODAY()');

De nouveau de façon très simple, la librairie PHPExcel, nous permet de définir un format précis, grâce à un certain nombre de constantes prédéfinies.

Il peut paraître fastidieux de retenir toutes ces constantes, ou de devoir aller dans l'API pour retrouver le format qui nous convient.
Dans ce cas, il suffit de passer un string en paramètre plutôt qu'une constante.

$sheet->getStyle('B43')->getNumberFormat()->applyFromArray(
      array(
        'code' => 'dd/mm/yyyy'
      )
    );

Pour aligner nos cellules, nous avons deux méthodes de la classe PHPExcel_Style_Alignment :
setHorizontal() - prenant en paramètre :

setVertical() - prenant en paramètre :

Voici un exemple d'utilisation

$sheet->duplicateStyleArray(array(
     'alignment'=>array(
              'horizontal'=>PHPExcel_Style_Alignment::HORIZONTAL_CENTER), 'A21:F37');

Pour la rotation du texte, il suffit de passer l'angle voulu dans la méthode rotation().

$sheet->duplicateStyleArray(array(
     'alignment'=>array(
              'rotation'=>90), 'A21:F37');

La passage automatique à la ligne : 'Wrap'

$sheet->duplicateStyleArray(array(
     'alignment'=>array(
              'wrap'=>true), 'A21:F37');

Ajuster les cellules : 'shrinkToFit'

$sheet->duplicateStyleArray(array(
     'alignment'=>array(
              'shrinkToFit'=>true), 'A21:F37');

Tout en même temps :

$sheet->duplicateStyleArray(array(
     'alignment'=>array(
            'shrinkToFit'=>true,
      'wrap'=>true,
      'rotation'=>90,
      'horizontal'=>PHPExcel_Style_Alignment::HORIZONTAL_CENTER)
, 'A21:F37');

Définir chaque ligne peut être vite fastidieux, il est possible de définir les quatre côtés de la cellule en une seule array(), grâce au mot clé 'allborders'.

$sheet->getStyle('B2')->getBorders()->applyFromArray(
      array(
        'allborders' => array(
          'style' => PHPExcel_Style_Border::BORDER_DASHDOT,
          'color' => array(
            'rgb' => '808080'
          )
        )
      )
  );