Участь у проекті

Статус проекту ​

PHP TrueAsync — це неофіційний проект зі зміни ядра PHP! RFC, що пропонується, наразі перебуває в невизначеній ситуації, і незрозуміло, чи буде воно прийняте в майбутньому.

Проте я як автор проекту вірю в те, що наявність вибору є важливою умовою розвитку. Проект PHP TrueAsync відкритий для ідей, пропозицій та допомоги.

Якщо ви хочете щось обговорити — пишіть на форумі проекту або зв'яжіться зі мною особисто:

Способи участі ​

Код ​

• Виправлення багів — перегляньте відкриті issues з міткою good first issue для початку
• Нові можливості — обговоріть ідею в Discussions перед реалізацією
• Ревю коду — допомагайте рецензувати pull requests, це цінний внесок

Документація ​

• Виправлення — знайшли неточність? Натисніть «Редагувати сторінку» внизу будь-якої сторінки
• Переклади — допоможіть перекласти документацію іншими мовами
• Приклади — напишіть приклади використання API для реальних сценаріїв
• Туторіали — створіть покрокові інструкції для конкретних завдань

Тестування ​

• Тестування збірок — спробуйте встановити TrueAsync на своїй системі та повідомте про проблеми
• Написання тестів — збільшіть покриття тестами для існуючого API
• Навантажувальне тестування — допоможіть знайти вузькі місця продуктивності

Спільнота ​

• Відповідайте на запитання в GitHub Discussions та Discord
• Розповідайте про проект — доповіді, статті, пости в блогах
• Повідомляйте про баги — детальний баг-репорт економить години розробки

Як почати ​

1. Форкніть репозиторій ​

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

2. Налаштуйте середовище ​

Слідуйте інструкції зі збірки для вашої платформи. Для розробки рекомендується збірка з debug:

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

3. Створіть гілку ​

git checkout -b feature/my-improvement

4. Внесіть зміни ​

• Дотримуйтесь стилю коду проекту
• Додайте тести для нового функціоналу
• Переконайтеся, що існуючі тести проходять: make test

5. Надішліть Pull Request ​

• Опишіть що та навіщо ви змінили
• Вкажіть пов'язані issues
• Будьте готові до обговорення та доопрацювань

Структура репозиторіїв ​

Рекомендації ​

• Маленькі PR краще за великі — один PR вирішує одне завдання
• Обговорюйте перед реалізацією — для великих змін створіть issue або discussion
• Пишіть тести — код без тестів складніше прийняти
• Документуйте — оновлюйте документацію при зміні API

Зв'язок ​

• GitHub Discussions — запитання та ідеї
• Discord — живе спілкування
• Issues — баг-репорти

Дякуємо за ваш внесок у розвиток PHP!