Panduan sumbangan
- Pemilihan Cawangan
- Kompilasi Aset
- Kerentanan Keselamatan.
- PHPDoc
- StyleCI
- Garis Panduan Sumbangan
- Gaya Pengekodan
- PHPDoc
- StyleCI
- Maklum balas ralat
- Untuk menggalakkan kerjasama aktif, Laravel amat menggalakkan penggunaan Pull Request untuk menunjukkan kandungan yang diubah suai dan bukannya hanya melaporkan ralat. "Maklum balas ralat" juga boleh menggunakan PR untuk menyerahkan ujian yang gagal. Jika anda menyerahkan maklum balas pepijat, isu anda harus menyertakan tajuk dan penerangan yang jelas tentang masalah itu, serta memberikan sebanyak mungkin maklumat dan contoh kod yang berkaitan yang menunjukkan masalah itu. Tujuan maklum balas pepijat adalah untuk memudahkan anda dan orang lain menghasilkan semula dan membetulkan pepijat.
- Sila ingat bahawa niat asal maklum balas ralat adalah untuk membenarkan orang lain yang mempunyai masalah yang sama bekerjasama dengan anda untuk menyelesaikan masalah tersebut. Jangan mengharapkan seseorang membetulkan pepijat dengan cepat selepas anda melaporkannya. Membuat maklum balas pepijat ialah satu cara untuk membantu anda dan orang lain mula menyelesaikan masalah. Kod sumber Laravel dihoskan pada GitHub, dan setiap projek Laravel mempunyai repositori kod sendiri:
- Aplikasi Laravel
vel Cash ier
Laravel Cashier untuk Braintree Laravel Horizon- Laravel Passport
- Laravel Scout
- Laravel Socialite
- Laravel Telescope
- Laravel Telescope
Perbincangan Pembangunan Teras
Anda boleh mencadangkan ciri baharu atau penambahbaikan pada gelagat sedia ada Laravel dalam Papan Isu Laravel Ideas. Jika anda mencadangkan ciri baharu, kami ingin meminta anda melengkapkan sekurang-kurangnya beberapa kod yang diperlukan untuk ciri tersebut.
Perbincangan tidak rasmi tentang pepijat, ciri baharu dan pelaksanaan ciri baharu berlaku dalam saluran Laravel Discord
#internals
. Taylor Otwell, penyelenggara Laravel, biasanya berada di saluran dari 8 pagi hingga 5 petang pada hari biasa (UTC-06:00 atau America/Chicago), dan kadangkala pada masa lain.#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
Semua pembetulan pepijat hendaklah dihantar ke cawangan stabil terkini atau cawangan LTS semasa. Pembetulan pepijat seharusnya tidak dihantar ke cawangan
master
melainkan pembetulan itu adalah untuk ciri yang hanya akan dikeluarkan dalam keluaran akan datang.Ciri baharuMinoryang serasi ke belakang sepenuhnya akan dihantar ke cawangan stabil terkini.
🎜Major ciri baharu harus dihantar ke cawanganmaster
, yang mengandungi keluaran Laravel yang akan datang. 🎜🎜Jika anda tidak pasti sama ada ciri anda layak sebagai ciri utama atau menengah, tanya Taylor Otwell dalam saluran Laravel Discord#internals
. 🎜🎜🎜🎜🎜Aset tersusun🎜🎜Jika anda melakukan perubahan yang mempengaruhi fail tersusun, seperti dalam repositorilaravel/laravel
Untuk kebanyakan fail dalam sumber/ sass atauresources/js
, sila jangan serahkan fail yang disusun. Oleh kerana saiznya yang besar, pengulas tidak dapat menyemaknya secara fizikal. Ini boleh dieksploitasi untuk menyuntik kod hasad ke dalam Laravel Untuk mengelakkan perkara ini daripada berlaku, semua aset statik dijana dan diserahkan oleh penyelenggara Laravel. 🎜🎜🎜🎜🎜Security Vulnerabilities🎜🎜Jika anda menemui kelemahan keselamatan dalam Laravel, sila e-mel Taylor Otwell: taylor@laravel.com. Dia mengendalikan semua pelanggaran keselamatan dengan segera. 🎜🎜🎜🎜🎜Gaya pengekodan🎜🎜Laravel mengikuti PSR-2🎜 spesifikasi pengekodan dan PSR-4🎜 Spesifikasi pemuatan automatik. 🎜🎜🎜🎜🎜PHPDoc🎜🎜Berikut ialah ulasan dokumentasi Laravel yang ditulis dengan betul. Sila ambil perhatian bahawa atribut@param
diikuti oleh dua ruang, jenis parameter, dua ruang, dan akhirnya nama pembolehubah: 🎜/** * 在容器中注册绑定。 * * @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🎜🎜Jangan risau kod anda gaya tidak cukup cantik! Selepas menggabungkan permintaan tarik, StyleCI akan membetulkan semua gaya secara automatik dan menggabungkannya ke dalam repositori Laravel. Ini membolehkan kami menumpukan lebih pada kandungan sumbangan dan bukannya gaya pengekodan. 🎜Artikel ini pertama kali diterbitkan di laman web LearnKu.com.