Please check this example script to learn how to build an automated decision engine using PHP AI library classes.

Ascoos OS - pure PHP Web 5.0 and WebAI Core

Welcome to Ascoos OS, an innovative PHP core that brings Web 5.0 to reality and flirts with WebAI!

Table of Contents

• Overview
• Vision
• Where will you find it?
• Getting Started
• Features
• System Requirements
• Lifetime Support (LTS)
• Installation
• Management of Optional Core Classes
• Code Development and Testing Platform
• Debugging and Testing
• DoBu Documentation
• Usage Examples
• Case Studies
• Links
• Author

Overview

With ~1,500 encrypted classes (in early 2028), Ascoos OS integrates Frameworks, CMS, IoT, and decentralized applications, delivering security, interoperability, and result synthesis.

Explore how we redefine the future of the internet!

Vision

Redefining web development with a secure, modular, AI-driven PHP kernel.

Where will you find it?

Ascoos OS is still in development, so it is not available for public use.

However, it is evolving very quickly!

Check out the Roadmap to learn about our next milestones and journey toward Web 5.0 and WebAI.

Included in Ascoos Web Extended Studio 26 Pro:

Getting Started

• Explore the documentation: Check out the Glossary, Roadmap, and Case Studies.
• See code examples: Find code with examples and case studies in the /examples/ folder.
• Learn about connecting with Web 5.0: Web 5.0 combines the convenience of Web 2.0 with the decentralization of Web 3.0, without blockchain complexity. Using Decentralized Identifiers (DIDs) and Decentralized Web Nodes (DWNs), Ascoos OS implements this vision through CiC (Cms-in-Cms) technology. Learn more at "The CiC Technology: Cross-Interpreter Communication ? The Philosophy of Integration for Web 5.0".
• Learn about connecting to WebAI: WebAI is an architecture where the web itself operates as an intelligent entity, rather than as a collection of artificial intelligence add-ons.

Features

• Dynamic loading of optional kernel classes
• Decentralized web and torrent management.
• Extensive network and system management.
• Native IoT support (Arduino, Raspberry Pi).
• Native capabilities of Artificial Intelligence (AI), Natural Language Processing (NLP), and Neural Networks (NeuralNet).
• JSQLDB: JSON-based database. A hybrid JSON SQL database engine focused on speed, and PHP-native SQL queries.
• JML: JSON-style Markup Language. A lightweight, readable markup format inspired by JSON and DSLs.
• WIC: Secure image transfer format.
• jAscoos & BootLib: JavaScript and UI frameworks.
• LibIn: Library management. Dynamic loading of optional third-party libraries
• Macro Engine: Natural language programming.
• ASS (Ascoos Security System): Multi-layered security.
• DoBu (Documentation Builder): A JML?inspired Documentation DSL for multilingual docblocks.

System Requirements

• PHP 8.4+ with extensions: IonCube loaders, JSON, cURL.
• Optional Databases: MariaDB 12+ or JSQLDB 1.0+.
• Web Server: Apache 2.4+.
• Recommended Memory: 512MB+ RAM.

> Although the memory consumption for loading the Ascoos OS kernel is minimal and does not exceed 20-30MB, it is nonetheless recommended to have at least 512 MBytes of free memory for the smooth execution of your scripts.

Lifetime Support (LTS)

| Version | Official Release | Bug Fixes | Security Fixes | PHP | |---------|------------------|-----------|----------------|-----------| | 1.0.0 | Q1 2028 | Q4 2032 | Q4 2034 | 8.4 ? 9.x |

Installation

Namespace

use ASCOOS\OS\...;

Installation Steps

• Download the commercial package, based on the license you have, from the Official Download Website.
• Extract to any folder you desire within your root.

• For configuration, you have three options:

  1. ?? Prepend Autoload: If you have access to php.ini, configure the auto_prepend_file directive with the appropriate folder so that it automatically loads Ascoos OS on every request.
    auto_prepend_file ="/path/aos/autoload.php"
  

  2. ?? spl_autoload: You can dynamically load Ascoos OS using the SPL library.
  

  spl_autoload_extensions('/path/aos/autoload.php'); spl_autoload_register();

  3. ?? require_once: You can load Ascoos OS within your PHP file using the "require_once" function.
  

  require_once "/path/aos/autoload.php";

Management of Optional Core Classes

The Ascoos OS has two types of kernel classes: core kernels and optional ones. The former are loaded automatically when Ascoos OS runs, while the latter are loaded optionally based on the user's choices and needs.

To manage this functionality, we created an internal application in Ascoos OS, the Extras Classes Manager (see screenshot), through which these classes can be loaded dynamically.

Code Development and Testing Platform

Ascoos Web Extended Studio

The AlexSoft Software provides you with a free Windows 64Bit development platform so that you can write, run, and debug your code.

*Try Ascoos Web Extended Studio*.

> ATTENTION!!! If you are using XAMPP/WAMP or some other similar program, before running the servers you must stop and remove the servers from Windows Services, because conflicts may occur.

Debugging and Testing

The Ascoos OS has built-in debugging (TDebugHandler) and testing (TTestHandler) classes.

For most of your tests, you will NOT need any other testing or debugging package.

// Setting properties
$properties = [
    'logs' => [
        'useLogger' => true,
        'dir' => $AOS_LOGS_PATH . '/',
        'file' => 'test_handler.log',
        'level' => DebugLevel::Info
    ],
    'lang' => 'el-GR',
    'debug' => [
        'precision' => 4,
        'log_threshold' => DebugLevel::Info
    ]
];

$testHandler = new TTestHandler($properties);

// Object check
$object = new TObject();
$testHandler->checkObject($object, true); // It must record that the object is valid

// Class check
$testHandler->checkClass('ASCOOS\OS\Kernel\Core\TObject', true); // It must record that the class exists

// Method execution with timing
$result = $testHandler->executeMethodWithTiming($object, 'getClassMetadata', [], true);
print_r($result); // Displays result, execution time, system statistics

Code Testing

Every class, every method, goes through thorough testing to ensure that it meets the strict standards and requirements of Ascoos OS.

$char_a_ring_nfd = "a\xCC\x8A";  // 'LATIN SMALL LETTER A WITH RING ABOVE' (U+00E5) normalization form "D"
$char_o_diaeresis_nfd = "o\xCC\x88"; // 'LATIN SMALL LETTER O WITH DIAERESIS' (U+00F6) normalization form "D"
$char_O_diaeresis_nfd = "O\xCC\x88"; // 'LATIN CAPITAL LETTER O WITH DIAERESIS' (U+00D6) normalization form "D"

$test = new TTestHandler(
    properties: [
        'titleTest' => 'TUTF8::grapheme_stripos()', 
        'subtitle' => '<code>Grapheme stripos</code>, without Intl Extension', 
        'desc' => 'Returns the position (in grapheme units) of the first occurrence of $needle in $haystack, starting from $offset graphemes.<br> Returns false if not found.'
    ]
);

$test->runTest(
    '$utf8->grapheme_stripos("a\xCC\x8Aa\xCC\x8Ao\xCC\x88", "O\xCC\x88"); // a?a?o?, O?',
    $utf8->grapheme_stripos( $char_a_ring_nfd . $char_a_ring_nfd . $char_o_diaeresis_nfd, $char_O_diaeresis_nfd) === 2,
    2,
    $utf8->grapheme_stripos( $char_a_ring_nfd . $char_a_ring_nfd . $char_o_diaeresis_nfd, $char_O_diaeresis_nfd),
    'Example with test Condition.'
);

Stress Tests

A stress test was recently conducted. You can see the results on the related Technical Report page.

DoBu Documentation

Ascoos OS includes as its official documentation a new documentation DSL standard called DoBu.

It is docblocks inside /.../ based on JML.

It is more oriented toward creating documentation files and less as immediate reference text. It has the capability for multilingual documentation and is an agnostic metakeys docblock.

Supports docblock for:

• the file with the class or the example file
• the class
• each method or function
• parameters
• return types
• exceptions
• multilingual descriptions
• mathematical formulas
• and much more.

Example of DoBu documentation for a file header

/*
dobu {
    file:id(`1`),name(`create-my-project`) {
        ascoos {
            logo {`
                  __ _  ___  ___ ___   ___   ___     ___   ___
                 / _V |/  / / __/ _ \ / _ \ /  /    / _ \ /  /
                | (_| |\  \| (_| (_) | (_) |\  \   | (_) |\  \
                 \__,_|/__/ \___\___/ \___/ /__/    \___/ /__/
            `},
            name {`ASCOOS OS`},
            version {`1.0.0`},
            category {`Web OS`},
            subcategory {`Web5 / WebAI`},
            description {`A Web 5.0 and Web AI Kernel for decentralized web and IoT applications`},
            creator {`Drogidis Christos`},
            site {`https://www.ascoos.com`},
            issues {`https://issues.ascoos.com`},
            support {`support@ascoos.com`},
            license {`[Commercial] http://docs.ascoos.com/lics/ascoos/AGL.html`},
            copyright {`Copyright (c) 2007 - 2026, AlexSoft Software.`}
        },
        project {
            package:langs {
                en {`DoBu code sample`},
                el {`?????? ?????? DoBu`}
            },
            subpackage:langs {
                en {`DoBu code sample for classes and methods`},
                el {`?????? ?????? DoBu ??? ??????? ??? ????????`}
            },
            category:langs {
                en {`Examples`},
                el {`????????????`}
            },
            subcategory:langs {
                en {`DoBu for classes`},
                el {`DoBu ??? ???????`}
            },
            source {`examples/create-my-project.php`},
            description:langs {
                en {`This file is a complete example of docblock writing and DoBu structure.`},
                el {`?? ?????? ???? ???????? ??? ???????????? ?????????? ???????? docblock, ????? DoBu`}
            },
            fileNo {`1`},
            version {`1.0.0`},
            build {`1`},
            created {`2026-02-12 09:25:03`},
            updated {`2026-02-12 09:51:43`},
            author {`Author Name`},
            authorSite {`https://www.example.com`},
            support {`support@example.com`},
            license {`MIT`},
            since {`1.0.0`},
            sincePHP {`8.4.0`}
        }
    }
}
*/

Usage Examples

DNS Info (TNetwork class)

declare(strict_types=1);
use ASCOOS\OS\Kernel\Net\TNetwork;

// Retrieve DNS information
$objNetwork = new TNetwork();
$dnsInfo = $objNetwork->getDNSInfo();
echo "Primary DNS: " . $dnsInfo[0];
if(key_exists(1, $dnsInfo)) echo "<br>"."Secondary DNS: " . $dnsInfo[1] . "<br>";

// Frees of the object
$objNetwork->Free();
?>

Collector of Collections (TCollector class)

declare(strict_types=1);
use Ascoos\OS\Kernel\Core\Collections\TCollector;

$collector = new TCollector();

echo "Number of registered types after initialization: " . count($collector->listTypes()) . "\n";

$collector->Free();

Case Studies

See how Ascoos OS implements Web 5.0 through practical examples, such as integrating Joomla with torrents, monitoring IoT sensors, and audio processing. Explore them in Case Studies.

Links

Documentation

• Web 5.0 and Ascoos OS
• Glossary
• Roadmap
• Case Studies
• Ascoos Meets Web 5.0

Tools & Libraries

• JSQLDB
• WIC
• BootLib
• BootLib Flex
• phpBCL
• AWES

Community

• YouTube
• X

Official Websites

• Ascoos Projects Family
• Ascoos Web Extended Studio (AWES)
• Ascoos OS (Under construction)
• BootLib UI Framework (Under construction)
• JML (DSL Markup Language)

Author

Drogidis Christos

ASCOOS OS Creator

https://www.ascoos.com