Repository files navigation

Welcome to the code base forOpenFlights, a tool that lets you map your flights around the world, search and filter them in all sorts of interesting ways, calculate statistics automatically, and share your flights and trips with friends and the entire world (if you wish).

Most people come here for thefree airport, airline and route data. See thedocumentation or plunge straight into thedata itself.

Seelocale for supported languages and instructions for editing them or adding new ones.

I'll be upfront: this codebase is an unholy mess. The bulk of it was written in 2008, back when PHP seemed like a good idea and the only way to learn JavaScript was the hard way. Any vestiges of sanity you may encounter (eg. unit and integration tests or package management) were grafted on as an incomplete afterthought.

Basically, though, it's your classicLNMP app. JavaScript frontend (mostly in the monolithicopenflights.js, some bits underjs) talking to a Nginx/PHP backend (inphp) that wraps around a MySQL database.

Test coverage is woefully incomplete, but comes in three flavors:

• client: Client-side full-stack integration tests, require live DB & server
• server: Server-side (PHP) integration tests, require a live database
• unit: Client-side JavaScript unit tests

SeeINSTALL for system requirements and instructions.

A basic Docker setup is available to simplify setting up a development environment but requires acouple of manual steps to get the site up and running.

1. cp php/config.sample.php php/config.php and set$host = "db"; so the host name matches thethe database container host name.

2. Rundocker-compose up to create the containers.

3. Install local PHP dependencies inside the container.

   # host shelluser@host:openflights $ docker exec -it openflights-web-1 bash# container shellroot@ee261e8f9103:/# cd /var/www/openflights/ && php /usr/local/bin/composer install

4. You should be able to access the site athttp://localhost:8007.