Λευκή οθόνη θανάτου (WSOD)

Πώς να κάνετε διάγνωση και να διορθώσετε κενές λευκές σελίδες στο XOOPS.

---

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

flowchart TD
    A[White Screen] --> B{PHP Errors Visible?}
    B -->|No| C[Enable Error Display]
    B -->|Yes| D[Read Error Message]

    C --> E{Errors Now Visible?}
    E -->|Yes| D
    E -->|No| F[Check PHP Error Log]

    D --> G{Error Type?}
    G -->|Memory| H[Increase memory_limit]
    G -->|Syntax| I[Fix PHP Syntax]
    G -->|Missing File| J[Restore File]
    G -->|Permission| K[Fix Permissions]
    G -->|Database| L[Check DB Connection]

    F --> M{Log Has Errors?}
    M -->|Yes| D
    M -->|No| N[Check Web Server Logs]

    N --> O{Found Issue?}
    O -->|Yes| D
    O -->|No| P[Enable XOOPS Debug]

---

Γρήγορη διάγνωση

# Βήμα 1: Ενεργοποίηση PHP Εμφάνιση σφαλμάτων

Προσθήκη στο mainfile.php προσωρινά:

<?php
// Add at the very top, after <?php
error_reporting(E_ALL);
ini_set('display_errors', '1');
ini_set('display_startup_errors', '1');

# Βήμα 2: Ελέγξτε το PHP Αρχείο καταγραφής σφαλμάτων

# Common log locations
tail -100 /var/log/php/error.log
tail -100 /var/log/apache2/error.log
tail -100 /var/log/nginx/error.log

# Or check PHP info for log location
php -i | grep error_log

# Βήμα 3: Ενεργοποίηση XOOPS Εντοπισμός σφαλμάτων

// In mainfile.php
define('XOOPS_DEBUG_LEVEL', 2);

---

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

pie title WSOD Common Causes
    "Memory Limit" : 25
    "PHP Syntax Error" : 20
    "Missing Files" : 15
    "Database Issues" : 15
    "Permissions" : 10
    "Template Errors" : 10
    "Timeout" : 5

# 1. Υπέρβαση ορίου μνήμης

Συμπτώματα:

• Κενή σελίδα για μεγάλες λειτουργίες
• Λειτουργεί για μικρά δεδομένα, αποτυγχάνει για μεγάλα

Σφάλμα:

Fatal error: Allowed memory size of 134217728 bytes exhausted

Λύσεις:

// In mainfile.php
ini_set('memory_limit', '256M');

// Or in .htaccess
php_value memory_limit 256M

// Or in php.ini
memory_limit = 256M

# 2. PHP Συντακτικό σφάλμα

Συμπτώματα:

• WSOD μετά την επεξεργασία του αρχείου PHP
• Συγκεκριμένη σελίδα αποτυγχάνει, άλλες λειτουργούν

Σφάλμα:

Parse error: syntax error, unexpected '}' in /path/file.php on line 123

Λύσεις:

# Check file for syntax errors
php -l /path/to/file.php

# Check all PHP files in module
find modules/mymodule -name "*.php" -exec php -l {} \;

# 3. Λείπει το απαιτούμενο αρχείο

Συμπτώματα:

• WSOD μετά upload/migration
• Οι τυχαίες σελίδες αποτυγχάνουν

Σφάλμα:

Fatal error: require_once(): Failed opening required 'class/Helper.php'

Λύσεις:

# Re-upload missing files
# Compare against fresh installation
diff -r /path/to/xoops /path/to/fresh-xoops

# Check file permissions
ls -la class/

# 4. Η σύνδεση της βάσης δεδομένων απέτυχε

Συμπτώματα:

• Όλες οι σελίδες δείχνουν WSOD
• Τα στατικά αρχεία (εικόνες, CSS) λειτουργούν

Σφάλμα:

Warning: mysqli_connect(): Access denied for user

Λύσεις:

// Verify credentials in mainfile.php
define('XOOPS_DB_HOST', 'localhost');
define('XOOPS_DB_USER', 'your_user');
define('XOOPS_DB_PASS', 'your_password');
define('XOOPS_DB_NAME', 'your_database');

// Test connection manually
<?php
$conn = new mysqli('localhost', 'user', 'pass', 'database');
if ($conn->connect_error) {
    die("Connection failed: " . $conn->connect_error);
}
echo "Connected successfully";

# 5. Ζητήματα άδειας

Συμπτώματα:

• WSOD κατά τη σύνταξη αρχείων
• Cache/compile σφάλματα

Λύσεις:

# Fix directory permissions
chmod -R 755 htdocs/
chmod -R 777 xoops_data/
chmod -R 777 uploads/

# Fix ownership
chown -R www-data:www-data /path/to/xoops

# 6. Σφάλμα Smarty Template

Συμπτώματα:

• WSOD σε συγκεκριμένες σελίδες
• Λειτουργεί μετά την εκκαθάριση της προσωρινής μνήμης

Λύσεις:

# Clear Smarty cache
rm -rf xoops_data/caches/smarty_cache/*
rm -rf xoops_data/caches/smarty_compile/*

# Check template syntax

# 7. Μέγιστος χρόνος εκτέλεσης

Συμπτώματα:

• WSOD μετά από ~30 δευτερόλεπτα
• Οι μακροχρόνιες λειτουργίες αποτυγχάνουν

Σφάλμα:

Fatal error: Maximum execution time of 30 seconds exceeded

Λύσεις:

// In mainfile.php
set_time_limit(300);

// Or in .htaccess
php_value max_execution_time 300

---

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

Δημιουργήστε το debug.php στη ρίζα XOOPS:

<?php
/**
 * XOOPS Debug Script
 * Delete after troubleshooting!
 */

error_reporting(E_ALL);
ini_set('display_errors', '1');

echo "<h1>XOOPS Debug</h1>";

// Check PHP version
echo "<h2>PHP Version</h2>";
echo "PHP " . PHP_VERSION . "<br>";

// Check required extensions
echo "<h2>Required Extensions</h2>";
$required = ['mysqli', 'gd', 'curl', 'json', 'mbstring'];
foreach ($required as $ext) {
    $status = extension_loaded($ext) ? '✓' : '✗';
    echo "$status $ext<br>";
}

// Check file permissions
echo "<h2>Directory Permissions</h2>";
$dirs = [
    'xoops_data' => 'xoops_data',
    'uploads' => 'uploads',
    'cache' => 'xoops_data/caches'
];
foreach ($dirs as $name => $path) {
    $writable = is_writable($path) ? '✓ Writable' : '✗ Not writable';
    echo "$name: $writable<br>";
}

// Test database connection
echo "<h2>Database Connection</h2>";
if (file_exists('mainfile.php')) {
    // Extract credentials (simple regex, not production safe)
    $mainfile = file_get_contents('mainfile.php');
    preg_match("/XOOPS_DB_HOST.*'(.+?)'/", $mainfile, $host);
    preg_match("/XOOPS_DB_USER.*'(.+?)'/", $mainfile, $user);
    preg_match("/XOOPS_DB_PASS.*'(.+?)'/", $mainfile, $pass);
    preg_match("/XOOPS_DB_NAME.*'(.+?)'/", $mainfile, $name);

    if (!empty($host[1])) {
        $conn = @new mysqli($host[1], $user[1], $pass[1], $name[1]);
        if ($conn->connect_error) {
            echo "✗ Connection failed: " . $conn->connect_error;
        } else {
            echo "✓ Connected to database";
            $conn->close();
        }
    }
} else {
    echo "mainfile.php not found";
}

// Memory info
echo "<h2>Memory</h2>";
echo "Memory Limit: " . ini_get('memory_limit') . "<br>";
echo "Current Usage: " . round(memory_get_usage() / 1024 / 1024, 2) . " MB<br>";

// Check error log location
echo "<h2>Error Log</h2>";
echo "Location: " . ini_get('error_log');

---

Πρόληψη

graph LR
    A[Backup Before Changes] --> E[Stable Site]
    B[Test in Development] --> E
    C[Monitor Error Logs] --> E
    D[Use Version Control] --> E

1. Να δημιουργείτε πάντα αντίγραφα ασφαλείας πριν κάνετε αλλαγές
2. Δοκιμάστε τοπικά πριν από την ανάπτυξη
3. Παρακολουθήστε τα αρχεία καταγραφής σφαλμάτων τακτικά
4. Χρησιμοποιήστε το git για την παρακολούθηση αλλαγών
5. Διατηρήστε το PHP ενημερωμένο στις υποστηριζόμενες εκδόσεις

---

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

• Σφάλματα σύνδεσης βάσης δεδομένων
• Σφάλματα άρνησης άδειας
• Ενεργοποιήστε τη λειτουργία εντοπισμού σφαλμάτων

---

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