Contribuir — TrueAsync

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:

GitHub Discussions Discord ✉ Email

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

Repositorio	Descripción
php-src	Núcleo PHP con Async API
ext-async	Extensión con implementación
true-async.github.io	Este sitio de documentación

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!