Вклад в Phalcon

Phalcon is an open source project and heavily relies on volunteer efforts. We welcome contributions from everyone!

Please take a moment to review this document in order to make the contribution process easy and effective for all.

Следование этим принципам, позволит вам эффективней общаться с остальными участниками сообщества, быстрее решать проблемы и двигать проект вперед.

Вклад

Вклад в Phalcon следует оформлять в виде запроса на принятие изменений (Pull Request) на GitHub. Каждый такой запрос будет рассмотрен участником команды (кем-то с правом принимать запрос). В зависимости от типа и содержания запроса, он может быть принят сразу, отложен, если необходимы разъяснения, или отклонен.

Пожалуйста, убедитесь, что вы отправляете свой запрос на принятие изменений в соответствующую ветку, и что ваша ветка в актуальном состоянии.

Вопросы и поддержка

We only accept bug reports, new feature requests and pull requests in GitHub. For questions regarding the usage of the framework or support requests please visit the official forum.

Контрольный список отчета об ошибках

  • Make sure you are using the latest released version of Phalcon before submitting a bug report. Bugs in versions older than the latest released one will not be addressed by the core team.
  • Если вы нашли ошибку, добавьте как можно больше связанной информации — любые детали, которые помогут нам воспроизвести её. Это очень важно. Воспроизводимые ошибки имеют наивысший шанс быть исправленными. Эта информация должна быть в виде скрипта, небольшого приложения или падающего теста. Для получения дополнительной информации, пожалуйста, ознакомьтесь с разделом Отправка воспроизводимого теста.
  • Пожалуйста, включите в ваш отчет дополнительную информацию, например ОС, версии PHP, Phalcon, веб-сервера, а так-же описание аппаратного обеспечения.
  • Если вы отправляете отчет об ошибке типа Segmentation Fault, нам будет необходима трассировка. Пожалуйста, ознакомьтесь с разделом Генерация трассировки для получения дополнительной информации.

Генерация трассировки

Иногда, из-за ошибки Segmentation Fault, Phalcon может аварийно завершить работу. Пожалуйста, помогите нам найти эту проблему, добавив трассировку аварийного завершения работы ваше сообщение об ошибке.

Пожалуйста, ознакомьтесь со следующим руководствами, в случае любых вопросов связанных с созданием трассировки:

Контрольный список запроса на принятие изменений

  • Не отправляйте запросы на принятие изменений в master ветку. Перед отправкой запроса, сделайте ответвление из необходимой для изменений ветки и при необходимости сделайте перемещение (rebase) с соответствующей веткой. Если ваши изменения не возможно будет слить (merge) без конфликтов, вам будет предложено сделать перемещение (rebase).
  • Не отправляйте обновления подмодулей, файла composer.lock и т.д.
  • Add tests relevant to the fixed bug or new feature. See our testing guide for more information
  • Phalcon написан на языке Zephir. Пожалуйста, не отправляйте коммиты с изменениями C-файлов.
  • Убедитесь, что PHP-код, который вы написали, соответствует общему стилю и стандартам кодирования PSR.
  • Удалите любые изменения ext/kernel, *.zep.c и *.zep.h файлов перед отправкой запроса на изменение.

Before submit new functionality, please open a NFR as a new issue on GitHub to discuss the impact of including the functionality or changes in the core extension. После утверждения, убедитесь, что ваш запрос на принятие изменений содержит следующее:

  • Обновлённый файл CHANGELOG.md
  • Модульные тесты
  • Документацию и примеры использования

Получение поддержки

If you have any questions about how to use Phalcon, please see the support page.

Предложение идей

If you have any changes or new features in mind, please fill an NFR.

Спасибо!

<3 Команда Phalcon