AIS v6 PHP Framework

AIS Framework is designed to be simple and efficient, allowing developers to quickly build and deploy applications. Its architecture promotes clean and maintainable code, making it a great choice for both beginners and experienced developers looking for a robust, scalable solution.

Installation

Clone, then use:

git clone https://github.com/titan2420/ais.git

AIS Structure

The AIS architecture is designed with simplicity at its core. This simplicity facilitates an intuitive understanding of the system, making it easier for developers to interact with and modify the framework. By minimizing complexity, AIS ensures that developers can focus more on developing features rather than wrestling with the framework itself.

---- app
-------- core
-------- controller
-------- model
-------- view
---- public
-------- js
-------- css
-------- img

Routing using Controllers

In the AIS Framework, routes are defined using a straightforward folder and file structure in controller folder. Each folder represents a potential route segment, and each file within those folders can be accessed as an endpoint. For example:

---- app
-------- controller
------------ home.php                   (Accessible via /)
------------ user
---------------- home.php               (Accessible via /user/)
---------------- transactions.php       (Accessible via /user/transactions)
---------------- edit-profile.php       (Accessible via /user/edit-profile)

This structure allows for easy mapping of URLs to their corresponding controllers and views, simplifying the routing process.

Middleware, Preprocess and Postprocess

There is a middleware, preprocess and postprocess artitecture in AIS to prevent code duplication and make the code more maintainable.

Take a look at this example:

---- app
-------- controller
------------ home.php
------------ middleware.php
------------ user
---------------- home.php
---------------- preprocess.php
---------------- postprocess.php

When client comes to /user/, the following steps will be taken:

Middleware controller/middleware.php will be executed.
Preprocess controller/user/preprocess.php will be executed.
Controller controller/user/home.php will be executed.
Postprocess controller/user/postprocess.php will be executed.

Dynamic routing

Dynamic routing in the AIS Framework allows for flexible URL patterns that adapt to the incoming requests dynamically. Instead of having a fixed URL structure, dynamic routing uses patterns that can match multiple URL paths. Here's how it works:

---- app
-------- controller
------------ user
---------------- dynamic.php       (Accessible via /user/{value})

For example, if a request is made to /user/123, the dynamic routing system will interpret 123 as a parameter and process it using the user/dynamic.php controller by $link_vars variable.

<?php
    // controller/user/dynamic.php
    echo "User id:  " . $link_vars[0]; // User id: 123
?>

Multiple dynamic routing

You can use directory structure for dynamic routing too, For example:

---- app
-------- controller
------------ user
---------------- dynamic
-------------------- dynamic
------------------------ home.php       (Accessible via /user/{value[0]}/{value[1]})
------------------------ open.php       (Accessible via /user/{value[0]}/{value[1]}/open)
-------------------- home.php           (Accessible via /user/{value[0]})
-------------------- edit.php           (Accessible via /user/{value[0]}/edit)

For example, if a request is made to /user/123/AIS-Project, the dynamic routing system will interpret 123 as a parameter and process it using the user/dynamic.php controller by $link_vars variable.

<?php
    // controller/user/dynamic/dynamic/open.php
<<<<<<< HEAD
    echo "Opening project:  " . $link_vars[1] . " of " . $link_vars[0] . " user.";
=======
    echo "Opening project:  " . $link_vars[1] . " of " . $link_vars[0] . " user."; // Opening AIS-Project of 123 user.
>>>>>>> 0bee68c121c4e091084a9bf093779bfe647b757d
?>

Views

You can load a view using the view(view_path, data, options) function.

<?php
    // controller/user/home.php
    $user = database::select('users', '*', ['id' => $_SESSION['user_id']]);
    view('user/home', ['user' => $user], ['title' => 'Dashboard']);
?>

If there is layout.php, It will be included in the view automatically.

---- app
-------- view
------------ layout.php
------------ home.php
------------ user
---------------- home.php
---------------- transactions.php
---------------- edit-profile.php

You will use user data in /user/home view.

<?php
    // view/user/home.php
    echo "Welcome, " . $user['name'] . "!";
?>

APIs

You can easily create APIs using AIS toolkit.

<?php
    // controller/api/user/get-users.php
    $users = database::select('users', '*', ['LIMIT' => 1]);
    response($users);
?>

The output will be in JSON format.

{
    "meta": {
        "status": "SUCCESS"
    },
    "data": [
        {
            "id": 1,
            "name": "John Doe"
        }
    ]
}

CLIs

You can easily create CLI commands using AIS toolkit.

<?php
    // controller/_cli/jobs/deactivate-users.php
    $inactive_users = database::select('users', '*', ['active' => 1]);
    ...
    cout("Deactivated users: " . count($inactive_users));
?>

You can run it using this command:

php index.php -r jobs/deactivate-users

Models

In AIS, it is preferred not to use models for simpilicity. However, In controllers, you can load models using the model(model_path) function when needed.

In AIS, models are simple and easy to use. They are located in the app/model folder and are used to interact with the database.

<?php
    // controller/user/home.php
    model('user');
    // or 
    require MODEL . 'user.php';

    $user = getUser($_SESSION['user_id']);
    view('user/home', ['user' => $user], ['title' => 'Dashboard']);
?>

Medoo as database wrapper

AIS uses a customized version of Medoo as the database wrapper. It is easy to use and easy to understand.

<?php
    // model/user.php
    function getUser($user_id) {
        return database::select('users', '*', ['id' => $user_id]);
    }
    function activateUser($user_id) {
        return database::update('users', ['active' => 1], ['id' => $user_id]);
    }
...
?>

AIS Rules

JUST DONT MAKE IT COMPLEX!

AIS Rule 1: For simplicity, Not to use classes for controllers and models to ensure easy implementations.

AIS Rule 2: For simplicity, Every file is only one request, ensuring that files remain small and manageable.

AIS Rule 3: For simplicity, No need to specify HTTP method in requests and routings, file names are enough!

AIS Rule 4: For simplicity, Not using models are recommended.

ToolKit

Here is a full use for the methods in AIS Framework:

http_check($options)

Forces a page to be accessed via HTTP request method and content type. You should call this function at the beginning of your controller. If the conditions are not met, the script will terminate with HTTP error.

Parameters:

$options (array): Options for method and content type.

Example Usage:

<?php
    // controller/user/home.php
    http_check(['method' => 'POST', 'content_type' => 'application/json']);

    $data = json_decode(file_get_contents('php://input'), true);
?>

model($model)

Loads a model file or a directory contaning model files.

Parameters:

$model (string): The model path in app/model folder.

Example Usage:

<?php
    // controller/user/home.php
    model('user');
?>

view($view, $data = [], $options = [])

Loads a view file with data and options.

Parameters:

$view (string): The view path in app/view folder.
$data (array): Data is an associative array to be extracted into the view as variables.
$options (array): Options for loading layout like ['title' => 'Home Page', 'description' => 'Home Page Description', 'load_layout' => true]. these options are accessible using $_VIEW variable.

Example Usage:

<?php
    // controller/user/home.php
    $user = database::select('users', '*', ['id' => $_SESSION['user_id']]);
    view('user/home', ['user' => $user], ['title' => 'Dashboard', 'load_layout' => true]);
?>

render($view, $data = [], $options = [])

Renders a view and returns the output buffer content. instead of using view() to echo output to client, you can use render() to get the output buffer content.

Parameters:

$view (string): The view path in app/view folder.
$data (array): Data is an associative array to be extracted into the view as variables.
$options (array): Options for loading layout like ['title' => 'Home Page', 'description' => 'Home Page Description', 'load_layout' => true]. these options are accessible using $_VIEW variable.

Example Usage:

<?php
    // controller/user/home.php
    $user = database::select('users', '*', ['id' => $_SESSION['user_id']]);
    $view = render('user/home', ['user' => $user], ['title' => 'Dashboard', 'load_layout' => true]);
    echo $view;
?>

lib($lib)

Loads a library file or a library directory with init.php file.

Parameters:

$lib (string): The library path in app/lib folder.

Example Usage:

<?php
    // controller/user/home.php
    lib('upload');
    $uploader = new upload();
?>

redirect($url)

Redirects to a specified URL and terminates the script.

Parameters:

$url (string): The URL to redirect to.

Example Usage:

redirect('https://example.com');

cout($data, $delimiter = 'n')

Outputs data with an optional delimiter to the console. This name is given from c++ language.

Parameters:

$data (mixed): The data to output.
$delimiter (string): The delimiter to append.

Example Usage:

cout('Hello World', "n");

response($data, $meta = [])

Sends a response with data and optional metadata to user in APIs then terminates the script.

Parameters:

$data (mixed): The response data.
$meta (array): Optional metadata.

Example Usage:

response(['sum' => 100], ['status' => 'SUCCESS']); 
// Output to endpoint: {"data":{"sum":100},"meta":{"status":"SUCCESS"}}

status($code, $data = [])

Sends a response with a status and data to user in APIs then terminates the script.

Parameters:

$code (string): The status to send to user.
$data (array): The response data.

Example Usage:

status('PROCESS_ERROR', ['error' => 'Something went wrong']);
// Output to endpoint: {"data":{"error":"Something went wrong"},"meta":{"status":"PROCESS_ERROR"}}

success($data = [])

Sends a success response with data.

Parameters:

$data (array): The response data.

Example Usage:

success();
// Output to endpoint: {"data":[],"meta":{"status":"SUCCESS"}}

fail($data = [], $status = "FAILED")

Sends a failure response with data and status.

Parameters:

$data (array): The response data.
$status (string): The status code.

Example Usage:

fail(['error' => 'Invalid request'], 'ERROR');

http_status($code, $data = [], $meta = [])

Sends an HTTP status code with optional data and metadata.

Parameters:

$code (int): The HTTP status code.
$data (array): The response data.
$meta (array): Optional metadata.

Example Usage:

http_status(404); // Shows browser 404 error.

Example Usage:

http_status(404, ['error' => 'Not found'], ['status' => 'ERROR']); 
// HTTP error 404 + Output to endpoint: {"data":{"error":"Not found"},"meta":{"status":"ERROR"}}

Example Usage:

http_status(404, "Page not found!"); 
// HTTP error 404 + Output text to endpoint: Page not found!

do_nothing()

Does nothing :). It is used for code beauty or just a placeholder for future development.

Example Usage:

    do_nothing();

dump($var, $die = false)

Dumps (var_dump) a variable and optionally terminates the script.

Parameters:

$var (mixed): The variable to dump.
$die (bool): Whether to terminate the script.

Example Usage:

    dump($var, true);

d($var, $die = false)

Alias for dump method.

Parameters:

$var (mixed): The variable to dump.
$die (bool): Whether to terminate the script.

Example Usage:

    d($var, true);

dd($var)

Alias For "Dump and Die". Dumps a variable and terminates the script.

Parameters:

$var (mixed): The variable to dump.

Example Usage:

    dd($var);

strand($length = 10)

Generates a random alphanumeric string of a specified length.

Parameters:

$length (int): The length of the random string.

Example Usage:

    strand(8); // Output: "9S34zD7o"

post($url, $data)

Sends a POST application/x-www-form-urlencoded request with form data.

Parameters:

$url (string): The URL to send the request to.
$data (array): The form data to send.

Example Usage:

    post('https://example.com/api/data', ['key' => 'value']);

post_json($url, $data)

Sends a POST application/json request with JSON data.

Parameters:

$url (string): The URL to send the request to.
$data (array): The JSON data to send.

Example Usage:

    post_json('https://example.com/api/data', ['key' => 'value']);

backtrace()

Outputs a backtrace of the current call stack.

Example Usage:

    backtrace(); // Outputs a backtrace of the current call stack.

close_everything()

Flushes the output buffer and closes the connections.

Example Usage:

    close_everything();

die_gracefully()

Closes everything and terminates the script.

Example Usage:

    die_gracefully();

Name		Name	Last commit message	Last commit date
Latest commit History 37 Commits
app		app
public		public
.gitignore		.gitignore
.htaccess		.htaccess
LICENSE		LICENSE
README.md		README.md
composer.json		composer.json
index.php		index.php

License

titan2420/AIS

Folders and files

Latest commit

History

Repository files navigation

AIS v6 PHP Framework

Installation

AIS Structure

Routing using Controllers

Middleware, Preprocess and Postprocess

Dynamic routing

Multiple dynamic routing

Views

APIs

CLIs

Models

Medoo as database wrapper

AIS Rules

ToolKit

http_check($options)

model($model)

view($view, $data = [], $options = [])

render($view, $data = [], $options = [])

lib($lib)

redirect($url)

cout($data, $delimiter = 'n')

response($data, $meta = [])

status($code, $data = [])

success($data = [])

fail($data = [], $status = "FAILED")

http_status($code, $data = [], $meta = [])

do_nothing()

dump($var, $die = false)

d($var, $die = false)

dd($var)

strand($length = 10)

post($url, $data)

post_json($url, $data)

backtrace()

close_everything()

die_gracefully()

About

Topics

Resources

License

Stars

Watchers

Forks

Releases 1

Packages 0

Languages

Packages