À propos du projet

PHP est un langage de script généraliste orienté vers le développement web. Ce dépôt, php/php-src, contient le code source officiel de l'interpréteur PHP et est distribué sous la licence BSD modifiée (BSD-3-Clause). Le README renvoie au manuel officiel sur php.net/docs pour la documentation. Pour les utilisateurs qui préfèrent ne pas compiler à partir des sources, des paquets et binaires préconstruits sont disponibles : les binaires Windows proviennent de windows.php.net, et les instructions d'installation pour les autres systèmes sont couvertes dans le chapitre d'installation du manuel. Compiler à partir des sources nécessite autoconf, bison et re2c pour une compilation minimale ; une compilation par défaut nécessite en plus libxml2 et libsqlite3. Le README liste les commandes d'installation de paquets pour Ubuntu, Fedora, macOS via Homebrew et macOS via MacPorts. Le processus de compilation est le suivant : exécutez ./buildconf pour générer configure, exécutez ./configure (avec --enable-debug recommandé pour le développement), puis make -j4, le nombre de tâches correspondant idéalement aux cœurs disponibles rapportés par nproc. Les utilisateurs de Windows sont dirigés vers un guide de compilation étape par étape séparé sur le wiki PHP. Les tests sont gérés par une suite de tests complète fournie, exécutée via make test après une compilation réussie. Les tests s'exécutent en parallèle par défaut en utilisant jusqu'à 10 processeurs logiques détectés ; le nombre de travailleurs peut être remplacé par -jN dans TEST_PHP_ARGS ou TESTS, et des répertoires spécifiques peuvent être ciblés, par exemple make TESTS=tests/lang/ test. Le site qa.php.net offre des informations supplémentaires sur les tests et l'assurance qualité. Après une compilation et des tests réussis, make install installe PHP, ce qui peut nécessiter des permissions de superutilisateur selon le préfixe et les permissions. Les extensions ajoutent des fonctionnalités au-delà des nombreuses extensions essentielles fournies. Des extensions supplémentaires sont répertoriées sur la page PIE Extensions sur Packagist et peuvent être installées avec PIE, le PHP Installer for Extensions, ou avec PECL, désormais obsolète. Les contributions sont les bienvenues via un fork du dépôt et l'ouverture de pull requests. Les discussions ont lieu sur GitHub et peuvent également être relayées sur la liste de diffusion des développeurs internals@lists.php.net. Les nouvelles fonctionnalités nécessitent un RFC accepté, avec des détails sur les pages RFC et vote du wiki ; les corrections de bogues ne nécessitent pas de RFC. Les messages de commit doivent référencer les problèmes GitHub comme GH-NNNNNN ou les anciens tickets du suivi de bogues comme #NNNNNN. Le README renvoie à d'autres documents pour les contributeurs : CONTRIBUTING.md, CODING_STANDARDS.md, la documentation interne, les règles de la liste de diffusion et le processus de publication. Une page de crédits liste les contributeurs.