Stato del progetto
PHP TrueAsync è un progetto non ufficiale per modificare il core di PHP!
L’RFC proposto si trova attualmente in una situazione incerta,
e non è chiaro se verrà accettato in futuro.
Tuttavia, come autore del progetto, credo che avere una scelta sia una condizione importante per il progresso.
Il progetto PHP TrueAsync è aperto a idee, suggerimenti e aiuto.
Se vuoi discutere di qualcosa – scrivi sul forum del progetto o contattami personalmente:
Modi per contribuire
Codice
- Correzione bug — controlla le issue aperte
con l’etichetta
good first issueper iniziare - Nuove funzionalità — discuti la tua idea nelle Discussions prima di implementarla
- Code review — aiuta a revisionare le pull request, è un contributo prezioso
Documentazione
- Correzioni — trovato un’inesattezza? Clicca su «Modifica pagina» in fondo a qualsiasi pagina
- Traduzioni — aiuta a tradurre la documentazione in altre lingue
- Esempi — scrivi esempi di utilizzo dell’API per scenari reali
- Tutorial — crea guide passo-passo per compiti specifici
Test
- Test di compilazione — prova a installare TrueAsync sul tuo sistema e segnala eventuali problemi
- Scrittura test — aumenta la copertura dei test per l’API esistente
- Test di carico — aiuta a trovare i colli di bottiglia delle prestazioni
Community
- Rispondi alle domande su GitHub Discussions e Discord
- Diffondi il progetto — presentazioni, articoli, post sul blog
- Segnala bug — un report dettagliato fa risparmiare ore di sviluppo
Come iniziare
1. Fai il fork del repository
git clone https://github.com/true-async/php-src.git
cd php-src
2. Configura l’ambiente
Segui le istruzioni di compilazione per la tua piattaforma. Per lo sviluppo, si consiglia una build di debug:
./buildconf
./configure --enable-async --enable-debug
make -j$(nproc)
3. Crea un branch
git checkout -b feature/my-improvement
4. Apporta le modifiche
- Segui lo stile del codice del progetto
- Aggiungi test per le nuove funzionalità
- Assicurati che i test esistenti passino:
make test
5. Invia una Pull Request
- Descrivi cosa e perché hai modificato
- Fai riferimento alle issue correlate
- Sii pronto per discussioni e revisioni
Struttura dei repository
| Repository | Descrizione |
|---|---|
| php-src | Core PHP con Async API |
| ext-async | Estensione con implementazione |
| true-async.github.io | Questo sito di documentazione |
Linee guida
- PR piccole sono meglio di grandi — una PR risolve un compito
- Discuti prima di implementare — per modifiche importanti, crea prima una issue o discussion
- Scrivi test — il codice senza test è più difficile da accettare
- Documenta — aggiorna la documentazione quando modifichi l’API
Contatti
- GitHub Discussions — domande e idee
- Discord — chat dal vivo
- Issues — segnalazioni bug
Grazie per il tuo contributo al futuro di PHP!