Contribuir

Estado del proyecto ​

PHP TrueAsync es un proyecto no oficial para modificar el núcleo de PHP. El RFC que se propone actualmente se encuentra en una situación incierta, y no está claro si será aceptado en el futuro.

Sin embargo, como autor del proyecto, creo que tener una elección es una condición importante para el progreso. El proyecto PHP TrueAsync está abierto a ideas, sugerencias y ayuda.

Si desea discutir algo, escriba en el foro del proyecto o contácteme personalmente:

Formas de contribuir ​

Código ​

• Corrección de errores — revise los issues abiertos con la etiqueta good first issue para empezar
• Nuevas funcionalidades — discuta su idea en Discussions antes de implementar
• Revisión de código — ayude revisando pull requests, es una contribución valiosa

Documentación ​

• Correcciones — ¿encontró una inexactitud? Haga clic en «Editar esta página» al final de cualquier página
• Traducciones — ayude a traducir la documentación a otros idiomas
• Ejemplos — escriba ejemplos de uso de la API para escenarios reales
• Tutoriales — cree guías paso a paso para tareas específicas

Pruebas ​

• Pruebas de compilación — pruebe instalar TrueAsync en su sistema y reporte cualquier problema
• Escribir pruebas — aumente la cobertura de pruebas para la API existente
• Pruebas de carga — ayude a encontrar cuellos de botella de rendimiento

Comunidad ​

• Responda preguntas en GitHub Discussions y Discord
• Difunda el proyecto — charlas, artículos, publicaciones en blogs
• Reporte errores — un reporte detallado de errores ahorra horas de desarrollo

Cómo empezar ​

1. Haga fork del repositorio ​

git clone https://github.com/true-async/php-src.git
cd php-src

2. Configure su entorno ​

Siga las instrucciones de compilación para su plataforma. Para desarrollo, se recomienda una compilación con debug:

./buildconf
./configure --enable-async --enable-debug
make -j$(nproc)

3. Cree una rama ​

git checkout -b feature/my-improvement

4. Realice sus cambios ​

• Siga el estilo de código del proyecto
• Agregue pruebas para la nueva funcionalidad
• Asegúrese de que las pruebas existentes pasen: make test

5. Envíe un Pull Request ​

• Describa qué y por qué cambió
• Haga referencia a los issues relacionados
• Esté preparado para discusión y revisiones

Estructura de repositorios ​

Directrices ​

• PRs pequeños son mejores que grandes — un PR resuelve una tarea
• Discuta antes de implementar — para cambios grandes, cree primero un issue o discussion
• Escriba pruebas — código sin pruebas es más difícil de aceptar
• Documente su trabajo — actualice la documentación al cambiar la API

Contacto ​

• GitHub Discussions — preguntas e ideas
• Discord — chat en vivo
• Issues — reportes de errores

¡Gracias por contribuir al futuro de PHP!