İçeriğe geç
XOOPS 2.7 Docs

module Kurulum Hataları

XOOPS’de module kurulum sorunlarının çözümüne ilişkin genel sorunlar ve çözümler.

Tanılama Akış Şeması

Section titled “Tanılama Akış Şeması”
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

Yaygın Nedenler ve Çözümler

Section titled “Yaygın Nedenler ve Çözümler”
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. Dosya Yükleme İzni Reddedildi

Section titled “1. Dosya Yükleme İzni Reddedildi”

Belirtiler:

  • Yükleme “İzin reddedildi” hatasıyla başarısız oluyor
  • module klasörü oluşturulmadı
  • modules dizinine yazılamıyor

Hata Mesajları:

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

Çözümler:

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. xoopsversion.php eksik

Section titled “2. xoopsversion.php eksik”

Belirtiler:

  • module listede görünüyor ancak etkinleştirilmiyor
  • Kurulum başlıyor ve duruyor
  • Yönetici sayfası oluşturulmadı

xoops_log’da hata:

Module xoopsversion.php not found

Çözümler:

module paketi yapısını doğrulayın:

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


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

Geçerli xoopsversion.php yapısı:

<?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. database SQL Yürütme Hataları

Section titled “3. database SQL Yürütme Hataları”

Belirtiler:

  • Yükleme başarılı ancak database tabloları oluşturulmadı
  • Yönetici sayfası yüklenmiyor
  • “Tablo mevcut değil” hataları

Hata Mesajları:

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

Çözümler:

SQL Dosya Sözdizimini kontrol edin

Section titled “SQL Dosya Sözdizimini kontrol edin”
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.)

Doğru SQL Formatı:

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’yi Manuel Olarak Yürütün

Section titled “SQL’yi Manuel Olarak Yürütün”
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. Bozuk module Yüklemesi

Section titled “4. Bozuk module Yüklemesi”

Belirtiler:

  • Dosyalar kısmen yüklendi
  • Rastgele .php dosyaları eksik
  • module kurulumdan sonra kararsız hale geliyor

Çözümler:

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 Versiyon Uyumsuzluğu

Section titled “5. PHP Versiyon Uyumsuzluğu”

Belirtiler:

  • Kurulum hemen başarısız oluyor
  • xoopsversion.php’deki hataları ayrıştırma
  • “Beklenmeyen belirteç” hataları

Hata Mesajları:

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

Çözümler:

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

Test Modülü Uyumluluğu:

<?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. module Dizini Zaten Mevcut

Section titled “6. module Dizini Zaten Mevcut”

Belirtiler:

  • module dizini mevcut olduğunda kurulum başarısız oluyor
  • module yeniden yüklenemiyor veya güncellenemiyor
  • “Dizin mevcut” hatası

Hata Mesajları:

The specified directory already exists

Çözümler:

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. Yönetici Sayfası Oluşturma Başarısız

Section titled “7. Yönetici Sayfası Oluşturma Başarısız”

Belirtiler:

  • module yükleniyor ancak yönetici sayfası eksik
  • Yönetici panelinde module görünmüyor
  • module ayarlarına erişilemiyor

Çözümler:

<?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. Dil Dosyaları Eksik

Section titled “8. Dil Dosyaları Eksik”

Belirtiler:

  • module, metin yerine değişken adlarıyla görüntülenir
  • Yönetici sayfalarında “[LANG_CONSTANT]” tarzı metin gösterilir
  • Kurulum tamamlandı ancak arayüz bozuldu

Çözümler:

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


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

Dil Dosyası Oluştur:

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

Kurulum Kontrol Listesi

Section titled “Kurulum Kontrol Listesi”
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"]

Komut Dosyasında Hata Ayıklama

Section titled “Komut Dosyasında Hata Ayıklama”

modules/mymodule/debug_install.php oluşturun:

<?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>";
?>

Önleme ve En İyi Uygulamalar

Section titled “Önleme ve En İyi Uygulamalar”
  1. Yeni modülleri kurmadan önce her zaman yedekleyin
  2. Üretime dağıtmadan önce yerel olarak test edin
  3. Yüklemeden önce module yapısını doğrulayın
  4. Yüklemeden hemen sonra izinleri kontrol edin
  5. Yükleme hataları için xoops_log tablosunu inceleyin
  6. Çalışan module sürümlerinin yedeklerini tutun

İlgili Belgeler

Section titled “İlgili Belgeler”
  • Hata Ayıklama Modunu Etkinleştir
  • module FAQ
  • module Yapısı
  • database Bağlantı Hataları

#xoops #sorun giderme #modules #kurulum #hata ayıklama