• 3.1.9
  • کامل شده
  • منقضی شده
این داکیومنت از طرف توسعه‌دهنده ساپورت نمی‌شود، جدیدترین ورژن داکیومنت بزودی ترجمه خواهد شد.

HTML Helper ساخت تگ‌های رایج HTML را با توابع PHP ساده می‌کند. این Helper برای تولید عنوان، لینک، تصویر، Meta، Script، Style و لیست کاربرد دارد. استفاده از آن می‌تواند کد View را خواناتر کند، اما خروجی نهایی باید از نظر Escape و ساختار HTML معتبر بررسی شود.

کاربرد و توابع اصلی

توابع پرکاربرد شامل heading()، anchor()، img()، link_tag()، meta()، script_tag()، style_tag()، ul()، ol()، br() و nbs() هستند. doctype() نیز Doctype مناسب را تولید می‌کند. برای داده پویا، Escape را فراموش نکنید.

نمونه استفاده

 $this->load->helper('html');
 echo heading('محصولات', 2);
 echo img('images/logo.png', FALSE, array('alt' => 'لوگوی فروشگاه'));
 echo anchor('products', 'مشاهده محصولات');

نکته مهم

ورودی را اعتبارسنجی کنید و خروجی را متناسب با محل نمایش Escape کنید. این Helper جایگزین کنترل دسترسی و سیاست امنیتی برنامه نیست.

مطالعه مرتبط

برای ادامه مطالعه، کوئری، SQL Injection را ببینید.

توابع HTML Helper

متد یا مفهومکاربرد
heading()ساخت Heading.
anchor() و anchor_popup()ساخت لینک.
img()ساخت تگ تصویر.
link_tag() و script_tag()ارجاع CSS و JavaScript.
meta()ساخت Meta Tag.
ul() و ol()ساخت لیست.
doctype()ساخت Doctype.

نکات استفاده در پروژه

Helperها معمولاً وضعیت داخلی نگه نمی‌دارند و برای تبدیل یا تولید مقدارهای کوچک مناسب‌اند. آن‌ها را فقط در Controller یا فایل‌های View بارگذاری نکنید، اگر در چند بخش برنامه استفاده می‌شوند می‌توانید در تنظیمات Autoload قرار دهید. در عین حال، بارگذاری همه Helperها به‌صورت سراسری ضرورتی ندارد و بهتر است وابستگی هر بخش روشن بماند.

در زمان استفاده، ورودی را از نظر نوع و محدوده بررسی کنید، خروجی HTML را متناسب با محل نمایش Escape کنید و مسیر فایل را از داده خام کاربر نسازید. اگر تابعی به دیتابیس، شبکه یا وضعیت Session وابسته است، آن رفتار دیگر یک Helper ساده نیست و بهتر است در Service یا Library مستقل قرار بگیرد.

در بازبینی کد، ترتیب و نتیجه متدهای heading()، anchor() و anchor_popup()، img()، link_tag() و script_tag() را بررسی کنید. نام متد به‌تنهایی تضمین نمی‌کند ورودی معتبر یا خروجی امن باشد، بنابراین رفتار هر متد را با تست و مستندات همان نسخه کنترل کنید.

سایر پست های داکیومنت