v0.6.3

Init Commit

Author: projectsaturnstudios

config.json

@@ -0,0 +1,27 @@
+{
+    "namespace": "linuxsystem",
+    "name": "linux-system",
+    "description": "PHP-Controllable Linux System Extension",
+    "author": "Project Saturn Studios, LLC",
+    "version": "0.6.3",
+    "warnings": {
+        "unused-variable": true,
+        "unused-variable-external": true,
+        "possible-wrong-parameter": true,
+        "possible-wrong-parameter-undefined": true,
+        "nonexistent-function": true,
+        "nonexistent-class": true
+    },
+    "optimizations": {
+        "static-type-inference": true,
+        "static-type-inference-second-pass": true,
+        "local-context-pass": true,
+        "constant-folding": true,
+        "static-constant-class-folding": true,
+        "call-gatherer-pass": true,
+        "check-invalid-reads": true,
+        "growth-cache-object": true,
+        "growth-cache-array": true
+    }
+}
+

install.sh

@@ -0,0 +1,199 @@
+#!/bin/bash
+
+# Portable installer for the HardwarePHP extension.
+# - Detects php extension dir dynamically
+# - Enables for available SAPIs (CLI/FPM/Apache) when present
+# - Finds zephir automatically or respects $ZEPHIR_BIN
+# - Provides clear preflight checks and verification
+
+set -Eeuo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+EXTENSION_NAME="linuxsystem"
+BUILD_SO="${SCRIPT_DIR}/ext/modules/${EXTENSION_NAME}.so"
+LOG_FILE="${SCRIPT_DIR}/build.log"
+
+if [ "${EUID:-$(id -u)}" -ne 0 ]; then
+    SUDO="sudo"
+else
+    SUDO=""
+fi
+
+die() {
+    echo ""
+    echo "❌ $*"
+    exit 1
+}
+
+require_cmd() {
+    local cmd="$1"
+    command -v "$cmd" >/dev/null 2>&1 || die "Required command not found: $cmd"
+}
+
+header() {
+    echo "=========================================="
+    echo "LinuxDevices Extension Installer (portable)"
+    echo "=========================================="
+    echo ""
+}
+
+step() {
+    echo "$*"
+}
+
+ok() {
+    echo "   ✓ $*"
+}
+
+header
+
+# Preflight
+step "🔎 Preflight checks..."
+require_cmd php
+require_cmd php-config
+
+# Resolve Zephir
+if [ -n "${ZEPHIR_BIN:-}" ]; then
+    ZEPHIR="$ZEPHIR_BIN"
+elif command -v zephir >/dev/null 2>&1; then
+    ZEPHIR="$(command -v zephir)"
+elif [ -x "$HOME/.config/composer/vendor/bin/zephir" ]; then
+    ZEPHIR="$HOME/.config/composer/vendor/bin/zephir"
+else
+    die "Zephir not found. Install via composer (composer global require phalcon/zephir) or set ZEPHIR_BIN."
+fi
+ok "Found zephir: $ZEPHIR"
+
+PHP_VER_MM="$(php -r 'echo PHP_MAJOR_VERSION.".".PHP_MINOR_VERSION;')"
+PHP_VER_NN="$(php -r 'echo PHP_MAJOR_VERSION.PHP_MINOR_VERSION;')"
+PHP_EXT_DIR="$(php-config --extension-dir || true)"
+[ -n "$PHP_EXT_DIR" ] || die "Could not determine PHP extension dir (php-config --extension-dir)."
+ok "PHP version: ${PHP_VER_MM}"
+ok "Extension dir: ${PHP_EXT_DIR}"
+
+# Set safe CFLAGS for GCC 14 compatibility (override any invalid flags from environment)
+# Suppress Zephir kernel code warnings that are harmless but break with GCC 14
+export CFLAGS="-Wno-error -Wno-error=incompatible-pointer-types -Wno-pointer-compare"
+export CPPFLAGS="${CPPFLAGS:-} -Wno-error -Wno-error=incompatible-pointer-types"
+echo ""
+
+# Clean previous build
+step "🧹 Cleaning previous build..."
+cd "${SCRIPT_DIR}"
+if ! "$ZEPHIR" fullclean >"$LOG_FILE" 2>&1; then
+    tail -50 "$LOG_FILE" || true
+    die "Clean failed. See ${LOG_FILE}."
+fi
+ok "Clean complete"
+echo ""
+
+# Build
+step "🔨 Building extension..."
+if ! "$ZEPHIR" build >>"$LOG_FILE" 2>&1; then
+    tail -80 "$LOG_FILE" || true
+    die "Build failed. See ${LOG_FILE}."
+fi
+if [ ! -f "$BUILD_SO" ]; then
+    tail -80 "$LOG_FILE" || true
+    die "Build output not found at ${BUILD_SO}."
+fi
+ok "Build complete"
+echo ""
+
+# Install .so
+step "📦 Installing binary..."
+$SUDO cp -f "$BUILD_SO" "${PHP_EXT_DIR}/${EXTENSION_NAME}.so"
+$SUDO chmod 755 "${PHP_EXT_DIR}/${EXTENSION_NAME}.so"
+ok "Copied to: ${PHP_EXT_DIR}/${EXTENSION_NAME}.so"
+echo ""
+
+# Enable extension across detected SAPIs
+step "⚙️  Enabling extension..."
+declare -a CONF_DIR_CANDIDATES=()
+
+# CLI scan dir (most accurate for CLI)
+CLI_SCAN_DIR="$(php --ini 2>/dev/null | awk -F': ' '/Scan for additional \.ini files in:/{print $2}' || true)"
+if [ -n "$CLI_SCAN_DIR" ] && [ "$CLI_SCAN_DIR" != "(none)" ] && [ -d "$CLI_SCAN_DIR" ]; then
+    CONF_DIR_CANDIDATES+=("$CLI_SCAN_DIR")
+fi
+
+# Debian/Ubuntu common paths
+for d in "/etc/php/${PHP_VER_MM}/cli/conf.d" "/etc/php/${PHP_VER_MM}/fpm/conf.d" "/etc/php/${PHP_VER_MM}/apache2/conf.d"; do
+    [ -d "$d" ] && CONF_DIR_CANDIDATES+=("$d")
+done
+
+# Alpine common path (e.g., /etc/php83/conf.d)
+ALPINE_CONF="/etc/php${PHP_VER_NN}/conf.d"
+[ -d "$ALPINE_CONF" ] && CONF_DIR_CANDIDATES+=("$ALPINE_CONF")
+
+# FPM generic fallbacks
+for d in "/etc/php-fpm.d" "/etc/php-fpm/conf.d"; do
+    [ -d "$d" ] && CONF_DIR_CANDIDATES+=("$d")
+done
+
+# Deduplicate
+mapfile -t CONF_DIRS < <(printf "%s\n" "${CONF_DIR_CANDIDATES[@]}" | awk '!seen[$0]++')
+
+if [ "${#CONF_DIRS[@]}" -eq 0 ]; then
+    echo "   ⚠️  No conf.d directories found; enabling only for current CLI context via php.d scan dir."
+fi
+
+INI_NAME="30-${EXTENSION_NAME}.ini"
+INI_CONTENT="extension=${EXTENSION_NAME}.so"
+
+for confd in "${CONF_DIRS[@]:-}"; do
+    INI_PATH="${confd}/${INI_NAME}"
+    if [ ! -f "$INI_PATH" ]; then
+        echo "$INI_CONTENT" | $SUDO tee "$INI_PATH" >/dev/null
+        ok "Created: $INI_PATH"
+    else
+        ok "Already enabled: $INI_PATH"
+    fi
+done
+echo ""
+
+# Verify CLI load
+step "🔍 Verifying installation (CLI)..."
+if php -m 2>/dev/null | grep -q "^linuxsystem$"; then
+    ok "Extension loaded successfully in CLI"
+else
+    echo ""
+    php -m 2>/dev/null | tail -n +1 >/dev/null || true
+    die "Extension not detected in CLI. Check ${INI_NAME} placement and php --ini."
+fi
+echo ""
+
+# Show module info
+step "=========================================="
+step "Extension Information (CLI)"
+step "=========================================="
+php --ri linuxsystem || true
+echo ""
+
+# Reload FPM if present
+if command -v systemctl >/dev/null 2>&1; then
+    if systemctl list-units --type=service 2>/dev/null | grep -q "php${PHP_VER_MM}-fpm\.service"; then
+        step "🔁 Reloading php${PHP_VER_MM}-fpm..."
+        $SUDO systemctl reload "php${PHP_VER_MM}-fpm" || true
+        ok "php${PHP_VER_MM}-fpm reloaded"
+    elif systemctl list-units --type=service 2>/dev/null | grep -q "php-fpm\.service"; then
+        step "🔁 Reloading php-fpm..."
+        $SUDO systemctl reload "php-fpm" || true
+        ok "php-fpm reloaded"
+    fi
+fi
+
+echo "✅ Installation complete!"
+echo ""
+echo "File locations:"
+echo "  • Binary: ${PHP_EXT_DIR}/${EXTENSION_NAME}.so"
+if [ "${#CONF_DIRS[@]}" -gt 0 ]; then
+    for d in "${CONF_DIRS[@]}"; do
+        echo "  • Config: ${d}/${INI_NAME}"
+    done
+else
+    echo "  • Config: (CLI scan dir via php --ini)"
+fi
+echo ""
+
+

linuxsystem/generalpurposecontroller.zep

@@ -0,0 +1,168 @@
+namespace LinuxSystem;
+
+use LinuxSystem\IOController;
+
+%{
+#include <fcntl.h>
+#include <unistd.h>
+#include <sys/ioctl.h>
+#include <linux/gpio.h>
+#include <string.h>
+}%
+
+abstract class GeneralPurposeController extends IOController
+{
+    private chip = null;
+    private line = null;
+    private direction = 0; // 0 = OUTPUT, 1 = INPUT
+
+    public function __construct()
+    {
+        this->basePath("/dev/gpiochip");
+        this->register();
+    }
+
+    public function chip(var c = null) -> int
+    {
+        if(!is_null(c)) {
+            let this->chip = c;
+        }
+        return intVal(this->chip);
+    }
+
+    public function line(var l = null, int dir = 0) -> int
+    {
+        if(!is_null(l)) {
+            var results = 0;
+            int fd = intVal(this->fileDescriptor());
+            let results = this->claimLine(fd, intVal(l), dir);
+
+            if(results >= 0) {
+                let this->line = l;
+                let this->direction = dir;
+            }
+
+        }
+        return intVal(this->line);
+    }
+
+    protected function claimLine(int fd, int line, int direction = 0) -> int
+    {
+        int line_fd;
+        
+        %{
+            struct gpio_v2_line_request req;
+            int result;
+            
+            // Configure the line request
+            memset(&req, 0, sizeof(req));
+            req.offsets[0] = line;
+            req.num_lines = 1;
+            
+            // Set direction: 0 = OUTPUT, 1 = INPUT
+            if (direction == 1) {
+                req.config.flags = GPIO_V2_LINE_FLAG_INPUT;
+            } else {
+                req.config.flags = GPIO_V2_LINE_FLAG_OUTPUT;
+            }
+            
+            strcpy(req.consumer, "scrapyard");
+            
+            // Request the line (kernel returns new FD in req.fd)
+            result = ioctl(fd, GPIO_V2_GET_LINE_IOCTL, &req);
+            
+            if (result < 0) {
+                line_fd = -1;
+            } else {
+                line_fd = req.fd;
+            }
+        }%
+        
+        // Close the chip FD (don't need it anymore)
+        this->_close(fd);
+        
+        // Store the line FD in inherited file_descriptor
+        if (line_fd >= 0) {
+            this->fileDescriptor(line_fd);
+        }
+        
+        return line_fd;
+    }
+
+    public function releaseLine() -> void
+    {
+        this->clearFileDescriptor();
+    }
+
+    public function high() -> bool
+    {
+        return this->setHigh(this->fileDescriptor());
+    }
+
+    public function low() -> bool
+    {
+        return this->setLow(this->fileDescriptor());
+    }
+
+    public function read() -> int
+    {
+        return this->getValue(this->fileDescriptor());
+    }
+
+    protected function getValue(int fd) -> int
+    {
+        int value;
+        
+        %{
+            struct gpio_v2_line_values values;
+            int result;
+            
+            memset(&values, 0, sizeof(values));
+            values.mask = 1;  // Read bit 0
+            
+            result = ioctl(fd, GPIO_V2_LINE_GET_VALUES_IOCTL, &values);
+            
+            if (result < 0) {
+                value = -1;
+            } else {
+                value = (values.bits & 1) ? 1 : 0;
+            }
+        }%
+        
+        return value;
+    }
+
+    protected function setHigh(int fd) -> bool
+    {
+        int result;
+        
+        %{
+            struct gpio_v2_line_values values;
+            
+            memset(&values, 0, sizeof(values));
+            values.bits = 1;  // HIGH
+            values.mask = 1;  // Update bit 0
+            
+            result = ioctl(fd, GPIO_V2_LINE_SET_VALUES_IOCTL, &values);
+        }%
+        
+        return result >= 0;
+    }
+
+    protected function setLow(int fd) -> bool
+    {
+        int result;
+        
+        %{
+            struct gpio_v2_line_values values;
+            
+            memset(&values, 0, sizeof(values));
+            values.bits = 0;  // LOW
+            values.mask = 1;  // Update bit 0
+            
+            result = ioctl(fd, GPIO_V2_LINE_SET_VALUES_IOCTL, &values);
+        }%
+        
+        return result >= 0;
+    }
+}