Getting Started

Working together

Photo by rawpixel.com.

Welcome to PHP TestFest!

In 2008, a group of contributors from the PHP-QA team met at the PHP Quebec conference to finalize plans for a PHP TestFest. When announced, Lukas Kahwe Smith described it as “an event that aims at improving the code coverage of the test suite for the PHP language itself.” PHP TestFest was a global success, with many user groups from around the world participating to help improve the code coverage of the PHP language.

Over the years, PHP TestFest has been instrumental in raising the coverage of the PHP language to almost 75%, but there are still many parts of the language left to be tested and many tests that can be improved. For the last few years, however, there has not been a globally-organized PHP TestFest event, and many newcomers to the PHP language and its community are unaware of their ability to contribute to the language core through writing tests. In 2017, we’re changing that.

PHP TestFest Is Back!

PHP TestFest aims to improve the code coverage of the test suite for the PHP programming language and encourage PHP programmers to make core contributions. From September through December, 2017, groups from around the world will meet physically or virtually to learn how to write and contribute phpt tests. You don’t have to be a C genius—in fact, you don’t even need to know C at all to contribute.1 If you can write a few lines of PHP, you can write a phpt test.

Participation through local user groups is encouraged but not required. If you don’t have a local user group and you’d like to put together a group of friends or co-workers to write and contribute phpt tests, please feel free to sign up and take part. Here’s how:

Google Group

Sign up for the Google Group. Ask questions, help others, and lend your ideas to make PHP TestFest better.

IRC

For real-time chat, join us on Freenode IRC in #phptestfest. There’s always someone around willing to help.

Twitter

Follow @phptestfest and use the hashtag #phptestfest to talk about what your group is doing.

GitHub

Contribute tools and tutorials to the project on GitHub to help us have a successful PHP TestFest.

Add Your Group

If you’d like to declare your group’s participation in PHP TestFest 2017, add it to the list. Then, be sure to join the Google Group, and learn about leading an event.

Be A Mentor

If you’re interested in helping groups learn how to write and contribute tests, volunteer as a mentor. Then, join the Google Group to find groups who need your help, and learn about mentoring.

Win Prizes!

PHP TestFest wouldn’t be complete without prizes. We’re still working out the details, so we’ll announce prizes and how to win them soon. Here are a few ideas of the type of categories for which we’ll be handing out awards (subject to change):

  • Person who has the most tests accepted into the PHP core (not necessarily new contributors).
  • New contributor who has the most tests accepted into the PHP core (never having contributed prior to September 2017).
  • Group who has the most individual contributors with at least one test accepted into the PHP core (not necessarily new contributors).
  • Group who has the most new individual contributors with at least one test accepted into the PHP core (contributors who have never contributed prior to September 2017).
  • General prize raffle including all PHP TestFest participants.

Stay tuned for more details on prizes. We’ll announce prizes, sponsors, and details on how to submit your information for inclusion in the awards and raffle. If your organization/company is interested in offering its products, services, or swag as prizes, let us know by sending email to [email protected].

Awards and raffle winners will be announced in January, 2018. All contributions for consideration must be made between 00:00:00 UTC on 1 September and 23:59:59 UTC on 31 December, 2017.

How It Works

If you lead a group that is interested in participating, join the Google Group, add your group to the list, and commit to hosting one or more PHP TestFest events from September through December. A good PHP TestFest event might include a kick-off meeting with information about PHP TestFest, a session on how to write and contribute phpt tests, and a mini-hackathon for writing tests. Learn more about leading a PHP TestFest event.

We still have a lot of details to work out. We will need to develop a way to track contributions and work with the PHP core team to help review and accept tests, so that they don’t become inundated with pull requests. If you’d like to help, please join the Google Group. We’ll update this section as more details emerge.

Who’s Behind This?

PHP TestFest is not new. It has a long history, going back nearly ten years; we stand on the shoulders of giants. Many have devoted a substantial amount of time to organizing and running previous PHP TestFest events, a few of whom are Lukas Kahwe Smith, Zoë Slattery, and Sebastian Schürmann.

In 2017, Ben Ramsey has taken up the PHP TestFest torch to introduce a new generation of PHP programmers to phpt tests and other ways of contributing to the PHP core.

  1. The PHP interpreter provided by php.net is written in the C programming language, but phpt tests are written in the PHP language.