Μετάβαση στο περιεχόμενο
XOOPS 2.7 Docs

Αποτυχίες εγκατάστασης μονάδας

Συνήθη προβλήματα και λύσεις για την επίλυση προβλημάτων εγκατάστασης μονάδων στο XOOPS.

Διαγνωστικό διάγραμμα ροής

Ενότητα με τίτλο «Διαγνωστικό διάγραμμα ροής»
flowchart TD
    A[Module Installation Fails] --> B{Upload Successful?}
    B -->|No| C[Check File Upload Permissions]
    B -->|Yes| D{Module Directory Created?}


    C --> C1[Fix uploads/permissions]
    C1 --> A


    D -->|No| E[Check Directory Permissions]
    D -->|Yes| F{xoopsversion.php Found?}


    E --> E1[Fix folder permissions to 755]
    E1 --> A


    F -->|No| G[Check Module Package]
    F -->|Yes| H{Database Tables Created?}


    G --> G1[Verify xoopsversion.php exists]
    G1 --> A


    H -->|Error| I[Check SQL Errors]
    H -->|Success| J[Check Admin Page]


    I --> I1[Review xoops_log table]
    I1 --> A


    J -->|Missing| K[Check install.php]
    J -->|Working| L[Installation Successful]


    K --> K1[Run install.php manually]
    K1 --> A

Συνήθεις αιτίες και λύσεις

Ενότητα με τίτλο «Συνήθεις αιτίες και λύσεις»
pie title Module Installation Failure Causes
    "Permission Issues" : 30
    "Missing xoopsversion.php" : 20
    "Database SQL Errors" : 20
    "Corrupted Upload" : 15
    "PHP Version Incompatibility" : 10
    "Directory Already Exists" : 5

1. Δεν επιτρέπεται η μεταφόρτωση αρχείου

Ενότητα με τίτλο «1. Δεν επιτρέπεται η μεταφόρτωση αρχείου»

Συμπτώματα:

  • Η μεταφόρτωση αποτυγχάνει με “Δεν επιτρέπεται η άδεια”
  • Ο φάκελος της μονάδας δεν δημιουργήθηκε
  • Δεν είναι δυνατή η εγγραφή στον κατάλογο λειτουργιών

Μηνύματα λάθους:

Warning: move_uploaded_file(): Unable to move file
Permission denied (13)

Λύσεις:

Terminal window
# Check current permissions
ls -ld /path/to/xoops/modules
ls -ld /path/to/xoops/uploads


# Fix module directory permissions
chmod 755 /path/to/xoops/modules


# Fix temporary upload directory
chmod 777 /path/to/xoops/uploads
chmod 777 /tmp  # if needed


# Fix ownership (if running as different user)
chown -R www-data:www-data /path/to/xoops/modules
chown -R www-data:www-data /path/to/xoops/uploads

2. Λείπει η έκδοση XOOPS.php

Ενότητα με τίτλο «2. Λείπει η έκδοση XOOPS.php»

Symptoms:

  • Η μονάδα εμφανίζεται στη λίστα αλλά δεν ενεργοποιείται
  • Η εγκατάσταση ξεκινά και μετά σταματά
  • Δεν δημιουργήθηκε σελίδα διαχειριστή

Σφάλμα στο xoops_log:

Module xoopsversion.php not found

Λύσεις:

Επαληθεύστε τη δομή του πακέτου της ενότητας:

Terminal window
# Extract and check module contents
unzip module.zip
ls -la mymodule/


# Must contain:
# - xoopsversion.php
# - language/
# - sql/
# - admin/ (optional but recommended)

Έγκυρο xoopsversion.php structure:

<?php
$modversion['name'] = 'My Module';
$modversion['version'] = '1.0.0';
$modversion['description'] = 'Module description';
$modversion['author'] = 'Author Name';
$modversion['author_mail'] = 'author@example.com';
$modversion['author_website_url'] = 'https://example.com';
$modversion['credits'] = 'Credits';
$modversion['license'] = 'GPL 2.0 or later';
$modversion['official'] = 0;
$modversion['image'] = 'images/icon.png';
$modversion['dirname'] = basename(__DIR__);
$modversion['modpath'] = __DIR__;


// Core module info
$modversion['hasMain'] = 1;
$modversion['hasAdmin'] = 1;
$modversion['hasSearch'] = 0;
$modversion['hasNotification'] = 0;


// Database tables
$modversion['sqlfile']['mysql'] = 'sql/mysql.sql';
$modversion['tables'] = ['table_name'];

3. Βάση δεδομένων SQL Σφάλματα εκτέλεσης

Ενότητα με τίτλο «3. Βάση δεδομένων SQL Σφάλματα εκτέλεσης»

Συμπτώματα:

  • Επιτυχής μεταφόρτωση αλλά δεν δημιουργήθηκαν πίνακες βάσης δεδομένων
  • Η σελίδα διαχειριστή δεν θα φορτώσει
  • Σφάλματα “Ο πίνακας δεν υπάρχει”.

Μηνύματα λάθους:

SQL Error: Table 'xoops_module_table' already exists
Syntax error in SQL statement

Λύσεις:

# Ελέγξτε SQL Σύνταξη αρχείου

Ενότητα με τίτλο «# Ελέγξτε SQL Σύνταξη αρχείου»
Terminal window
# View the SQL file
cat modules/mymodule/sql/mysql.sql


# Check for syntax issues
# Verify:
# - All CREATE TABLE statements end with ;
# - Proper backticks for identifiers
# - Valid field types (INT, VARCHAR, TEXT, etc.)

Σωστή μορφή SQL:

CREATE TABLE `xoops_module_table` (
  `id` INT(11) NOT NULL AUTO_INCREMENT,
  `name` VARCHAR(255) NOT NULL,
  `description` TEXT,
  `created` INT(11) NOT NULL,
  `updated` INT(11) NOT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

# Μη αυτόματη εκτέλεση SQL

Ενότητα με τίτλο «# Μη αυτόματη εκτέλεση SQL»
modules/mymodule/test_sql.php
<?php
require_once '../../mainfile.php';


$sql_file = __DIR__ . '/sql/mysql.sql';
$sql_content = file_get_contents($sql_file);


// Split statements
$statements = array_filter(array_map('trim', explode(';', $sql_content)));


foreach ($statements as $statement) {
    if (empty($statement)) continue;


    try {
        $GLOBALS['xoopsDB']->query($statement);
        echo "✓ Executed: " . substr($statement, 0, 50) . "...<br>";
    } catch (Exception $e) {
        echo "✗ Error: " . $e->getMessage() . "<br>";
        echo "Statement: " . substr($statement, 0, 100) . "...<br>";
    }
}
?>

4. Κατεστραμμένη μεταφόρτωση μονάδας

Ενότητα με τίτλο «4. Κατεστραμμένη μεταφόρτωση μονάδας»

Συμπτώματα:

  • Τα αρχεία μεταφορτώθηκαν μερικώς
  • Τυχαία .php files missing
  • Η μονάδα γίνεται ασταθής μετά την εγκατάσταση

Λύσεις:

Terminal window
# Re-upload fresh copy
rm -rf /path/to/xoops/modules/mymodule


# Verify checksum if provided
md5sum -c mymodule.md5


# Verify archive integrity before extract
unzip -t mymodule.zip


# Extract to temp, verify, then move
unzip -d /tmp mymodule.zip
find /tmp/mymodule -name "*.php" | wc -l
# Should show expected number of files

5. PHP Ασυμβατότητα έκδοσης

Ενότητα με τίτλο «5. PHP Ασυμβατότητα έκδοσης»

Συμπτώματα:

  • Η εγκατάσταση αποτυγχάνει αμέσως
  • Ανάλυση σφαλμάτων στο xoopsversion.php
  • “Unexpected token” errors

Μηνύματα λάθους:

Parse error: syntax error, unexpected 'fn' (T_FN)

Λύσεις:

Terminal window
# Check XOOPS supported PHP version
grep -r "php_require" /path/to/xoops/


# Check module requirements
grep -i "php\|version" modules/mymodule/xoopsversion.php


# Check PHP version on server
php --version

Συμβατότητα δοκιμαστικής μονάδας:

<?php
// Create modules/mymodule/check_compat.php
$required_php = '7.4.0';
$current_php = PHP_VERSION;


echo "Required PHP: $required_php<br>";
echo "Current PHP: $current_php<br>";


if (version_compare(PHP_VERSION, $required_php, '<')) {
    echo "✗ PHP version too old<br>";
} else {
    echo "✓ PHP version compatible<br>";
}


// Check required extensions
$required_ext = ['mysqli', 'json', 'mb_string'];
foreach ($required_ext as $ext) {
    echo extension_loaded($ext) ? "✓" : "✗";
    echo " $ext<br>";
}
?>

6. Ο κατάλογος της μονάδας υπάρχει ήδη

Ενότητα με τίτλο «6. Ο κατάλογος της μονάδας υπάρχει ήδη»

Συμπτώματα:

  • Η εγκατάσταση αποτυγχάνει όταν υπάρχει κατάλογος λειτουργικών μονάδων
  • Δεν είναι δυνατή η επανεγκατάσταση ή η ενημέρωση της μονάδας
  • Σφάλμα “Ο κατάλογος υπάρχει”.

Μηνύματα λάθους:

The specified directory already exists

Λύσεις:

Terminal window
# Backup existing module
cp -r modules/mymodule modules/mymodule.backup


# Remove old installation completely
rm -rf modules/mymodule


# Clear any cache related to module
rm -rf xoops_data/caches/*


# Now retry installation through admin panel

7. Η δημιουργία σελίδας διαχειριστή απέτυχε

Ενότητα με τίτλο «7. Η δημιουργία σελίδας διαχειριστή απέτυχε»

Συμπτώματα:

  • Εγκαταστάσεις μονάδας αλλά λείπει η σελίδα διαχειριστή
  • Ο πίνακας διαχείρισης δεν εμφανίζει την ενότητα
  • Δεν είναι δυνατή η πρόσβαση στις ρυθμίσεις της μονάδας

Λύσεις:

<?php
// Create modules/mymodule/admin/index.php
<?php
/**
 * Module Administration Index
 */


include_once XOOPS_ROOT_PATH . '/kernel/module.php';


if (!is_object($xoopsModule) || !is_object($xoopsUser) || !$xoopsUser->isAdmin($xoopsModule->mid())) {
    exit("Access Denied");
}


// Include admin header
xoops_cp_header();


// Add admin content
echo "<h1>Module Administration</h1>";
echo "<p>Welcome to module administration</p>";


// Include admin footer
xoops_cp_footer();
?>

8. Λείπουν αρχεία γλώσσας

Ενότητα με τίτλο «8. Λείπουν αρχεία γλώσσας»

Συμπτώματα:

  • Εμφανίζεται μονάδα με ονόματα μεταβλητών αντί για κείμενο
  • Οι σελίδες διαχειριστή εμφανίζουν κείμενο στυλ “[LANG_CONSTANT]”.
  • Η εγκατάσταση ολοκληρώθηκε αλλά η διεπαφή είναι κατεστραμμένη

Λύσεις:

Terminal window
# Verify language file structure
ls -la modules/mymodule/language/


# Should contain:
# english/ (at minimum)
#   admin.php
#   index.php
#   modinfo.php

Δημιουργία αρχείου γλώσσας:

modules/mymodule/language/english/index.php
<?php
<?php
define('_AM_MYMODULE_INSTALLED', 'Module installed successfully');
define('_AM_MYMODULE_UPDATED', 'Module updated successfully');
define('_AM_MYMODULE_ERROR', 'An error occurred');
?>

Λίστα ελέγχου εγκατάστασης

Ενότητα με τίτλο «Λίστα ελέγχου εγκατάστασης»
graph TD
    A[Installation Checklist] --> B["1. Verify Module Structure"]
    A --> C["2. Check Permissions"]
    A --> D["3. Test SQL File"]
    A --> E["4. Verify xoopsversion.php"]
    A --> F["5. Check Language Files"]
    A --> G["6. Test Installation"]
    A --> H["7. Verify in Admin"]


    B --> B1["✓ Contains xoopsversion.php"]
    B --> B2["✓ SQL files present"]
    B --> B3["✓ Language files present"]


    C --> C1["✓ modules/ is 755"]
    C --> C2["✓ uploads/ is 777"]
    C --> C3["✓ Web server can write"]


    D --> D1["✓ SQL syntax valid"]
    D --> D2["✓ No duplicate tables"]


    E --> E1["✓ Valid PHP syntax"]
    E --> E2["✓ Required fields present"]


    F --> F1["✓ english/ folder exists"]
    F --> F2["✓ .php files present"]


    G --> G1["✓ Uploads successfully"]
    G --> G2["✓ Database creates"]


    H --> H1["✓ Visible in module list"]
    H --> H2["✓ Admin page accessible"]

Σενάριο εντοπισμού σφαλμάτων

Ενότητα με τίτλο «Σενάριο εντοπισμού σφαλμάτων»

Δημιουργία modules/mymodule/debug_install.php:

<?php
/**
 * Module Installation Debugger
 * Delete after troubleshooting!
 */


require_once '../../mainfile.php';


echo "<h1>Module Installation Debug</h1>";


// 1. Check file structure
echo "<h2>1. File Structure</h2>";
$required_files = [
    'xoopsversion.php',
    'language/english/modinfo.php',
    'language/english/index.php',
    'language/english/admin.php'
];


foreach ($required_files as $file) {
    $path = __DIR__ . '/' . $file;
    echo file_exists($path) ? "✓" : "✗";
    echo " $file<br>";
}


// 2. Check xoopsversion.php
echo "<h2>2. xoopsversion.php Content</h2>";
$version_file = __DIR__ . '/xoopsversion.php';
if (file_exists($version_file)) {
    $modversion = [];
    include $version_file;
    echo "<pre>";
    echo "Name: " . ($modversion['name'] ?? 'NOT SET') . "\n";
    echo "Version: " . ($modversion['version'] ?? 'NOT SET') . "\n";
    echo "Dirname: " . ($modversion['dirname'] ?? 'NOT SET') . "\n";
    echo "Has SQL: " . (isset($modversion['sqlfile']) ? "YES" : "NO") . "\n";
    echo "Has Tables: " . (isset($modversion['tables']) ? count($modversion['tables']) : 0) . "\n";
    echo "</pre>";
}


// 3. Check SQL file
echo "<h2>3. SQL File</h2>";
$sql_file = __DIR__ . '/sql/mysql.sql';
if (file_exists($sql_file)) {
    $content = file_get_contents($sql_file);
    $tables = substr_count($content, 'CREATE TABLE');
    echo "✓ SQL file exists<br>";
    echo "✓ Contains $tables CREATE TABLE statements<br>";
    echo "<pre>" . htmlspecialchars(substr($content, 0, 300)) . "...</pre>";
} else {
    echo "✗ SQL file not found<br>";
}


// 4. Check language files
echo "<h2>4. Language Files</h2>";
$lang_files = [
    'language/english/modinfo.php',
    'language/english/index.php',
    'language/english/admin.php'
];


foreach ($lang_files as $file) {
    $path = __DIR__ . '/' . $file;
    if (file_exists($path)) {
        $size = filesize($path);
        echo "✓ $file ($size bytes)<br>";
    } else {
        echo "✗ $file MISSING<br>";
    }
}


// 5. Check permissions
echo "<h2>5. Directory Permissions</h2>";
echo "Module dir: " . substr(sprintf('%o', fileperms(__DIR__)), -4) . "<br>";


// 6. Test database connection
echo "<h2>6. Database Connection</h2>";
if (is_object($GLOBALS['xoopsDB'])) {
    echo "✓ Database connected<br>";


    // Try to create test table
    $test_sql = "CREATE TEMPORARY TABLE test_install (id INT PRIMARY KEY)";
    if ($GLOBALS['xoopsDB']->query($test_sql)) {
        echo "✓ Can create tables<br>";
    } else {
        echo "✗ Cannot create tables: " . $GLOBALS['xoopsDB']->error . "<br>";
    }
} else {
    echo "✗ Database not connected<br>";
}


echo "<p><strong>Delete this file after testing!</strong></p>";
?>

Πρόληψη & Βέλτιστες Πρακτικές

Ενότητα με τίτλο «Πρόληψη & Βέλτιστες Πρακτικές»
  1. Να δημιουργείτε πάντα αντίγραφα ασφαλείας πριν εγκαταστήσετε νέες μονάδες
  2. Δοκιμάστε τοπικά πριν από την ανάπτυξη στην παραγωγή
  3. Επαληθεύστε τη δομή της μονάδας πριν από τη μεταφόρτωση
  4. Ελέγξτε τα δικαιώματα αμέσως μετά τη μεταφόρτωση
  5. Ελέγξτε τον πίνακα xoops_log για σφάλματα εγκατάστασης
  6. Διατηρήστε αντίγραφα ασφαλείας των εκδόσεων λειτουργικής μονάδας

Σχετική τεκμηρίωση

Ενότητα με τίτλο «Σχετική τεκμηρίωση»
  • Ενεργοποιήστε τη λειτουργία εντοπισμού σφαλμάτων
  • Ενότητα FAQ
  • Δομή ενότητας
  • Σφάλματα σύνδεσης βάσης δεδομένων

XOOPS #αντιμετώπιση προβλημάτων #modules #installation #debugging

Ενότητα με τίτλο «XOOPS #αντιμετώπιση προβλημάτων #modules #installation #debugging»