1.0.4 2022-01-20 13:03 UTC

This package is auto-updated.

Last update: 2022-09-23 14:30:32 UTC


Total Downloads Latest Stable Version License


Server Requirements

The Sura framework has a few system requirements.

However, if you are not using Homestead, you will need to make sure your server meets the following requirements:

  • PHP >= 8.0
  • JSON PHP Extension
  • ICONV PHP Extension
  • GD PHP extension
  • MySQLI PHP Extension

Installing Sura

It's recommended that you use Composer to install Sura.

$ composer create-project sura/sura:^1.0.0 MYPROJECT --prefer-dist

The database configuration is located in config/config.php

To create a migration, use the -migrate

$ php craft -migrate

To create a user admin, use the -make:add-user

$ php craft -make:add-user Ivan Petrov password


Public Directory

After installing Sura, you should configure your web server's document / web root to be the public directory. The index.php in this directory serves as the front controller for all HTTP requests entering your application.

Configuration Files

All of the configuration files for the Sura framework are stored in the config directory.



Sura includes a public/.htaccess file that is used to provide URLs without the index.php front controller in the path. Before serving Sura with Apache, be sure to enable the mod_rewrite module so the .htaccess file will be honored by the server.

If the .htaccess file that ships with Sura does not work with your Apache installation, try this alternative:

    Options +FollowSymLinks -Indexes
    RewriteEngine On

    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteRule ^ index.php [L]


If you are using Nginx, the following directive in your site configuration will direct all requests to the index.php front controller:

    location / {
        try_files $uri $uri/ /index.php?$query_string;


Please see CONTRIBUTING for details.


If you discover security related issues, please email instead of using the issue tracker.

For enterprise

Financial Contributors

Become a financial contributor and help us sustain our community. (


The Sura Framework is licensed under the MIT license. See License File for more information.