صفحه سفید مرگ (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 Error Log را بررسی کنید

# 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 Debug را فعال کنید

// 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 را در نسخه های پشتیبانی شده به روز نگه دارید

---

مستندات مرتبط

• خطاهای اتصال پایگاه داده
• خطاهای مجوز رد شده
• حالت Debug Mode را فعال کنید

---

#xoops #عیب یابی #wsod #debugging #errors