Signatur
Beschreibung
Die Funktion trader_cdlrickshawman() gehört zur TRADER-Extension (TA-Lib-Binding für PHP) und analysiert eine Reihe von Kerzenchartdaten (Open, High, Low, Close), um das Rickshaw Man-Muster zu identifizieren. Dieses Muster ist eine Variante des Doji und zeichnet sich dadurch aus, dass Eröffnungs- und Schlusskurs sehr nahe beieinander liegen, während die Dochte (Schatten) oben und unten annähernd gleich lang sind. Der Körper der Kerze liegt exakt in der Mitte.
Das Rickshaw Man-Muster gilt in der technischen Analyse als Trendwendesignal oder Zeichen von Unentschlossenheit am Markt. Es tritt auf, wenn weder Käufer noch Verkäufer die Kontrolle über den Preis behalten konnten. Trader nutzen es vor allem als Warnsignal, dass ein bestehender Trend an Kraft verliert.
Der Rückgabe-Array hat dieselbe Länge wie die Eingabedaten; Positionen, die nicht berechnet werden konnten (Lookback-Periode), werden mit 0 aufgefüllt. Ein Wert von 100 signalisiert ein bullisches Auftreten, -100 ein bearisches, und 0 bedeutet, dass an dieser Stelle kein Muster erkannt wurde.
Die Funktion erfordert, dass die PHP-TRADER-Extension installiert und aktiviert ist (pecl install trader). Alle vier Arrays müssen dieselbe Länge haben und konsistent geordnete OHLC-Daten enthalten.
Parameter
| Name | Typ | Default | Beschreibung |
|---|---|---|---|
| $open Pflicht | array | Array der Eröffnungskurse (numerisch indiziert, chronologisch aufsteigend). | |
| $high Pflicht | array | Array der Höchstkurse (numerisch indiziert, chronologisch aufsteigend). | |
| $low Pflicht | array | Array der Tiefstkurse (numerisch indiziert, chronologisch aufsteigend). | |
| $close Pflicht | array | Array der Schlusskurse (numerisch indiziert, chronologisch aufsteigend). |
Rückgabewert
Gibt ein numerisch indiziertes Array zurück, das für jede Eingabekerze einen ganzzahligen Signalwert enthält:
100— Rickshaw-Man-Muster erkannt (bullisch / neutral)-100— Rickshaw-Man-Muster erkannt (bearisch / neutral)0— kein Muster erkannt oder Wert liegt innerhalb der Lookback-Periode
Bei einem Fehler (z. B. unterschiedliche Array-Längen) gibt die Funktion false zurück.
Beispiele
Einfache Mustererkennung auf synthetischen OHLC-Daten
<?php
// Voraussetzung: TRADER-Extension ist installiert (pecl install trader)
$open = [100.0, 102.0, 101.5, 103.0, 102.0];
$high = [105.0, 107.0, 108.0, 110.0, 109.0];
$low = [ 95.0, 97.0, 95.0, 96.0, 95.5];
$close = [100.2, 102.1, 101.6, 103.1, 102.1];
$result = trader_cdlrickshawman($open, $high, $low, $close);
if ($result === false) {
echo 'Fehler bei der Berechnung.';
} else {
foreach ($result as $index => $signal) {
if ($signal !== 0) {
echo "Rickshaw-Man-Muster an Position {$index}: Signal = {$signal}\n";
}
}
echo 'Analyse abgeschlossen.';
}Praxisanwendung mit realen Kursdaten aus einer Datenbank
<?php
// TRADER-Extension vorausgesetzt
// Simulierter Datenbankabzug (z. B. aus PDO)
$rows = [
['open' => 200.0, 'high' => 215.0, 'low' => 185.0, 'close' => 200.5],
['open' => 198.0, 'high' => 213.0, 'low' => 183.0, 'close' => 198.3],
['open' => 199.0, 'high' => 216.0, 'low' => 182.0, 'close' => 199.1],
];
$open = array_column($rows, 'open');
$high = array_column($rows, 'high');
$low = array_column($rows, 'low');
$close = array_column($rows, 'close');
$signals = trader_cdlrickshawman($open, $high, $low, $close);
foreach ($signals as $i => $value) {
$label = match($value) {
100 => '✓ Bullisches Rickshaw-Man-Signal',
-100 => '✓ Bearisches Rickshaw-Man-Signal',
default => 'kein Signal',
};
printf("Kerze %d: %s\n", $i + 1, $label);
}// Wichtig · Fallstricke
Lookback-Periode: TA-Lib benötigt eine Mindestanzahl an Kerzen, um Berechnungen durchzuführen. Positionen innerhalb der Lookback-Periode enthalten immer 0. Bei Mustern wie dem Rickshaw Man ist die Lookback-Periode typischerweise 0 bis wenige Kerzen.
Extension-Abhängigkeit: trader_cdlrickshawman() ist nur verfügbar, wenn die TRADER PECL-Extension installiert ist. Prüfe die Verfügbarkeit vorab mit extension_loaded('trader').
Eingabedaten: Alle vier Arrays müssen exakt dieselbe Länge besitzen. Inkonsistente Daten führen zu einem Fehler (false als Rückgabewert). Negativwerte oder NaN-Werte können zu unerwarteten Ergebnissen führen.