Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

language namespace section sync with EN #770

Merged
merged 1 commit into from
Jan 25, 2024
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 14 additions & 2 deletions language/namespaces.xml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: a442778670dd2dde02af237a2de06048c59cb8cd Maintainer: yannick Status: ready -->
<!-- EN-Revision: 874f7c1266d4e4f2e1e6c79b5fb48b590caa1197 Maintainer: yannick Status: ready -->
<!-- Reviewed: no -->
<!-- CREDITS: DAnnebicque -->
<chapter xml:id="language.namespaces" xmlns="http://docbook.org/ns/docbook"
Expand All @@ -8,6 +8,7 @@

<sect1 xml:id="language.namespaces.rationale">
<title>Introduction aux espaces de noms</title>
<titleabbrev>Introduction</titleabbrev>
<?phpdoc print-version-for="namespaces"?>
<simpara>
Que sont les espaces de noms ? Dans leur définition la plus large, ils représentent
Expand Down Expand Up @@ -53,6 +54,7 @@
</simpara>
<example>
<title>Exemple de syntaxe des espaces de noms</title>
<titleabbrev>Espaces de noms</titleabbrev>
<programlisting role="php">
<![CDATA[
<?php
Expand Down Expand Up @@ -152,6 +154,7 @@ namespace MonProjet; // erreur fatale : l'espace de noms doit être le premier
</sect1>
<sect1 xml:id="language.namespaces.nested">
<title>Déclaration d'un sous espace de noms</title>
<titleabbrev>Sous espace de noms</titleabbrev>
<?phpdoc print-version-for="namespaces"?>
<para>
Comme pour les fichiers et les dossiers, les espaces de noms sont aussi
Expand Down Expand Up @@ -179,6 +182,7 @@ function connecte() { /* ... */ }
</sect1>
<sect1 xml:id="language.namespaces.definitionmultiple">
<title>Définition de plusieurs espaces de noms dans le même fichier</title>
<titleabbrev>Définition de plusieurs espaces de noms dans le même fichier</titleabbrev>
<?phpdoc print-version-for="namespaces"?>
<para>
Plusieurs espaces de noms peuvent aussi être déclarés dans le même fichier.
Expand Down Expand Up @@ -295,6 +299,7 @@ echo MonProjet\Connexion::start();
</sect1>
<sect1 xml:id="language.namespaces.basics">
<title>Utilisation des espaces de noms : introduction</title>
<titleabbrev>Introduction</titleabbrev>
<?phpdoc print-version-for="namespaces"?>
<para>
Avant de discuter de l'utilisation des espaces de noms, il est important de
Expand Down Expand Up @@ -445,6 +450,7 @@ $c = new \Exception('error'); // instantie la classe globale Exception
</sect1>
<sect1 xml:id="language.namespaces.dynamic">
<title>Espaces de noms et langage dynamique</title>
<titleabbrev>Espaces de noms et langage dynamique</titleabbrev>
<?phpdoc print-version-for="namespaces"?>
<para>
L'implémentation des espaces de noms de PHP est influencée par sa nature dynamique
Expand Down Expand Up @@ -524,6 +530,7 @@ echo constant('nomdelespacedenoms\constname'), "\n"; // affiche aussi namespaced
</sect1>
<sect1 xml:id="language.namespaces.nsconstants">
<title>La commande namespace et la constante __NAMESPACE__</title>
<titleabbrev>Commande namespace et __NAMESPACE__</titleabbrev>
<?phpdoc print-version-for="namespaces"?>
<para>
PHP supporte deux moyens pour accéder de manière abstraite aux éléments
Expand Down Expand Up @@ -622,6 +629,7 @@ $b = namespace\CONSTANT; // assigne la valeur de la constante CONSTANT à $b
<sect1 xml:id="language.namespaces.importing">
<?phpdoc print-version-for="namespaces"?>
<title>Utilisation des espaces de noms : importation et alias</title>
<titleabbrev>Importation et alias</titleabbrev>
<para>
La capacité de faire référence à un nom absolu avec un alias ou en important
un espace de noms est stratégique. C'est un avantage similaire aux liens
Expand Down Expand Up @@ -797,6 +805,7 @@ use const some\namespace\{ConstA, ConstB, ConstC};
</sect1>
<sect1 xml:id="language.namespaces.global">
<title>Espace de noms global</title>
<titleabbrev>Global</titleabbrev>
<?phpdoc print-version-for="namespaces"?>
<para>
Sans aucune définition d'espace de noms, toutes les classes et les fonctions
Expand Down Expand Up @@ -824,7 +833,8 @@ function fopen() {
</para>
</sect1>
<sect1 xml:id="language.namespaces.fallback">
<title>Utilisation des espaces de noms : retour à l'espace global</title>
<title>Utilisation des espaces de noms : retour sur l'espace global pour les fonctions et les constantes</title>
<titleabbrev>Retour sur l'espace global</titleabbrev>
<?phpdoc print-version-for="namespaces"?>
<para>
Dans un espace de noms, lorsque PHP rencontre un nom sans qualification,
Expand Down Expand Up @@ -883,6 +893,7 @@ if (is_array('hi')) { // affiche "n'est pas un tableau"

<sect1 xml:id="language.namespaces.rules">
<title>Règles de résolutions de noms</title>
<titleabbrev>Règles de résolutions de noms</titleabbrev>
<?phpdoc print-version-for="namespaces"?>
<para>
Dans le cadre des règles de résolution, il y a plusieurs définitions importantes :
Expand Down Expand Up @@ -1077,6 +1088,7 @@ A\B::foo(); // appelle la méthode "foo" de la classe "B" de l'espace de noms
</sect1>
<sect1 xml:id="language.namespaces.faq">
<title>Foire aux questions : ce que vous devez savoir des espaces de noms</title>
<titleabbrev>Foire aux questions</titleabbrev>
<?phpdoc print-version-for="namespaces"?>
<para>
Cette FAQ est décomposée en deux sections : les questions courantes,
Expand Down