php / doc-fr Goto Github PK

From manual page: https://php.net/language.oop5.traits

Précédence ¶

Une méthode héritée depuis une classe mère est écrasée par une méthode issue d'un Trait. L'ordre de précédence fait en sorte que les méthodes de la classe courante écrasent les méthodes issues d'un Trait, elles-mêmes surchargeant les méthodes héritées.

this sentance is contradictory

From manual page: https://php.net/language.fibers

There is a typo in the "Exemple #1 Utilisation de base" ouput . It should be in this order :

Valeur de la suspension de la fibre: fiber
Valeur utilisée pour reprendre la fibre: test

From manual page: https://php.net/function.fgetcsv

"les fichiers encodés par un encodage d'un octet peuvent être mal lus par cette function. "

"les fichiers encodés avec un encodage d'un octet peuvent être mal lus par cette fonction. "

From manual page: https://www.php.net/manual/fr/function.setlocale.php

Dans les "Notes" :

"Les utilisateurs de Windows trouverons des informations utiles à propos du paramètre ..."

devrait être :

"Les utilisateurs de Windows trouveront des informations utiles à propos du paramètre ..."

From manual page: https://php.net/function.array-filter

The french translation for the "mode" parameter contain a repetition:
-> "Par défaut 0 par défaut qui passera la valeur comme seul argument de callback."
It could be:
-> "Par défaut 0 qui passera la valeur comme seul argument de callback."

From manual page: https://php.net/index

--- Notice: Array to string conversion in C:\wamp64\www\products-dashboard-ui\dist\displayproduct.php on line 53

From manual page: https://php.net/function.mb-list-encodings

PHP version 7.4.33 64bit with in php.ini:
extension=ldap
extension=mbstring
extension=exif ; Must be after mbstring as it depends on it

• Fatal error function mb_list_encoding undefined
  [11-Dec-2022 16:05:21 UTC] PHP Fatal error: Uncaught Error: Call to undefined function  mb_list_encodings() in E:\wamp64\scripts\test.php:9
  The line 9 is:
  $known_codages = mb_list_encodings();

The result of:
$list = get_defined_functions();
is:
[11-Dec-2022 16:07:12 UTC] Array
(
[internal] => Array
(
[0] => zend_version
[1] => func_num_args
[...]
[1484] => mb_convert_encoding
[1485] => mb_detect_encoding
[1486] => mb_list_encodings
[1487] => mb_encoding_aliases

With $list = get_defined_functions(true);
we can see that the function mb_list_encodings is not disabled.

phpinfo() show that mbstring is activated :
mbstring
Multibyte Support enabled
Multibyte string engine libmbfl
HTTP input encoding translation disabled
libmbfl version 1.3.2

The function mb_convert_encoding is recognized and works perfectly.

Same problem happens with PHP 8.0.26, 8.1.13 or 8.2.0

From manual page: https://php.net/function.ftp-nlist

It happened to me today, in v7.4.7 :

$list = ftp_nlist(null, '/');
var_dump($list);

will result in

PHP Warning:  ftp_nlist() expects parameter 1 to be resource, null given in /var/www/ftp_nlist.php on line 2
NULL

I also confirmed this behavior in other php versions (5.3 and 7.2).
Although it is understandable, the documentation does not mention it and I expected to have false as return

From manual page: https://php.net/class.ziparchive

Today I was trying create a file with this name "Liste des postes de distribution à la date du ".now()->format('d-m-Y H:i:s')" and because of the accent on "à" I faced an issue and I decide to report it

https://www.php.net/manual/fr/language.types.type-juggling.php

On dit : il requiert/elle requiert
et pas : PHP ne requis pas

From manual page: https://php.net/function.array-map

L'expression "si un nombre insuffisant d'arguments sont fourni" doit être remplacée par "si un nombre insuffisant d'arguments est fourni".

From manual page: https://php.net/collator.create

--Call to undefined function collator_create() in PHP 8.2.8 ???

The word "survient." is repeated twice in the documentation of the return value.

This is not a serious enough error, but I still wanted to point it out so as not to confuse some people.

The doc fr:

The doc en:

From manual page: https://php.net/function.rawurlencode

See screenshots for more details !:

From manual page: https://php.net/ref.filesystem

class Files{
public function FileCreatWriteNotRead(string $FileName, string $TypeOpenFile, string $MessageWriteInFile){
$File = fopen($FileName, $TypeOpenFile);
fputs($File, $MessageWriteInFile);
fclose($File);
}
public function FileDelet(string $FileName){
unlink($FileName);
}
}

From manual page: https://php.net/simplexmlelement.xpath

On this page of the PHP doc, this example:

<?php
$string = <<<XML
<a>
 <b>
  <c>text</c>
  <c>stuff</c>
 </b>
 <d>
  <c>code</c>
 </d>
</a>
XML;

$xml = new SimpleXMLElement($string);

/* Search for <a><b><c> */
$result = $xml->xpath('/a/b/c');

while(list( , $node) = each($result)) {
    echo '/a/b/c: ',$node,"\n";
}

/* Relative paths also work... */
$result = $xml->xpath('b/c');

while(list( , $node) = each($result)) {
    echo 'b/c: ',$node,"\n";
}
?>

...doesn't work in PHP8+ because each method deleted in PHP v8

From manual page: https://php.net/faq.misc

Bonjour à tous,
Je n'arrive pas à mettre en route l'extension PHP server sur VSC. (le plugin s'est bien installé)
J'ai ce message :

En refermant VSC et en l'ouvrant, j'ai eu ça :

qui mène à ça

On m'a dit d'aller voir https://www.php.net/downloads.php
et de télécharger un des lien proposé ici :

J'en ai téléchargé 2 , mais lorsque je clique sur n'importe quel .exe, j'ai ça :

QQn a une solution ?

The current version of gmdate function display a wrong format (corresponding to UTC)

See https://github.com/php/doc-fr/blob/master/reference/datetime/functions/gmdate.xml#L8

Expected : "Formate une date/heure GMT/UTC"
But got : "Formate une date/heure GMT/CUT"

From manual page: https://php.net/fann.installation

After following the guide on https://www.php.net/manual/fr/fann.installation.php to use Fann on my wamp server (I use Windows, PHP 7.3.21 and the corresponding version of FANN and libfann) , Visual Studio Code doesn't detect FANN. I have an error telling my FANN-based functions are not defined but when I hover on them I have the description of what it is suppose to do.

Could somebody help me ?

Page affected

https://www.php.net/manual/fr/reference.pcre.pattern.modifiers.php

Error

The "u" modifier turns on Unicode features incompatible with Perl, as the english doc rightly says.

However the french documentation says that it turns them OFF, not on.

Original wording

Cette option désactive les fonctionnalités additionnelles de PCRE qui ne sont pas compatibles avec Perl. Le masque et la chaîne d'entrée sont traitées comme des chaînes UTF-8. Une chaîne d'entrée invalide entrainera aucune détection par les fonctions preg_*. Un masque invalide va lever une erreur de niveau E_WARNING. Les séquences UTF-8 de cinq et six octets sont invalides.

Suggested fix

Cette option active des fonctionnalités additionnelles de PCRE qui ne sont pas compatibles avec Perl. La chaîne d'entrée et le masque sont traités comme des chaînes UTF-8. Une chaîne d'entrée invalid aura pour conséquence une absence de correspondance dans les fonctions preg_*. Un masque invalide va lever une erreur de niveau E_WARNING. Les séquences UTF-8 de cinq et six octets sont considérées comme invalides.

From manual page: https://php.net/mysqli.query

"les données doivent être correctement formatéES" i/o "les données doivent être correctement formaté"

From manual page: https://php.net/function.mail

The two last arguments of the function prototype have the same name in the French documentation ($additional_params twice) :

https://www.php.net/manual/fr/function.mail.php

The first one should be $additional_headers as in the English documentation :

https://www.php.net/manual/en/function.mail.php

From manual page: https://php.net/datetime.format

Il est marqué dans le tableau de référence:
G | Heure, au format 24h, sans les zéros initiaux | 0 à 23

Hors, c'est bien précisé "sans les zéros initiaux", tandis que l'exemple dis "0 à 23".
Rien de bien grave, mais ça reste une erreur.

Bonne continuation

From manual page: https://php.net/language.types.numeric-strings

https://www.php.net/manual/fr/language.types.numeric-strings.php
Ce texte est ecrit en anglais et non en francais,alors uqe le lien est indique en francais .
La bise au chat

Hi,

From manual page: https://php.net/oci8.requirements

I think there is a small typo in the Oracle OCI8 module requirements. In English we have:

In summary, Oracle Client 19, 18 and 12.2 can connect to Oracle Database 11.2 or greater.

while in French we have:

En résumé, Oracle Client 19, 18 et 12.2 peuvent se connecter à Oracle Database 10.2 ou supérieur.

so if the English documentation is right (I'm no Oracle specialist), we should have:

En résumé, Oracle Client 19, 18 et 12.2 peuvent se connecter à Oracle Database 11.2 ou supérieur.

I can open a PR to fix that if you wish.

Regards,

Nicolas

From manual page: https://php.net/function.fopen

Translation has confusion between "happened" and "appended".

| 'a+' | Ouvre en lecture et écriture ; place le pointeur de fichier à la fin du fichier. Si le fichier n'existe pas, on tente de le créer. Dans ce mode, la fonction fseek() n'affecte que la position de lecture, les écritures surviennent toujours. les écritures sont toujours ajoutées à la fin

| 'a+' | Open for reading and writing; place the file pointer at the end of the file. If the file does not exist, attempt to create it. In this mode, fseek() only affects the reading position, writes are always appended.

From manual page: https://php.net/function.array-diff

In French the description for array_diff refers to array1 instead of array. The description should be:

array_diff() compare le tableau array avec un ou plusieurs tableaux et retourne les valeurs du tableau array qui ne sont pas présentes dans les autres tableaux.

From manual page: https://php.net/book.pcre

In french translation, should not be "rationnelles" but "régulières"
"rationnelles" -> 2/3
"régulières" -> /^.*$/

From manual page: https://php.net/function.gmp-pow

La puissance positive utiliser pour élever num.
=>
La puissance positive utilisée pour élever num.

From manual page: https://php.net/function.strtotime

[edit] My bad, I found this page where the change is, in fact, documented. However, the page is not easy to find. I think there should be a warning when an incorrect number format is used.

I noticed the following difference in output for the same code between php7.4 and php8.2:

echo date('Y', strtotime('+-1 year', time()));
// php7.4: 2023
// php8.2: 2025

I didn't find this difference documented anywhere.

Maybe +- should be discouraged with a warning ?

Versions used for this comparison:

PHP 7.4.3-4ubuntu2.19 (cli) (built: Jun 27 2023 15:49:59) ( NTS )
Copyright (c) The PHP Group
Zend Engine v3.4.0, Copyright (c) Zend Technologies
    with Zend OPcache v7.4.3-4ubuntu2.19, Copyright (c), by Zend Technologies

PHP 8.2.15 (cli) (built: Jan 20 2024 14:16:39) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.2.15, Copyright (c) Zend Technologies
    with Zend OPcache v8.2.15, Copyright (c), by Zend Technologies
    with Xdebug v3.3.1, Copyright (c) 2002-2023, by Derick Rethans

From manual page: https://php.net/function.random-int

but if I click on contribute to documentation, the translation of the text is correct : "Generates cryptographic random integers that are suitable for use where unbiased results are critical, such as when shuffling a deck of cards for a poker game. "

From manual page: https://php.net/language.types.array

Page: https://www.php.net/manual/fr/language.types.array.php
Examples 6 and 7 are the same example. The 6th is in French and the 7th is in English.
Can you delete the duplicate line, please? (line 283)

 Comme vous pouvez le voir, la dernière valeur "d" a été assignée à la clé 7. Ceci est du au fait que la dernière clé entière la plus grande utilisé auparavant était 6.

Exemple #6 Exemple complexe sur la modification de type et l'écrasement

Exemple #7 Complex Type Casting and Overwriting example

Cet exemple inclus toutes les variations de modification de type de clés et écrasements des éléments. 

Thank you.

From manual page: https://php.net/language.types.boolean

When I use an object containing a bool attribute, it is impossible to save the false value of the boolean in the database

From manual page: https://php.net/function.mktime

Plural is missing "aux valeurs" (twice) // Le pluriel manque sur "au valeur" (deux fois)

L'année, peut être sur deux ou quatre chiffres, avec des valeurs allant de 0 à 69, correspondant au valeur 2000 à 2069 et 70 à 100, correspondant au valeur 1970 à 2000. Sur les systèmes où time_t un entier signé sur 32bits, ce qui est le plus courant de nos jours, la période valide pour year est quelque part près de 1901 et 2038.

L'année, peut être sur deux ou quatre chiffres, avec des valeurs allant de 0 à 69, correspondant aux valeurs 2000 à 2069 et 70 à 100, correspondant aux valeurs 1970 à 2000. Sur les systèmes où time_t un entier signé sur 32bits, ce qui est le plus courant de nos jours, la période valide pour year est quelque part près de 1901 et 2038.