Install



Recommended

This framework was designed to be installed above the document root directory, with the document root being the webroot (commonly this is a known as public_html/public/htdocs folder) folder.

Additionally, installing in a sub-directory, on a production server, will introduce severe security issues. If there is no choice still place the framework files above the document root and have only index.php and .htacess from the webroot folder in the sub folder and adjust the paths in index.php.

//path to the root folder holding all files
define('BASEPATH', realpath(__DIR__.'/../') .DS);

//path to the app directory
define('APPPATH', realpath(__DIR__.'/../app/') .DS);

//path to the webroot directory
define('WEBPATH', realpath(__DIR__) .DS);

The framework is located on Packagist.

You can install the framework from a terminal by using:

composer create-project nova-framework/app foldername

The foldername is the desired folder to be created.

This will install the latest release of Nova.

Demo Application

for a demo application install nova-framework/framework instead

composer create-project nova-framework/framework foldername

Run using PHP's built in web server:

Using Nova's CLI tool Forge Open terminal and navigate to the root of the project and type:

php forge serve

This will start the server listening on port 8000.

Nginx configuration

No special configuration, you only need to configure Nginx and PHP-FPM.

server {
  listen 80;
  server_name yourdomain.tld;

  access_log /var/www/access.log;
  error_log  /var/www/error.log;

  root   /var/www;
  index  index.php index.html;

  location = /robots.txt {access_log off; log_not_found off;}
  location ~ /\\. {deny all; access_log off; log_not_found off;}
  location / {
    try_files $uri $uri/ /index.php?$args;
  }

  location ~ \.php$ {
    fastcgi_pass unix:/var/run/php7-fpm.sock;
    fastcgi_split_path_info ^(.+\.php)(/.+)$;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    include fastcgi_params;
  }
}

IIS with URL Rewrite module installed

http://www.iis.net/downloads/microsoft/url-rewrite

For IIS the htaccess needs to be converted to web.config, Nova provides a web.config file located in webroot/web.config

<configuration>
  <system.webServer>
    <rewrite>
      <rules>
        <rule name="Imported Rule 1" stopProcessing="true">
          <match url="^(.*)/$" ignoreCase="false" />
          <conditions>
            <add input="{REQUEST_FILENAME}" matchType="IsDirectory" ignoreCase="false" negate="true" />
          </conditions>
          <action type="Redirect" redirectType="Permanent" url="/{R:1}" />
        </rule>
        <rule name="Imported Rule 2" stopProcessing="true">
          <match url="^" ignoreCase="false" />
          <conditions>
            <add input="{REQUEST_FILENAME}" matchType="IsDirectory" ignoreCase="false" negate="true" />
            <add input="{REQUEST_FILENAME}" matchType="IsFile" ignoreCase="false" negate="true" />
          </conditions>
          <action type="Rewrite" url="index.php" />
        </rule>
      </rules>
    </rewrite>
  </system.webServer>
</configuration>

XAMPP

Installing Nova-Framework on xampp virtual server for Windows.

The first way is under the C:/XAMPP/htdocs directory. (see further down on page for second way)

Now in command prompt go to the 'C:/XAMPP/htdocs` directory. Run the below command replacing foldername with the name of your project.

composer create-project nova-framework/framework foldername

Now go to the folder with the name of your project created under the htdocs folder. Open httpd-vhosts.conf file C:/XAMPP/apache/conf/extra/httpd-vhosts.conf Add following code.

<Directory C:/XAMPP/htdocs>
    AllowOverride All
    Require all granted
</Directory>

#this is the default address of XAMPP
<VirtualHost *:80>
    DocumentRoot "C:/XAMPP/htdocs/"
    ServerName localhost
</VirtualHost>

#this is the vhost address in XAMPP
<VirtualHost *:80>
    DocumentRoot "C:/XAMPP/htdocs/projectname/webroot/"
    ServerName projectname.dev
    SetEnv NS_ENV variable_value
</VirtualHost>

change projectname to you're projects name.

Save the file and exit out of Xampp. Open hosts file in C:\windows\system32\drivers\etc you need Administrator privilege to edit the file. Add 127.0.0.1 projectname.dev at the end of the file, Save and close the file. Again changing projectname to your's.

127.0.0.1       localhost
127.0.0.1       projectname.dev

Restart Xampp and start apache server. Go to your project folder and open app/Config/App.php and change to your URL.

    'url' => 'http://www.projectname.dev/',

Now open browser and go to your url. You should see the Nova startup screen.