php-the-right-way

PHP: The Right Way est une référence rapide et facile à lire sur les bonnes pratiques PHP, les normes de codage acceptées et les liens vers des tutoriels faisant autorité sur le Web. Le projet expose clairement sa motivation : la communauté PHP manque d'informations suffisantes et crédibles pour les programmeurs débutant en PHP, et ce site vise à combler cette lacune. Structure du site et du dépôt : - Le site est un projet Jekyll hébergé sur GitHub Pages. - Chaque section et sous-section est un fichier Markdown dans _posts/, les sous-sections étant marquées isChild: true dans leur en-tête. - La navigation et la structure des pages sont générées automatiquement à partir de ces fichiers. Normes de contenu : Les exemples de code des contributeurs doivent respecter PSR-1 ou une version supérieure. Le guide de style des contributeurs exige l'orthographe américaine (uniquement pour le dépôt principal en anglais), une indentation de quatre espaces au lieu de tabulations, et un texte limité à 120 caractères par ligne. Contribution : Les contributeurs lisent CONTRIBUTING.md pour des instructions détaillées, puis forquent et modifient, installent éventuellement Ruby avec la gemme Jekyll pour prévisualiser les changements en local, et soumettent une demande de tirage. Le projet fournit également des bannières web que les sympathisants peuvent placer sur leurs propres sites pour orienter les nouveaux développeurs PHP vers cette ressource. Traductions : Le document est disponible dans de nombreuses langues autres que l'anglais, notamment l'espagnol, le français, l'indonésien, l'italien, le polonais, le portugais brésilien, le roumain, le slovène, le serbe, le turc, le bulgare, le russe, l'ukrainien, l'arabe, le persan, le thaï, le coréen, le japonais, le chinois simplifié et le chinois traditionnel. Les nouvelles traductions sont produites en forquant le dépôt et en publiant la version localisée sur GitHub Pages, soit sous la forme [nom_utilisateur].github.io/php-the-right-way, soit en sous-domaine configuré via le fichier CNAME ; les mainteneurs relient ensuite la traduction terminée depuis le document principal pour éviter la fragmentation. Auteur et licence : Le projet est maintenu par Josh Lockhart, auteur du framework Slim, avec les collaborateurs Kris Jordan et Phil Sturgeon. Le contenu est publié sous la licence Creative Commons Attribution - Pas d'Utilisation Commerciale - Partage dans les Mêmes Conditions 3.0 non transposé.