نصب و راه‌اندازی

پیش‌نیازها

برای نصب AlvandCMS به موارد زیر نیاز دارید:

1. وب سرور: Apache 2.4+ با mod_rewrite فعال
1. PHP: نسخه 8.0 یا بالاتر
1. MySQL: نسخه 5.7+ یا MariaDB 10.3+
1. حافظه: حداقل 256MB رم
1. فضای دیسک: حداقل 100MB

مراحل نصب

1. دانلود

فایل هسته را از وب‌سایت رسمی دانلود کرده و در هاست خود آپلود کنید.

https://alvandcms.com/download

2. استخراج فایل‌ها

فایل فشرده را در ریشه وب‌سرور (مثلاً public_html یا www) استخراج کنید.

3. تنظیم دیتابیس

یک دیتابیس MySQL جدید ایجاد کنید، سپس فایل alvandcms.sql را در آن import کنید:

bash
mysql -u username -p database_name < alvandcms.sql

4. تنظیم فایل config

فایل core/config.php را باز کرده و اطلاعات دیتابیس را وارد کنید:

php
define('HOSTNAME', 'localhost');
define('USERNAME', 'your_db_user');
define('PASSWORD', 'your_db_pass');
define('DATABASE', 'your_db_name');

5. تنظیم دسترسی‌ها

پوشه‌های زیر باید توسط وب‌سرور قابل نوشتن باشند:

bash
chmod 755 uploads/
chmod 755 plugins/cache/storage/
chmod 644 core/config.php

6. تنظیم Rewrite Rules

فایل .htaccess در ریشه سایت باید شامل قوانین زیر باشد:

apache
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php [QSA,L]

نصب خودکار

AlvandCMS از نصب خودکار از طریق پنل مدیریت پشتیبانی می‌کند. کافیست:

1. فایل‌ها را آپلود کنید

1. به آدرس https://yourdomain.com بروید

1. wizard نصب به صورت خودکار اجرا می‌شود

1. اطلاعات دیتابیس و مدیر سیستم را وارد کنید

ساختار فایل‌ها

public_html/
  index.php              # نقطه ورود اصلی
  .htaccess              # قوانین Rewrite
  core/
    config.php           # تنظیمات اصلی
    db.php               # اتصال به دیتابیس
    modules.php          # هسته مسیریابی
    functions.php        # توابع کمکی
    jdf.php              # تبدیل تاریخ شمسی
    system/
      admin/     ...

ثابت‌های سیستمی

php
define('SITE_URL', '/');
define('ASSETS_ADMIN', 'core/system/admin/assets/');
define('ALVAND_VERSION', '1.0.2');

عیب‌یابی نصب

1. صفحه سفید: بررسی خطاهای PHP و لاگ سرور
1. خطای 500: بررسی دسترسی فایل‌ها و قوانین htaccess
1. خطای اتصال دیتابیس: بررسی اطلاعات config.php
1. صفحه 404: بررسی فعال بودن mod_rewrite