Contribuir con Phalcon

Phalcon es un proyecto open source y depende en gran medida del esfuerzo de sus colaboradores voluntarios. ¡Son bienvenidas las contribuciones de todos!

Por favor, tómese un momento, para revisar este documento con el fin de hacer el proceso de contribución más fácil y eficaz para todos.

Seguir estas directrices, permite una mejor comunicación, más rápida resolución de problemas y permite que el proyecto avance.

Contribuciones

Las contribuciones para Phalcon deben realizarse en la forma de Pull Requests de GitHub. Cada pull request será revisada por un colaborador principal (alguien con permiso para fusionar los pull requests). Basado en el tipo y contenido del pull request, puede ser fusionado inmediatamente, puesto en espera si se requieren aclaraciones, o bien, rechazado.

Por favor asegúrese que está enviando su pull request a la rama correcta y que ya cuenta con un rebase en el código.

Preguntas y Ayuda

Lista de verificación para Reportes de Errores

  • Asegúrate de estar utilizando la última versión liberadas de Phalcon antes de enviar un reporte de errores. Los errores en las versiones anteriores al último publicado no serán abordados por el equipo central.
  • Si has encontrado un error, es esencial añadir información relevante para reproducirlo. Ser capaz de reproducir un error reduce en gran manera el tiempo para investigar y solucionarlo. Esta información debe venir en la forma de un script, pequeña aplicación o incluso una prueba que falla. Para obtener más información, compruebe por favor Presentar prueba Reproducible.
  • Como parte de su informe, por favor incluya información adicional, como el sistema operativo, versión de PHP, versión de Phalcon, servidor web, memoria, etcétera.
  • Si estás enviando un error de Segmentation Fault, requerimos un backtrace. Consulte generación de un Backtrace para obtener más información.

Generación de un Backtrace

A veces debido a un error de Fallo de segmentación, Phalcon podría bloquear algunos procesos de su servidor web. Por favor ayúdenos a averiguar el problema añadiendo un backtrace del bloqueo de procesos a su informe de fallo.

Por favor siga estas indicaciones para entender cómo generar el backtrace:

Lista de Verificación para Pull Request

  • No envíe su pull request directamente a la rama master. Cree una rama de la rama requerida y, si es necesario, rebase a la rama adecuada antes de enviar su solicitud de pull request. Si no es posible hacer una fusión limpia con la rama master se te pedirá que hagas una nueva rama como base para tus cambios
  • No pongas actualizaciones de submódulos, composer.lock, etc. en tu solicitud de extracción a menos que sean para commits fusionados
  • Agregar las pruebas pertinentes para corregir el error o la nueva característica. Revise nuestra guía de testeo para más información
  • Phalcon está escrito en Zephir, por favor no envíe cambios que modifiquen archivos C que se generan directamente o de aquellos cuyas funcionalidad/correcciones se aplican en el lenguaje de programación C
  • Asegúrese de que el código PHP que escriba ajusta con el estilo general y codificación estándar de las Normas Aceptadas de PHP
  • Retire cualquier cambio a los archivos ext/kernel, *. zep.c y *. zep.h antes de enviar su pull request

Antes de presentar nuevas funcionalidades, por favor abra una NFR (New Feature Request) como un tema nuevo en GitHub para debatir el impacto de incluir la funcionalidad o los cambios en la extensión. Una vez aprobada la funcionalidad, asegúrese de que su PR contiene lo siguiente:

  • Una actualización al CHANGELOG.md
  • Pruebas unitarias
  • Documentación o ejemplos de uso

Solicitar Soporte

Si usted tiene una pregunta acerca de cómo utilizar Phalcon, consulte la Página de soporte.

Solicitar Funcionalidades

Si usted tiene un cambio o una nueva funcionalidad en mente, por favor llene una NFR.

¡Gracias!

<3 El equipo de Phalcon