Dans cet article nous allons voir comment à partir d’un code source bien commenté, générer une documentation comme on aimerait avoir pour tout projet ou application digne de son nom.

Pour cela nous allons utiliser PHPDocumentor. qui va nous permetre de générer une documentation à paritr des sources de notre projet.

Il faut d’abord l’installer avec la commande suivante :

pear install phpdocumentor

(si pear n’est pas installé faites un apt-get install php-pear)

Si vous rencontrez un problème de dépassement de mémoire alouée avec PHP, allez dans /etc/php5/cli/php.ini et augmenter cette limite (il s’agit du paramètre memory_limit).

création d’un fichier de configuration pour le projet :

pour générer la documentation d’un projet nous avons besoin d’un fichier de configuration par projet, en voici un exemple :
fichier nom_du_projet.conf :

[Parse Data]
title = Titre de la documentation
hidden = false
parseprivate = off
javadocdesc = off
defaultcategoryname = Documentation
defaultpackagename = Projet
target = /PATH/OU/SERA/ENREGISTRE/LA/DOCUMENTATION
readmeinstallchangelog = README, INSTALL, FAQ, LICENSE
directory =   /PATH/VERS/LE/PROJET
ignore = templates/,test*.php
sourcecode = on
output=HTML:frames:earthli

et pour tester exécutez la commande suivante (après avoir créé le répertoire cible de la documentation)

phpdoc -c nom_du_projet.conf

et voilà, la génération prend un peu de temps, en fonction de la machine et de la taille du projet.

(6 votes, note : 5 sur 5)

Catégories : Linux, Linux - Logiciels, PHP / MySQL, Programmation | Pas de commentaires

Parmi tous les services que propose les API google, on peut trouver des choses assez intéressantes, surtout en terme de géolocalisation avec l’API google maps et surtout très pratiques, dernièrement j’ai eu l’occasion de travailler avec le web service de géolocalisation, un outil très simple à utiliser et très pratique.

le but de la manipulation est d’obtenir la latitude et la longitude d’un point à partir de son adresse, pour cela, rien de bien méchant :

$address = 'notre adresse' //exemple : 5 rue du taur 31000 Toulouse

$request = 'http://maps.google.com/maps/geo?';
$request .='q='.urlencode($address);
$request .='&key='.GOOGLE_API_KEY ; // Vous devez en avoir une comme pour toutes les API google.
$request .='&output=csv'; // on peut choisir d'autres format, c'est très bien expliqué dans lien du web service

$response = @file_get_contents($request); // notre réponse est composée de 4 parties.

//exemple de réponse : 200,6,42.730070,-73.690570
//200 code réponse (200 => ok)
//6 degré de précision
//et les deux dernier sont les coordonnées du point que nous cherchons a géolocaliser.

et voilà avec ce bout de code très simple nous avons géolocalisé une adresse postale, chose très pratique, mais n’oublier pas la limitation qu’impose Google (50 000 requêtes par tranche de 24 heures).

(6 votes, note : 5 sur 5)

Catégories : PHP / MySQL, Programmation | Commentaires (2)

voici une fonction simple mais efficace pour convertir un texte en UTF-8 sans se préoccuper de sa provenance (encodage d’origine).

setlocale(LC_ALL, 'fr_FR.utf8'); //selon la configuration du serveur cela peut être : fr_FR

mb_detect_order(array('UTF-8', 'ISO-8859-1', 'ISO-8859-15', 'Windows-1252')); //l'extention mb_string est installée par defaut sur php5
function toUTF8($string){

   $from = mb_detect_encoding($string);

if ($from != 'UTF-8') {

      $string = mb_convert_encoding($string, 'UTF-8', $from);

   }

return $string;

}

(6 votes, note : 4.83 sur 5)

Catégories : PHP / MySQL, Programmation | Un commentaire

Firefox avance encore et encore, la barre des 500 millions de téléchargements est déjà franchie, en terme de pourcentage c’est déjà plus de 28% des utilisateurs en europe.

On reste encore un peu en dessous en France (25%) mais on progresse, comme partout d’ailleurs :-)

en attendant IE reste dans les 60% de parts, mais ça ne fait que baisser, et tant mieux ! a part bien sûr si du jour au lendemain IE devienne aussi respectueux des standards que ses concurrents, mais faut pas rêver non plus ;-)

(6 votes, note : 3.5 sur 5)

Catégories : Divers | Pas de commentaires

Comme si les sanctions et amendes infligées à Microsoft en Europe font de l’effet.

Microsoft vient de signer avec Samba, et pour 10 000 € (paiement unique, pas de royalties ni autre), cette dernière a obtenu toute la documentation des protocoles utilisés par Windows.

Samba pour ceux qui ne connaissent pas, est un logiciel libre, en Open source, sous Linux qui permet de faire des partages réseaux entre ordinateurs Windows <–> Linux. Ce dernier avait un peu de mal à suivre toutes les évolutions de windows, et donc, ne pouvait pas vraiment être au top et présentait même des limites dans certaines situations, mais tout cela devrait changer maintenant que les développeurs possèdent la documentation des protocoles, et ainsi Samba n’aura plus d’excuses pour le mauvais fonctionnement dans certains cas bien précis.

(4 votes, note : 4 sur 5)

Catégories : Divers, Linux - Logiciels, Windows - OS | Un commentaire

L’extension d’internationalisation est de localisation de PHP vient d’être annoncée en version Bêta, elle sera incluse dans PHP 5.3 (encore en développement).

Voici les premières classes disponibles :

• Collator : Manipulation de chaînes ;
• NumberFormatter : Manipulation de nombres ;
• Locale : Informations sur la Locale ;
• Normalizer : Uniformisation de texte en fonction de la locale ;
• MessageFormatter : Construction abstraite de texte à partir des autres objets de l’extension.

Collator et FormatNumber permettent de travailler avec des chaînes et avec des nombres, de manière indépendante de la langue (ex : “français”) et de la localisation (ex : “fr-CA” ou “fr-FR”).
Locale et Normalizer permettent d’intéragir plus en détail avec la localisation et avec du texte localisé.
MessageFormatter est le maître d’orchestre, un nouveau sprintf() en quelque sorte.

L’annonce : http://php100.wordpress.com/2007/12/12/icuphplove/
La documentation : http://docs.php.net/manual/en/book.intl.php
Téléchargement : http://pecl.php.net/package/intl

Source : Developpez.com

(6 votes, note : 4.83 sur 5)

Catégories : PHP / MySQL | Pas de commentaires

La bourse de New York avait commencé l’année dernière un plan d’expansion, qui se poursuit, mais cette fois, par une bonne surprise, en effet, ce sont pas loin de 600 machines HP avec (400 quadri processeurs) qui se veront installé un pingouin aux commandes, c’est aussi le cas de nombreux serveurs.

Un choix étonnant de la part de la Bourse, qui a depuis toujours fonctionné sous Unix, mais les responsables disent ne pas vouloir être dépendant d’un Unix propriétaire, d’où le choix du libre. Sans oublier l’économie réalisée en faisant ce choix. étonnant également que la bourse n’ait pas retenu le Système d’exploitation d’HP avec tout ce matériel HP.

(4 votes, note : 2.75 sur 5)

Catégories : Divers, Linux | Pas de commentaires

Le nouveau né de chez Microsoft est ouvert aux tests publics plutôt que prévu, en effet, la firme vient d’annoncer la nouvelle, plutôt encourageante quand on sait que la sortie était prévue pour le premier trimestre 2008.

Pour ceux qui ne le savent pas, Hyper-V est un logiciel de virtualisation, le plus connu dans ce domaine c’est VMware qui devrait se faire du soucis d’ailleurs, mais bon connaissant Miscrosoft, ils ne devraient pas trop quand même :-)

Cependant certaines sources affirment que le nouveau né de chez Miscrosoft serait 3 fois plus rapide que VMware, mais comme ne le savons tous, la vitesse ne fait pas tout, surtout s’il s’agit de faire cohabiter plusieurs serveurs virtuels entre eux.

Et pour finir un peut clin d’œil à l’environnement, car ne l’oublions pas, chaque serveur virtuel (émulé) évite l’utilisation d’un vrai serveur (machine) donc un ordinateur en moins, donc de l’énergie économisée.

(2 votes, note : 3 sur 5)

Catégories : Windows - Logiciels | Pas de commentaires

L’Association des Utilisateurs de PHP (AFUP) propose dès aujourd’hui un nouveau site ‘Planète PHP’.

Ce nouveau site regroupe l’ensemble des blogs et sites francophones parlant surtout de PHP.

Un très bon site dont la plus part des blogs partenaires sont très actifs sur la scene PHP. Un site complémentaire du site de Nexen.net

Planete PHP

(1 votes, note : 5 sur 5)

Catégories : Divers | Pas de commentaires

Certes il n’y a pas le même nombre de jeux que sous Windows, loin de là, mais il faut savoir qu’on peut quand même se divertir avec des vrais jeux meme sous linux, il y’en a pour à peu près tous les gouts, jeux de guerre, simulation, FPS, etc.

Voici quelques un parmi les plus connus :

• America’s Army : Vous êtes GI devinez ce qu’il vous reste a faire :p
• Tremulous : C’est le Quake du monde du pingouin
• Tux Racer : Vous aimez le pingouin ? faites le glisser au plus vite :-)
• The Open Racing Car Simulator : C’est pas NFS mais c’est pas mal (courses en circuit)
• Frets on Fire : Ca fait fureur ! tout le monde veut devenir guitariste maintenant

et bien d’autres encore, en voici une liste

(1 votes, note : 5 sur 5)

Catégories : Linux - Logiciels | Pas de commentaires