Index: phpdoc/fr/functions/mail.xml
diff -u phpdoc/fr/functions/mail.xml:1.11 phpdoc/fr/functions/mail.xml:1.12
--- phpdoc/fr/functions/mail.xml:1.11 Tue Jul 31 04:05:31 2001
+++ phpdoc/fr/functions/mail.xml Wed Nov 14 16:23:12 2001
@@ -1,9 +1,62 @@
+
+
EmailMail
- mail envoie du courrier éléctronique.
+ mail envoie du courrier éléctronique.
+
+
+ Directive de configuration du courrier éléctronique
+
+
+ SMTP
+ string
+
+
+
+ Nom de serveur ou adresse IP du serveur SMTP que PHP sous
+ Windows doit utiliser pour envoyer le mail avec la fonction
+ mail.
+
+
+
+
+
+ sendmail_from
+ string
+
+
+
+ Entête MIME "From:" qui doit être utilisé dans les
+ mail, pour PHP sous Windows.
+
+
+
+
+
+ sendmail_path
+ string
+
+
+
+ Localisation du programme sendmail (généralement
+ /usr/sbin/sendmail ou /usr/lib/sendmail).
+ La commande configure effectue une recherche automatique
+ plutôt efficace pour vous, et choisit une des valeurs par défaut. Si cette
+ recherche échoue, vous pouvez indiquer les informations ici.
+
+
+ Les systèmes qui n'utilisentp as sendmail doivent utiliser cette
+ directive pour indiquer le programme de mail de remplacement. Par
+ exemple, pour Qmail, vous pouvez
+ utiliser la valeur suivante :
+ /var/qmail/bin/sendmail.
+
+
+
+
@@ -36,8 +89,8 @@
to. Les destinataires multiples doivent être
séparés par des virgules. Les emails avec pièces jointes
ou contenus particuliers (comme les emails en HTML, par exemple), peuvent
- être réalisés avec cette fonction. Il faut respecter l'encodage MIME. Pour
- plus de détails, voyez
+ être réalisés avec cette fonction. Il faut respecter
+ l'encodage MIME. Pour plus de détails, voyez
&url.zend.mail; et
la RFC 1896 (Visit http://www.rfc-editor.org/).
@@ -184,7 +237,7 @@
$user = "kris <email protected>";
$hash = ezmlm_hash($user);
$query = sprintf("INSERT INTO sample VALUES (%s, '%s')", $hash, $user);
- $db->query($query);
+ $db->query($query);
// utilisation de l'interface PHPLIB
?>
Index: phpdoc/fr/functions/math.xml
diff -u phpdoc/fr/functions/math.xml:1.14 phpdoc/fr/functions/math.xml:1.15
--- phpdoc/fr/functions/math.xml:1.14 Fri Aug 10 09:19:43 2001
+++ phpdoc/fr/functions/math.xml Wed Nov 14 16:23:12 2001
@@ -1,4 +1,5 @@
-
+
+
MathématiquesMaths
@@ -6,8 +7,9 @@
Introduction
- Ces fonctions ne sont capables de manipuler que des entiers "double", ou
- des "long". Si vous avez besoin de manipuler des nombres plus grands,
+ Ces fonctions ne sont capables de manipuler que des entiers
+ integer, ou nombres à virgule flottante (float).
+ Si vous avez besoin de manipuler des nombres plus grands,
reportez-vous aux fonctions mathématiques sur des
nombres de grande taille.
@@ -164,6 +166,33 @@
+
+
+ acosh
+ Arc cosinus hyperbolique
+
+
+ Description
+
+
+ float acosh
+ float arg
+
+
+
+ acosh retourne l'arc cosinus hyperbolique
+ de arg, c'est à dire la valeur dont
+ le cosinus hyperbolique est arg.
+
+ ¬e.no-windows;
+
+ Voir aussi
+ acos,
+ asin et
+ atan.
+
+
+ Asin
@@ -188,6 +217,33 @@
+
+
+ asinh
+ Arc sinus hyperbolique
+
+
+ Description
+
+
+ float asinh
+ float arg
+
+
+
+ asinh retourne l'arc sinus
+ hyperbolique de arg, c'est à dire la valeur dont
+ le sinus hyperbolique est arg.
+
+ ¬e.no-windows;
+
+ Voir aussi
+ asin,
+ acos et
+ atan.
+
+
+ Atan
@@ -244,6 +300,33 @@
+
+
+ atanh
+ Arc tangeant hyperbolique
+
+
+ Description
+
+
+ float atanh
+ float arg
+
+
+
+ atanh retourne l'arc tangente hyperbolique
+ de arg, c'est à dire la valeur dont
+ la tangente hyperbolique est arg.
+
+ ¬e.no-windows;
+
+ Voir aussi
+ atan,
+ asin et
+ acos.
+
+
+ base_convert
@@ -341,7 +424,7 @@
NOTE: ceil sous PHP/FI 2 retournait un nombre à
- virgule flottante. Utilisez: $new = (double)ceil($number);
+ virgule flottante. Utilisez: $new = (float)ceil($number);
pour retrouver le comportement traditionnel.
@@ -375,6 +458,33 @@
+
+
+ cosh
+ Cosinus hyperbolic
+
+
+ Description
+
+
+ float cosh
+ float arg
+
+
+
+ cosh retourne le cosinus hyperbolique de
+ arg, définit comme
+ (exp(arg) + exp(-arg))/2.
+
+
+ Voir aussi
+ cos,
+ acosh,
+ sin et
+ tan.
+
+
+ DecBin
@@ -462,8 +572,8 @@
Description
- double deg2rad
- double number
+ float deg2rad
+ float number
@@ -522,7 +632,7 @@
NOTE: floor sous PHP/FI retournait un float.
- Utilisez: $new = (double)floor($number);
+ Utilisez: $new = (float)floor($number);
pour retrouver le comportement traditionnel.
@@ -615,7 +725,7 @@
Description
- double lcg_value
+ float lcg_valuevoid
@@ -623,8 +733,8 @@
lcg_value retourne un nombre pseudo-aléatoire,
compris entre 0 et 1. lcg_value combine deux
générateurs de congruence, de périodes respectives
- 2^31 - 85 et 2^31 - 249.
- La période de cette fonction est le produit de ces deux
+ 2^31 - 85 et 2^31 - 249.
+ La période de cette fonction est le produit de ces deux
nombres premiers (soit (2^31 - 85)*(2^31 - 249)).
@@ -643,7 +753,7 @@
- log retourne le logarithme naturel
+ log retourne le logarithme naturel
(ou népérien) de arg.
@@ -676,10 +786,10 @@
Description
- mixed max
- mixed arg1
- mixed arg2
- mixed argn
+ number max
+ number arg1
+ number arg2
+ number argn
@@ -690,14 +800,16 @@
Si le premier paramètre est un tableau,
max retourne la plus grande valeur de ce tableau.
Si le premier paramètre est un entier, une chaîne ou
- un double, max requiert au moins deux paramètres,
+ un nombre à virgule flottante (float),
+ max requiert au moins deux paramètres,
et retournera alors le plus grand d'entre eux.
Le nombre d'arguments est alors illimité.
- Si au moins une valeur est un entier double, elles seront toutes
- traitées comme des doubles, et un double sera retourné.
- Si aucune valeur n'est de type double, elles seront traitées
+ Si au moins une valeur est un nombre à virgule flottante, elles seront toutes
+ traitées comme des nombres à virgule flottante, et un nombre
+ à virgule flottante sera retourné.
+ Si aucune valeur n'est un nombre à virgule flottante, elles seront traitées
comme des entiers, et un entier sera retourné.
@@ -711,10 +823,10 @@
Description
- mixed min
- mixed arg1
- mixed arg2
- mixed argn
+ number min
+ number arg1
+ number arg2
+ number argn
@@ -724,15 +836,16 @@
Si le premier paramètre est un tableau, min
retourne la plus petite valeur de ce tableau. Si le premier
- paramètre est un entier, une chaîne ou un double,
+ paramètre est un entier, une chaîne ou un nombre à virgule flottante,
min requiert au moins deux paramètres, et
retournera alors le plus petit d'entre eux. Le nombre d'arguments est alors
illimité.
- Si au moins une valeur est un entier double, elles seront toutes
- traitées comme des doubles, et un double sera retourné.
- Si aucune valeur n'est de type double, elles seront traitées
+ Si au moins une valeur est un nombre à virgule flottante, elles seront toutes
+ traitées comme des nombres à virgule flottante, et un nombre
+ à virgule flottante sera retourné.
+ Si aucune valeur n'est un nombre à virgule flottante, elles seront traitées
comme des entiers, et un entier sera retourné.
@@ -749,12 +862,8 @@
int mt_rand
- int
- min
-
- int
- max
-
+ int min
+ int max
@@ -822,7 +931,7 @@
<?php
// initialise avec les microsecondes depuis la dernière seconde entière
- mt_srand((double)microtime()*1000000);
+ mt_srand((float) microtime()*1000000);
$randval = mt_rand();
?>
@@ -974,7 +1083,7 @@
Description
- double pi
+ float pivoid
@@ -1013,20 +1122,20 @@
Si possible, pow retourne un integer.
- Si le calcul ne peut être fait, une alerte sera affichée et
+ Si le calcul ne peut être fait, une alerte sera affichée et
pow retournera &false;.
Quelques exemples avec pow
<?php
- var_dump( pow(2,8) );
+ var_dump( pow(2,8) );
// int(256)
- echo pow(-1,20);
+ echo pow(-1,20);
// 1
- echo pow(0, 0);
+ echo pow(0, 0);
// 1
-echo pow(-1, 5.5);
+echo pow(-1, 5.5);
// erreur
?>
@@ -1034,9 +1143,9 @@
En PHP 4.0.6 plus ancien, pow retournait
- toujours un nombre à virgule flottante (float),
- et n'affichait pas d'alerte. Si le calcul est impossible
- (racine d'un nombre négatif, par exemple),
+ toujours un nombre à virgule flottante (float),
+ et n'affichait pas d'alerte. Si le calcul est impossible
+ (racine d'un nombre négatif, par exemple),
pow retournait NAN.
@@ -1057,8 +1166,8 @@
Description
- double rad2deg
- double number
+ float rad2deg
+ float number
@@ -1081,12 +1190,8 @@
int rand
- int
- min
-
- int
- max
-
+ int min
+ int max
@@ -1128,8 +1233,8 @@
Description
- double round
- double val
+ float round
+ float valint
precision
@@ -1139,6 +1244,19 @@
round retourne la valeur arrondie de val
à la précision precision
(nombre de chiffres après la virgule).
+ Le paramètre precision peut être négatif
+ ou null (sa valeur par défaut).
+
+
+
+
+ PHP ne gère par correctement les chaînes telles que "12 300,2",
+ par défaut. Reportez-vous à
+ la conversion de chaînes.
+
+
+
+
<?php
@@ -1186,6 +1304,33 @@
+
+
+ sinh
+ Sinyus hyperbolique
+
+
+ Description
+
+
+ float sinh
+ float arg
+
+
+
+ sinh retourne le sinus hyperbolique
+ de arg, défini comme
+ (exp(arg) - exp(-arg))/2.
+
+
+ Voir aussi
+ sin,
+ asinh,
+ cos et
+ tan.
+
+
+ Sqrt
@@ -1225,7 +1370,7 @@
<?php
// initialise avec les microsecondes depuis la dernière seconde entière
- srand((double)microtime()*1000000);
+ srand((float) microtime()*1000000);
$randval = rand();
?>
@@ -1260,6 +1405,33 @@
Voir aussi
+ sin et
+ cos.
+
+
+
+
+
+ tanh
+ Tangente hyperbolique
+
+
+ Description
+
+
+ float tanh
+ float arg
+
+
+
+ tanh retourne la tangeante hyperbolique de
+ arg, définie comme
+ sinh(arg)/cosh(arg).
+
+
+ Voir aussi
+ tan,
+ atanh,
sin et
cos.
Index: phpdoc/fr/functions/mbstring.xml
diff -u phpdoc/fr/functions/mbstring.xml:1.3 phpdoc/fr/functions/mbstring.xml:1.4
--- phpdoc/fr/functions/mbstring.xml:1.3 Sun Jul 8 09:01:24 2001
+++ phpdoc/fr/functions/mbstring.xml Wed Nov 14 16:23:12 2001
@@ -1,3 +1,5 @@
+
+
Chaînes de caractères multi-octetsChaînes de caractères multi-octets
@@ -23,15 +25,419 @@
Les jeux de caractères multi-octets représentent les caractères
sur plusieurs octets consécutifs (d'où leur nom). Certains
- systèmes d'encodages ont des caractères d'échappement dédiés, pour
- démarrer/finir une séquence de caractères multi-octets. De ce fait,
- certains caractères peuvent être détruit lorsqu'une chaîne est
+ systèmes d'encodages ont des caractères d'échappement
+ dédiés, pour démarrer/finir une séquence de
+ caractères multi-octets. De ce fait, certains caractères
+ peuvent être détruit lorsqu'une chaîne est
coupée en plusieurs morceaux, ou bien conduire à des résultats
erronnés lorsque le nombre de caractère est compté. Il faut utiliser
des fonctions qui supportent ces encodages. Les fonctions
mbstring supportent les jeux de caractères
multi-octets, ainsi que les conversions.
+
+ Etant donné que PHP supporte essentiellement le jeu de
+ caractères ISO-8859-1, certains jeux de caractères
+ ne fonctionnent pas bien avec PHP. Par conséquent,
+ il est important de donner une valeur à l'option de configuration
+ mbstring.internal_encoding qui permettent à PHP de
+ travailler correctement.
+
+
+ Pré-requis PHP 4
+
+
+
+
+
+ Encodage par octet
+
+
+
+
+ Les caractères d'un octet dans l'intervalle 00h-7fh
+ doivent être compatibles avec le code ASCII
+
+
+
+
+ Jeux de caractères multi-octets, qui n'utilisent pas l'intervalle
+ 00h-7fh.
+
+
+
+
+
+ Voici des exemples d'encodage internes :
+
+
+Jeu de caractères qui fonctionnent avec PHP :
+ISO-8859-*, EUC-JP, UTF-8
+Jeu de caractères qui NE fonctionnent PAS avec PHP :
+JIS, SJIS
+
+
+
+
+ Les jeux de caractères qui ne fonctionnent pas comme encodage interne
+ à PHP, peuvent toutefois être utilisé avec les fonctions de conversion
+ de mbstring.
+
+
+
+ SJIS ne doit pas être utilisé comme encodage interne, à
+ moins que vous ne soyez familier de l'analyseur/compilateur, et des
+ problèmes liés aux jeux de caractères.
+
+
+
+
+ SI vous utilisez une base de données avec PHP, il est recommandé
+ que vous utilisiez le même jeu de caractère pour la base de données
+ et le jeu de caractère interne de PHP, pour améliorer les performances.
+
+
+ Si vous utilisez PostgreSQL, il supporte des jeux de caractères qui
+ peuvent être différents de ceux du client. Reportez vous au manuel
+ de PostgreSQL pour plus de détails.
+
+
+
+ Comment activer mbstring
+
+ mbstring est un module PHP. Vous devez activer le
+ module avec le script de configuration configure.
+ Reportez vous à la section installation
+ pour plus de détails.
+
+
+ Les options de configurations suivantes sont liées au module
+ mbstring.
+
+
+
+
+
+ : Active les
+ fonctions mbstring. Cette option est nécessaire
+ pour utiliser les fonctions mbstring.
+
+
+
+
+ :
+ Active la conversion automatique des données par HTTP, avec le moteur
+ de conversion de mbstring. Si cette option est activée,
+ les données venants du web via HTTP seront converties dans le jeu
+ de caractères mbstring.internal_encoding, automatiquement.
+
+
+
+
+
+
+ Entrées/Sorties HTTP
+
+ La conversion automatiques des entrées/sorties HTTP peuvent
+ aussi convertir des données binaires. Les utilisateurs
+ doivent contrôler les conversions, si des données binaires doivent
+ être utilisées via HTTP.
+
+
+ Si l'option enctype d'un formulaire HTML vaut
+ multipart/form-data,
+ mbstring ne convertira pas les données du POST. Dans ce
+ cas, les chaînes de caractères doivent être convertis manuellement.
+
+
+
+
+
+ Entrée HTTP
+
+
+ Il n'y a pas de moyen de contrôler la conversion des caractères
+ HTTP en entrée, depuis un script PHP. Pour désactiver cette conversion,
+ il faut le faire dès le fichier php.ini.
+
+
+ Inactive la conversion HTTP dans le php.ini
+
+
+;; Inactive la conversion HTTP
+mbstring.http_input = pass
+
+
+
+
+ Lorsque vous utilisez PHP comme module Apache, il est possible
+ d'annuler la configuration du php.ini pour
+ chaque Virtual Host dans le fichier
+ httpd.conf ou par dossier avec le fichier
+ .htaccess. Reportez vous à la section de
+ configuration ainsi qu'au
+ manuel Apache.
+
+
+
+
+ Sorties HTTP
+
+
+ Il y a plusieurs moyens d'activer la conversion en sortie de script
+ PHP. L'un d'entre eux utilise php.ini, un autre
+ utilise ob_start avec la fonction
+ mb_output_handler comme fonction de call-back.
+
+
+
+ Pour les utilisateurs PHP3-i18n, le système de conversion de
+ mbstring diffère de celui de PHP3-i18n.
+ Le jeu de caractère est converti avec un buffer de sortie.
+
+
+
+
+
+
+
+ Exemple de configuration de mbstring dans php.ini
+
+;; Active la conversion de sortie pour toute les pages PHP
+;; Active la bufferisation de sortie
+output_buffering = On
+;; Choisi mb_output_handler pour effectuer la conversion de sortie
+output_handler = mb_output_handler
+
+
+
+
+
+ Script example
+
+<?php
+// Active la conversion de caractère uniquement pour cette page
+// Choisi le jeu de caractères SJIS
+mb_http_output('SJIS');
+// Commence la bufferisation et spécifie "mb_output_handler"
+// comme fonction de callback
+ob_start('mb_output_handler');
+?>
+
+
+
+
+
+ Jeux de caractères supportés
+
+ Actuellement, les jeux de caractères suivants sont
+ supportés par mbstring. L'encodage
+ de caractère peut être spécifié
+ par les paramètres encoding dans les fonctions
+ mbstring.
+
+
+ Les jeux de caractères suivants sont supportés par
+ mbstring :
+
+
+ UCS-4,
+ UCS-4BE,
+ UCS-4LE,
+ UCS-2,
+ UCS-2BE,
+ UCS-2LE,
+ UTF-32,
+ UTF-32BE,
+ UTF-32LE,
+ UCS-2LE,
+ UTF-16,
+ UTF-16BE,
+ UTF-16LE,
+ UTF-8,
+ UTF-7,
+ ASCII,
+ EUC-JP,
+ SJIS,
+ eucJP-win,
+ SJIS-win,
+ ISO-2022-JP,
+ JIS,
+ ISO-8859-1,
+ ISO-8859-2,
+ ISO-8859-3,
+ ISO-8859-4,
+ ISO-8859-5,
+ ISO-8859-6,
+ ISO-8859-7,
+ ISO-8859-8,
+ ISO-8859-9,
+ ISO-8859-10,
+ ISO-8859-13,
+ ISO-8859-14,
+ ISO-8859-15,
+ byte2be,
+ byte2le,
+ byte4be,
+ byte4le,
+ BASE64,
+ 7bit,
+ 8bit et
+ UTF7-IMAP.
+
+
+ Les entrées du fichiers php.ini, qui acceptent des
+ noms de jeux de caractères, acceptent aussi les valeurs
+ "auto" et
+ "pass".
+ Les fonctions mbstring,qui acceptent des
+ noms de jeux de caractères, acceptent aussi la valeur
+ "auto"/
+
+
+ Si "pass" est utilisée, aucune conversion
+ n'est effectuée.
+
+
+ Si "auto" est utilisée, elle est remplacée
+ par "ASCII,JIS,UTF-8,EUC-JP,SJIS".
+
+
+ Voir aussi mb_detect_order.
+
+
+
+ Un jeu de caractère supporté n'est pas forcément un bon choix comme
+ jeu de caractères interne.
+
+
+
+
+ Configuration php.ini
+
+
+
+
+ mbstring.internal_encoding définit le jeu
+ de caractères interne par défaut.
+
+
+
+
+ mbstring.http_input définit le jeu
+ de caractères d'entrée HTTP par défaut.
+
+
+
+
+ mbstring.http_output defines définit le jeu
+ de caractères d'affichage HTTP par défaut.
+
+
+
+
+ mbstring.detect_order définit l'ordre de détection
+ des jeux de caractères (lors de la lecture sur une source externe.
+ Voir aussi la fonction mb_detect_order.
+
+
+
+
+ mbstring.substitute_character définit le
+ caractère de substitution pour les codes invalides.
+
+
+
+
+
+ Les navigateurs web utilisent tout le temps le même encodage lorsqu'ils
+ émettent les données d'un formulaire. Cependant, les navigateurs peuvent
+ ne pas tous utiliser le même encodage. Voyez la fonction
+ mb_http_input pour détecter les jeux de caractères
+ utilisés par les navigateurs.
+
+
+ Si enctype vaut multipart/form-data dans
+ un formulaire HTML, mbstring n'effectue aucune conversion
+ des données. Il faut les faire manuellement, dans le script.
+
+
+ Bien que les navigateurs soivent généralement assez intelligents pour
+ détecter les jeux de caractères automatiquement,
+ il est recommandé de l'indiquer dans l'en-tête
+ charset. Modifiez default_charset
+ en fonction du jeu de caractères.
+
+
+
+ Exemple de configuration php.ini pour mbstring
+
+;; Set default internal encoding
+;; Note: Make sure to use character encoding works with PHP
+mbstring.internal_encoding = UTF-8 ; Set internal encoding to UTF-8
+;; Set default HTTP input character encoding
+;; Note: Script cannot change http_input setting.
+mbstring.http_input = pass ; No conversion.
+mbstring.http_input = auto ; Set HTTP input to auto
+ ; "auto" is expanded to "ASCII,JIS,UTF-8,EUC-JP,SJIS"
+mbstring.http_input = SJIS ; Set HTTP2 input to SJIS
+mbstring.http_input = UTF-8,SJIS,EUC-JP ; Specify order
+;; Set default HTTP output character encoding
+mbstring.http_output = pass ; No conversion
+mbstring.http_output = UTF-8 ; Set HTTP output encoding to UTF-8
+;; Set default character encoding detection order
+mbstring.detect_order = auto ; Set detect order to auto
+mbstring.detect_order = ASCII,JIS,UTF-8,SJIS,EUC-JP ; Specify order
+;; Set default substitute character
+mbstring.substitute_character = 12307 ; Specify Unicode value
+mbstring.substitute_character = none ; Do not print character
+mbstring.substitute_character = long ; Long Example: U+3000,JIS+7E7E
+
+
+
+
+
+ Exemple de configuration php.ini pour
+ mbstring pour utiliser EUC-JP
+
+;; Disable Output Buffering
+output_buffering = Off
+;; Set HTTP header charset
+default_charset = EUC-JP
+;; Set HTTP input encoding conversion to auto
+mbstring.http_input = auto
+;; Convert HTTP output to EUC-JP
+mbstring.http_output = EUC-JP
+;; Set internal encoding to EUC-JP
+mbstring.internal_encoding = EUC-JP
+;; Do not print invalid characters
+mbstring.substitute_character = none
+
+
+
+
+
+ Exemple de configuration php.ini pour
+ mbstring pour utiliser SJIS
+
+;; Enable Output Buffering
+output_buffering = On
+;; Set mb_output_handler to enable output conversion
+output_handler = mb_output_handler
+;; Set HTTP header charset
+default_charset = Shift_JIS
+;; Set http input encoding conversion to auto
+mbstring.http_input = auto
+;; Convert to SJIS
+mbstring.http_output = SJIS
+;; Set internal encoding to EUC-JP
+mbstring.internal_encoding = EUC-JP
+;; Do not print invalid characters
+mbstring.substitute_character = none
+
+
+
+ Cas des caractères japonais
@@ -57,8 +463,8 @@
à comparer avec les caractères simple-octet traditionnellement
utilisé. Les caractères les plus gros sont appelés "zen-kaku"
(i.e. grande largeur) et les plus petits sont appelés "han-kaku"
- (i.e. demi-largeur). Les caractères "zen-kaku" sont généralement de taille
- constante.
+ (i.e. demi-largeur). Les caractères "zen-kaku" sont
+ généralement de taille constante.
@@ -70,8 +476,8 @@
Les bases de données allouent des tailles de stockages différentes
- de celles utilisées par PHP, même si le même encodage de caractère
- est utilisé (par exemple, PostGreSQL).
+ de celles utilisées par PHP, même si le même encodage
+ de caractère est utilisé (par exemple, PostGreSQL).
@@ -87,112 +493,129 @@
-
- Jeux de caractères supportés
-
- Les jeux de caractères suivants sont supportés par cette extension PHP :
- UCS-4,
- UCS-4BE,
- UCS-4LE,
- UCS-2,
- UCS-2BE,
- UCS-2LE,
- UTF-32,
- UTF-32BE,
- UTF-32LE,
- UCS-2LE,
- UTF-16,
- UTF-16BE,
- UTF-16LE,
- UTF-8,
- UTF-7,
- ASCII,
- EUC-JP,
- SJIS,
- eucJP-win,
- SJIS-win,
- ISO-2022-JP(JIS),
- ISO-8859-1,
- ISO-8859-2,
- ISO-8859-3,
- ISO-8859-4,
- ISO-8859-5,
- ISO-8859-6,
- ISO-8859-7,
- ISO-8859-8,
- ISO-8859-9,
- ISO-8859-10,
- ISO-8859-13,
- ISO-8859-14,
- ISO-8859-15.
-
-
-
- Configuration du fichier php.ini
-
-
-
-
- mbstring.internal_encoding définit le jeu
- de caractères interne par défaut.
-
-
-
-
- mbstring.http_input définit le jeu
- de caractères d'entrée HTTP par défaut.
-
-
-
-
- mbstring.http_output defines définit le jeu
- de caractères d'affichage HTTP par défaut.
-
-
-
-
- mbstring.detect_order définit l'ordre de détection
- des jeux de caractères (lors de la lecture sur une source externe
- inconnue).
-
-
-
-
- mbstring.substitute_character définit le
- caractère de substitution pour les codes invalides.
-
-
-
-
-
-
- Exemple de configuration du php.ini
-
-;; Set default internal encoding
-mbstring.internal_encoding = UTF-8 ; Par défaut, to UTF-8
-;; Set default HTTP input character code
-mbstring.http_input = auto ; Par défaut, mode automatique
-; or
-; mbstring.http_input = SJIS ; Par défaut, HTTP fournit du code SJIS
-; mbstring.http_input = eucjp-win, sjis-win, UTF-8 ; Ordre spécifique
-;; Set default HTTP output character code
-mbstring.http_output = UTF-8 ; Par défaut, HTTP affiche du code UTF-8
-;; Set default character code detection order
-mbstring.detect_order = auto ; Par défaut, mode automatique
-; or
-; mbstring.detect_order = eucjp-win, sjis-win, UTF-8 ; Ordre spécifique
-;; Set default substitute character
-mbstring.substitute_character = 12307 ; Spécifie un code de caractère
-; or
-; mbstring.substitute_character = none ; Caractère NULL
-; mbstring.substitute_character = long ; Long
-
-
-
-
+
+ Références
+
+ Les jeux de caractères multi-octets et leurs techniques sont très complexes.
+ Il n'est pas possible de couvrir tous les aspects en détails ici. Reportez-vous aux
+ URL suivantes, pour d'autres ressouces complémentaires :
+
+
+
+ Unicode/UTF/UCS/etc
+
+
+ http://www.unicode.org/
+
+
+
+
+ Japanais/coréen/Chinois
+
+
+
+ ftp://ftp.ora.com/pub/examples/nutshell/ujip/doc/cjk.inf
+
+
+
+
+
+
-
+
+
+ mb_language
+ Lit/modifie le langage courant
+
+
+ Description
+
+
+ string mb_language
+ string
+ language
+
+
+
+ mb_language remplace le langage courant par
+ language. Si language est omis,
+ mb_language retourne le langage courant.
+
+
+ Le paramètre language sert à encoder les
+ messages électroniques. Les langages valies sont :
+ "Japanese" (japonais), "ja" (japonais), "English" (anglais), "en"
+ (anglais) and "uni" (UTF-8). mb_send_mail utilise cette
+ option pour encoder les emails.
+
+
+ Le langage et sa configuration valle ISO-2022-JP/Base64
+ poru le japonais, UTF-8/Base64 pour l'UTF-8 et
+ ISO-8859-1/quoted printable pour l'anglais.
+
+
+ Si language est fourni et valide,
+ mb_language retourne &true;.
+ Sinon, elle retourne &false;. Lorsque le paramètre
+ language est omis, mb_language retourne
+ le nom du langage courant, sous forme de chaîne. Si aucun langage n'avait
+ été configuré, mb_language retourne &false;.
+
+
+ Voir aussi
+ mb_send_mail.
+
+
+
+
+
+ mb_parse_str
+
+ Analyse les données HTTP GET/POST/COOKIE et assigne les variables globales
+
+
+
+ Description
+
+
+ string mb_parse_str
+
+ string
+ encoded_string
+
+ array
+ result
+
+
+
+
+ mb_parse_str analyse les données d'entrées
+ HTTP GET/POST/COOKIE et assigne les variables globales. Etant donné
+ que PHP ne fournit pas de valeurs brutes de POST/COOKIE, cette
+ fonction n'est utilisable que sur les données en méthode GET.
+ mb_parse_str prend les données de l'URL appelante,
+ détecte le jeu de caractères, converti les données en jeu de caractères
+ interne, et affecte les valeurs au tableau de variables globales.
+
+
+ encoded_string: Les données encodées de l'URL.
+
+
+ result: Un tableau contenant les valeurs décodées,
+ et les noms des jeux de caractères.
+
+
+ mb_parse_str retourne &true; en
+ cas de succès, et &false; sinon.
+
+
+ Voir aussi
+ mb_detect_order et
+ mb_internal_encoding.
+
+
+ mb_internal_encoding
@@ -234,7 +657,7 @@
Exemple avec mb_internal_encoding
-<?php
+<?;php
/* Utilise l'encodage interne UTF-8 */
mb_internal_encoding("UTF-8");
/* Affiche l'encodage interne courant */
@@ -367,7 +790,7 @@
Exemple avec mb_detect_order
-<?php
+<?php
/* Remplace l'ordre de détection par une liste énumérée */
mb_detect_order("eucjp-win,sjis-win,UTF-8");
/* Remplace l'ordre de détection par un tableau */
@@ -443,7 +866,7 @@
Exemple avec mb_substitute_character
-<?php
+<?php
/* Configure le caractère de substitution avec U+3013 (GETA MARK) */
mb_substitute_character(0x3013);
/* Configure le caractère de substitution avec un format héxadécimal */
@@ -491,7 +914,7 @@
Exemple avec mb_output_handler
-<?php
+<?php
mb_http_output("UTF-8");
ob_start("mb_output_handler");
?>
@@ -534,7 +957,7 @@
Exemple avec mb_preferred_mime_string
-<?php
+<?php
$outputenc = "sjis-win";
mb_http_output($outputenc);
ob_start("mb_output_handler");
@@ -821,7 +1244,7 @@
-
+ mb_strimwidthTronque une chaîne
@@ -862,7 +1285,7 @@
Exemple avec mb_strimwidth
-<?php
+<?;php
$str = mb_strimwidth($str, 0, 40, "..>");
?>
@@ -911,7 +1334,7 @@
Exemple avec mb_convert_encoding
-<?php
+<?php
/* Convertit l'encodage interne vers SJIS */
$str = mb_convert_encoding($str, "SJIS");
/* Convertit EUC-JP en UTF-7 */
@@ -965,7 +1388,7 @@
Exemple avec mb_detect_encoding
-<?php
+<?php
/* Détecte l'encodage avec les valeurs par défaut */
echo mb_detect_encoding($str);
/* "auto" signifie "ASCII,JIS,UTF-8,EUC-JP,SJIS" */
@@ -1047,7 +1470,7 @@
Exemple avec mb_convert_kana
-<?php
+<?php
/* Convertit tous les "kana" en "zen-kaku" "kata-kana" */
$str = mb_convert_kana($str, "KVC");
/* Convertit "han-kaku" "kata-kana" en "zen-kaku" "kata-kana"
@@ -1104,7 +1527,7 @@
Exemple avec mb_convert_kana
-<?php
+<?php
$name = ""; // kanji
$mbox = "kru";
$doma = "gtinn.mon";
@@ -1186,7 +1609,7 @@
Exemple avec mb_convert_variables
-<?php
+<?php
/* Convertit les variables $post1, $post2 en encodage interne */
$interenc = mb_internal_encoding();
$inputenc = mb_convert_variables($interenc, "ASCII,UTF-8,SJIS-win", $post1, $post2);
@@ -1232,7 +1655,7 @@
Exemple de paramètre convmap
-<?php
+<?php
$convmap = array (
int start_code1, int end_code1, int offset1, int mask1,
int start_code2, int end_code2, int offset2, int mask2,
@@ -1249,7 +1672,7 @@
Exemple avec mb_encode_numericentity
-<?php
+<?php
/* Convertit du ISO-8859-1 en entités HTML */
$convmap = array(0x80, 0xff, 0, 0xff);
$str = mb_encode_numericentity($str, $convmap, "ISO-8859-1");
Index: phpdoc/fr/functions/ldap.xml
diff -u phpdoc/fr/functions/ldap.xml:1.10 phpdoc/fr/functions/ldap.xml:1.11
--- phpdoc/fr/functions/ldap.xml:1.10 Tue Jul 31 02:52:45 2001
+++ phpdoc/fr/functions/ldap.xml Wed Nov 14 16:23:12 2001
@@ -1,3 +1,5 @@
+
+
LDAPLDAP
@@ -199,8 +201,8 @@
- ldap_add retourne TRUE en cas de succès,
- ou FALSE en cas d'erreur.
+ ldap_add retourne &true; en cas de succès,
+ ou &true; en cas d'erreur.
ldap_add sert à ajouter une entrée
dans un dossier LDAP. Le ND de l'entrée sera ajouté à
@@ -221,7 +223,7 @@
Exemple complet avec lien authentifié
<?php
- $ds=ldap_connect("localhost");
+ $ds=ldap_connect("localhost");
// On suppose que le serveur LDAP est sur cet hôte
if ($ds) {
// liaison avec le nd approprié, pour avoir un accès en modification
@@ -261,8 +263,8 @@
ldap_bind lie un serveur LDAP avec le RDN
bind_rdn et mot de passe
bind_password. ldap_bind retourne
- TRUE en cas de succès, et
- FALSE sinon.
+ &true; en cas de succès, et
+ &true; sinon.
ldap_bind effectue une opération de liaison
@@ -286,8 +288,8 @@
- ldap_close retourne TRUE en cas de succès,
- et FALSE sinon.
+ ldap_close retourne &true; en cas de succès,
+ et &true; sinon.
ldap_close ferme le lien au serveur LDAP
@@ -318,7 +320,7 @@
- ldap_compare retournr TRUE si
+ ldap_compare retournr &true; si
value un fichier correspond à la recherche; retourne
-1 si une erreur survient.
@@ -335,7 +337,7 @@
Vérification d'un mot de passe avec LDAP
<?php
- $ds=ldap_connect("localhost");
+ $ds=ldap_connect("localhost");
// on suppose que le serveur LDAP est sur le serveur local
if ($ds) {
// liaison
@@ -348,9 +350,9 @@
$r=ldap_compare($ds, $dn, $attr, $value);
if ($r === -1) {
echo "Erreur: ".ldap_error($ds);
- } elseif ($r === TRUE) {
+ } elseif ($r === &true;) {
echo "Mot de passe correct.";
- } elseif ($r === FALSE) {
+ } elseif ($r === &true;) {
echo "Mot de passe erroné!";
}
} else {
@@ -391,7 +393,7 @@
ldap_connect retourne un identifiant positif de serveur
- LDAP en cas de succès, ou bien FALSE en cas d'erreur.
+ LDAP en cas de succès, ou bien &true; en cas d'erreur.
ldap_connect établit une connexion avec un serveur.
@@ -428,7 +430,7 @@
ldap_count_entries retourne le nombre
- d'entrées en cas de succès, et FALSE sinon.
+ d'entrées en cas de succès, et &true; sinon.
ldap_count_entries retourne le nombre d'entrées
@@ -453,8 +455,8 @@
- ldap_delete retourne TRUE en cas de succès,
- et FALSE sinon.
+ ldap_delete retourne &true; en cas de succès,
+ et &true; sinon.
ldap_delete efface une entrée dans un dossier
@@ -509,8 +511,8 @@
numéro d'erreur.
- Voir aussi
- ldap_errno et
+ Voir aussi
+ ldap_errno et
ldap_error.
Enumérer tous les messages d'erreur LDAP
@@ -580,8 +582,8 @@
- Voir aussi
- ldap_err2str et
+ Voir aussi
+ ldap_err2str et
ldap_error.
@@ -619,8 +621,8 @@
les affichages, les erreurs LDAP s'afficheront aussi dans le code PHP.
- Voir aussi
- ldap_err2str et
+ Voir aussi
+ ldap_err2str et
ldap_errno.
@@ -669,7 +671,7 @@
ldap_first_attribute retourne le premier attribut
- en cas de succès, et FALSE sinon.
+ en cas de succès, et &true; sinon.
Le comportement est similaire pour les entrées. Les attributs sont lus
@@ -684,7 +686,7 @@
ldap_next_attribute, qui modifie ce pointeur.
- Voir aussi
+ Voir aussi
ldap_get_attributes.
@@ -705,7 +707,7 @@
ldap_first_entry retourne un identifiant sur la
- première entrée en cas de succès, et FALSE sinon.
+ première entrée en cas de succès, et &true; sinon.
Les entrées d'un résultat sont lues séquentiellement,
@@ -716,7 +718,7 @@
accéder à la prochaine entrée.
- Voir aussi
+ Voir aussi
ldap_get_entries.
@@ -737,8 +739,8 @@
- ldap_free_result retourne TRUE en cas de
- succès, et FALSE sinon.
+ ldap_free_result retourne &true; en cas de
+ succès, et &true; sinon.
ldap_free_result libère la mémoire
@@ -775,7 +777,7 @@
ldap_get_attributes retourne un tableau multi-dimensionel
- en cas de succès, et FALSE sinon.
+ en cas de succès, et &true; sinon.
ldap_get_attributes sert à simplifier la lecture
@@ -810,7 +812,7 @@
- Voir aussi
+ Voir aussi
ldap_first_attribute et
ldap_next_attribute.
@@ -832,7 +834,7 @@
ldap_get_dn retourne le DN de l'entrée
- en cas de succès, et FALSE sinon.
+ en cas de succès, et &true; sinon.
ldap_get_dn sert à obtenir le ND d'une
@@ -856,7 +858,7 @@
ldap_get_entries retourne un tableau multi-dimensionnel
- en cas de succès, et FALSE sinon.
+ en cas de succès, et &true; sinon.
ldap_get_entries sert à simplifier la lecture
@@ -881,7 +883,7 @@
- Voir aussi
+ Voir aussi
ldap_first_entry et
ldap_next_entry.
@@ -905,7 +907,7 @@
ldap_get_option remplace la valeur courante de
l'option option par retval,
- et retourne TRUE en cas de succès, FALSE sinon.
+ et retourne &true; en cas de succès, &true; sinon.
Le paramètre option peut prendre l'une des valeurs :
@@ -935,7 +937,7 @@
- Voir aussi
+ Voir aussi
ldap_set_option.
@@ -957,7 +959,7 @@
ldap_get_option retourne un tableau de valeurs en
- cas de succès, et FALSE sinon.
+ cas de succès, et &true; sinon.
ldap_get_values sert à lire toutes les valeurs
@@ -1027,7 +1029,7 @@
ldap_get_values_len retourne un tableau de valeurs
- pour l'attribut, ou bien FALSE en cas d'erreur.
+ pour l'attribut, ou bien &true; en cas d'erreur.
ldap_get_values_len sert à lire toutes les
@@ -1075,8 +1077,8 @@
- ldap_list retourne TRUE en cas de succès,
- et FALSE sinon.
+ ldap_list retourne &true; en cas de succès,
+ et &true; sinon.
ldap_list effecture une recherche avec le filtre7
@@ -1125,8 +1127,8 @@
- ldap_modify retourne TRUE en cas de succès,
- et FALSE sinon.
+ ldap_modify retourne &true; en cas de succès,
+ et &true; sinon.
ldap_modify sert à modifier les entrées
@@ -1151,8 +1153,8 @@
- ldap_mod_add retourne TRUE en cas de
- succès, et FALSE sinon.
+ ldap_mod_add retourne &true; en cas de
+ succès, et &true; sinon.
ldap_mod_add ajoute les attributs entry
@@ -1179,8 +1181,8 @@
- ldap_mod_del retourne TRUE en cas de
- succès, et FALSE sinon.
+ ldap_mod_del retourne &true; en cas de
+ succès, et &true; sinon.
ldap_mod_del efface les attributs entry
@@ -1207,8 +1209,8 @@
- ldap_mod_replace retourne TRUE en cas de
- succès, et FALSE sinon.
+ ldap_mod_replace retourne &true; en cas de
+ succès, et &true; sinon.ldap_mod_replace remplace les attributs
entry à l'entrée dn.
@@ -1247,7 +1249,7 @@
ldap_first_attribute.
- Voir aussi
+ Voir aussi
ldap_get_attributes.
@@ -1270,7 +1272,7 @@
ldap_next_entry retourne l'identifiant de
l'entrée suivante, dans le résultat qui a été
initialisé par ldap_first_entry. S'il n'y a
- plus d'entrée, retourne FALSE.
+ plus d'entrée, retourne &true;.
ldap_next_entry sert à retrouver toutes les
@@ -1283,7 +1285,7 @@
ldap_first_entry.
- Voir aussi
+ Voir aussi
ldap_get_entries.
@@ -1319,7 +1321,7 @@
ldap_read retourne un identifiant de résultat
- en cas de succès, et FALSE sinon.
+ en cas de succès, et &true; sinon.
ldap_read effectue une recherche avec le filter
@@ -1340,7 +1342,8 @@
- Ces paramètres optionnels ont été ajoutés à partir de la version 4.0.2:
+ Ces paramètres optionnels ont été ajoutés à
+ partir de la version 4.0.2:
attrsonly,
sizelimit,
timelimit,
@@ -1371,10 +1374,10 @@
dn. Le nouveau RDN est spécifié par
newrdn et le nouveau père est spécifié par
newparent. Si le paramètre
- deleteoldrdn est TRUE,
+ deleteoldrdn est &true;,
l'ancienne valeur sera supprimée et la nouvelle valeur sera
- retenue. ldap_rename retourne TRUE
- en cas de succès, et FALSE sinon.
+ retenue. ldap_rename retourne &true;
+ en cas de succès, et &true; sinon.
ldap_rename ne fonctionne qu'avec LDAPv3.
@@ -1419,7 +1422,7 @@
ldap_search retourne un identifiant de résultat
- en cas de succès, et FALSE sinon.
+ en cas de succès, et &true; sinon.
ldap_search effectue une recherche avec le filtre
@@ -1496,16 +1499,18 @@
- Ces paramètres optionnels ont été ajoutés à partir de la version 4.0.2:
+ Ces paramètres optionnels ont été ajoutés à
+ partir de la version 4.0.2:
attrsonly,
sizelimit,
timelimit,
deref.
- La chaîne de filtre peut être simple ou complexe. Elle utilise les opérateurs
- booléens au même format que celui décrit dans les documentations LDAP.
- (Allez voir celle de Netscape Directory SDK
+ La chaîne de filtre peut être simple ou complexe. Elle utilise
+ les opérateurs booléens au même format que celui
+ décrit dans les documentations LDAP (Allez voir celle de
+ Netscape Directory SDK
pour plus d'informations sur les filtres).
@@ -1552,7 +1557,7 @@
ldap_set_option remplace la valeur de l'option
option par newval, et
- retourn TRUE en cas de succès, FALSE sinon.
+ retourn &true; en cas de succès, &true; sinon.
Le paramètre option peut prendre l'une des valeurs suivantes :
@@ -1571,14 +1576,15 @@
sont des chaînes de caractères. Le premier exemple illustre leur utilisation.
LDAP_OPT_SERVER_CONTROLS et LDAP_OPT_CLIENT_CONTROLS requiert une liste de
contrôles, ce qui signifie que la valeur peut être un tableau de contrôles.
- Un contrôle est constitué d'un oid identifiant le contrôle,
- d'une valeur value optionnelle, et d'un flag optionnel
- de criticalité. En PHP un contrôle est un tableau
- ayant la clé oid et une valeur sous forme de chaîne,
- ainsi que deux éléments optionnels. Ces éléments ont pour clé
+ Un contrôle est constitué d'un oid
+ identifiant le contrôle, d'une valeur value
+ optionnelle, et d'un flag optionnel de criticalité.
+ En PHP un contrôle est un tableau ayant la clé oid
+ et une valeur sous forme de chaîne, ainsi que
+ deux éléments optionnels. Ces éléments ont pour clé
value, sous forme de chaîne, et une clé
iscritical contenant un booléen.
- Par défaut, iscritical vaut FALSE
+ Par défaut, iscritical vaut &true;
Voyez aussi l'exemple ci-dessous.
@@ -1606,7 +1612,7 @@
// $ds est un lien valide LDAP
// control n'est pas une valeur
$ctrl1 = array("oid" => "1.2.752.58.10.1", "iscritical" => TRUE);
-// iscritical vaut par défaut FALSE
+// iscritical vaut par défaut &true;
$ctrl2 = array("oid" => "1.2.752.58.1.10", "value" => "magic");
// modification des deux contrôles
if (!ldap_set_option($ds, LDAP_OPT_SERVER_CONTROLS, array($ctrl1, $ctrl2)))
@@ -1616,7 +1622,7 @@
- Voir aussi
+ Voir aussi
ldap_get_option.
@@ -1635,8 +1641,8 @@
- ldap_unbind retourne TRUE
- en cas de succès, et FALSE sinon.
+ ldap_unbind retourne &true;
+ en cas de succès, et &true; sinon.
ldap_unbind termine la liaison avec le serveur LDAP.