git/reactiveData
1
0
Fork 0
Code Issues 1 Pull Requests Actions Packages Projects Releases Wiki Activity

improved comments

Browse Source
This commit is contained in:
git 2025-06-06 14:18:55 +01:00
parent f4edef0556
commit 15b25b3bf3
1 changed files with 48 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

49
plt.php
View File

@ -3,7 +3,54 @@
*
* 2. PLT-Level
*
* Depends on tables:
* Overview:
* This PHP script automates database updates by processing rows marked for action in various tables.
* It dynamically executes predefined functions based on table-specific instructions stored in the database.
* Functions are executed in either PHP or Python environments depending on configuration.
*
* How It Works:
* 1. The script queries the `SYS_PRD_BND.Tables` table to determine which tables require processing.
* 2. For each identified table, it selects rows updated since the last run (based on the `LastUpdated` column).
* 3. Each row is individually processed through:
* - PHP-level triggers defined in system-level or database-level code.
* - Python-level triggers similarly defined.
* 4. If a trigger modifies the row, the script updates the database with new values.
* 5. Errors encountered during processing are logged and sent as notifications via Telegram.
*
* Tables and Their Purpose:
* - SYS_PRD_BND.Tables:
* Defines active tables and their respective PHP or Python trigger codes.
* Columns: Name, onUpdate_phpCode, onUpdate_pyCode, LastUpdated, LastError
*
* - SYS_PRD_BND.Constants:
* Holds constants that are injected into the PHP environment during execution.
* Columns: Name, Type, Value
*
* - SYS_PRD_BND.SupportFunctions:
* Stores reusable PHP functions available during trigger execution.
* Columns: Name, InputArgs_json, PhpCode
*
* - SYS_PRD_BND.PyPi:
* Lists external Python libraries imported into Python trigger execution.
* Columns: LibName, AliasName
*
* Dynamic Tables:
* - Application-specific tables, each must include at least:
* - LastUpdated (timestamp for tracking)
* - Primary key columns for row identification (defined externally)
*
* Important Functions:
* - sendTelegramMessage($message, $dstUsers): Sends notifications to a specified Telegram group.
* - runProcess($command, $code, &$stdout, &$error): Executes external PHP/Python code securely.
*
* Usage:
* Ensure proper configuration of constants, Telegram bot token, and required Python modules.
* Regularly schedule this script to automate database maintenance and data integrity tasks.
*
*
*
*
* Expects tables:
* SYS_PRD_BND.Tables (Name, onUpdate_phpCode, onUpdate_pyCode, LastUpdated, LastError)
* SYS_PRD_BND.Constants (Name, Type, Value)
* SYS_PRD_BND.SupportFunctions (Name, InputArgs_json, PhpCode)