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 @@ + + Email Mail - 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ématiques Maths @@ -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_value void @@ -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 pi void @@ -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 <function>pow</function> <?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 val int 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-octets Chaî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 <filename>php.ini</filename> + +;; 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 <filename>php.ini</filename> 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 <filename>php.ini</filename> pour + mbstring pour utiliser <literal>EUC-JP</literal> + +;; 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 <filename>php.ini</filename> pour + mbstring pour utiliser <literal>SJIS</literal> + +;; 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 <literal>php.ini</literal> - -;; 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 <function>mb_internal_encoding</function> -<?php +<?;php /* Utilise l'encodage interne UTF-8 */ mb_internal_encoding("UTF-8"); /* Affiche l'encodage interne courant */ @@ -367,7 +790,7 @@ Exemple avec <function>mb_detect_order</function> -<?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 <function>mb_substitute_character</function> -<?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 <function>mb_output_handler</function> -<?php +<?php mb_http_output("UTF-8"); ob_start("mb_output_handler"); ?> @@ -534,7 +957,7 @@ Exemple avec <function>mb_preferred_mime_string</function> -<?php +<?php $outputenc = "sjis-win"; mb_http_output($outputenc); ob_start("mb_output_handler"); @@ -821,7 +1244,7 @@ - + mb_strimwidth Tronque une chaîne @@ -862,7 +1285,7 @@ Exemple avec <function>mb_strimwidth</function> -<?php +<?;php $str = mb_strimwidth($str, 0, 40, "..>"); ?> @@ -911,7 +1334,7 @@ Exemple avec <function>mb_convert_encoding</function> -<?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 <function>mb_detect_encoding</function> -<?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 <function>mb_convert_kana</function> -<?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 <function>mb_convert_kana</function> -<?php +<?php $name = ""; // kanji $mbox = "kru"; $doma = "gtinn.mon"; @@ -1186,7 +1609,7 @@ Exemple avec <function>mb_convert_variables</function> -<?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 <parameter>convmap</parameter> -<?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 <function>mb_encode_numericentity</function> -<?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 @@ + + LDAP LDAP @@ -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.