Hi all,
After following various PHP mailing lists for about two years now, I'd like
to get a bit more involved. In the past I have supplied two patches[1], one
of which more or less got implemented, and commented on mailing lists / bug
reports a few times.
While doing most things in PHP these days, I'm a pretty decent C(++)
programmer and believe I might be able to supply more bugfixes for PHP code
and/or extensions in the future. I'd first like to get familiar with the
community a bit, which is why I'd like to start off with documenting and
translating. My native language is Dutch, however, I am able to write
English at a fairly advanced level as well.
Attached is an English -> Dutch translation of the apc_add function. The
Dutch documentation is outdated a lot while the Dutch PHP community is quite
big, so I thought it would be a good thing to start with getting it back
up-to-date. I will be aiming to provide at least three or four translated
functions per day, more when time allows it.
Thanks,
Peter
[1]
http://bugs.php.net/bug.php?id=48693
http://bugs.php.net/bug.php?id=47752
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.4 $ -->
<refentry xml:id="function.apc-add" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>apc_add</refname>
<refpurpose>
Bewaar een variable in de cache opslag
</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>
Slaat een variable op in de cache opslag indien deze nog niet bestaat.
</para>
<note>
<simpara>
Anders dan de meeste technieken in PHP zullen variablen opgeslagen via
<function>apc_add</function> bewaard blijven tussen verschillende
requests (tot de waarde wordt verwijderd uit de cache).
</simpara>
</note>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>key</parameter></term>
<listitem>
<para>
Sla de variable op met deze naam. <parameter>key</parameter>s moeten
uniek zijn, dus variablen opslaan met een key die al bestaat zal de
huidige waarde niet overschrijven, maar zal &false; retourneren (Dit is
het enige verschil tussen <function>apc_add</function> en
<function>apc_store</function>.)
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>var</parameter></term>
<listitem>
<para>
De variable die opgeslagen moet worden.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>ttl</parameter></term>
<listitem>
<para>
Time To Live; sla <parameter>var</parameter> op in de cache voor
<parameter>ttl</parameter> seconden. Nadat de
<parameter>ttl</parameter> verstreken is zal de opgeslagen variable
verwijderd worden uit de cache (tijdens het eerstvolgende request).
Indien er geen <parameter>ttl</parameter> wordt opgegeven, of als de
<parameter>ttl</parameter> gelijk is aan <literal>0</literal>, zal de
variable worden opgeslagen tot hij handmatig uit de cache wordt
verwijderd of de cache ophoudt met bestaan.
</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> voorbeeld</title>
<programlisting role="php">
<![CDATA[
<?php
$bar = 'BAR';
apc_add('foo', $bar);
var_dump(apc_fetch('foo'));
echo "\n";
$bar = 'WORDT NOOIT INGESTELD';
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
-->