Zu Handbuch PHP-API

Golem_Api_Article_Meta – Metadaten eines Artikels holen

Mit der Klasse Golem_Api_Article_Meta laden Sie die Metadaten eines bestimmten Golem.de-Artikels. Metadaten umfassen unter anderem die Überschrift, die Unter-Überschrift, den Abstract und das Publikationsdatum.

Einbindung

require_once '[Installationsort/]Golem/Request.php';
require_once '[Installationsort/]Golem/Api/Article/Meta.php';

Verwendung

Um ein neues Objekt der Klasse Golem_Api_Article_Meta zu erzeugen, übergeben Sie dem Konstruktor Ihren Entwicklerschlüssel und den Identifier des Artikels:

$request = new Golem_Api_Article_Meta($developerKey, 12345);
Beispiel 1: Objektinitialisierung

Die eigentliche Abfrage erfolgt mit der Methode fetch(). War sie erfolgreich, können Sie auf die Metadaten des Artikels zugreifen, die als lesbare Eigenschaften des Objektes bereit stehen.

$request->fetch();

$headline = $request->headline;
Beispiel 2: Abfrage starten und Daten holen

Fehlerbehandlung

Während der Datenabfrage können Fehler auftreten:

  • Golem_Api_Article_Meta::ERROR_INVALID_IDENTIFIER bedeutet, dass der übergebene Artikel-Identifier nicht die korrekte Form aufweist. Ein Artikel-Identifier besteht immer nur aus Ziffern.
  • Golem_Api_Article_Meta::ERROR_NO_ARTICLE bedeutet, dass der übergebene Artikel-Identifier nicht auf einen veröffentlichten Artikel verweist.

Wenn während der Abfrage ein Fehler auftritt, wird eine Exception geworfen, die Sie mit try-catch auffangen können.

try {

 $request->fetch();

} catch(Exception $e) {

 switch($e->getErrorCode()) {

  case Golem_Api_Article_Meta::ERROR_INVALID_IDENTIFIER :
       ...
       break;
  case ...

 }

}
Beispiel 3: Fehler abfangen

Verfügbare Artikeldaten

Für jeden Artikel werden folgende Eigenschaften mitgeliefert:

Name Bedeutung
articleid Artikel-Identifier
abstracttext Der Abstract des Artikels, eine Kurzzusammenfassung des Inhaltes
headline Die Überschrift des Artikels
subheadline Die Unter-Überschrift des Artikels
date Das Veröffentlichungsdatum als UNIX-Timestamp in Millisekunden
url Die URL des Artikels
pages Die Anzahl der Seiten des Artikels
leadimg Ein assoziatives Array mit den Daten des Headline-Bildes des Artikels. Die Einträge des Arrays sind:
  • url – Die URL des Bildes
  • width – Die Breite des Bildes in Pixel
  • height – Die Höhe des Bildes in Pixel

Vollständiges Beispiel

<?php

require_once 'Golem/Request.php';
require_once 'Golem/Api/Article/Meta.php';

$developerKey = '..';
$articles     = array();
$error        = '';

$request = new Golem_Api_Article_Meta($developerKey, 12345);

try {

 $request->fetch();

} catch( Exception $e ) {

 switch($e->getErrorCode()) {

  case Golem_Api_Article_Meta::ERROR_INVALID_IDENTIFIER :
       $error = 'Der Artikel-Identifier ist fehlerhaft!';
       break;

  case Golem_Api_Article_Meta::ERROR_NO_ARTICLE :
       $error = 'Ein Artikel mit diesem Identifier existiert nicht!';
       break;

  default :
        $error = 'Es trat ein interner Fehler auf!';

 }

}
?>

<html>
 <head>
  <title>Meta data article example</title>
 </head>
 <body>
  <?php
    if('' != $error) {
        echo $error;
    } else {
  ?>
  <table border="1">
   <tr>
    <td>Überschrift</td>
    <td><?php echo $request->headline; ?></td>
   </tr>
   <tr>
    <td>Unter-Überschrift</td>
    <td><?php echo $request->subheadline; ?></td>
   </tr>
   <tr>
    <td>Erschienen</td>
    <td><?php echo date('d. m. Y', $request->date); ?></td>
   </tr>
  </table>
  <?php
    }
  ?>
 </body>
</html>



Zu Handbuch PHP-API