repo_zf1/documentation/manual/ar/module_specs/Zend_Config-Introduction.xml

<sect1 id="zend.config.introduction">
	<title>مقدمة</title>
	<para>
		تم تصميم
		<code>Zend_Config</code>
		لتُبسّط عملية الوصول و أستخدام بيانات الأعدادات "configuration data"
		داخل التطبيقات , حيث توفرالوصول إلى هذه البيانات بنفس الطريقة المتبعة
		لقرائة قيمة
		property فى أى كائن PHP عادى,
		و يمكن أن تأتى هذه البيانات من عدّة وسائط حفظ بيانات تدعم جفظ البيانات
		بهيكلة هرمية,
		فحالياً توفر
		<code>Zend_Config</code>
		ادوات لقرائة انواع من البيانات المحفوظة فى ملفات نصية و هى
		<link linkend="zend.config.adapters.ini">
			<code>Zend_Config_Ini</code>
		</link>
		و
		<link linkend="zend.config.adapters.xml">
			<code>Zend_Config_Xml</code>
		</link>
		.
	</para>
	<example>
		<title>إستخدام Zend_Config Per Se</title>
		<para>
			من الطبيعى توقع أن المبرمجين سيستخدمون أحد الـ adapter classes أو الـ
			"classes التوفيقية" مثل
			<link linkend="zend.config.adapters.ini">
				<code>Zend_Config_Ini</code>
			</link>
			أو
			<link linkend="zend.config.adapters.xml">
				<code>Zend_Config_Xml</code>
			</link>
			,
			لكن إن كانت بيانات الأعدادات متوفرة فى مصفوفة PHP عادية, يمكن تمرير هذه
			البيانات إلى
			<code>Zend_Config</code>
			فى الـ constructor , و ذلك يفضل لتغليف البيانات داخل
			واجهة كأنية.
		</para>
		<programlisting role="php"><![CDATA[<?php
// Given an array of configuration data
$configArray = array(
    'webhost' => 'www.example.com',
    'database' => array(
        'type'     => 'pdo_mysql',
        'host'     => 'db.example.com',
        'username' => 'dbuser',
        'password' => 'secret',
        'name'     => 'dbname'
    )
);

// Create the object-oriented wrapper upon the configuration data
require_once 'Zend/Config.php';
$config = new Zend_Config($configArray);

// Print a configuration datum (results in 'www.example.com')
echo $config->webhost;

// Use the configuration data to connect to the database
$myApplicationObject->databaseConnect($config->database->type,
                                      $config->database->host,
                                      $config->database->username,
                                      $config->database->password,
                                      $config->database->name);]]></programlisting>
	</example>
	<para>
		كما هو موضح فى المثال السابق ,
		<code>Zend_Config</code>
		توفر امكانية الوصول إلى البيانات
		الممرة إليه بنفس الطريقة المتبعة لقرائة قيم property من أى كائن PHP عادى.
	</para>
</sect1>
<!-- vim:se ts=4 sw=4 et: -->