इसे छोड़कर कंटेंट पर जाएं
XOOPS 2.7 Docs

Smarty टेम्पलेट डिबगिंग

XOOPS थीम और मॉड्यूल में Smarty टेम्प्लेट डीबग करने की उन्नत तकनीकें।

डायग्नोस्टिक फ़्लोचार्ट

Section titled “डायग्नोस्टिक फ़्लोचार्ट”
flowchart TD
    A[Template Issue] --> B{Syntax Error?}
    B -->|Yes| C[Check Braces]
    B -->|No| D{Variable Issue?}


    C --> C1[Match all braces]
    C1 --> C2[Check tag format]
    C2 --> C3[View error log]


    D -->|Undefined| E[Check Assignment]
    D -->|Wrong Value| F[Log Variable]


    E --> E1[Verify PHP code]
    E1 --> E2[Assign variable]
    E2 --> E3[Clear cache]


    F --> F1[Enable debug mode]
    F1 --> F2[Dump variable]
    F2 --> F3[Check logic]


    C3 --> G{Issue Fixed?}
    E3 --> G
    F3 --> G


    G -->|No| H[Enable Debug Console]
    G -->|Yes| I[Problem Solved]


    H --> J[Check compiled template]
    J --> K[Review output]
    K --> G

Smarty डिबग मोड सक्षम करें

Section titled “Smarty डिबग मोड सक्षम करें”

विधि 1: व्यवस्थापक पैनल

Section titled “विधि 1: व्यवस्थापक पैनल”

XOOPS एडमिन > सेटिंग्स > प्रदर्शन:

  • “डीबग आउटपुट” सक्षम करें
  • “डीबग लेवल” को 2 पर सेट करें

विधि 2: कोड कॉन्फ़िगरेशन

Section titled “विधि 2: कोड कॉन्फ़िगरेशन”
<?php
// In mainfile.php or module code
require_once XOOPS_ROOT_PATH . '/class/smarty/Smarty.class.php';


$tpl = new XoopsTpl();


// Enable debug mode
$tpl->debugging = true;


// Optional: Set custom debug template
$tpl->debug_tpl = XOOPS_ROOT_PATH . '/class/smarty/debug.tpl';


// Render template
$tpl->display('file:template.html');
?>

विधि 3: ब्राउज़र में पॉपअप डीबग करें

Section titled “विधि 3: ब्राउज़र में पॉपअप डीबग करें”
{* Add to template to enable debug in footer *}
{debug}

यह सभी निर्दिष्ट चरों के साथ एक पॉपअप दिखाता है।

सामान्य Smarty डिबग तकनीकें

Section titled “सामान्य Smarty डिबग तकनीकें”

सभी वेरिएबल्स को डंप करें

Section titled “सभी वेरिएबल्स को डंप करें”
<?php
// In PHP code
$tpl = new XoopsTpl();


// Get all assigned variables
$variables = $tpl->get_template_vars();


echo "<pre>";
print_r($variables);
echo "</pre>";
?>

टेम्पलेट में:

{* Display debug info *}
<div style="border: 1px red solid; background: #ffffcc; padding: 10px;">
    <h3>Debug Info</h3>
    {debug}
</div>

लॉग विशिष्ट चर

Section titled “लॉग विशिष्ट चर”
<?php
$tpl = new XoopsTpl();


// Check if variable exists
$user = $tpl->get_template_var('user');


if ($user === null) {
    error_log("Variable 'user' not assigned to template");
} else {
    error_log("User data: " . json_encode($user));
}
?>

टेम्पलेट में वेरिएबल की जाँच करें

Section titled “टेम्पलेट में वेरिएबल की जाँच करें”
{* Dump variable for debugging *}
<pre>
{$variable|print_r}
</pre>


{* Or with label *}
<pre>
User Data:
{$user|print_r}
</pre>


{* Check if variable exists *}
{if isset($user)}
    <p>User: {$user.name}</p>
{else}
    <p style="color: red;">ERROR: user variable not set</p>
{/if}

संकलित टेम्पलेट्स देखें

Section titled “संकलित टेम्पलेट्स देखें”

Smarty प्रदर्शन के लिए टेम्पलेट्स को PHP में संकलित करता है। संकलित कोड देखकर डीबग करें:

Terminal window
# Find compiled templates
ls -la xoops_data/caches/smarty_compile/


# View compiled template
cat xoops_data/caches/smarty_compile/filename.php
<?php
// Create debug script to view latest compiled template
$compile_dir = XOOPS_CACHE_PATH . '/smarty_compile';


// Get latest compiled file
$files = glob($compile_dir . '/*.php');
usort($files, function($a, $b) {
    return filemtime($b) - filemtime($a);
});


if ($files) {
    echo "<h1>Latest Compiled Template</h1>";
    echo "<pre>";
    echo htmlspecialchars(file_get_contents($files[0]));
    echo "</pre>";
}
?>

टेम्पलेट संकलन का विश्लेषण करें

Section titled “टेम्पलेट संकलन का विश्लेषण करें”
<?php
// Create modules/yourmodule/debug_smarty.php


require_once '../../mainfile.php';
require_once XOOPS_ROOT_PATH . '/vendor/autoload.php';


$tpl = new XoopsTpl();
$ray = ray();  // If using Ray debugger


$ray->group('Smarty Configuration');


// Get Smarty paths
$ray->label('Compile Dir')->info($tpl->getCompileDir());
$ray->label('Cache Dir')->info($tpl->getCacheDir());
$ray->label('Template Dirs')->dump($tpl->getTemplateDir());


// Check compiled templates
$compile_dir = $tpl->getCompileDir();
$compiled_files = glob($compile_dir . '*.php');
$ray->label('Compiled Templates')->info(count($compiled_files) . " files");


// Show compilation stats
$total_size = 0;
foreach ($compiled_files as $file) {
    $total_size += filesize($file);
}
$ray->label('Compiled Cache Size')->info(round($total_size / 1024 / 1024, 2) . " MB");


// Check cache directory
$cache_dir = $tpl->getCacheDir();
$cache_files = glob($cache_dir . '*.php');
$ray->label('Cached Templates')->info(count($cache_files) . " files");


$ray->groupEnd();
?>

विशिष्ट मुद्दों को डीबग करें

Section titled “विशिष्ट मुद्दों को डीबग करें”

अंक 1: वेरिएबल खाली के रूप में दिखाता है

Section titled “अंक 1: वेरिएबल खाली के रूप में दिखाता है”
<?php
$tpl = new XoopsTpl();


// Check what's assigned
$user = $tpl->get_template_var('user');


if ($user === null) {
    error_log("ERROR: 'user' not assigned");
} elseif (empty($user)) {
    error_log("WARNING: 'user' is empty");
} else {
    error_log("user data: " . json_encode($user));
}


// Also check in template
?>

टेम्प्लेट डीबग:

{if !isset($user)}
    <span style="color: red;">ERROR: user variable not set</span>
{elseif empty($user)}
    <span style="color: orange;">WARNING: user is empty</span>
{else}
    <p>User: {$user.name}</p>
{/if}

अंक 2: सारणी कुंजी नहीं मिली

Section titled “अंक 2: सारणी कुंजी नहीं मिली”
{* Use safe array access *}


{* WRONG - causes undefined index notice *}
{$array.key}


{* CORRECT - check first *}
{if isset($array.key)}
    {$array.key}
{else}
    <span style="color: red;">Key 'key' not found in array</span>
{/if}


{* Or use default *}
{$array.key|default:'key not found'}

PHP में डीबग करें:

<?php
$array = $tpl->get_template_var('array');


if (!isset($array['key'])) {
    error_log("Missing key in array: " . json_encode(array_keys($array)));
}
?>

अंक 3: प्लगइन/संशोधक नहीं मिला

Section titled “अंक 3: प्लगइन/संशोधक नहीं मिला”
plugins/modifier.debug.php
<?php
function smarty_modifier_debug($var) {
    return '<pre style="background: #ffffcc; border: 1px solid red;">' .
           htmlspecialchars(json_encode($var, JSON_PRETTY_PRINT)) .
           '</pre>';
}
?>

कोड में रजिस्टर करें:

<?php
$tpl = new XoopsTpl();
$tpl->addPluginDir(XOOPS_ROOT_PATH . '/modules/yourmodule/plugins');
$tpl->register_modifier('debug', 'smarty_modifier_debug');
?>

टेम्पलेट में उपयोग करें:

{$data|debug}

अंक 4: नेस्टेड ऐरे डिस्प्ले

Section titled “अंक 4: नेस्टेड ऐरे डिस्प्ले”
{* Debug nested arrays *}
<div style="background: #f5f5f5; padding: 10px; border: 1px solid #ccc;">
    <h3>Data Debug</h3>
    <pre>{$data|@json_encode}</pre>
</div>


{* Or iterate and show *}
<h3>User Data:</h3>
{foreach $user as $key => $value}
    <p><strong>{$key}:</strong> {$value|escape}</p>
{/foreach}


{* Check for specific keys *}
<h3>Verification:</h3>
<ul>
    <li>Has 'name': {if isset($user.name)}✓{else}✗{/if}</li>
    <li>Has 'email': {if isset($user.email)}✓{else}✗{/if}</li>
    <li>Has 'id': {if isset($user.id)}✓{else}✗{/if}</li>
</ul>

डिबग टेम्पलेट बनाएं

Section titled “डिबग टेम्पलेट बनाएं”
{* Create themes/mytheme/debug.html *}
{strip}


<div style="background: #fff3cd; border: 2px solid #ff0000; padding: 20px; margin: 20px 0;">
    <h2 style="color: #ff0000;">🔍 SMARTY DEBUG MODE</h2>


    <h3>Assigned Variables:</h3>
    <div style="background: white; padding: 10px; border: 1px solid #999; overflow-x: auto; max-height: 400px;">
        {* Show all variables *}
        {debug output='html'}
    </div>


    <h3>Template Information:</h3>
    <table style="width: 100%; border-collapse: collapse;">
        <tr>
            <td style="border: 1px solid #999; padding: 5px;"><strong>Current Template:</strong></td>
            <td style="border: 1px solid #999; padding: 5px;">{$smarty.template}</td>
        </tr>
        <tr>
            <td style="border: 1px solid #999; padding: 5px;"><strong>Smarty Version:</strong></td>
            <td style="border: 1px solid #999; padding: 5px;">{$smarty.version}</td>
        </tr>
        <tr>
            <td style="border: 1px solid #999; padding: 5px;"><strong>Current Time:</strong></td>
            <td style="border: 1px solid #999; padding: 5px;">{$smarty.now|date_format:"%Y-%m-%d %H:%M:%S"}</td>
        </tr>
    </table>


    <p style="color: #ff0000;"><strong>⚠️ Remove this debug code before going to production!</strong></p>
</div>


{/strip}

प्रदर्शन डिबगिंग

Section titled “प्रदर्शन डिबगिंग”

टेम्प्लेट रेंडरिंग को मापें

Section titled “टेम्प्लेट रेंडरिंग को मापें”
<?php
$start = microtime(true);


$tpl->display('file:template.html');


$render_time = (microtime(true) - $start) * 1000;


error_log("Template rendered in: {$render_time}ms");


if ($render_time > 100) {
    error_log("WARNING: Slow template rendering");
}
?>

कैश प्रभावशीलता की जाँच करें

Section titled “कैश प्रभावशीलता की जाँच करें”
<?php
$compile_dir = XOOPS_CACHE_PATH . '/smarty_compile';
$cache_dir = XOOPS_CACHE_PATH . '/smarty_cache';


// Count files
$compiled = count(glob($compile_dir . '*.php'));
$cached = count(glob($cache_dir . '*.php'));


// Size
$compile_size = 0;
foreach (glob($compile_dir . '*') as $file) {
    $compile_size += filesize($file);
}


$cache_size = 0;
foreach (glob($cache_dir . '*') as $file) {
    $cache_size += filesize($file);
}


echo "Compiled: $compiled files (" . round($compile_size/1024/1024, 2) . "MB)";
echo "Cached: $cached files (" . round($cache_size/1024/1024, 2) . "MB)";


// Age of files
$oldest_compile = min(array_map('filemtime', glob($compile_dir . '*')));
$oldest_cache = min(array_map('filemtime', glob($cache_dir . '*')));


echo "Oldest compiled: " . date('Y-m-d H:i:s', $oldest_compile);
echo "Oldest cached: " . date('Y-m-d H:i:s', $oldest_cache);
?>

कैश साफ़ करें और पुनर्निर्माण करें

Section titled “कैश साफ़ करें और पुनर्निर्माण करें”
<?php
// Force rebuild of all templates


$tpl = new XoopsTpl();


// Clear cache
$tpl->clearCache();
$tpl->clearCompiledTemplate();


// Force recompilation
$tpl->force_compile = true;


// Render all module templates
$modules = ['mymodule', 'publisher', 'downloads'];


foreach ($modules as $module) {
    $template = "file:" . XOOPS_ROOT_PATH . "/modules/$module/templates/index.html";


    try {
        $tpl->display($template);
        error_log("Compiled: $module");
    } catch (Exception $e) {
        error_log("Error compiling $module: " . $e->getMessage());
    }
}


// Disable force compile after done
$tpl->force_compile = false;
?>

डिबगिंग वर्कफ़्लो

Section titled “डिबगिंग वर्कफ़्लो”

चरण-दर-चरण डिबग प्रक्रिया

Section titled “चरण-दर-चरण डिबग प्रक्रिया”
graph TD
    A[Template Not Working] --> B["Step 1: Check Syntax"]
    B --> C["Step 2: Enable Debug"]
    C --> D["Step 3: Check Variables"]
    D --> E["Step 4: View Compiled"]
    E --> F["Step 5: Verify Output"]


    B --> B1["✓ Match braces"]
    C --> C1["✓ Enable debug mode"]
    D --> D1["✓ Dump variables"]
    E --> E1["✓ Review PHP code"]
    F --> F1["✓ Check HTML output"]

डिबग हेल्पर फ़ंक्शन

Section titled “डिबग हेल्पर फ़ंक्शन”
<?php
// Create class/TemplateDebugger.php


class TemplateDebugger {
    private static $tpl = null;
    private static $debug_info = [];


    public static function init(&$smarty) {
        self::$tpl = $smarty;
    }


    public static function dumpVar($name) {
        $var = self::$tpl->get_template_var($name);


        if ($var === null) {
            self::$debug_info[] = "Variable '$name' not found";
            return;
        }


        self::$debug_info[] = "$name: " . json_encode($var);
    }


    public static function checkVar($name, $keys = []) {
        $var = self::$tpl->get_template_var($name);


        if ($var === null) {
            return "ERROR: Variable '$name' not assigned";
        }


        if (!is_array($var)) {
            return "$name is not an array";
        }


        $missing = [];
        foreach ($keys as $key) {
            if (!isset($var[$key])) {
                $missing[] = $key;
            }
        }


        if ($missing) {
            return "Missing keys in '$name': " . implode(', ', $missing);
        }


        return "OK: Variable '$name' has all required keys";
    }


    public static function getReport() {
        return implode("\n", self::$debug_info);
    }


    public static function logAll() {
        $vars = self::$tpl->get_template_vars();
        error_log("Template Variables: " . json_encode($vars));
    }
}
?>

उपयोग:

<?php
TemplateDebugger::init($tpl);
TemplateDebugger::dumpVar('user');
TemplateDebugger::checkVar('articles', ['id', 'title', 'author']);
error_log(TemplateDebugger::getReport());
?>

संबंधित दस्तावेज़ीकरण

Section titled “संबंधित दस्तावेज़ीकरण”
  • डिबग मोड सक्षम करें
  • टेम्पलेट त्रुटियाँ
  • रे डिबगर का उपयोग करना
  • Smarty टेम्प्लेटिंग

#xoops #टेम्प्लेट्स #Smarty #डिबगिंग #समस्या निवारण