Skrin Putih Kematian (WSOD)

Bagaimana untuk mendiagnosis dan membetulkan halaman putih kosong dalam XOOPS.

---

Carta Aliran Diagnostik

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]

---

Diagnosis Pantas

Langkah 1: Dayakan PHP Paparan Ralat

Tambahkan pada mainfile.php buat sementara waktu:

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

Langkah 2: Semak PHP Log Ralat

# 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

Langkah 3: Dayakan XOOPS Nyahpepijat

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

---

Punca & Penyelesaian Biasa

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. Had Memori Melebihi

Simptom:

• Halaman kosong pada operasi besar
• Berfungsi untuk data kecil, gagal untuk besar

Ralat:

Fatal error: Allowed memory size of 134217728 bytes exhausted

Penyelesaian:

// 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 Ralat Sintaks

Simptom:

• WSOD selepas menyunting fail PHP
• Halaman tertentu gagal, yang lain berfungsi

Ralat:

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

Penyelesaian:

# 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. Fail yang Diperlukan Tiada

Simptom:

• WSOD selepas upload/migration
• Halaman rawak gagal

Ralat:

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

Penyelesaian:

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

# Check file permissions
ls -la class/

4. Sambungan Pangkalan Data Gagal

Simptom:

• Semua halaman menunjukkan WSOD
• Fail statik (imej, CSS) berfungsi

Ralat:

Warning: mysqli_connect(): Access denied for user

Penyelesaian:

// 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. Isu Kebenaran

Simptom:

• WSOD semasa menulis fail
• Cache/compile kesilapan

Penyelesaian:

# 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. Ralat Templat Smarty

Simptom:

• WSOD pada halaman tertentu
• Berfungsi selepas mengosongkan cache

Penyelesaian:

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

# Check template syntax

7. Masa Pelaksanaan Maksimum

Simptom:

• WSOD selepas ~30 saat
• Operasi yang lama gagal

Ralat:

Fatal error: Maximum execution time of 30 seconds exceeded

Penyelesaian:

// In mainfile.php
set_time_limit(300);

// Or in .htaccess
php_value max_execution_time 300

---

Skrip Nyahpepijat

Buat debug.php dalam XOOPS akar:

<?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');

---

Pencegahan

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. Sentiasa backup sebelum membuat perubahan
2. Uji secara setempat sebelum digunakan
3. Pantau log ralat dengan kerap
4. Gunakan git untuk menjejaki perubahan
5. Pastikan PHP dikemas kini dalam versi yang disokong

---

Dokumentasi Berkaitan

• Ralat Sambungan Pangkalan Data
• Kebenaran Ditolak Ralat
• Dayakan Mod Nyahpepijat

---

#XOOPS #penyelesaian masalah #wsod #debugging #ralat