Installation von php-RGraph

Die Installation ist unkompliziert. Sobald Sie die Installationsdatei "php-RGraph-V2.1.18.zip" heruntergeladen haben, entpacken Sie sie und laden Sie alle Ordner und Dateien auf Ihre Website in ein zugängliches Verzeichnis hoch. (oder wenn Sie XAMPP verwenden, kopieren Sie Ordner und Dateien in ein zugängliches Verzeichnis. "Zugänglich" bedeutet, dass Sie Zugriff auf alle Dateien über ihren Webserver (z. B. Apache) und den Browser haben. Bitte behalten Sie die Verzeichnisstruktur und die Benennung von Ordnern bei (keine Verzeichniss umbenennen).

Überprüfen Sie dann, ob Sie über folgende URL auf die Dokumentation von php-RGraph zugreifen können:
http://your-host/ihr-installations-verszeichnis/RGraph/index.html. Wenn dies in Ordnung ist, können Sie die Referenz von RGraph lesen und die bereitgestellten Beispiele einsetzen oder testen.

Struktur von php-RGraph Diagramm Scripten

Um Ihnen eine Vorstellung davon zu geben, wie alles funktioniert, sollten Sie einige der bereitgestellten Beispiele überprüfen. (Bitte verwenden Sie folgende URL http://your-host/ihr-installations-verzeichnis/RGraph/doc/samples-de.html. Auf dieser Beispielseite haben Sie die Möglichkeit, ein Beispiel anzuzeigen und den php-Code für das Erstellen des Beispiels anzusehen. Mit diesem Code wird die Struktur von php-RGraph Scripten veranschaulicht. Ein php-Diagrammscript hat hier immer diese Komponenten:

1. Definition der Umgebungsvariablen
2. Definition des Layout vom Diagramm
3. Definition der Diagrammdaten
4. Definition der RGraph Diagramm Eigenschaften
5. Erstellung eines json-Objekts für RGraph
6. Verwendung von templates für die Anzeige des Diagramms (html-Generierung)

Definition der Umgebungsvariablen

Jedes Diagrammskript muss "wissen", wo sich Ressourcen für Diagramme befinden. Dies wird mit der Einbettung (include) des Scripts "environment.php" definiert. Wenn dieses Skript nicht richtig funktioniert können Diagramme nicht erstellt werden. Sehen sie hier Layout von "environment.php", das aufzeigt, welche Informationen benötigt werden: Hinweis: Die Vergabe von Variablne-Namen ist wichtig für den Einsatz vong Templates.

Seit der Version 2.1.1 von php-RGraph sind alle Klasssen in Namespaces eingebunden, deshalb ist es notwendig, neben der include file "environment.php" mit "use"-Anweisungen die Namespaced Klassen anzugeben:

Definition des Layout vom Diagramm

Mit vier Codezeilen definieren Sie das Hauptlayout Ihres Diagramms: Sie definieren die Breite ("$width") und Höhe ("$height") des Canvas. und welche Methode RGraph zur Anzeigen des Diagramms verwendent soll ("$draw_option"). Und Sie müssen angeben, welches Template zum Rendern des Diagramms verwendet werden soll.

Definition der Diagrammdaten

Diagrammdaten können aus verschiedenen Quellen stammen:

• Definieren Sie ein Array numerischer Daten direkt in Ihrem Diagrammskriptt
• Daten aus Datei abrufen
• Daten von einem lokalen oder entfernten Server anfordern
• Daten aus der MySQL-Datenbank abrufen
• Daten aus csv-Datei abrufen
• Daten aus Google Tabellen (sheets) abrufen
• Daten über eine mathematische Formel generieren

Die php-Klasse rgraph_chart verfügt über verschiedene Methoden, die Sie bei der Bereitstellung von Daten für Ihr Diagramm unterstützen. Weitere Informationen finden Sie im Referenzhandbuch oder Schauen Sie sich die Beispiele an.

Definition der RGraph Diagramm Eigenschaften

Der erste Schritt besteht darin, ein rgraph_chart-Objekt zu definieren:

• "$id" ist erforderlich und definiert die Canvas-ID (z. B." cvs ").
• "$data" definiert die Daten, die für das Diagramm verwendet werden sollen
• "$chart_type" legt den gewünschten Diagrammtyp fest (z. B. "Pie")
  gültige Typen sind:
  • Bar
  • HBar
  • Bipolar
  • Line
  • Pie
  • Fuel
  • Funnel
  • Gauge
  • Gantt
  • Meter
  • Odometer
  • Radar
  • Rose
  • RScatter
  • SemiCircularProgress
  • Scatter
  • Waterfall

Nachdem Sie ein rgraph_chart-Objekt erstellt haben, können Sie ein rgraph_options-Objekt erstellen und Diagrammeigenschaften definieren. Mit dem optionalen Parameter "$ini_file" können Sie eine INI-Datei mit vordefinierten Diagramm-Eigenschaften angeben (z. B. Schriftgrößen, Farben, Schriftfamilien usw.).

php-RGraph "kennt" mehr als 500 verschiedene Diagrammeigenschaften für fast alle von RGraph angebotenen Diagramme. Die php-Klasse rgraph_options verfügt über verschiedene Methoden, die Sie bei der Bereitstellung von Diagrammeigenschaften unterstützen. Weitere Informationen finden Sie im Referenzhandbuch, in den Beispielen oder besuchen sie die Homepage von RGraph.

Erstellung eines json-Objekts für RGraph

Nachdem Sie das Diagrammobjekt und seine Eigenschaften erstellt haben, müssen Sie zuerst die Eigenschaften ($options object) für das Diagrammobjekt deinieren. Danach erstellen Sie ein JSON-Objekt, das mit RGraph verwendet werden soll:

Verwendung von templates für die Anzeige des Diagramms

Dies ist eine einfache Aufgabe, da das Verzeichnis des Templates mit dem include script "environment.php" definiert wurde. Ihr Code sieht also so aus:

<?php
// check settings
if (! isset($chart))
  die ("Error: rgraph_chart object not defined");
if (! isset($rgraph_json))
      die ("Error: json object is not defined");
$id = $chart->get_id();
$chart_type = $chart->get_chartType();
$script= '<script src="' . $rgraph_libraries . $chart->getScript($chart_type) . '">';
echo $script;

// check for defined values
if (! isset($width))
    $width = 400;
if (! isset($height))
    $height = 250;
if (! isset($draw_option))
    $draw_option = "draw();";
if (! isset($canvas_style))
    $canvas_style = "";
if (! isset($canvas_class))
    $canvas_class = "";
if (! isset($chart_name))
    $chart_name = "chart";
if (! isset($event_script))
    $event_script = "";
if (! isset($chart_script))
    $chart_script = "";

<?php

<?php include_once "default_header.php"; ?>

<canvas id="<?php echo $id; ?>" width="<?php echo $width; ?>" height="<?php echo $height; ?>" 
 style=" <?php echo $canvas_style; ?>" class="<?php echo $canvas_class; ?>">
    [No canvas support]>
</canvas>
<script>
jQuery(document).ready(function() {
 
  <?php echo $event_script; ?>
   
  RGraph.reset('<?php echo $id; ?>');  
   
  var <?php echo $chart_name; ?> = new RGraph.<?php echo $chart_type; ?> (
   <?php echo $rgraph_json; ?>).<?php echo $draw_option; ?>

   <?php echo $chart_script; ?>
});
</script>

<script src="/../js/jquery.min.js" type="text/javascript">
<script src="/../libraries/RGraph.common.lib.js" type="text/javascript">

<script type="text/javascript">
jQuery(document).ready(function() { 
 var url = "../samples/logo.php";
 jQuery("#show-sample").load( url, function() {
   }); 
});
</script>

<div id="show-sample" style="float:right"></div>

 function show_chart() {
    var url = "../samples/meter.php";  
    jQuery("#show-sample" ).load( url, function() {
   });
}

<script src="/../libraries/RGraph.common.libs.js" type="text/javascript">

{jphpx [php-apps/RGraph/samples_jphpx/bar_simple.php]}