Conseils de contribution
- Sélection de branches
- Compiler les actifs
- Vulnérabilités de sécurité
- Style de codage
- PHPDoc
- StyleCI
- Retour sur les bogues
- Discussions sur le développement principal
- Sélection de succursales
- Compiler les actifs
- Vulnérabilités de sécurité
- Style de codage
- Application Laravel
- Laravel Art
- Documentation Laravel
- Laravel Cash ier Caissier Laravel pour Braintree Laravel Horizon
- Laravel Passport
- Laravel Scout
- Laravel Socialite
- Laravel Telescope
- Laravel Website
Consignes de contribution
Retour sur les erreurs
Afin d'encourager une collaboration active, Laravel encourage fortement l'utilisation de Pull Request pour indiquer le contenu modifié au lieu de simplement signaler les erreurs. Les « retours d'erreur » peuvent également utiliser les relations publiques pour soumettre des tests ayant échoué.
Si vous soumettez des commentaires sur un bug, votre problème doit inclure un titre et une description claire du problème, et fournir autant d'informations pertinentes et d'exemples de code que possible illustrant le problème. Le but des commentaires sur les bogues est de permettre à vous et aux autres de reproduire et de corriger facilement le bogue.
N'oubliez pas que l'intention initiale du retour d'erreur est de permettre à d'autres personnes rencontrant le même problème de collaborer avec vous pour résoudre le problème. Ne vous attendez pas à ce que quelqu'un corrige un bug rapidement après l'avoir signalé. Créer des commentaires sur les bogues est un moyen de vous aider, vous et les autres, à commencer à résoudre le problème.
Le code source de Laravel est hébergé sur GitHub, et chaque projet Laravel possède son propre référentiel de code :
Discussion de développement principal
Vous pouvez proposer de nouvelles fonctionnalités ou des améliorations au comportement existant de Laravel dans le forum de discussion des idées de Laravel. Si vous proposez une nouvelle fonctionnalité, nous aimerions vous demander de compléter au moins une partie du code requis pour la fonctionnalité.
Des discussions informelles sur les bugs, les nouvelles fonctionnalités et les implémentations de nouvelles fonctionnalités ont lieu sur le canal Laravel Discord #internals. Taylor Otwell, le responsable de Laravel, est généralement sur la chaîne de 8h à 17h en semaine (UTC-06:00 ou America/Chicago), et occasionnellement à d'autres moments. #internals 频道中进行。Laravel 的维护者 Taylor Otwell, 通常会在工作日的早上八点到下午五点 (UTC-06:00 或 America/Chicago) 出现在频道上，偶尔也会在其它时间出现在该频道。
分支选择
所有 Bug 修复都应该发送到最新的稳定版分支或当前的 LTS 分支上。Bug 修复决不应该发送到 master 分支，除非修复的是仅在即将发布的版本中发布的功能。
次要的完全向后兼容的新功能会发送到最新的稳定分支。
主要的新功能都应该发送到 master 分支，其中包含即将发布的 Laravel 版本。
如果你不确定你的功能符合主要的还是次要的，请在 Laravel Discord 的 #internals 频道中询问 Taylor Otwell。
编译资产
如果你提交的更改会影响已编译的文件，例如在 laravel/laravel 储存库中的 resources/sass 或者 resources/js 中的大多数文件，请不要提交已编译好的文件。因为它们尺寸较大，审查人员无法进行实际审查。这样可以被利用向 Laravel 中注入恶意代码，为了防止这种情况的发生，所有静态资产都由 Laravel 维护者生成并提交。
安全漏洞
如果你发现 Laravel 存在安全漏洞，请发送电子邮件给 Taylor Otwell: taylor@laravel.com。他会及时处理所有的安全漏洞。
编码风格
Laravel 遵循 PSR-2 编码规范和 PSR-4 自动加载规范。
PHPDoc
以下是正确写法的 Laravel 文档注释。请注意，@param
Tous les correctifs de bogues doivent être envoyés à la dernière branche stable ou à la branche LTS actuelle. Les correctifs de bogues ne doivent jamais être envoyés à la branche master, sauf si le correctif concerne une fonctionnalité qui ne sera publiée que dans une prochaine version.
Les nouvelles fonctionnalités de Minor qui sont entièrement rétrocompatibles seront envoyées vers la dernière branche stable.
🎜Les nouvelles fonctionnalités majeures devraient être envoyées à la branchemaster, qui contient les prochaines versions de Laravel. 🎜🎜Si vous n'êtes pas sûr que votre fonctionnalité soit considérée comme principale ou secondaire, demandez à Taylor Otwell sur le canal Laravel Discord #internals. 🎜🎜🎜🎜🎜Actifs compilés🎜🎜Si vous validez des modifications qui affectent les fichiers compilés, tels que ceux du référentiel laravel/laravel Pour la plupart des fichiers dans resources/ sass ou resources/js, veuillez ne pas soumettre de fichiers compilés. En raison de leur grande taille, les évaluateurs n'étaient pas en mesure de les examiner physiquement. Cela peut être exploité pour injecter du code malveillant dans Laravel. Pour éviter que cela ne se produise, tous les actifs statiques sont générés et soumis par le responsable de Laravel. 🎜🎜🎜🎜🎜Vulnérabilités de sécurité🎜🎜Si vous découvrez une vulnérabilité de sécurité dans Laravel, veuillez envoyer un e-mail à Taylor Otwell : taylor@laravel.com. Il traite rapidement toutes les failles de sécurité. 🎜🎜🎜🎜🎜Style de codage🎜🎜Laravel suit Spécification de codage PSR-2🎜 et PSR-4🎜 Spécification de chargement automatique. 🎜🎜🎜🎜🎜PHPDoc🎜🎜Ce qui suit est le commentaire correctement écrit de la documentation Laravel. Veuillez noter que l'attribut @param est suivi de deux espaces, du type du paramètre, de deux espaces et enfin du nom de la variable : 🎜/**
* 在容器中注册绑定。
*
* @param string|array $abstract
* @param \Closure|string|null $concrete
* @param bool $shared
* @return void
* @throws \Exception
*/public function bind($abstract, $concrete = null, $shared = false){ //}🎜🎜🎜🎜🎜StyleCI🎜🎜Ne vous inquiétez pas que votre code le style n'est pas assez beau ! Après avoir fusionné la pull request, StyleCI corrigera automatiquement tous les styles et les fusionnera dans le référentiel Laravel. Cela nous permet de nous concentrer davantage sur le contenu de la contribution plutôt que sur le style de codage. 🎜
