PHP Luminova: Installation Guides
Installation guides for the PHP Luminova framework highlight the benefits of using Composer for easy maintenance and ensuring you're always up to date with the latest framework and dependency.
Whether you're new to the framework or a seasoned developer, getting started with Luminova is a breeze. In this guide, we'll walk you through the installation process
For easy maintenance and keeping Luminova up to date, it's recommended to install it using Composer, although manual download is also possible. Composer ensures that you have the latest version of the framework and its dependencies.
Composer Installation
Installing via Composer is recommended to keeps Framework up to date easily.
composer create-project luminovang/luminova my-project
Git Installation
Installing via git command.
$ git clone https://github.com/luminovang/luminova
$ composer install
$ composer test
Manual Download
Download the framework project and extract it as zip in your project directory.
Latest VersionYou can manually download the latest version of Luminova framework from official website, by simply Download Framework and extract to your local host directory and lunch in browser to start using Luminova.
GitHub
If you choose to download manually from GitHub, here are the steps to follow.
- First you will need to Download Framework Scaffolding and extract the zip to your project directory.
- Then you will need to Download Framework Codes and extract in a separate directory, then navigate to
src
directory, copy all the files and folders except forplugins
directory, to the framework scaffoldingsystem
directory. - Now set your
hostname
andapplication name
inenv
file. - Open your project localhost url (e.g. http://localhost/project-path), in a browser.
Server Configuration
Let's start by creating the first website using the Luminova framework.
The first thing to do is configure your web server to use a custom document root which should be the path to framework controller and other browser accessible files. e.g: /path/to/your/project/public
.
Assuming your existing document root is /var/www/public_html
now you have to change it to /var/www/project/public
or /var/www/public_html/public
. The project
or public_html
directory will serve as your private document root where the framework files will be located which is not accessible from web browsers, while the public
will be accessible in browser.
VirtualHost Samples
An example configuration of a virtual host file may look like below depending on your server configuration.
Apache
Apache VirtualHost configuration example.
<VirtualHost *:80>
ServerName example.com
DocumentRoot "/var/www/public_html/public"
ErrorLog "/var/www/public_html/error_log"
CustomLog "/var/www/public_html/access_log" common
<Directory "/var/www/public_html/public">
AllowOverride All
Require all granted
</Directory>
</VirtualHost>
Nginx
Nginx VirtualHost configuration example.
server {
listen 80;
server_name example.com;
root /var/www/example.com/public_html/public;
access_log /var/www/example.com/public_html/access_log;
error_log /var/www/example.com/error_log;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;
}
location ~ /\.ht {
deny all;
}
}
Project Structure
The above configuration assumes the project folder is located as follows:
/var/www/example.com/
└── public_html/ (Framework Document Root)
├── app/ (Application configurations, utils, models and other files)
| └── Controllers/ (Controllers for handling application logic)
├── public/ (Document Root)
│ ├── index.php (Front Controller)
│ └── assets/ (Static Assets)
├── libraries/
│ └── libs/ (Custom libraries)
├── system/ (Luminova Framework Classes)
│ └── plugins/ (Third-party libraries or plugins)
├── resources/
│ └── views/ (Resource View Templates Files)
└── writeable/ (Writable Directory)
├── log/ (Error Logs)
├── storages/ (Private Storage Directory)
└── caches/ (Cache Directory)
IMPORTANTMake sure you set the required permissions for
public
directory to be accessible in browsers.
Build Project
To package your application for publishing, you can use the Novakit command to archive the project files required for production. Run the following command in a CLI tool:
php novakit build:project --type zip
After configuring the document root and archiving your project files, proceed to upload the latest version of your project, located in the /builds/v-{*.*}
folder, to your production server. You can upload it to either the /user/var/www/public_html/
or /user/var/www/
directory, depending on your setup."