Cette série en deux parties explore comment contribuer au projet PHP, en se concentrant sur la documentation dans la première partie. Nous couvrirons les demandes de compte et les étapes post-approbation.
Points clés:
- La contribution à la documentation de PHP améliore la langue et stimule votre expertise PHP. Cela peut également conduire à un compte php.net, influençant la direction de la langue.
- La documentation utilise DocBook XML; La familiarité est utile mais pas obligatoire.
- Les débutants peuvent utiliser l'éditeur en ligne pour des correctifs simples. La révision des directives de style à l'avance est recommandée.
- Les contributeurs fréquents ou ceux qui ont besoin de modifications approfondies doivent configurer les documents localement et demander un compte php.net. Cela implique la création d'un répertoire, le clonage des documents et la configuration des mots clés SVN.
- Les contributions incluent les corrections de bogues, les traductions, l'expansion du contenu existant, la documentation des fonctionnalités sans papiers et les améliorations générales.
Pourquoi contribuer?
PHP, étant open-source, prospère sur la participation communautaire. Une participation accrue profite à tout le monde. Qu'il s'agisse d'améliorer la documentation, de corriger les bogues ou d'ajouter des fonctionnalités, chaque contribution compte. La participation active approfondit vos connaissances PHP et vous permet de demander un compte PHP.NET, en façonnant l'avenir de la langue.
Comprendre la documentation de PHP
La documentation est dans DocBook XML. Les connaissances antérieures ne sont pas strictement nécessaires; La syntaxe XML est facilement apprise.
La structure du répertoire est:
doc-base contient des outils pour convertir la documentation XML. en détient la documentation anglaise (d'autres langues utilisent leurs codes à deux lettres). reference contient des répertoires spécifiques à une extension (fonctions pour les extensions procédurales, les dossiers de classe pour ceux orientés objet). Chaque dossier d'extension comprend book.xml (page de destination) et versions.xml (Informations de versioning).
La documentation est actuellement basée sur SVN (bien que migrant vers GIT). La configuration locale nécessite une familiarité SVN.
Contributeurs pour la première fois
Commencez par utiliser l'éditeur de documentation en ligne. Cela permet la connexion et la soumission à OAuth de patchs simples. L'utilisation cohérente du compte simplifie les contributions de suivi pour les futures applications de compte php.net.
Familiarisez-vous avec les directives de style avant de soumettre des correctifs.
Exemple: Résolution du bug # 71716
Ce bogue rapporte une classe client MongoDB mal conforme à des noms de noms dans un échantillon. Après vérification, utilisez l'éditeur en ligne pour corriger l'espace de noms.
Embed vidéo: https://www.php.cn/link/14aa36297925d3c82891d74fa28d7df1 (Remplacez par du code emballé réel si nécessaire)
Configuration locale
L'éditeur en ligne est limité; Pour des contributions plus substantielles, configurez les documents localement et demandez un compte php.net.
- Créer un répertoire
phpdocs. - Clone les documents à l'aide de SVN:
svn checkout https://svn.php.net/repository/phpdoc/modules/doc-en - Clone PhD (outil de rendu):
git clone http://git.php.net/repository/phd.git - Clone Le site Web PHP.NET:
git clone http://git.php.net/repository/web/php.git web-php; Supprimezweb-php/manual/enet créez un lien symbolique aux documents rendus. - Configurez les mots clés SVN dans
~/.subversion/config:*.xml = svn:eol-style=native;svn:keywords=Id Rev Revision Date LastChangedDate LastChangedRevision Author LastChangedBy HeadURL URL - (facultatif) Créez un fichier
refavec des commandes de validation, de construction et de visualisation des documents localement.
Docs Workflow (local)
Après la configuration, mettez à jour les référentiels (svn up et git pull). Modifiez le fichier XML pertinent, validez à l'aide de php ~/phpdocs/doc-en/doc-base/configure.php, créez avec PhD et démarrez le serveur local. Engagez des modifications à l'aide de SVN (svn ci -m "Resolve doc bug #..."), faisant référence au numéro de bogue. Fermez le rapport de bogue de l'onglet "développeur" après les modifications Propagate.
demandant un compte php.net
Après la configuration locale, demandez un compte php.net avec Docs Karma. Bien qu'aucune condition préalable stricte n'existe, la démonstration de contribution active est essentielle. Soumettez le formulaire de demande de compte et envoyez un courriel à phpdoc@lists.php.net expliquant vos intentions, nom d'utilisateur Wiki et contributions passées.
Tâches de documentation
au-delà des corrections de bogues:
- Traductions
- élargir le matériel partiellement documenté
- documenter les fonctionnalités sans papiers
- Améliorations générales
Conseils généraux
- Suivre les directives de style.
- Vérifiez les aspects liés lors de la correction des bogues.
- Écrivez de manière concise.
- Exemple de code séparé de la sortie.
- Assurer la commande correcte de la page.
- supprimer les références php 4.
- version correctement de nouveaux fichiers.
- Consultez la liste de diffusion DOCS FAQ ou PHP-DOCS pour obtenir de l'aide.
Conclusion
Cette partie a couvert deux workflows: l'éditeur en ligne et la configuration locale. La deuxième partie couvrira la contribution au cœur de PHP.
faqs (déplacé à la fin pour un meilleur flux)
- Processus de contribution: Créer un compte, modifier / créer du contenu, traduire, suivre les directives.
- Importance de la contribution: Améliore la qualité de la documentation, le maintient à jour, favorise la communauté.
- Assurer l'acceptation: Suivez les directives, assurez-vous de l'exactitude et de la clarté, obtenez des commentaires.
- Les anglophones non natifs: Les contributions sont les bienvenues; La traduction est une contribution précieuse.
- Erreurs courantes: Ne pas suivre les directives, des informations inexactes / peu claires, le manque de relecture, les changements inutiles.
- Obtenir de l'aide: Utiliser des forums en ligne, des groupes de discussion, des directives de documentation.
- Contribution anonyme: possible, mais un compte est encouragé.
- Fréquence de contribution: varie en fonction de la disponibilité et de l'intérêt.
- Compensation: Généralement le travail de bénévolat.
- Erreurs de rapport: Corrigez-les si un contributeur, sinon signalez à la communauté.
N'oubliez pas de remplacer les URL de l'image d'espace réservé par les URL d'image réelles. J'ai conservé le formatage de l'image et gardé les images dans leurs positions d'origine comme demandé.
Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!
Au-delà du battage médiatique: évaluer le rôle de PHP aujourd'huiApr 12, 2025 am 12:17 AMPHP reste un outil puissant et largement utilisé dans la programmation moderne, en particulier dans le domaine du développement Web. 1) PHP est facile à utiliser et intégré de manière transparente aux bases de données, et est le premier choix pour de nombreux développeurs. 2) Il prend en charge la génération de contenu dynamique et la programmation orientée objet, adaptée à la création et à la maintenance des sites Web rapidement. 3) Les performances de PHP peuvent être améliorées en mettant en cache et en optimisant les requêtes de base de données, et sa vaste communauté et son écosystème riche le rendent toujours important dans la pile technologique d'aujourd'hui.
Quelles sont les références faibles en PHP et quand sont-elles utiles?Apr 12, 2025 am 12:13 AMEn PHP, les références faibles sont mises en œuvre via la classe FaibleRreference et n'empêcheront pas le collecteur des ordures de récupérer des objets. Les références faibles conviennent aux scénarios tels que les systèmes de mise en cache et les auditeurs d'événements. Il convient de noter qu'il ne peut garantir la survie des objets et que la collecte des ordures peut être retardée.
Expliquez la méthode magique __invoke en PHP.Apr 12, 2025 am 12:07 AMLa méthode \ _ \ _ Invoke permet aux objets d'être appelés comme des fonctions. 1. Définissez la méthode \ _ \ _ Invoquer afin que l'objet puisse être appelé. 2. Lorsque vous utilisez la syntaxe $ obj (...), PHP exécutera la méthode \ _ \ _ Invoke. 3. Convient pour des scénarios tels que la journalisation et la calculatrice, l'amélioration de la flexibilité et de la lisibilité du code.
Expliquez les fibres dans PHP 8.1 pour la concurrence.Apr 12, 2025 am 12:05 AMLes fibres ont été introduites dans PHP8.1, améliorant les capacités de traitement simultanées. 1) Les fibres sont un modèle de concurrence léger similaire aux coroutines. 2) Ils permettent aux développeurs de contrôler manuellement le flux d'exécution des tâches et conviennent à la gestion des tâches à forte intensité d'E / O. 3) L'utilisation des fibres peut écrire du code plus efficace et réactif.
La communauté PHP: ressources, soutien et développementApr 12, 2025 am 12:04 AMLa communauté PHP fournit des ressources et un soutien riches pour aider les développeurs à se développer. 1) Les ressources incluent la documentation officielle, les tutoriels, les blogs et les projets open source tels que Laravel et Symfony. 2) Le support peut être obtenu via les canaux Stackoverflow, Reddit et Slack. 3) Les tendances de développement peuvent être apprises en suivant la RFC. 4) L'intégration dans la communauté peut être réalisée grâce à la participation active, à la contribution au code et au partage d'apprentissage.
PHP vs Python: comprendre les différencesApr 11, 2025 am 12:15 AMPHP et Python ont chacun leurs propres avantages, et le choix doit être basé sur les exigences du projet. 1.Php convient au développement Web, avec une syntaxe simple et une efficacité d'exécution élevée. 2. Python convient à la science des données et à l'apprentissage automatique, avec une syntaxe concise et des bibliothèques riches.
PHP: Est-il en train de mourir ou est-ce simplement de s'adapter?Apr 11, 2025 am 12:13 AMLe PHP n'est pas en train de mourir, mais d'adapter et d'évoluer constamment. 1) PHP a subi plusieurs itérations de version depuis 1994 pour s'adapter aux nouvelles tendances technologiques. 2) Il est actuellement largement utilisé dans le commerce électronique, les systèmes de gestion de contenu et d'autres domaines. 3) PHP8 introduit le compilateur JIT et d'autres fonctions pour améliorer les performances et la modernisation. 4) Utilisez OPCACHE et suivez les normes PSR-12 pour optimiser les performances et la qualité du code.
L'avenir de PHP: adaptations et innovationsApr 11, 2025 am 12:01 AML'avenir de PHP sera réalisé en s'adaptant aux nouvelles tendances technologiques et en introduisant des fonctionnalités innovantes: 1) s'adapter aux architectures de cloud computing, de conteneurisation et de microservice, en prenant en charge Docker et Kubernetes; 2) introduire des compilateurs JIT et des types d'énumération pour améliorer l'efficacité des performances et du traitement des données; 3) Optimiser en continu les performances et promouvoir les meilleures pratiques.
Outils d'IA chauds
Undresser.AI Undress
Application basée sur l'IA pour créer des photos de nu réalistes
AI Clothes Remover
Outil d'IA en ligne pour supprimer les vêtements des photos.
Undress AI Tool
Images de déshabillage gratuites
Clothoff.io
Dissolvant de vêtements AI
AI Hentai Generator
Générez AI Hentai gratuitement.
Article chaud
Outils chauds
Télécharger la version Mac de l'éditeur Atom
L'éditeur open source le plus populaire
MantisBT
Mantis est un outil Web de suivi des défauts facile à déployer, conçu pour faciliter le suivi des défauts des produits. Cela nécessite PHP, MySQL et un serveur Web. Découvrez nos services de démonstration et d'hébergement.
ZendStudio 13.5.1 Mac
Puissant environnement de développement intégré PHP
Version crackée d'EditPlus en chinois
Petite taille, coloration syntaxique, ne prend pas en charge la fonction d'invite de code
Listes Sec
SecLists est le compagnon ultime du testeur de sécurité. Il s'agit d'une collection de différents types de listes fréquemment utilisées lors des évaluations de sécurité, le tout en un seul endroit. SecLists contribue à rendre les tests de sécurité plus efficaces et productifs en fournissant facilement toutes les listes dont un testeur de sécurité pourrait avoir besoin. Les types de listes incluent les noms d'utilisateur, les mots de passe, les URL, les charges utiles floues, les modèles de données sensibles, les shells Web, etc. Le testeur peut simplement extraire ce référentiel sur une nouvelle machine de test et il aura accès à tous les types de listes dont il a besoin.
