Kesalahan Izin Ditolak

Masalah izin file dan direktori sering terjadi pada instalasi XOOPS, terutama setelah pengunggahan atau migrasi server. Panduan ini membantu mendiagnosis dan menyelesaikan masalah izin.

Memahami Izin File

Dasar-Dasar Izin Linux/Unix

Izin file direpresentasikan sebagai kode tiga digit:

rwxrwxrwx
||| ||| |||
||| ||| +-- Others (world)
||| +------ Group
+--------- Owner

r = read (4)
w = write (2)
x = execute (1)

755 = rwxr-xr-x (owner full, group read/execute, others read/execute)
644 = rw-r--r-- (owner read/write, group read, others read)
777 = rwxrwxrwx (everyone full access - NOT RECOMMENDED)

Kesalahan Izin Umum

”Izin ditolak” di Upload

Warning: fopen(/var/www/html/xoops/uploads/file.jpg): failed to open stream:
Permission denied in /var/www/html/xoops/class/file.php on line 42

”Tidak dapat menulis file"

Error: Unable to write file to /var/www/html/xoops/cache/

"Tidak dapat membuat direktori”

Error: mkdir(/var/www/html/xoops/uploads/temp/): Permission denied

Direktori XOOPS Penting

Direktori yang Membutuhkan Izin Menulis

Direktori	Minimal	Tujuan
/uploads	755	Unggahan pengguna
/cache	755	File cache
/templates_c	755	template yang dikompilasi
/var	755	Data variabel
mainfile.php	644	Konfigurasi (dapat dibaca)

Pemecahan Masalah Linux/Unix

Langkah 1: Periksa Izin Saat Ini

# Check file permissions
ls -l /var/www/html/xoops/

# Check specific file
ls -l /var/www/html/xoops/mainfile.php

# Check directory permissions
ls -ld /var/www/html/xoops/uploads/

Langkah 2: Identifikasi Pengguna Server Web

# Check Apache user
ps aux | grep -E '[a]pache|[h]ttpd'
# Usually: www-data (Debian/Ubuntu) or apache (RedHat/CentOS)

# Check Nginx user
ps aux | grep -E '[n]ginx'
# Usually: www-data or nginx

Langkah 3: Perbaiki Kepemilikan

# Set correct ownership (assuming www-data user)
sudo chown -R www-data:www-data /var/www/html/xoops/

# Fix only web-writable directories
sudo chown www-data:www-data /var/www/html/xoops/uploads/
sudo chown www-data:www-data /var/www/html/xoops/cache/
sudo chown www-data:www-data /var/www/html/xoops/templates_c/
sudo chown www-data:www-data /var/www/html/xoops/var/

Langkah 4: Perbaiki Izin

Opsi A: Izin Terbatas (Disarankan)

# All directories: 755 (rwxr-xr-x)
find /var/www/html/xoops -type d -exec chmod 755 {} \;

# All files: 644 (rw-r--r--)
find /var/www/html/xoops -type f -exec chmod 644 {} \;

# Except writable directories
chmod 755 /var/www/html/xoops/uploads/
chmod 755 /var/www/html/xoops/cache/
chmod 755 /var/www/html/xoops/templates_c/
chmod 755 /var/www/html/xoops/var/

Opsi B: Skrip Sekaligus

fix-permissions.sh

#!/bin/bash
XOOPS_PATH="/var/www/html/xoops"
WEB_USER="www-data"

echo "Fixing XOOPS permissions..."

# Set ownership
sudo chown -R $WEB_USER:$WEB_USER $XOOPS_PATH

# Set directory permissions
find $XOOPS_PATH -type d -exec chmod 755 {} \;

# Set file permissions
find $XOOPS_PATH -type f -exec chmod 644 {} \;

# Ensure writable directories
chmod 755 $XOOPS_PATH/uploads/
chmod 755 $XOOPS_PATH/cache/
chmod 755 $XOOPS_PATH/templates_c/
chmod 755 $XOOPS_PATH/var/

echo "Done! Permissions fixed."

Masalah Izin berdasarkan Direktori

Direktori Unggah

Masalah: Tidak dapat mengunggah file

# Solution
sudo chown www-data:www-data /var/www/html/xoops/uploads/
chmod 755 /var/www/html/xoops/uploads/
find /var/www/html/xoops/uploads -type f -exec chmod 644 {} \;
find /var/www/html/xoops/uploads -type d -exec chmod 755 {} \;

Direktori Tembolok

Masalah: File cache tidak ditulis

# Solution
sudo chown www-data:www-data /var/www/html/xoops/cache/
chmod 755 /var/www/html/xoops/cache/

Cache template

Masalah: template tidak dapat dikompilasi

# Solution
sudo chown www-data:www-data /var/www/html/xoops/templates_c/
chmod 755 /var/www/html/xoops/templates_c/

Pemecahan Masalah Windows

Langkah 1: Periksa Properti File

1. Klik kanan file → Properti
2. Klik tab “Keamanan”.
3. Klik tombol “Edit”.
4. Pilih pengguna dan verifikasi izin

Langkah 2: Berikan Izin Menulis

Melalui GUI:

1. Right-click folder → Properties
2. Select "Security" tab
3. Click "Edit"
4. Select "IIS_IUSRS" or "NETWORK SERVICE"
5. Check "Modify" and "Write"
6. Click "Apply" and "OK"

Melalui Baris Perintah (PowerShell):

# Run PowerShell as Administrator

# Grant IIS app pool permissions
$path = "C:\inetpub\wwwroot\xoops\uploads"
$acl = Get-Acl $path
$rule = New-Object System.Security.AccessControl.FileSystemAccessRule(
    "IIS_IUSRS",
    "Modify",
    "ContainerInherit,ObjectInherit",
    "None",
    "Allow"
)
$acl.SetAccessRule($rule)
Set-Acl -Path $path -AclObject $acl

Skrip PHP untuk Memeriksa Izin

check-xoops-permissions.php

<?php
$paths = [
    XOOPS_ROOT_PATH . '/uploads' => 'uploads',
    XOOPS_ROOT_PATH . '/cache' => 'cache',
    XOOPS_ROOT_PATH . '/templates_c' => 'templates_c',
    XOOPS_ROOT_PATH . '/var' => 'var',
    XOOPS_ROOT_PATH . '/mainfile.php' => 'mainfile.php'
];

echo "<h2>XOOPS Permission Check</h2>";
echo "<table border='1'>";
echo "<tr><th>Path</th><th>Readable</th><th>Writable</th></tr>";

foreach ($paths as $path => $name) {
    $readable = is_readable($path) ? 'YES' : 'NO';
    $writable = is_writable($path) ? 'YES' : 'NO';

    echo "<tr>";
    echo "<td>$name</td>";
    echo "<td style='background: " . ($readable === 'YES' ? 'green' : 'red') . "'>$readable</td>";
    echo "<td style='background: " . ($writable === 'YES' ? 'green' : 'red') . "'>$writable</td>";
    echo "</tr>";
}

echo "</table>";
?>

Praktik Terbaik

1. Prinsip Hak Istimewa Terkecil

# Only grant necessary permissions
# Don't use 777 or 666

# Bad
chmod 777 /var/www/html/xoops/uploads/  # Dangerous!

# Good
chmod 755 /var/www/html/xoops/uploads/  # Secure

2. Cadangan Sebelum Perubahan

# Backup current state
getfacl -R /var/www/html/xoops > /tmp/xoops-acl-backup.txt

Referensi Cepat

# Quick fix (Linux)
sudo chown -R www-data:www-data /var/www/html/xoops/
find /var/www/html/xoops -type d -exec chmod 755 {} \;
find /var/www/html/xoops -type f -exec chmod 644 {} \;

Dokumentasi Terkait

• Layar Putih Kematian - Kesalahan umum lainnya
• Kesalahan Koneksi Basis Data - Masalah basis data
• ../../01-Getting-Started/Configuration/System-Settings - Konfigurasi XOOPS

---

Terakhir Diperbarui: 31-01-2026 Berlaku Untuk: XOOPS 2.5.7+ OS: Linux, Windows, macOS