function.apache-note.html
6.35 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<title>Setzt und liest Apache Request Notes</title>
</head>
<body><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="function.apache-lookup-uri.html">apache_lookup_uri</a></div>
<div class="next" style="text-align: right; float: right;"><a href="function.apache-request-headers.html">apache_request_headers</a></div>
<div class="up"><a href="ref.apache.html">Apache Funktionen</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="function.apache-note" class="refentry">
<div class="refnamediv">
<h1 class="refname">apache_note</h1>
<p class="verinfo">(PHP 4, PHP 5)</p><p class="refpurpose"><span class="refname">apache_note</span> — <span class="dc-title">Setzt und liest Apache Request Notes</span></p>
</div>
<div class="refsect1 description" id="refsect1-function.apache-note-description">
<h3 class="title">Beschreibung</h3>
<div class="methodsynopsis dc-description">
<span class="type">string</span> <span class="methodname"><strong>apache_note</strong></span>
( <span class="methodparam"><span class="type">string</span> <code class="parameter">$note_name</code></span>
[, <span class="methodparam"><span class="type">string</span> <code class="parameter">$note_value</code><span class="initializer"> = ""</span></span>
] )</div>
<p class="para rdfs-comment">
Diese Funktion ist ein Wrapper für das <em>table_get</em> und
<em>table_set</em> von Apache. Sie editiert die Notestabelle, die
während eines Requests existiert. Der Sinn dieser Tabelle ist es, die
Kommunikation zwischen Apachemodulen zu ermöglichen.
</p>
<p class="para">
Der primäre Anwendungsfall für <span class="function"><strong>apache_note()</strong></span> ist die
Übergabe von Informationen von einem Modul an ein anderes während der
Abarbeitung eines bestimmten Requests.
</p>
</div>
<div class="refsect1 parameters" id="refsect1-function.apache-note-parameters">
<h3 class="title">Parameter-Liste</h3>
<p class="para">
<dl>
<dt>
<code class="parameter">note_name</code></dt>
<dd>
<p class="para">
Der Name der Note.
</p>
</dd>
<dt>
<code class="parameter">note_value</code></dt>
<dd>
<p class="para">
Der Wert der Note.
</p>
</dd>
</dl>
</p>
</div>
<div class="refsect1 returnvalues" id="refsect1-function.apache-note-returnvalues">
<h3 class="title">Rückgabewerte</h3>
<p class="para">
Wenn die Funktion mit einem Argument aufgerufen wird, gibt sie den aktuellen
Wert der Note <em>note_name</em> zurück. Wird sie mit zwei
Argumenten aufgerufen, setzt sie den Wert der Note <em>note_name</em>
auf <em>note_value</em> und gibt den vorigen Wert der Note
<em>note_name</em> zurück. Wenn die Note nicht angesprochen werden
kann, wird <strong><code>FALSE</code></strong> zurückgegeben.
</p>
</div>
<div class="refsect1 examples" id="refsect1-function.apache-note-examples">
<h3 class="title">Beispiele</h3>
<p class="para">
<div class="example" id="example-4715">
<p><strong>Beispiel #1 Übergeben von Informationen zwischen PHP und Perl</strong></p>
<div class="example-contents">
<div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB"><?php<br /><br />apache_note</span><span style="color: #007700">(</span><span style="color: #DD0000">'name'</span><span style="color: #007700">, </span><span style="color: #DD0000">'Fredrik Ekengren'</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">// Perl-Skript aufrufen<br /></span><span style="color: #0000BB">virtual</span><span style="color: #007700">(</span><span style="color: #DD0000">"/perl/some_script.pl"</span><span style="color: #007700">);<br /><br /></span><span style="color: #0000BB">$result </span><span style="color: #007700">= </span><span style="color: #0000BB">apache_note</span><span style="color: #007700">(</span><span style="color: #DD0000">"resultdata"</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?></span>
</span>
</code></div>
</div>
<div class="example-contents">
<div class="perlcode"><pre class="perlcode"># Hole das Apache Request Objekt
my $r = Apache->request()->main();
# Hole die übergebenen Daten
my $name = $r->notes('name');
# beliebige Verarbeitung
# Reiche das Ergebnis an PHP zurück
$r->notes('resultdata', $result);</pre>
</div>
</div>
</div>
</p>
<p class="para">
<div class="example" id="example-4716">
<p><strong>Beispiel #2 Werte in access.log loggen</strong></p>
<div class="example-contents">
<div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB"><?php<br /><br />apache_note</span><span style="color: #007700">(</span><span style="color: #DD0000">'sessionID'</span><span style="color: #007700">, </span><span style="color: #0000BB">session_id</span><span style="color: #007700">());<br /><br /></span><span style="color: #0000BB">?></span>
</span>
</code></div>
</div>
<div class="example-contents">
<div class="apachecode"><pre class="apachecode"># "%{sessionID}n" kann in der LogFormat-Direktive verwendet werden</pre>
</div>
</div>
</div>
</p>
</div>
<div class="refsect1 seealso" id="refsect1-function.apache-note-seealso">
<h3 class="title">Siehe auch</h3>
<p class="para">
<ul class="simplelist">
<li class="member"><span class="function"><a href="function.virtual.html" class="function" rel="rdfs-seeAlso">virtual()</a> - Führt eine Apache-Unteranfrage durch</span></li>
</ul>
</p>
</div>
</div><hr /><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="function.apache-lookup-uri.html">apache_lookup_uri</a></div>
<div class="next" style="text-align: right; float: right;"><a href="function.apache-request-headers.html">apache_request_headers</a></div>
<div class="up"><a href="ref.apache.html">Apache Funktionen</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>