Kurulum Kılavuzunu Tamamlayın

XOOPS Kurulum Kılavuzunu tamamlayın

Bu kılavuz, kurulum sihirbazını kullanarak XOOPS’yi sıfırdan kurmak için kapsamlı bir yol göstermektedir.

Önkoşullar

Kuruluma başlamadan önce aşağıdakilere sahip olduğunuzdan emin olun:

FTP veya SSH aracılığıyla web sunucunuza erişim
database sunucunuza yönetici erişimi
Kayıtlı bir alan adı
Sunucu gereksinimleri doğrulandı
Yedekleme araçları mevcut

Kurulum Süreci

flowchart TD
    A[Download XOOPS] --> B[Extract Files]
    B --> C[Set File Permissions]
    C --> D[Create Database]
    D --> E[Visit Installation Wizard]
    E --> F{License Accepted?}
    F -->|No| G[Review License]
    G --> F
    F -->|Yes| H[System Check]
    H --> I{All Checks Pass?}
    I -->|No| J[Fix Issues]
    J --> I
    I -->|Yes| K[Database Configuration]
    K --> L[Admin Account Setup]
    L --> M[Module Installation]
    M --> N[Installation Complete]
    N --> O[Remove install Folder]
    O --> P[Secure Installation]
    P --> Q[Begin Using XOOPS]

Adım Adım Kurulum

Adım 1: XOOPS’yi indirin

En son sürümü şu adresten indirin: https://xoops.org/:

# Using wget
wget https://xoops.org/download/xoops-2.5.8.zip

# Using curl
curl -O https://xoops.org/download/xoops-2.5.8.zip

Adım 2: Dosyaları Çıkarın

XOOPS arşivini web kökünüze çıkarın:

# Navigate to web root
cd /var/www/html

# Extract XOOPS
unzip xoops-2.5.8.zip

# Rename folder (optional, but recommended)
mv xoops-2.5.8 xoops
cd xoops

3. Adım: Dosya İzinlerini Ayarlayın

XOOPS dizinleri için uygun izinleri ayarlayın:

# Make directories writable (755 for dirs, 644 for files)
find . -type d -exec chmod 755 {} \;
find . -type f -exec chmod 644 {} \;

# Make specific directories writable by web server
chmod 777 uploads/
chmod 777 templates_c/
chmod 777 var/
chmod 777 cache/

# Secure mainfile.php after installation
chmod 644 mainfile.php

Adım 4: database Oluşturun

MySQL kullanarak XOOPS için yeni bir database oluşturun:

-- Create database
CREATE DATABASE xoops_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

-- Create user
CREATE USER 'xoops_user'@'localhost' IDENTIFIED BY 'secure_password_here';

-- Grant privileges
GRANT ALL PRIVILEGES ON xoops_db.* TO 'xoops_user'@'localhost';
FLUSH PRIVILEGES;

Veya phpMyAdmin’i kullanarak:

phpMyAdmin’de oturum açın
“Veritabanları” sekmesine tıklayın
database adını girin: xoops_db
“utf8mb4_unicode_ci” harmanlamasını seçin
“Oluştur”a tıklayın
Veritabanıyla aynı adı taşıyan bir user oluşturun
Tüm ayrıcalıkları verin

Adım 5: Kurulum Sihirbazını Çalıştırın

Tarayıcınızı açın ve şuraya gidin:

http://your-domain.com/xoops/install/

Sistem Kontrol Aşaması

Sihirbaz sunucu yapılandırmanızı kontrol eder:

PHP sürüm >= 5.6.0
MySQL/MariaDB mevcut
Gerekli PHP uzantıları (GD, PDO vb.)
Dizin izinleri
database bağlantısı

Kontroller başarısız olursa:

Çözümler için #Ortak Kurulum Sorunları bölümüne bakın.

database Yapılandırması

database kimlik bilgilerinizi girin:

Database Host: localhost
Database Name: xoops_db
Database User: xoops_user
Database Password: [your_secure_password]
Table Prefix: xoops_

Önemli Notlar:

database ana makineniz yerel ana bilgisayardan farklıysa (örneğin uzak sunucu), doğru ana bilgisayar adını girin
Tablo öneki, bir veritabanında birden fazla XOOPS örneğinin çalıştırılması durumunda yardımcı olur
Büyük/küçük harf, rakam ve simgelerden oluşan güçlü bir şifre kullanın

Yönetici Hesabı Kurulumu

Yönetici hesabınızı oluşturun:

Admin Username: admin (or choose custom)
Admin Email: admin@your-domain.com
Admin Password: [strong_unique_password]
Confirm Password: [repeat_password]

En İyi Uygulamalar:

“Yönetici” değil, benzersiz bir user adı kullanın
16+ karakterden oluşan bir şifre kullanın
Kimlik bilgilerini güvenli bir şifre yöneticisinde saklayın
Yönetici kimlik bilgilerini asla paylaşmayın

module Kurulumu

Yüklenecek varsayılan modülleri seçin:

Sistem Modülü (gerekli) - Temel XOOPS işlevselliği
user Modülü (gerekli) - user yönetimi
Profil Modülü (önerilen) - user profilleri
PM (Özel Mesaj) Modülü (önerilir) - Dahili mesajlaşma
WF Kanalı Modülü (isteğe bağlı) - İçerik yönetimi

Tam bir kurulum için önerilen tüm modülleri seçin.

Adım 6: Kurulumu Tamamlayın

Tüm adımlardan sonra bir onay ekranı göreceksiniz:

Installation Complete!

Your XOOPS installation is ready to use.
Admin Panel: http://your-domain.com/xoops/admin/
User Panel: http://your-domain.com/xoops/

Adım 7: Kurulumunuzu Güvenceye Alın

Kurulum Klasörünü Kaldır

# Remove the install directory (CRITICAL for security)
rm -rf /var/www/html/xoops/install/

# Or rename it
mv /var/www/html/xoops/install/ /var/www/html/xoops/install.bak

WARNING: Kurulum klasörünü asla üretimde erişilebilir bırakmayın!

Secure mainfile.php

# Make mainfile.php read-only
chmod 644 /var/www/html/xoops/mainfile.php

# Set ownership
chown www-data:www-data /var/www/html/xoops/mainfile.php

Uygun Dosya İzinlerini Ayarlayın

# Recommended production permissions
find . -type f -name "*.php" -exec chmod 644 {} \;
find . -type d -exec chmod 755 {} \;

# Writable directories for web server
chmod 777 uploads/ var/ cache/ templates_c/

Etkinleştir HTTPS/SSL

Web sunucunuzda (nginx veya Apache) SSL’yi yapılandırın.

Apache için:

<VirtualHost *:443>
    ServerName your-domain.com
    DocumentRoot /var/www/html/xoops

    SSLEngine on
    SSLCertificateFile /etc/ssl/certs/your-cert.crt
    SSLCertificateKeyFile /etc/ssl/private/your-key.key

    # Force HTTPS redirect
    <IfModule mod_rewrite.c>
        RewriteEngine On
        RewriteCond %{HTTPS} off
        RewriteRule ^(.*)$ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]
    </IfModule>
</VirtualHost>

Kurulum Sonrası Yapılandırma

1. Yönetici Paneline Erişim

Şuraya gidin:

http://your-domain.com/xoops/admin/

Yönetici kimlik bilgilerinizle giriş yapın.

2. Temel Ayarları Yapılandırın

Aşağıdakileri yapılandırın:

Site adı ve açıklaması
Yönetici e-posta adresi
Saat dilimi ve tarih formatı
Arama motoru optimizasyonu

3. Kurulumu Test Edin

Ana sayfayı ziyaret edin
module yükünü kontrol edin
user kaydının çalıştığını doğrulayın
Yönetici paneli işlevlerini test edin
SSL/HTTPS’nin çalıştığını onaylayın

4. Yedeklemeleri Planlayın

Otomatik yedeklemeleri ayarlayın:

# Create backup script (backup.sh)
#!/bin/bash
DATE=$(date +%Y%m%d_%H%M%S)
BACKUP_DIR="/backups/xoops"
XOOPS_DIR="/var/www/html/xoops"

# Backup database
mysqldump -u xoops_user -p[password] xoops_db > $BACKUP_DIR/db_$DATE.sql

# Backup files
tar -czf $BACKUP_DIR/files_$DATE.tar.gz $XOOPS_DIR

echo "Backup completed: $DATE"

Cron ile zamanlama:

# Daily backup at 2 AM
0 2 * * * /usr/local/bin/backup.sh

Yaygın Kurulum Sorunları

Sorun: İzin Reddedildi Hataları

Belirti: Dosyaları yüklerken veya oluştururken “İzin reddedildi”

Çözüm:

# Check web server user
ps aux | grep apache  # For Apache
ps aux | grep nginx   # For Nginx

# Fix permissions (replace www-data with your web server user)
chown -R www-data:www-data /var/www/html/xoops
chmod -R 755 /var/www/html/xoops
chmod 777 uploads/ var/ cache/ templates_c/

Sorun: database Bağlantısı Başarısız

Belirti: “database sunucusuna bağlanılamıyor”

Çözüm:

Kurulum sihirbazında database kimlik bilgilerini doğrulayın
MySQL/MariaDB’nin çalışıp çalışmadığını kontrol edin:

   service mysql status  # or mariadb

Veritabanının mevcut olduğunu doğrulayın:

   SHOW DATABASES;

Bağlantıyı komut satırından test edin:

   mysql -h localhost -u xoops_user -p xoops_db

Sorun: Boş Beyaz Ekran

Belirti: XOOPS adresini ziyaret ettiğinizde boş sayfa gösteriliyor

Çözüm:

PHP hata günlüklerini kontrol edin:

   tail -f /var/log/apache2/error.log

Mainfile.php’de hata ayıklama modunu etkinleştirin:

   define('XOOPS_DEBUG', 1);

mainfile.php ve config dosyalarındaki dosya izinlerini kontrol edin
PHP-MySQL uzantısının kurulu olduğunu doğrulayın

Sorun: Yükleme Dizinine Yazılamıyor

Belirti: Yükleme özelliği başarısız oluyor, “Yüklemelere yazılamıyor/”

Çözüm:

# Check current permissions
ls -la uploads/

# Fix permissions
chmod 777 uploads/
chown www-data:www-data uploads/

# For specific files
chmod 644 uploads/*

Sayı: PHP Uzantılar Eksik

Belirti: Eksik uzantılar nedeniyle sistem kontrolü başarısız oluyor (GD, MySQL vb.)

Çözüm (Ubuntu/Debian):)

# Install PHP GD library
apt-get install php-gd

# Install PHP MySQL support
apt-get install php-mysql

# Restart web server
systemctl restart apache2  # or nginx

Çözüm (CentOS/RHEL):)

# Install PHP GD library
yum install php-gd

# Install PHP MySQL support
yum install php-mysql

# Restart web server
systemctl restart httpd

Sorun: Yavaş Kurulum Süreci

Belirti: Yükleme sihirbazı zaman aşımına uğruyor veya çok yavaş çalışıyor

Çözüm:

php.ini’de PHP zaman aşımını artırın:

   max_execution_time = 300  # 5 minutes

MySQL max_allowed_packet’i artırın:

   SET GLOBAL max_allowed_packet = 256M;

Sunucu kaynaklarını kontrol edin:

   free -h  # Check RAM
   df -h    # Check disk space

Sorun: Yönetici Paneline Erişilemiyor

Belirti: Kurulumdan sonra yönetici paneline erişilemiyor

Çözüm:

Veritabanında yönetici kullanıcısının bulunduğunu doğrulayın:

   SELECT * FROM xoops_users WHERE uid = 1;

Tarayıcı önbelleğini ve çerezleri temizleyin
Oturumlar klasörünün yazılabilir olup olmadığını kontrol edin:

   chmod 777 var/

Htaccess kurallarının yönetici erişimini engellemediğini doğrulayın

Doğrulama Kontrol Listesi

Kurulumdan sonra şunları doğrulayın:

Sonraki Adımlar

Kurulum tamamlandıktan sonra:

Temel Yapılandırma kılavuzunu okuyun
Kurulumunuzu güvence altına alın
Yönetici panelini keşfedin
Ek modülleri yükleyin
user gruplarını ve izinlerini ayarlayın

Etiketler: #kurulum #kurulum #başlarken #sorun giderme

İlgili Makaleler:

Sunucu Gereksinimleri
Yükseltiliyor-XOOPS
../Configuration/Security-Configuration