افزودن ویژگی (addAttribute)
در XML، «ویژگی (Attribute)» مثل برچسب روی دفتر است. متد addAttribute() روی SimpleXMLElement یک ویژگی تازه به عنصر اضافه می کند. بنابراین، اطلاعات جانبی مثل نوع یا تاریخ را تمیز نگه می داریم.
تعریف و کاربرد
تابع addAttribute() یک ویژگی به عنصر SimpleXML می چسباند. نام ویژگی اجباری است. مقدار و فضای نام اختیاری هستند.
نگارش
SimpleXMLElement::addAttribute(name, value, ns)
مثال عملی
به ریشه و به تگ <body> ویژگی اضافه می کنیم. سپس خروجی XML را چاپ می کنیم.
<?php
$note = <<<XML
<note>
<to>Tove</to>
<from>Jani</from>
<heading>Reminder</heading>
<body>Do not forget me this weekend!</body>
</note>
XML;
$xml = new SimpleXMLElement($note);
$xml->addAttribute("type", "private");
$xml->body->addAttribute("date", "2014-01-01");
echo $xml->asXML();
?>
گام های سریع تمرین
- XML را به
SimpleXMLElementتبدیل کن. - یک ویژگی با نام و مقدار بساز.
- نتیجه را با
asXML()چاپ کن.
نکته ها و هشدارها
نکته: نام ویژگی باید یکتا در همان عنصر باشد.
نکته: پارامتر ns برای فضای نام است؛ همیشه لازم نیست.
هشدار: مقدارها را اعتبارسنجی کن؛ XML روی شکل درست حساس است.
لینک های مرتبط
نگاه کن به سازنده (__construct) برای ساخت شیء. همچنین به رشته ( __tostring ) برای چاپ متنِ عنصر.
منبع: W3Schools: addAttribute · مرجع: SimpleXML Reference
جمع بندی سریع
addAttribute()ویژگی تازه می افزاید.- نام اجباری است؛ مقدار اختیاری است.
- فضای نام با
nsممکن است. - برای توصیف داده ها عالی است.