PHPackages                             pbrus/astro-quiz - 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. pbrus/astro-quiz

ActiveProject

pbrus/astro-quiz
================

0.1.0(7y ago)2642MITCSSPHP ^7.0

Since Apr 12Pushed 6y ago1 watchersCompare

[ Source](https://github.com/pbrus/astro-quiz)[ Packagist](https://packagist.org/packages/pbrus/astro-quiz)[ Docs](https://github.com/pbrus/astro-quiz)[ RSS](/packages/pbrus-astro-quiz/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (1)Versions (2)Used By (0)

Astro-quiz
==========

[](#astro-quiz)

[![GitHub release](https://camo.githubusercontent.com/cb3b92c7e82ebfdffaf920a6973dd6a967c2afae94c89fcdb7311be1b1f79d56/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7665722e2d302e312e302d627269676874677265656e2e737667 "download")](https://github.com/pbrus/astro-quiz)[![Written in PHP](https://camo.githubusercontent.com/b825ebf92a08b110c62da1bffa3be1057ee3fd1ace3918ef201e3ba67633b10d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f636f64652d5048502d626c75652e737667 "language")](https://www.php.net/)[![License](https://camo.githubusercontent.com/07a7d0169027aac6d7a0bfa8964dfef5fbc40d5a2075cabb3d8bc67e17be3451/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d79656c6c6f772e737667 "MIT license")](https://github.com/pbrus/astro-quiz/blob/master/LICENSE)[![License](https://camo.githubusercontent.com/6a63337314de3c208961cf07449e8a6940e296e3dd9894ddfa98afeaa28b3b98/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d53494c2d6f72616e67652e737667 "SIL license")](https://github.com/pbrus/astro-quiz/blob/master/LICENSE)[![License](https://camo.githubusercontent.com/aad47559870fa48dc377696c7f383f1f5d9fd67904be3af5aabf2503380c8951/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d43432d2d42592d2d4e432d6c69676874677261792e737667 "CC-BY-NC license")](https://github.com/pbrus/astro-quiz/blob/master/LICENSE)

A little advanced quiz for astronomy enthusiasts. Designed for students and small groups of amateur astronomers.

[![astro-quiz](https://camo.githubusercontent.com/59f082b9ed3f568e08c7ce99cd9ea86465e378ee97aeec769009b850baabb0dd/687474703a2f2f7777772e617374726f2e756e692e77726f632e706c2f6c75647a69652f627275732f696d672f6769746875622f617374726f2d7175697a2e676966)](https://camo.githubusercontent.com/59f082b9ed3f568e08c7ce99cd9ea86465e378ee97aeec769009b850baabb0dd/687474703a2f2f7777772e617374726f2e756e692e77726f632e706c2f6c75647a69652f627275732f696d672f6769746875622f617374726f2d7175697a2e676966)

Introduction
------------

[](#introduction)

The program was designed to run locally, not on the Internet. The application uses a web browser only as an interface. For example, **astro-quiz** doesn't cooperate with any database but stores all information in text files and utilizes a session mechanism. However, it can be used by many users simultaneously, e.g. for students in a classroom (computers connected through LAN).

Installation
------------

[](#installation)

### General information

[](#general-information)

I assume that you're not familiar with PHP applications and how to install them. Let's split the whole installation process into significant parts:

1. Download and install [*XAMPP*](https://www.apachefriends.org/download.html) with PHP 7.0 or greater
2. Install [*Composer*](https://getcomposer.org/) for [Linux](https://getcomposer.org/download/) or [Windows](https://getcomposer.org/doc/00-intro.md#installation-windows)
3. Change the localhost path just editing two lines in `httpd.conf` file
4. Start/restart *XAMPP*
5. Open yor favourite web browser and type `localhost` into the address bar

Note that this is the easiest way to install the application because the program does't worry about security on the Internet.

### Linux

[](#linux)

Execute first two instructions from the **General information** section manually. If you successfully install *XAMPP* with default settings, `php` should be located in the `/opt/lampp/bin/` directory. After installation I recommend to move the `composer.phar` file to any catalog pointed by the `$PATH` variable and to change its name to `composer`.

In the next step choose the destination directory where you want to install application, open a terminal window and go there. Download the repo and all required components typing:

```
$ composer require pbrus/astro-quiz=dev-master
```

Instructions included in 3. and 4. lines will be executed automatically by the `install` script. To do this log in as root:

```
$ su
```

and run the script:

```
$ bash vendor/pbrus/astro-quiz/install
```

Note that the use of `sudo` instead of `su` sometimes can't call `composer`. If everything goes well, you will see the message **The installation has been completed**. It's time to open your web browser and test the application typing `localhost` into the address bar.

To start *XAMPP* after computer rebooting type into the terminal window:

```
$ sudo /opt/lampp/lampp start
```

### Windows

[](#windows)

Execute first two instructions from the **General information** section manually. If you successfully install *XAMPP* with default settings, `php.exe` should be located in the `C:\xampp\php\` directory. Note that you have to point at the `php.exe` file during *Composer* installation.

[![composer-install](https://camo.githubusercontent.com/a778aeba40f256f1804010ff0dc88420112bb52cee1a88035a674f0dfd7dd5fc/687474703a2f2f7777772e617374726f2e756e692e77726f632e706c2f6c75647a69652f627275732f696d672f6769746875622f636f6d706f7365722d696e7374616c6c2e706e67)](https://camo.githubusercontent.com/a778aeba40f256f1804010ff0dc88420112bb52cee1a88035a674f0dfd7dd5fc/687474703a2f2f7777772e617374726f2e756e692e77726f632e706c2f6c75647a69652f627275732f696d672f6769746875622f636f6d706f7365722d696e7374616c6c2e706e67)

In the next step create an empty directory to store the whole project. Let's assume that it will be the `astro-quiz` located in `D:\`, i.e. `D:\astro-quiz\`. Open the [*cmd.exe*](https://en.wikipedia.org/wiki/Cmd.exe) and go there typing:

```
> D:
```

and further:

```
> cd astro-quiz
```

Now it's time to download the project using *Composer*. Please type into *cmd.exe*:

```
> composer require pbrus/astro-quiz=dev-master
```

Then copy all files and directories from `D:\astro-quiz\vendor\pbrus\astro-quiz\` to `D:\astro-quiz\` (just change the structure of the project). After all, type into *cmd.exe*:

```
> composer dump-autoload
```

Note that your current localization must be `D:\astro-quiz\`.

At the end you must connect `localhost` with the project's directory. To do this open the *XAMPP Control Panel* and edit two lines in the `httpd.conf` file:

```
DocumentRoot "C:/xampp/htdocs"

```

```
DocumentRoot "D:/astro-quiz"

```

[![localhost-edit](https://camo.githubusercontent.com/48e8fc79a9386f3b0da1ad96dea3803ce674491af8dcf664f155939533a83330/687474703a2f2f7777772e617374726f2e756e692e77726f632e706c2f6c75647a69652f627275732f696d672f6769746875622f6c6f63616c686f73742d656469742e706e67)](https://camo.githubusercontent.com/48e8fc79a9386f3b0da1ad96dea3803ce674491af8dcf664f155939533a83330/687474703a2f2f7777772e617374726f2e756e692e77726f632e706c2f6c75647a69652f627275732f696d672f6769746875622f6c6f63616c686f73742d656469742e706e67)

Save changes and start/restart *Apache*. Open your web browser and test the application typing `localhost` into the address bar.

To start *XAMPP* after computer rebooting open the *XAMPP Control Panel* and start the *Apache* module.

Usage
-----

[](#usage)

The package contains demo files so you can easily test **astro-quiz** after the installation process. Of course you can prepare your own questions. Let's see the most important parts of the project.

### Web browser

[](#web-browser)

A web browser is a [BUI](https://en.wikipedia.org/wiki/Browser_user_interface) for users and an administrator which oversees the users. To start quiz type into the address bar `localhost`. To see results, statistics and to manage the database please type into address bar `localhost/admin.php`. Access to this page is secured by the password stored in the `astroquiz.cfg` file.

### Define own quiz

[](#define-own-quiz)

All files needed to define own quiz must be located in the `files/` directory. You should create a text file to store all questions, points, answers and names of images if are required. You can create as many text files as you need. The current quiz is called in the `astroquiz.cfg` file.

I encourage to visit my website to see more detailed description of this project. The current link can be found on my [GitHub profile](https://github.com/pbrus).

Credits
-------

[](#credits)

- [Pure CSS Circular Percentage Bar](http://www.cssscript.com/pure-css-circular-percentage-bar/)

    Used on the last page with results.
- [Fontello - icon fonts generator](http://fontello.com/)

    Used icons:

    - *icon-check*
    - *icon-check-empty*
    - *icon-right-circled2*
- Demo images from [My subjective astronomy](https://mozdzierski.wordpress.com/my-subjective-astronomy/)

    Used files:

    - *question1.jpg*
    - *question2.jpg*
    - *question4.jpg*
    - *question5.jpg*

License
-------

[](#license)

**Astro-quiz** is licensed under the [MIT license](http://opensource.org/licenses/MIT). Some external components have own licenses. See the [license](https://github.com/pbrus/astro-quiz/blob/master/LICENSE) file for more details.

###  Health Score

23

—

LowBetter than 27% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity13

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity44

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

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

Unknown

Total

1

Last Release

2584d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/a1d4fee4b0b7c815d63ec703d1e6a5b6076007e5f27b43f8eecd447b1b8b5724?d=identicon)[PBrus](/maintainers/PBrus)

---

Top Contributors

[![pbrus](https://avatars.githubusercontent.com/u/19304263?v=4)](https://github.com/pbrus "pbrus (63 commits)")

---

Tags

applicationevaluationinteractivequizusers

### Embed Badge

![Health badge](/badges/pbrus-astro-quiz/health.svg)

```
[![Health](https://phpackages.com/badges/pbrus-astro-quiz/health.svg)](https://phpackages.com/packages/pbrus-astro-quiz)
```

###  Alternatives

[sonata-project/entity-audit-bundle

Audit for Doctrine Entities

644989.8k1](/packages/sonata-project-entity-audit-bundle)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)