Перайсці да асноўнага змесціва

← Даведнік API · Вярнуцца да README

Распрацоўка

Праверкі пакета​

Усталюйце PHP-залежнасці:

composer install

Запусціце тэсты або стварыце справаздачу аб пакрыцці:

composer test
composer test:coverage

Прымяніце наладжаны стыль кода:

composer style

Наборы Pest правяраюць розныя кантракты:

НаборПакрыццё
tests/FeatureЗначэнні па змаўчанні, перавызначэнні, выдаленне, адсутныя даныя і ўладальнікі
tests/Unit/CastsСтандартны JSON, карыстальніцкія пераўтварэнні, morph map і Laravel Data
tests/Unit/KeyTypesРадковыя і цэлалікавыя ключы, backed enum і pure unit enum
tests/Unit/PrimaryKeyTypesЦэлалікавыя, радковыя, UUID- і ULID-ідэнтыфікатары бацькоўскіх мадэляў
tests/Unit/QueryCountКолькасць запытаў пры чытанні і запісе, уключаючы папярэднюю загрузку
tests/ArchitectureПрасторы імёнаў, тыпы, строгі рэжым і архітэктурныя правілы Laravel

Праверкі дакументацыі​

Для сайта Docusaurus патрэбны Node.js 20 або навейшы. Усталюйце залежнасці з каталога docs:

npm ci
ЗадачаКаманда
Запусціць лакальны сайтnpm run start
Праверыць TypeScriptnpm run typecheck
Праверыць перакладыnpm run check:i18n
Стварыць production-зборкуnpm run build

Production-зборка правярае ўнутраныя спасылкі для кожнай наладжанай лакалі.

Захоўвайце старонкі дакументацыі ў docs/docs. Кожная старонка выкарыстоўвае front matter для пазіцыі ў бакавой панэлі, радок навігацыі ў пачатку, адносныя спасылкі паміж кіраўніцтвамі і раздзел Гл. таксама у канцы.

Захоўвайце кожную лакаль, акрамя асноўнай, у каталогу docs/i18n/<locale>/docusaurus-plugin-content-docs/current. Кожная лакаль павінна змяшчаць тыя ж шляхі старонак, што і docs/docs. Каманда npm run check:i18n правярае гэта перад production-зборкай.

Удзел у распрацоўцы​

Перад стварэннем pull request прачытайце кіраўніцтва па ўдзеле.

Бяспека​

Адпраўляйце паведамленні пра ўразлівасці прыватна на [email protected].

Аўтары​

Пакет стварылі Andrey Helldar і удзельнікі праекта.

Гл. таксама​