cvs: phpdoc-fa /reference/apc/functions apc-add.xml

psalehpoor Tue May 19 16:30:20 2009 UTC Added files: /phpdoc-fa/reference/apc/functions apc-add.xml Log: translated to persian http://cvs.php.net/viewvc.cgi/phpdoc-fa/reference/apc/functions/apc-add.xml?view=markup&rev=1.1 Index: phpdoc-fa/reference/apc/functions/apc-add.xml +++ phpdoc-fa/reference/apc/functions/apc-add.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <refentry xml:id="function.apc-add" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>apc_add</refname> <refpurpose> ذخیره یک متغیر در کاشه در محل ذخیره داده </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>apc_add</methodname> <methodparam><type>string</type><parameter>key</parameter></methodparam> <methodparam><type>mixed</type><parameter>var</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>ttl</parameter><initializer>0</initializer></methodparam> </methodsynopsis> <para> ذخیره یک متغیر در کاشه در محل ذخیره داده، فقط اگر پیش از این ذخیره نشده باشد. </para> <note> <simpara> برخلاف بیشتر ساز و کارهای، متغیرهای ذخیره شده توسط <function>apc_add</function> در بین در خواست‌ها باقی خواهند ماند (تا زمانی که مقدار از کاشه حذف شود). </simpara> </note> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>key</parameter></term> <listitem> <para> ذخیره متغیر با این نام. <parameter>key</parameter>ها مختص کاشه هستند، و تلاش برای استفاده از <function>apc_add</function> برای ذخیره داده یک key که پیش از این وجود دارد مقدار موجود را بازنویسی نخواهد کرد و مقدار &false; بازگردانده می‌شود. (این تنها تفاوت بین <function>apc_add</function> و <function>apc_store</function> است.) </para> </listitem> </varlistentry> <varlistentry> <term><parameter>var</parameter></term> <listitem> <para> متغیر برای ذخیره‌سازی </para> </listitem> </varlistentry> <varlistentry> <term><parameter>ttl</parameter></term> <listitem> <para> زمان باقی ماندن; <parameter>var</parameter> را در کاشه به مدت <parameter>ttl</parameter> ثانیه ذخیره کن. پس از این که <parameter>ttl</parameter> گذشت، متغیر ذخیره شده از کاشه حذف خواهد شد (در درخواست بعدی. اگر <parameter>ttl</parameter> مشخص نشده باشد (یا اگر <parameter>ttl</parameter> <literal>0</literal>) باشد، مقدار تا هنگام حذف دستی باقی خواهد ماند، یا این که دیگر نتواند در کاشه باقی بماند . </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>یک مثال <function>apc_add</function></title> <programlisting role="php"> <![CDATA[ <?php $bar = 'BAR'; apc_add('foo', $bar); var_dump(apc_fetch('foo')); echo "\n"; $bar = 'NEVER GETS SET'; apc_add('foo', $bar); var_dump(apc_fetch('foo')); echo "\n"; ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ string(3) "BAR" string(3) "BAR" ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>apc_store</function></member> <member><function>apc_fetch</function></member> <member><function>apc_delete</function></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->