Installer PHPDocumentor

La méthode la plus simlpe est de télécharger le phar (archive PHP) et de l’invoquer en ligne de commande.

Installer GraphViz pour visualiser graphiquement vos classe

Qui n’a jamais fait d’include de fichiers externes en PHP? C’est même récurrent pour les programmeurs.

Avouez que c’est quand même lourd à la longue. Il existe une méthode depuis PHP 5.3 pour résoudre automatique le chemin des fichiers de classe, enfin presque. A condition de bien comprendre quelques notions fondamentales en PHP objet.

Autoloading qu’est ce que c’est?

Quand vous avez à instancier un objet:

myDeuche = new Voiture();

PHP doit trouver le chemin du fichier qui contient la déclaration de classe et le charger (Autoloading). Prenons soins de nommer le fichier de déclaration de classe avec le même nom que la classe. Et dans un fichier il y a une seule classe. Ces deux conditions sont nécessaires pour faire marcher l’autoloading.

Votre fichier peut être dans le même répertoire que celui contenant le script ci-dessus.

Ou il peut être dans un sous répertoire ou sous sous répertoire.

Comment lui faire savoir dans ce cas?

C’est là qu’interviennent les espaces de nom.

soit la déclaration suit:

//Voiture.php

namespace vehicule;

class Voiture{

 //....suite du code

}

Ce fichier est obligatoirement dans le répertoire vehicule.

Ainsi lorsqu’on instancie l’objet Deuche, PHP va aller dans le répertoire vehicule pour chercher le fichier Voiture.php grâce à la correspondance du nom de classe (vous comprenez pourquoi on ne doit déclarer qu’une seule classe par fichier)

Historique et Évolution

L’autoloading a évolué avec PHP, particulièrement avec l’introduction de spl_autoload_register() dans PHP 5.1, qui a simplifié l’enregistrement de fonctions d’autoload personnalisées.

Les différentes méthodes d’autoloading

__autoload() (déprécié depuis PHP 7.2.0)

Cette fonction magique permettait de définir une méthode globale pour charger automatiquement les classes. Exemple :

function __autoload($className) {
    include $className . '.php';
}

spl_autoload_register()

Il s’agit de la méthode recommandée pour enregistrer une ou plusieurs fonctions d’autoloading :

spl_autoload_register(function ($class) {
    include 'classes/' . $class . '.class.php';
});

Autoloading PSR-4

La norme PSR-4 de PHP-FIG spécifie une manière standardisée d’autoloading des classes à partir de leurs namespaces. Elle est largement utilisée et soutenue par Composer.

{
    "autoload": {
        "psr-4": {
            "App\\": "src/"
        }
    }
}

Autoloading avec Composer

Composer, le gestionnaire de dépendances pour PHP, utilise l’autoloading version PSR-4 pour inclure automatiquement les bibliothèques externes. Il crée un fichier vendor/autoload.php qui gère l’autoloading des classes définies dans les packages installés. Composer n’est pas fourni avec PHP il faut l’installer.

require 'vendor/autoload.php';

use Monolog\Logger;
use Monolog\Handler\StreamHandler;

$log = new Logger('name');
$log->pushHandler(new StreamHandler('path/to/your.log', Logger::WARNING));

$log->warning('Foo');
$log->error('Bar');

Xdebug est un outil très utilisé pour profiler votre code PHP

Il vous génère un fichier de log qui exploité avec Wincachegrind (un analyseur de log dédié sous windows) ou Kcachegrin (sous Linux), vous pourrez voir les goulots d’étranglement de vos code PHP.

 

Pour installer sur Debian rien de plus simple, connecté sous root:

apt-get install php5-xdebug

Pour windows je ne vous fais pas la manip qui doit couler de source.

Ensuite ajoutez ces lignes dans le fichier php.ini :

[xdebug]
xdebug.remote_enable = off
xdebug.profiler_enable = off
xdebug.profiler_enable_trigger = 1
xdebug.profiler_output_name = “cachegrind.out.%u.%H_%R”
xdebug.profiler_output_dir = “c:/wamp/tmp”
xdebug.show_local_vars=0
xdebug.max_nesting_level=250

Attention en fonction de votre installation de WAMP, le chemin eput être différent, c’est soit wamp pour les version avant 3, et wamp64 pour les version 3.

Ensuite une fois que tout est installé, allez sur une url que vous voulez profiler, et ajoutez à la fin de l’url :

?XDEBUG_PROFILE

s’il y a déjà un autre paramètre :

?id=5&XDEBUG_PROFILE

 

Le fichier est enregistré dans le répertoire tmp.

Comme vous pouvez le voir les fichiers de xdebug commencent par « cachegrind.out » plus une heure ou date.

Pour paramétrer l’output dir, c’est à vous de choisir le meilleur répertoire, vérifiez qu’il soit autorisé en écriture. Si c’est généré sur votre serveur web, il suffit de le télécharger sur votre ordinateur et de l’analyser avec Wincachegrind.

Pour analyser ces logs générés, il vous faut sous Windows le programme Wincachegrind, une fois installé, ouvrez le fichier log généré et vous pourrez explorer les goulots d’étranglement. En effet tous les fichiers php qui s’exécutent sont profilés et vous avez vraiment un détail exceptionnel sur les temps d’exécution du moindre script php ainsi que leur temps d’exécution, c’est en regardant ce dernier paramètre que vous pourrez identifier les coupables d’un site web lent.

Un peu à la manière de l’installation de la librairie  GD, pour installer CURL voici la commande à taper dans le shell

apt-get install php5-curl

Voici comment créer un lien qui va ouvrir un client email avec déjà le texte du email écrit dedans, utili si vous automatiser la création d’email personnalisés.

Relancer Paiement Me

L’astuce consiste à mettre un lien mailto au lieu de http://, et de mettre le email cible.

Ensuite on introduit deux paramètres : Subject et body.

Le caractère esperluette doit être url encodé, en php c’est avec la fonction urlencode qu’on fait ça.

Le caractère %0A%0A est un retour chariot.

Programmez votre propre client FTP en PHP

Vous aurez peut être envie un jour de pouvoir uploader des fichier dans un serveur web, afin de mettre en place une nouvelle version d’un script. Si vous pouvez automatiser cette tâche, vous aurez un grand gain de productivité. On peut imaginer que vous ayez déployé un CMs sur plusieurs serveurs web, et que vous vouliez mettre en place une mise à jour en trois fois rien de temps.

Ceci est possible en php, votre langage de programmation favori. Fini donc les laborieuses connexions à la main avec Filezilla, on va automatiser ça.

FTP en PHP avec CURL

Ce n’est pas l’option la plus simple. En effet, il faut disposer de la bibliothèque CURL (pas si difficile que ça en fait), mais surtout écrier plusieurs lignes de php :

$ch = curl_init();
$localfile = 'test.txt';
$fp = fopen($localfile, 'r');

curl_setopt($ch, CURLOPT_URL, 'ftp://login:password@www.monsite.com/public_html/'.$localfile);
curl_setopt($ch, CURLOPT_UPLOAD, 1);
curl_setopt($ch, CURLOPT_INFILE, $fp);
curl_setopt($ch, CURLOPT_INFILESIZE, filesize($localfile));

curl_exec ($ch);
$error_no = curl_errno($ch);
curl_close ($ch);

if ($error_no == 0) {
$message = 'File uploaded successfully.';
} else {
$message = "File upload error: $error_no. Error codes explained here http://curl.haxx.se/libcurl/c/libcurl-errors.html.";
}
echo $message;

?>

ce script va charger le fichier test.txt de votre disque dur vers le serveur FTP et donc votre site web !

Mais comme toujours avec CURL, c’est fastidieux, il faut instancier l’objet CURL, injecter de paramètre et l’exécuter.

FTP en PHP plus simple avec les fonction FTP de PHP

Nos allons voir que c’est plus intuitif avec les fonction FTP de PHP.

En effet pour faire la même chose que le script ci-dessus:

// Ouverture de quelques fichiers pour lecture
$file = 'somefile.txt';
$fp = fopen($file, 'r');

// Mise en place d'une connexion basique
$conn_id = ftp_connect($ftp_server);

// Identification avec un nom d'utilisateur et un mot de passe
$login_result = ftp_login($conn_id, $ftp_user_name, $ftp_user_pass);

// Tente de charger le fichier $file
if (ftp_fput($conn_id, $file, $fp, FTP_ASCII)) {
echo "Chargement avec succès du fichier $file\n";
} else {
echo "Il y a eu un problème lors du chargement du fichier $file\n";
}

// Fermeture de la connexion et du pointeur de fichier
ftp_close($conn_id);
fclose($fp);

?>

Ici on crée une connexion FTP comme si on le faisait pour une connexion Mysql, on ouvre le fichier en local et on le met sur le serveur FTP. Avouez que c’est quand même plus lisible !

Installe GD en ligne de commande

C’est très simple, il faut vous logger sur votre shell via putty en mode root (pour pouvoir installer des extension sous Linux il faut être en mode root.

Et ensuite tapez cette commande :

$ apt-get install php5-gd

Ou alors si vous n’êtes pas connecté en root, tapez cette commande et vous serez invité à entrer le mot de passe root.

$ sudo apt-get install php5-gd

l’installation dur une trentaine de seconde le temps de reconfigurer (automatiquement) le serveur web Apache