omegacms/omega

The example application for the Omega framework.

1.0.0 2024-11-07 21:00 UTC

Requires

• php: >=8.2
• ext-fileinfo: *
• ext-ftp: *
• ext-mbstring: *
• ext-memcached: *
• ext-pdo: *
• ext-zip: *
• omegacms/framework: ^1.0.0
• symfony/console: ^7.1

Requires (Dev)

• filp/whoops: ^2.15
• phpstan/phpstan: ^1.12
• phpunit/phpunit: ^11.4
• squizlabs/php_codesniffer: ^3.10

GPL-3.0

• Adriano Giovannini

• framework
• cms
• omegacms

README

First and foremost, I would like to express my gratitude to Christopher Pitt for the splendid second edition of his book on PHP and MVC. Without it, I wouldn't have found the inspiration and motivation to write this framework.

OmegaCMS Example Application

This is the example application developed using the OmegaCMS framework. For more information about this application, its structure, controllers, models, views, or anything else, you are encouraged to visit the official OmegaCMS website.

Requirements

• PHP 8.2 or later

Installation

To install the package, you can simply run the following from the command line:

composer create-project omegacms/omega your_project_name

or

git clone https://github.com/omegacms/omega.git
cd omega
composer install

Installing the Database

First, create the database using phpMyAdmin or the command line, then input the database details into the config/database.php file. Finally, create the tables with the following command:

php omega migrate 

or

composer migrate

Alternatively, you can use the --fresh option. However, note that this option will delete existing tables before recreating them.

php omega migrate --fresh

or

composer dbfresh

Testing

Running Unit Tests

To run unit tests, use the command:

vendor/bin/phpunit

or

composer serve

PHP built-in server.

Omega has a script that starts the built-in PHP server. However, please note that due to the absence of pcntl extensions, the verbosity level on Windows operating systems is lower than that on Linux and MacOSX.

php omega serve

or

composer serve

Contributing

If you'd like to contribute to the OmegaCMS example application package, please follow our contribution guidelines.

License

This project is open-source software licensed under the GNU General Public License v3.0.