PHPackages chrishaensel/ivao-data - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. chrishaensel/ivao-data ActiveLibrary chrishaensel/ivao-data ====================== Simple PHP lib to download IVAO whazzup data while conforming to the IVAO rules. v1.0.1(5y ago)091MITPHP Since Apr 8Pushed 5y ago1 watchersCompare [ Source](https://github.com/chrishaensel/ivao-data)[ Packagist](https://packagist.org/packages/chrishaensel/ivao-data)[ RSS](/packages/chrishaensel-ivao-data/feed)WikiDiscussions master Synced today READMEChangelogDependenciesVersions (3)Used By (0) IVAO-Data ========= [](#ivao-data) The IVAO data library is a very simple PHP class to download IVAO whazzup data. IMPORTANT --------- [](#important) This is **work in progress**! This is not the best code you will ever see. But it might help you. Good luck. IVAO API Information -------------------- [](#ivao-api-information) You can find more information on the IVAO API and the retrievval of the whazzup data in the IVAO wiki: [IVAO WIKI](https://wiki.ivao.aero) auf. Usage ----- [](#usage) 1. Clone this repo or composer-require it `git clone https://...` or `composer require chrishaensel/ivao-data` 2. Create a new instance of the IVAO class ` $ivao = new \chrishaensel\Ivao("My app name v.1.1");` 3. Download the data `$ivao->downloadIvaoWhazzupData();` Options ------- [](#options) When instantiating the `Ivao` class, you **must** pass your application's name as the first parameter. `$ivao = new \chrishaensel\Ivao("My app name v1.1")`, otherwise it will fail with an exception. IVAO requires you to pass your application name as `User Agent` string when downloading the data. As second parameter, you can pass an `array` with other options. Currently, the only supported option is `create_json`. When set to `1`, the library will create a `JSON` file of the ATC and PILOT data contained in the whazzupt.txt file. When calling the `downloadIvaoWhazzupData` method, you can pass a parameter (`string`) with the target path / filename for the whazzup data. `$ivao->downloadIvaoWhazzupData("my_whazzup.txt"")` will cause the script to save the data in the file `my_whazzup.txt`. IVAO Rules ---------- [](#ivao-rules) IVAO does have some rules regarding the download of whazzup data. Most importantly: #### These files may only be obtained after an official clearance from the IVAO Development Operations Department! [](#these-files-may-only-be-obtained-after-an-official-clearance-from-the-ivao-development-operations-department) - Always set your user agent to the name of your application, including the version. - The whazzup file may only be downloaded once **every 5 minutes**. - The status.txt file may only be downloaded **once a day** **IVAO-data** does take care of the timing - you need to ask for permission :) ### Some sample code [](#some-sample-code) This way, you can use the Ivao class. We're using naspaces, so there won't be conflicts with other libraries you might use. ``` require_once 'vendor/autoload.php'; use chrishaensel\Ivao; $options = [ "create_json" => 1, "json_file" => "whazzup.json" ]; $ivao = new Ivao("My best app ever v1.1", $options); $ivao->downloadIvaoWhazzupData("my_whazzup.txt"); ``` ### Sample output of the JSON file [](#sample-output-of-the-json-file) The whazzup data will be split in two parts within the JSON. "PILOT" and "ATC" - both are arrays of the connected parties. ``` { "PILOT": [ { "callsign": "5RAED", "user": { "vid": "652248", "name": "652248", "rating": 3, "rating_decoded": "Flight Student (FS2)" }, "client_type": "PILOT", "freq": "", "position": { "latitude": "-22.7559", "longitude": "47.8591", "altitude": "1929" }, "flight_data": { "groundspeed": "179", "heading": "319", "on_ground": "0" }, "flightplan": { "aircraft": "1\/M20P\/L-SDFGR\/C", "cruising_speed": "N0130", "origin": "FMSG", "cruising_level": "F080", "destination": "FMMI", "revision": "0", "flight_rules": "I", "dep_time": "1431", "actual_dep_time": "1431", "eet_hours": "2", "eet_minutes": "18", "endurance_hours": "4", "endurance_minutes": "25", "alternate_aerodrome": "FMMT", "remarks": "PBN\/D2 DOF\/210408 REG\/5RAED PER\/A RMK\/TCAS", "route": "FMSG FMSF FMME FMMA FMMI", "alternate_aerodrome2": "", "type_of_flight": "S", "persons_on_board": "2" }, "server": "SHARD1", "protocol": "B", "combined_rating": "3", "transponder_code": "2000", "facility_type": "0", "visual_range": "50", "unused1": "", "unused2": "", "ATIS": "", "ATIS_time": "", "connection_time": "20210408140418", "connection_duration": "2:25:21", "software": { "name": "Altitude\/win", "version": "1.10.2b" }, "plane": "1\/M20P\/L-SDFGR\/C" }, }, "ATC": [ { "callsign": "EDDF_A_GND", "user": { "vid": "544029", "name": "544029", "rating": 4, "rating_decoded": "Advanced ATC Trainee - AS3" }, "client_type": "ATC", "freq": "121.855", "position": { "latitude": "50.0333", "longitude": "8.57046", "altitude": "0" }, "flight_data": { "groundspeed": "0", "heading": "", "on_ground": "" }, "flightplan": { "aircraft": "", "cruising_speed": "", "origin": "", "cruising_level": "", "destination": "", "revision": "", "flight_rules": "", "dep_time": "", "actual_dep_time": "", "eet_hours": "", "eet_minutes": "", "endurance_hours": "", "endurance_minutes": "", "alternate_aerodrome": "", "remarks": "", "route": "", "alternate_aerodrome2": "", "type_of_flight": "", "persons_on_board": "" }, "server": "SHARD3", "protocol": "B", "combined_rating": "4", "transponder_code": "0", "facility_type": "3", "visual_range": "10", "unused1": "", "unused2": "", "ATIS": "", "ATIS_time": "", "connection_time": "20210408141942", "connection_duration": "2:9:57", "software": { "name": "Aurora\/win", "version": "1.2.12b" }, "plane": "" } ] ``` Questions? Remarks? ------------------- [](#questions-remarks) - Contact me at . - Find my website at . ### Health Score 23 — LowBetter than 27% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity5 Limited adoption so far Community5 Small or concentrated contributor base Maturity53 Maturing project, gaining track record How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~0 days Total 2 Last Release 1857d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/1893b51f37d9651e1076d8b533db0663363d5eeafceb6fbd05dda7ff0a59278d?d=identicon)[chaensel](/maintainers/chaensel) ### Embed Badge ![Health badge](/badges/chrishaensel-ivao-data/health.svg) ``` [![Health](https://phpackages.com/badges/chrishaensel-ivao-data/health.svg)](https://phpackages.com/packages/chrishaensel-ivao-data) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)