|
1 | 1 | <?xml version="1.0" encoding="utf-8"?> |
2 | | -<!-- EN-Revision: e9366ee458b2900c53a503b1ad97664e1d9a8859 Maintainer: moradZahid Status: ready --> |
| 2 | +<!-- EN-Revision: 080a00e2014fbf36c8bd7fff91ed97f7ba636949 Maintainer: moradZahid Status: ready --> |
3 | 3 | <!-- Reviewed: no --> |
4 | 4 | <refentry xml:id="function.apcu-entry" xmlns="http://docbook.org/ns/docbook"> |
5 | 5 | <refnamediv> |
|
13 | 13 | <methodsynopsis> |
14 | 14 | <type>mixed</type><methodname>apcu_entry</methodname> |
15 | 15 | <methodparam><type>string</type><parameter>key</parameter></methodparam> |
16 | | - <methodparam><type>callable</type><parameter>generator</parameter></methodparam> |
| 16 | + <methodparam><type>callable</type><parameter>callback</parameter></methodparam> |
17 | 17 | <methodparam choice="opt"><type>int</type><parameter>ttl</parameter><initializer>0</initializer></methodparam> |
18 | 18 | </methodsynopsis> |
19 | 19 | <para> |
20 | 20 | Tente de récupérer atomiquement la valeur indexée par la clé <parameter>key</parameter> |
21 | 21 | dans le cache. Si elle ne peut pas être récupérée, la fonction passée à |
22 | | - <parameter>generator</parameter> est appelée, avec pour unique argument la valeur |
| 22 | + <parameter>callback</parameter> est appelée, avec pour unique argument la valeur |
23 | 23 | contenue dans <parameter>key</parameter>. La valeur de retour de l'appel est |
24 | 24 | ensuite mise en cache avec le paramètre optionnel <parameter>ttl</parameter>, |
25 | 25 | puis rend la main. |
|
29 | 29 | Lorsque le contrôle entre dans <function>apcu_entry</function> le verrou du cache est |
30 | 30 | acquis de façon exclusive. Il est libéré lorsque le contrôle quitte |
31 | 31 | <function>apcu_entry</function>: Plus précisément, le corps de la fonction passée à |
32 | | - <parameter>generator</parameter> devient une section critique, ce qui interdit à |
| 32 | + <parameter>callback</parameter> devient une section critique, ce qui interdit à |
33 | 33 | deux processus d'exécuter la même partie du code concurrentiellement. En outre, il |
34 | 34 | interdit l'exécution concurrentielle de tout autre fonction APCu, puisqu'elle acquerra |
35 | 35 | le même verrou. |
36 | 36 | </simpara> |
37 | 37 | </note> |
38 | 38 | <warning> |
39 | 39 | <simpara> |
40 | | - La seule fonction qui peut être appelée en toute sécurité par <parameter>generator</parameter> |
| 40 | + La seule fonction qui peut être appelée en toute sécurité par <parameter>callback</parameter> |
41 | 41 | est <function>apcu_entry</function>. |
42 | 42 | </simpara> |
43 | 43 | </warning> |
|
55 | 55 | </listitem> |
56 | 56 | </varlistentry> |
57 | 57 | <varlistentry> |
58 | | - <term><parameter>generator</parameter></term> |
| 58 | + <term><parameter>callback</parameter></term> |
59 | 59 | <listitem> |
60 | 60 | <para> |
61 | 61 | Un paramètre de type callable qui prend <parameter>key</parameter> pour unique argument |
|
0 commit comments