[PHP-DOC] cvs: phpdoc /en/functions outcontrol.xml
avsmFri Mar 30 16:46:13 2001 EDT Modified files: /phpdoc/en/functionsoutcontrol.xml Log: Typo in example PR: Submitted by: Reviewed by: Obtained from: Index: phpdoc/en/functions/outcontrol.xml diff -u phpdoc/en/functions/outcontrol.xml:1.11 phpdoc/en/functions/outcontrol.xml:1.12 --- phpdoc/en/functions/outcontrol.xml:1.11 Tue Feb 6 15:00:58 2001 +++ phpdoc/en/functions/outcontrol.xml Fri Mar 30 16:46:13 2001 @@ -276,7 +276,7 @@ ob_gzhandler Example -
[PHP-DOC] cvs: phpdoc /fr/functions strings.xml
damsFri Mar 30 09:51:36 2001 EDT Modified files: /phpdoc/fr/functionsstrings.xml Log: Soundex and strrchr Index: phpdoc/fr/functions/strings.xml diff -u phpdoc/fr/functions/strings.xml:1.38 phpdoc/fr/functions/strings.xml:1.39 --- phpdoc/fr/functions/strings.xml:1.38Fri Mar 30 06:03:01 2001 +++ phpdoc/fr/functions/strings.xml Fri Mar 30 09:51:35 2001 @@ -1081,8 +1081,10 @@ demandée au CPU, et annule l'optimisation des autres variantes. - Voir aussi soundex, - similar_text et metaphone. + Voir aussi + soundex, + similar_text et + metaphone. @@ -1786,9 +1788,9 @@ Une valeur Soundex est telle que deux mots prononcés de la même façon auront des valeurs Soundex identiques. Cela permet d'effectuer des recherches dans les bases de données, - si vous connaissez la prononciation mais pas l'orthographe. Cette - fonction retourne une chaîne de 4 caractères, commencant - par une lettre. + si vous connaissez la prononciation mais pas l'orthographe. + soundex retourne une chaîne de 4 + caractères, commencant par une lettre. soundex particulière a été @@ -1796,6 +1798,11 @@ vol. 3: Sorting And Searching", Addison-Wesley (1973), pp. 391-392. + Attention : le soundex dépend de la langue, et le soundex PHP + est optimisé pour l'anglais. Des versions françaises existent + sous forme de script. + + Exemple avec Soundex @@ -2642,8 +2649,8 @@ strrchr - Recherche la dernière occurrence d'un caractère dans une - chaîne + Recherche la partie terminale d'une chaîne après + un caractère donné
[PHP-DOC] cvs: phpdoc /fr/functions strings.xml
damsFri Mar 30 06:03:02 2001 EDT
Modified files:
/phpdoc/fr/functionsstrings.xml
Log:
refpurpose re-reading.corrected example in strpos
Index: phpdoc/fr/functions/strings.xml
diff -u phpdoc/fr/functions/strings.xml:1.37 phpdoc/fr/functions/strings.xml:1.38
--- phpdoc/fr/functions/strings.xml:1.37Tue Mar 27 07:22:04 2001
+++ phpdoc/fr/functions/strings.xml Fri Mar 30 06:03:01 2001
@@ -538,7 +538,7 @@
explode
- Scinde une chaîne en morceau, grâce à un délimiteur.
+ Scinde une chaîne en morceaux, grâce à un délimiteur.
@@ -590,8 +590,7 @@
get_html_translation_table
- Retourne la table de traduction utilisée par
- htmlspecialchars et htmlentities.
+ Retourne la table de traduction HTML
@@ -658,8 +657,7 @@
get_meta_tags
-Extrait toutes les balises meta d'un fichier, et les retourne sous forme d'un
-tableau.
+ Extrait toutes les balises meta d'un fichier
@@ -1734,7 +1732,7 @@
similar_text
- Calcule la similarité de deux chaînes.
+ Calcule la similarité de deux chaînes.
@@ -1964,7 +1962,7 @@
strncasecmp
- Comparaison binaires de chaînes de caractères
+ Compare en binaire des chaînes de caractères
@@ -2007,7 +2005,7 @@
strcasecmp
- Comparaison binaire de chaînes, insensible à la casse.
+ Compare en binaire des chaînes, insensible à la casse.
@@ -2073,7 +2071,7 @@
strcmp
-Comparaison binaire de chaînes.
+Compare en binaire des chaînes.
Description
@@ -2108,7 +2106,7 @@
strcoll
-Comparaison de chaînes localisée
+Compare des chaînes localisées
Description
@@ -2221,7 +2219,7 @@
StripCSlashes
- Déquote une chaîne quotée avec addcslashes
+ Déquote une chaîne quotée avec addcslashes()
@@ -2254,7 +2252,7 @@
StripSlashes
-Enlève les slash ajoutés par la fonction
addslashes
+Enlève les slash ajoutés par la fonction
+addslashes()
Description
@@ -2339,7 +2337,7 @@
strnatcmp
-Comparare des chaînes par ordre "naturel"
+Compare des chaînes par ordre "naturel"
@@ -2427,7 +2425,7 @@
strnatcasecmp
-Comparaisons de chaîne par ordre "naturel" insensible à la casse
+Compare des chaînes par ordre "naturel" insensible à la casse
@@ -2470,7 +2468,7 @@
strncmp
-Comparaison binaire des premiers caractères
+Compare en binaire les premiers caractères
@@ -2570,8 +2568,8 @@
strpos
- Recherche la première occurrence d'un caractère dans une
- chaîne.
+ Recherche la première occurrence d'un caractère dans une
+ chaîne.
@@ -2610,7 +2608,7 @@
// non trouvé
}
// versions plus anciennes que 4.0b3:
-$pos = strpos($machaine, "b");
+$pos = strpos("b", $machaine);
if (is_string($pos) && !$pos) {
// non trouvé
}
@@ -2738,7 +2736,7 @@
strrev
- Inverse l'ordre des caractères d'une chaîne.
+ Inverse l'ordre des caractères d'une chaîne.
@@ -2971,7 +2969,7 @@
strtolower
-Met tous les caractères en minuscule.
+Met tous les caractères en minuscules.
Description
@@ -3010,7 +3008,7 @@
strtoupper
-Met tous les caractères en majuscule.
+Met tous les caractères en majuscules.
Description
@@ -3272,7 +3270,7 @@
substr_count
-Compte le nombre de sous chaînes
+Compte le nombre de sous-chaînes
Description
[PHP-DOC] cvs: phpdoc /fr/pear standards.xml
damsFri Mar 30 00:51:52 2001 EDT
Added files:
/phpdoc/fr/pear standards.xml
Log:
Added PEAR and translated.
Index: phpdoc/fr/pear/standards.xml
+++ phpdoc/fr/pear/standards.xml
Style de codage PEAR
Indenting
Utilisez une indentation de 4 espaces, mais pas de tabulations.
Si vous utilisez Emacs pour éditer du code PEAR, pensez à mettre
indent-tabs-mode à nil. Voici un exemple de hook qui
va configurer Emacs suivant ces conseils (you devez vous
assurer qu'il sera appelé avant l'édition des fichiers PHP) :
(defun php-mode-hook ()
(setq tab-width 4
c-basic-offset 4
c-hanging-comment-ender-p nil
indent-tabs-mode nil))
Voici quelques règles pour vim :
set expandtab
set shiftwidth=4
set tabstop=4
Structures de contrôle
Cela couvre if, for, while, switch, etc... Voici un exemple de
condition if, (c'est une des plus compliquées) :
if ((condition1) || (condition2)) {
action1;
} elseif ((condition3) && (condition4)) {
action2;
} else {
defaultaction;
}
Les structures de contrôle doivent être suivi d'un espace
et d'une parenthèse ouvrante, pour les distinguer des appels
de fonctions.
Il est vivement recommandé d'utiliser les accolades en
toutes occasions, même lorsqu'elles sont techniquement
optionnelles. Cela améliore nettement la lisibilité, et
réduit la probabilité d'erreurs lorsque de nouvelles
lignes sont ajoutées.
Boucle For, switch:
switch (condition) {
case 1:
action1;
break;
case 2:
action2;
break;
default:
defaultaction;
break;
}
Function Calls
Les fonctions doivent être appelées sans espaces entre le nom
de la fonction, la parenthèse ouvrante et le premier argument;
il faut place un espace entre chaque argument et la virgule
de séparation, mais pas d'espace entre le dernier argument,
la parenthèse fermante et le point-virgule. Voici un exemple :
$var = foo($bar, $baz, $quux);
Comme illustré ci-dessus, il faut un espace autour des signes
égal lorsqu'il est utilisé dans une assignation de variable.
Dans le cas d'assignement en bloc, plusieurs espaces peuvent être
introduit pour améliorer la lisibilité.
$short = foo($bar);
$long_variable = foo($baz);
Function Definitions
Les déclarations de fonction suivent la convention
"one TRUE brace" (une seule accolade véritable) :
function fooFunction($arg1, $arg2 = '')
{
if (condition) {
statement;
}
return $val;
}
Les arguments ayant une valeur par défaut doivent aller
à la fin de la liste des arguments. Essayez de retourner
une valeur utile de vos fonctions, dès que c'est le cas.
Voici un exemple :
function connect(&$dsn, $persistent = false)
{
if (is_array($dsn)) {
$dsninfo = &$dsn;
} else {
$dsninfo = DB::parseDSN($dsn);
}
if (!$dsninfo || !$dsninfo['phptype']) {
return $this->raiseError();
}
return true;
}
Commentaires
La documentation du code doit suivre les conventions de
PHPDoc, similaire à Javadoc. Plus d'informations sur PHPDoc
sont disponibles ici : &url.phpdoc;.
Les commentaires hors documentation sont vivement conseillés.
En règle généaral, si vous voyez une portion de code et que
vous
pensez "Houla!, je n'ai pas envie de tester ça", vous devez
la commentez avant d'oublier ce qu'elle fait.
Les commentaires de style C (/* */) et standard C++ (// ) sont
bien tous les deux. Les autres styles (notamment Perl et shell
(# )) sont déconseillés.
Inclusion de Code
A chaque fois que vous incluez inconditionnellement une
classe, utilisez la fonction require_once.
A chaque fois que vous incluez conditionnellement une
classe, utilisez la fonction include_once.
Ces deux fonctions s'assureront que les classes ne sont
déclarées qu'une seule fois. Elles partagent la même
liste de fichier, ce qui permet leur utilisation sans
gêne. Un fichier inclus par require_once
ne sera pas inclus encore une fois avec include_once.
include_once et
require_once sont des commandes, et pas
des fonctions. Vous n'êtes pas obligés d'utiliser des
parenthèses autour des noms de fichiers.
Balises de code PHP
Utilisez toujours la syntaxe
pour délimiter du
code PHP, et jamais .
Ceci est nécessaire pour la compatibilité du code PEAR et c'est
la version la plus portable du code PHP sur les différents
systèmes d'exploitation.
Entête de fichier
Tous les codes sources des distributions PEAR doivent contenir
les commentaires suivants comme e
[PHP-DOC] cvs: phpdoc /fr/pear pear.xml
damsFri Mar 30 00:51:49 2001 EDT
Added files:
/phpdoc/fr/pear pear.xml
Log:
Added PEAR and translated.
Index: phpdoc/fr/pear/pear.xml
+++ phpdoc/fr/pear/pear.xml
Manuel de référence PEAR
PEAR
Ce chapitre contient la documentation de référence des composants
PEAR, qui sont distribué avec PHP. Une bonne connaissances des
mécanismes objets est
nécessaire.
PEAR
Classe de base PEAR
require_once "PEAR.php";
class classname extends
PEAR { ... }
Description
La classe de base PEAR fournit les fonctionnalités qui sont
utilisées
par la plus part des classes PEAR. Normalement, vous n'avez pas à
utiliser cette classe directement : il vous suffit d'en hériter.
Les fonctionnalités marquantes sont :
Fonction de fin de requête
Gestion des erreurs
Fonction de fin de requête
Si vous faîtes hériter de la classe PEAR,
une classe appelée NomClasse, vous pouvez
définir une méthode appelée
_ClassName
(le nom de la classe précédé d'un souligné), qui
sera appelée
lorsque le script prend fin. Ce n'est pas un destructeur, car
vous pouvez détruire un objet avec cette méthode, mais le
destructeur
sera quand même appelé. C'est une fonction de callback, qui
intervient lorsque le script prend fin. Voyez
l'exemple.
Gestion des erreurs
La classe de base PEAR fournit aussi un moyen de manipuler des
erreurs plus complexes qu'un simple booléen ou entier. Une
erreur PEAR est un objet qui est une instance de la classe
PEAR_Error, ou d'une de ses sous-classes.
Une des éxigences de conception des erreurs PEAR est qu'il ne
faut pas forcer l'affichage d'erreurs, mais plutôt de fournir
les outils pour les afficher, tout en laissant à l'utilisateur
le choix de les utiliser. Cela permet de traiter correctement
les erreurs, notamment si le format de sortie n'est pas HTML
(par exemple WML ou XML).
L'objet d'erreur peut être configuré de nombreuses façons
dès
sa création : affichage d'erreur, affichage d'erreur suivi
de la fin du script, envoie d'une erreur PHP avec
trigger_error, appeler une fonction
de traitement, ou rien du tout. Vous pouvez typiquement
spécifier ces parmètres dès le constructeur de
PEAR_Error : tous ces paramètres sont
optionnel, et PEAR fournit un moyen de
gérer des valeurs par défaut. Voyez les
exemples d'erreurs PEAR,
pour avoir une illustration, et la documentation de
PEAR_Error pour plus de détails.
Exemples
Les exemples ci-dessus montre comment utiliser les
simili destructeurs, pour implémenter une classe qui gère le
contenu d'un fichier, ajoute des données, et sauve le tout
à la fin du script.
Les simili destructeurs de PEAR
PEAR(); // cette ligne appelle le constructeur père
$fp = fopen($file, "r");
if (!is_resource($fp)) {
return;
}
while (!empty($data = fread($fp, 2048))) {
$this->contents .= $data;
}
fclose($fp);
}
function append($str)
{
$this->contents .= $str;
$this->modified++;
}
// le simili-destructeur est nommé d'après le nom de la classe
// mais avec un souligné devant.
function _FileContainer()
{
if ($this->modified) {
$fp = fopen($this->file, "w");
if (!is_resource($fp)) {
return;
}
fwrite($fp, $this->contents);
fclose($fp);
}
}
}
$fileobj = new FileContainer("testfile");
$fileobj->append("Ceci se termine à la fin du fichier\n");
// Lorsque le script est terminé et que PHP s'arrête,
// le simili destructeur de $fileobj est appelé, et
// met à jour les informations sur le disque
?>
Les simili destructeurs de PEAR utilisent les fonctions de
fin de script de PHP (register_shutdown_function),
et vous ne pourrez rien afficher dans ces fonctions, si vous
utilisez un serveur web. En ligne de commande, toutefois,
l'affichage se fera. C'est comme ca.
L'exemple suivant montre différentes façons d'utiliser le
mécanisme d'erreur de PHP.
Exemple d'erreurs PEAR(1)
[PHP-DOC] cvs: phpdoc /fr/pear about.xml
damsFri Mar 30 00:51:45 2001 EDT Added files: /phpdoc/fr/pear about.xml Log: Added PEAR and translated. Index: phpdoc/fr/pear/about.xml +++ phpdoc/fr/pear/about.xml About PEAR PEAR est dédié à Malin Bakken, né le 21 Novembre 1999 (le premier code de PEAR était écrit quelques heures avant sa naissance). Qu'est ce que PEAR? PEAR est une bibliothèque de codes et d'extensions, inspiré du CTAN de TeX et du CPAN de Perl. Les objectifs de PEAR sont : fournir un moyen de partager le codes entre développeurs donner à la communauté PHP un système de partage de code définir des standards pour aider les développeurs à écrire des codes portables et réutilisables fournir des outils de maintenance et de distribution
[PHP-DOC] cvs: phpdoc /en/functions ming.xml
damsFri Mar 30 00:16:20 2001 EDT Modified files: /phpdoc/en/functionsming.xml Log: Minor typos. Index: phpdoc/en/functions/ming.xml diff -u phpdoc/en/functions/ming.xml:1.5 phpdoc/en/functions/ming.xml:1.6 --- phpdoc/en/functions/ming.xml:1.5Thu Mar 29 04:24:11 2001 +++ phpdoc/en/functions/ming.xmlFri Mar 30 00:16:20 2001 @@ -619,7 +619,7 @@ swfdisplayitem->scale scales the current object by (dx,dy) from its - current position. + current size. The object may be a swfshape, a @@ -991,7 +991,7 @@ SWFDisplayItem->setRatio -Sets the object's ratio to ratio. +Sets the object's ratio. Description
