« Programmation PHP/PEAR » : différence entre les versions

Un livre de Wikilivres.
Contenu supprimé Contenu ajouté
Ligne 111 : Ligne 111 :


== phpDocumentor ==
== phpDocumentor ==
Ce générateur de documentation analyse aussi le code. Ainsi, on peut décrire dans l'annotation qui précède une méthode, les types de ses arguments ou de son résultat :
Ce générateur de documentation analyse aussi le code. Ainsi, on peut décrire dans l'annotation qui précède une méthode, les types de ses arguments ou de son résultat<ref>https://www.phpdoc.org/</ref> :
<source lang=php>
<source lang=php>
/**
/**

Version du 22 novembre 2016 à 01:58


Qu'est-ce que PEAR ?

PEAR, acronyme de PHP Extension and Application Repository, est un framework PHP libre issu d'un groupe de développeurs qui proposent des extensions PHP en garantissant un code de qualité. La liste complète des extensions est téléchargeable gratuitement sur le site officiel[1].

Pour l'installer le framework, il y a quatre solutions :

  1. Télécharger les packages un par un sur http://pear.php.net/packages.php.
  2. Télécharger le gestionnaire sur https://pear.php.net/go-pear, et le lancer (ex : http://localhost/Frameworks/go-pear.php). Avec l'installation par défaut, les fichiers sont téléchargés dans un sous-dossier "PEAR".
  3. La commande pear install Nom_du_package.
  4. La commande php pyrus.phar install pear/Nom_du_package.

DB

L'extension PEAR DB fournit une gamme de fonctions de gestion de base de données permettant d'utiliser le même code quel que soit la base de données. Cela permet, si vous décidez de changer de BDD de ne pas être obligé de modifier de nouveau tous vos scripts. Un simple changement de variable vous permettra de passer de MySQL à Oracle par exemple.

Elle n'est plus maintenue depuis 2015[2], ce qui offre un inconvénient par rapport à PEAR MDB2.

Connexion à la base

Se connecter à une base de données revêt la syntaxe suivante :

require_once('DB.php'); // Indispensable

$dbType = "mysql";
$host = "127.0.0.1";
$account = "Mon_Compte";
$pass = "Mon_Mot_de_passe";
$dbName = "Ma_Base";
$dsn = "$dbType://$account:$pass@$host/$dbName";

$db = DB::connect($dsn);

if (PEAR::isError($db)) {
echo "Erreur : ".$db->getMessage();
}

Il est également possible de remplacer la chaîne de caractères par un tableau contenant vos informations :

$dsn = array(
    'phptype'  => 'mysql',
    'username' => 'myAccount',
    'password' => '****',
    'hostspec' => '127.0.0.1',
    'database' => 'tests',
);

Vous êtes donc connectés à votre base de données. Il s'agit maintenant d'effectuer des opérations avec celle-ci.

Fermeture de la connexion

Il est important de fermer votre connexion une fois vos opérations terminées pour augmenter la sécurité de votre code, réduisant les risques d'atteinte à vos données par un individu mal intentionné. Voici donc le code détruisant la connexion :

$db->disconnect();


Envoyer une requête

Une fois connecté, vous allez pouvoir envoyer des requêtes à votre BDD comme suit :

$query = "SELECT * FROM table WHERE id=5";
$rsc = $db->query($query);

Récupérer des informations

Comme avec n'importe quelle base de données, vous aurez à récupérer le résultat de votre requête. Voici une fonction équivalente de mysql_fetch_array() :

$query = "SELECT * FROM table WHERE id=5";
$rsc = $db->query($query);

if ( DB::isError($rsc) )
die($rsc->getMessage());

while($result = $rsc->fetchRow(DB_FETCHMODE_ASSOC) )
{
 echo $result['id']."\n";
}

MDB2

Cette bibliothèque issue de la précédente, offre une API de gestion des SGBD. Elle se télécharge sur http://pear.php.net/package/MDB2.

Spreadsheet_Excel_Writer

Cette bibliothèque fournit des classes de manipulation de fichier .xls sont[3][4].

Pour l'installer, il faut simplement télécharger le paquetage Spreadsheet_Excel_Writer, qui utilise OLE et Getopt.

Pour l'utiliser :

include "Spreadsheet/Excel/Writer.php;

Limites

Cette bibliothèque n'est plus maintenue depuis 2012[5], on lui préfèrera donc PHPExcel[6][7], qui gère en plus l'auto-ajustement, les filtres, et les XLSX (plus de limite de 65 536 lignes par feuille).

D'autant plus qu'elle remplit rapidement les logs avec des centaines de warnings : Object of class Spreadsheet_Excel_Writer_Format could not be converted to int.

phpDocumentor

Ce générateur de documentation analyse aussi le code. Ainsi, on peut décrire dans l'annotation qui précède une méthode, les types de ses arguments ou de son résultat[8] :

/**
 * @param bool $condition
 *
 * @return String|null
 */

Une méthode qui hérite d'une autre peut aussi hériter de sa doc :

@inheritdoc

Références

  1. http://pear.php.net/
  2. http://pear.php.net/package/DB
  3. pear.php.net
  4. developpez.com
  5. http://pear.php.net/package/Spreadsheet_Excel_Writer/
  6. https://github.com/PHPOffice/PHPExcel
  7. https://phpexcel.codeplex.com/
  8. https://www.phpdoc.org/