Installation von php-RGraph

Ü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

• 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:

  <?php
  // php-Rgraph root directory
  $rgraph_root = "/ihr-installations-verzeichnis/RGraph";
  
  // php-Rgraph library
  $lib = $_SERVER['DOCUMENT_ROOT'] . $rgraph_root . "/lib/rgraph_chart.php";
  if (!file_exists($lib))
   die ("Error: $lib not found");
  require_once ($lib);
  
  // directory for templates
  $templates =  $_SERVER['DOCUMENT_ROOT'] . $rgraph_root . "/templates/";
  if (!file_exists($templates))
      die ("Error: $templates not found");
  
  // directory for RGraphs's javascript library
  $rgraph_libraries = $rgraph_root . "/libraries/";
  
  // (optional) directory for Utilities
  $utility =   $_SERVER['DOCUMENT_ROOT'] . $rgraph_root . '/lib/util.php';
  

  Hinweis: Die Vergabe von Variablne-Namen ist wichtig für den Einsatz von 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:

  include_once "environment.php";
  use phpRGraph\rgraph_chart;
  use phpRGraph\rgraph_options;
  

  
  
• Definition des Layout vom Diagramm
  
  Mit vier Codezeilen definieren Sie das Hauptlayout Ihres Diagramms:

  $template = "default.php";
  $draw_option = "draw();";
  $width = "500";
  $height = "350";
  

  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:

  $chart = new rgraph_chart($id, $data, $chart_type);
  

  • "$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.

   $options = new rgraph_options($ini-file);
   $options->set_option("title", "Mein erstes Diagramm");
    ...
  

  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:

  $chart->set_options($options);
  $rgraph_json = $chart->toPrettyString();
  

  
  
• 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:

   include_once ($templates . $template);